6323_FM_final.qxd 2/27/06 7:07 PM Page i Expert C# 2005 Business Objects Second Edition Rockford Lhotka 6323_FM_final.qxd 2/27/06 7:07 PM Page ii Expert C# 2005 Business Objects,Second Edition Copyright © 2006 by Rockford Lhotka All rights reserved. No part of this work may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording, or by any information storage or retrieval system, without the prior written permission of the copyright owner and the publisher. ISBN-13 (pbk): 978-1-59059-632-6 ISBN-10 (pbk): 1-59059-632-3 Printed and bound in the United States of America 9 8 7 6 5 4 3 2 1 Trademarked names may appear in this book. Rather than use a trademark symbol with every occurrence of a trademarked name, we use the names only in an editorial fashion and to the benefit of the trademark owner, with no intention of infringement of the trademark. Lead Editor: Jonathan Hassell Technical Reviewers: Dan Billingsley, Brant Estes, Petar Kozul Editorial Board: Steve Anglin, Dan Appleman, Ewan Buckingham, Gary Cornell, Jason Gilmore, Jonathan Hassell, James Huddleston, Chris Mills, Matthew Moodie, Dominic Shakeshaft, Jim Sumser, Matt Wade Project Manager: Kylie Johnston Copy Edit Manager: Nicole LeClerc Copy Editor: Damon Larson Assistant Production Director: Kari Brooks-Copony Production Editor: Laura Cheu Compositor:Linda Weidemann, Wolf Creek Press Proofreader: Elizabeth Berry Indexer: John Collin Artist: Kinetic Publishing Services, LLC Cover Designer: Kurt Krames Manufacturing Director: Tom Debolski Distributed to the book trade worldwide by Springer-Verlag New York, Inc., 233 Spring Street, 6th Floor, New York, NY 10013. Phone 1-800-SPRINGER, fax 201-348-4505, e-mail [email protected],or visit http://www.springeronline.com. For information on translations, please contact Apress directly at 2560 Ninth Street, Suite 219, Berkeley, CA 94710. Phone 510-549-5930, fax 510-549-5939, e-mail [email protected],or visit http://www.apress.com. The information in this book is distributed on an “as is” basis, without warranty. Although every precaution has been taken in the preparation of this work, neither the author(s) nor Apress shall have any liability to any person or entity with respect to any loss or damage caused or alleged to be caused directly or indirectly bythe information contained in this work. The source code for this book is available to readers at http://www.apress.comin the Source Code section. 6323_FM_final.qxd 2/27/06 7:07 PM Page iii In memory of my Grandmother,Evylyn, atrue angel on earth,who now rests in heaven. 6323_FM_final.qxd 2/27/06 7:07 PM Page iv 6323_FM_final.qxd 2/27/06 7:07 PM Page v Contents at a Glance About the Author ......................................................................xv About the Technical Reviewers ..........................................................xvii Acknowledgments .....................................................................xix Introduction ..........................................................................xxi nCHAPTER 1 Distributed Architecture.............................................1 nCHAPTER 2 Framework Design.................................................35 nCHAPTER 3 Business Framework Implementation...............................91 nCHAPTER 4 Data Access and Security .........................................159 nCHAPTER 5 Completing the Framework........................................235 nCHAPTER 6 Object-Oriented Application Design ................................321 nCHAPTER 7 Using the CSLA .NET Base Classes.................................361 nCHAPTER 8 Business Object Implementation...................................405 nCHAPTER 9 Windows Forms UI................................................465 nCHAPTER 10 Web Forms UI ....................................................513 nCHAPTER 11 Web Services Interface............................................563 nCHAPTER 12 Implementing Remote Data Portal Hosts............................601 nINDEX ...........................................................................621 v 6323_FM_final.qxd 2/27/06 7:07 PM Page vi 6323_FM_final.qxd 2/27/06 7:07 PM Page vii Contents About the Author ......................................................................xv About the Technical Reviewers ..........................................................xvii Acknowledgments .....................................................................xix Introduction ..........................................................................xxi nCHAPTER 1 Distributed Architecture........................................1 Logical and Physical Architecture .......................................1 Complexity .....................................................3 Relationship Between Logical and Physical Models ...................4 A5-Layer Logical Architecture.....................................8 Applying the Logical Architecture .................................13 The Way Ahead ................................................17 Managing Business Logic.............................................17 Potential Business Logic Locations................................18 Business Objects...............................................21 Mobile Objects.................................................24 Architectures and Frameworks.........................................32 Conclusion .........................................................33 nCHAPTER 2 Framework Design.............................................35 Basic Design Goals ..................................................36 N-Level Undo Capability.........................................37 Tracking Broken Business Rules..................................40 Tracking Whether the Object Has Changed .........................41 Strongly Typed Collections of Child Objects.........................41 Simple and Abstract Model for the UI Developer.....................42 Supporting Data Binding.........................................46 Object Persistence and Object-Relational Mapping...................49 Custom Authentication ..........................................56 Integrated Authorization .........................................57 vii 6323_FM_final.qxd 2/27/06 7:07 PM Page viii viii nCONTENTS Framework Design...................................................58 Business Object Creation ........................................58 N-Level Undo Functionality.......................................63 Data Binding Support ...........................................66 Validation Rules................................................67 Data Portal ....................................................70 Custom Authentication ..........................................82 Integrated Authorization .........................................84 Helper Types and Classes........................................85 Namespace Organization .............................................88 Conclusion .........................................................90 nCHAPTER 3 Business Framework Implementation........................91 Setting Up the CSLA .NET Project.......................................92 Creating the Directory Structure...................................93 Supporting Localization..........................................93 Csla.Core Namespace................................................94 IBusinessObject Interface........................................94 IUndoableObject Interface........................................95 IEditableCollection Interface......................................96 IReadOnlyObject Interface........................................96 IReadOnlyCollection Interface.....................................97 ICommandObject Interface.......................................97 ObjectCloner Class..............................................97 BindableBase Class.............................................98 NotUndoableAttribute Class .....................................101 UndoableBase Class ...........................................101 BusinessBase Class............................................109 ReadOnlyBindingList Class......................................127 Csla.Validation Namespace...........................................128 RuleHandler Delegate..........................................128 RuleArgs Class................................................129 RuleMethod Class .............................................130 ValidationRules Class ..........................................130 BrokenRule Class..............................................134 BrokenRulesCollection Class ....................................134 ValidationException............................................135 Csla.Security Namespace............................................136 RolesForProperty Class.........................................136 AccessType Enum.............................................136 AuthorizationRules Class........................................137 6323_FM_final.qxd 2/27/06 7:07 PM Page ix nCONTENTS ix Csla Namespace ...................................................139 BusinessBase Class............................................139 BusinessListBase Class.........................................142 ReadOnlyBase Class...........................................155 ReadOnlyListBase Class........................................156 Conclusion ........................................................157 nCHAPTER 4 Data Access and Security ....................................159 Data Portal Design..................................................160 Channel Adapter and Message Router Patterns.....................161 Distributed Transaction Support..................................164 Context and Location Transparency ..............................166 Enhancing the Base Classes..........................................169 Factory Methods and Criteria....................................171 Save Methods.................................................172 Data Portal Methods ...........................................174 Channel Adapter....................................................177 Csla.MethodCaller Class........................................177 Csla.Server.CallMethodException ................................183 Csla.RunLocalAttribute Class....................................184 Csla.DataPortalEventArgs Class..................................184 Csla.DataPortal Class ..........................................185 Csla.Server.IDataPortalServer ...................................193 Csla.DataPortalClient.IDataPortalProxy............................194 Csla.DataPortalClient.LocalProxy.................................194 Csla.DataPortalClient.RemotingProxy .............................195 Csla.Server.Hosts.RemotingPortal................................198 Csla.DataPortalClient.EnterpriseServicesProxy......................200 Csla.Server.Hosts.EnterpriseServicesPortal ........................201 Csla.DataPortalClient.WebServicesProxy ..........................206 Csla.Server.Hosts.WebServicePortal..............................208 Distributed Transaction Support.......................................210 Csla.TransactionalTypes........................................210 Csla.TransactionalAttribute......................................210 Csla.Server.DataPortal .........................................211 Csla.Server.ServicedDataPortal..................................215 Csla.Server.TransactionalDataPortal..............................216 Message Router....................................................217 Csla.CriteriaBase..............................................217 Csla.Server.SimpleDataPortal....................................218