/df12-apex-enterprise-patterns

Dreamforce 2012 Session - Applying Enterprise Application Design Patterns on Force.com

Primary LanguageApexBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

This repository will remain compatible with the implementation and presentations given at Dreamforce 2012. The above link takes you to a repository that will form a more ongoing place to share and evolve the classes supporting these patterns. Which shares initially, the structure and features of the ones orignally presented, but is free to adopting new features and evoluations.

Application Enterprise Patterns on Force.com

Design patterns are an invaluable tool for developers and architects looking to build enterprise solutions. Here are presented some tried and tested enterprise application engineering patterns that have been used in other platforms and languages. We will discuss and illustrate how patterns such as Data Mapper, Service Layer, Unit of Work and of course Model View Controller can be applied to Force.com. Applying these patterns can help manage governed resources (such as DML) better, encourage better separation-of-concerns in your logic and enforce Force.com coding best practices.

You can view the slides for my Dreamforce 2012 session here and a re-recording of the session here.

Latest Article Series on Developer Force.com

I'm proud to have been given the opportunity to run a more detailed look at these patterns on developer.force.com.

IMPORTANT NOTE: Updates 9th April 2013

The sample code in this repo was updated to reflect some new ideas and designs, mainly around the SObjectDomain base class methods (e.g. beforeUpdate has become onBeforeUpdate). These new methods will be show cased in an upcoming article on developer.force.com (which will be linked above). The principles and general design shown below, slides and video are still valid.

Introduction and Acknowledgement

Thanks to Martin Fowler for his clear and well define descriptions of the patterns used in this session. While not all are directly applicable to Force.com. We hope to illustrate Force.com tailored implementions of some that are. Many of which are designed to ensure good Separation of Concerns (SOC) and management of resources. Something as we know is quite important on the Force.com platform. You can find a full overview of all of Martin's EAA patterns here.

Sample Code Class Diagram

This class diagram gives an approximate view of the classes used in this sample. Colour coding helps illustrate how separation of concerns has been implemented.

Class Diagram Key

Model View Controller

"Splits user interface interaction into three distinct roles." http://martinfowler.com/eaaCatalog/modelViewController.html

Force.com Note: Visualforce is the Force.com implementation of this pattern. However it does not help you maintain a clear separation of concerns by default. It is up to the developer to consider the purpose and thus positioning of the logic they are writing in respect to the rest of the application. Otherwise action methods in UI controllers will endup containing much of applications true business logic. The patterns below help provide a framework to help avoid. Most important for controllers (a client) is the Service Layer.

See OpportunityApplyDiscountController and OpportunityCreateInvoiceController

Service Layer

"A Service Layer defines an application's boundary [Cockburn PloP] and its set of available operations from the perspective of interfacing client layers. It encapsulates the application's business logic, controlling transactions and coor-dinating responses in the implementation of its operations." http://martinfowler.com/eaaCatalog/serviceLayer.html

See OpportunitiesService.cls

Force.com Note: On Force.com, application behaviour is exposed in terms of the data model (your Custom Objects). As clients interact with our Custom Objects via the standard UI, Salesforce API's and tools like Data Loader. Consider in addition to this, that your applicaiton will likely have business logic that is more task or process orientated (creating invoices, applying discounts, batch processes, scheduled jobs etc). This logic is ideally suited to the Service layer pattern. Eitherway, as per the Domain Model pattern bellow and adhering to good SOC, avoid positioning business logic above your Custom Object or Service layer.

Domain Model

"An object model of the domain that incorporates both behavior and data. At its worst business logic can be very complex. Rules and logic describe many different cases and slants of behavior, and it's this complexity that objects were designed to work with. A Domain Model creates a web of interconnected objects, where each object represents some meaningful individual, whether as large as a corporation or as small as a single line on an order form." http://martinfowler.com/eaaCatalog/domainModel.html

Force.com Note: In order to encourage bulkficaiton throughout your business logic the implementation of this pattern here proposes that your domain classes deal with a collection of SObject's, much like an Apex Trigger does. Also consider that you may have Custom Objects that share common behavior, in these cases you can utilise OO programming to develop base classes and interfaces to reuse this code between these objects by having their domain classes extend a common domain base class.

See Opportunities.cls, OpportunityLineItems.cls and SObjectDomain.cls

(also see OpportunitiesTrigger.trigger and OpportunityLineItems.trigger)

Data Mapper (Selector)

"Objects and relational databases have different mechanisms for structuring data. Many parts of an object, such as collections and inheritance, aren't present in relational databases. When you build an object model with a lot of business logic it's valuable to use these mechanisms to better organize the data and the behavior that goes with it. Doing so leads to variant schemas; that is, the object schema and the relational schema don't match up." http://martinfowler.com/eaaCatalog/dataMapper.html

Force.com Note: This pattern is an ideal place to place CRUD security checks for permission to read. It also helps avoid runtime exceptions relating to fields referenced that have not been queried. Since it can help form and encapsulate a consistent place for placing code relating to querying data as apposed to spreading adhoc SOQL queries throughout your logic.

See OpportunitiesSelector.cls, OpportunityLineItemsSelector.cls and SObjectSelector

Unit Of Work

"Maintains a list of objects affected by a business transaction and coordinates the writing out of changes and the resolution of concurrency problems." http://martinfowler.com/eaaCatalog/unitOfWork.html

Force.com Note: This pattern provides the following specific benifits

  • Applies bulkfication to DML operations, insert, update and delete
  • Manages a business transaction around the work and ensures a rollback occurs (even when exceptions are later handled by the caller)
  • Honours dependency rules between records and updates dependent relationships automatically during the commit cycle
  • Implements CRUD security

See SObjectUnitOfWork.cls