Awesome
FFLib Apex Common
Dependencies: Must deploy ApexMocks before deploying this library
<a href="https://githubsfdeploy.herokuapp.com?owner=apex-enterprise-patterns&repo=fflib-apex-common"> <img alt="Deploy to Salesforce" src="https://raw.githubusercontent.com/afawcett/githubsfdeploy/master/src/main/webapp/resources/img/deploy.png"> </a>Updates
- December 2022, IMPORTANT CHANGE - Support for native Apex User Mode was added to the library (see discussion). For new projects, the old
enforceCRUD
andenforceFLS
flags onfflib_SObjectSelector
should be considered deprecated and the constructors that takedataAccess
arguments should be used instead. Additionally, the introduction offflib_SObjectUnitOfWork.UserModeDML
provides anIDML
implementation that supportsUSER_MODE
orSYSTEM_MODE
.fflib_SObjectUnitOfWork.SimpleDML
(the defaultIDML
implementation) should be considered deprecated. There are measurable performance benefits to usingSYSTEM_MODE
andUSER_MODE
(Apex CPU usage reduction). Additionally, the use of explicitUSER_MODE
andSYSTEM_MODE
overrides thewith sharing
andwithout sharing
class declaration and makes the expected behavior of DML and SOQL easier to understand. - April 2020, IMPORTANT CHANGE, the directory format of this project repo was converted to Salesforce DX Source Format. While the GIT commit history was maintained, it is not visible on GitHub. If you need to see the history, either clone the repo and execute
git log --follow
from the command line or refer to this tag of the codebase prior to conversion. - September 2014, IMPORTANT CHANGE, changes applied to support Dreamforce 2014 advanced presentation, library now provides Application factories for major layers and support for ApexMocks. More details to follow! As a result ApexMocks must be deployed to the org before deploying this library. The sample application here has also been updated to demonstrate the new features!
- July 2014, IMPORTANT CHANGE, prior 23rd July 2014, both the
fflib_SObjectDomain.onValidate()
andfflib_SObjectDomain.onValidate(Map<Id, SObject> existingRecords)
methods where called during an on after update trigger event. From this point on theonValidate()
method will only be called during on after insert. If you still require the orignal behaviour add the lineConfiguration.enableOldOnUpdateValidateBehaviour();
into your constructor. - June 2014, New classes providing utilities to support security and dynamic queries, in addition to improvements to existing Apex Enterprise Pattern base classes. Read more here.
This Library
Is derived from the Dreamforce 2012 presentation on Apex Enterprise Patterns and progresses the patterns further with a more general ongoing home for them. It also adds some form of namespace qualification from the previous version. So that classes are grouped together more easily in the IDE's and packages. Below you can find comprehensive articles and videos on the use of these patterns. There is also a working sample application illustrating the patterns here.
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.
Documentation
- Apex Sharing and applying to Apex Enterprise Patterns
- Tips for Migrating to Apex Enterprise Patterns
- Great Contributions to Apex Enterprise Patterns
- Unit Testing, Apex Enterprise Patterns and ApexMocks – Part 1
- Unit Testing, Apex Enterprise Patterns and ApexMocks – Part 2
- Apex Enterprise Patterns - Separation of Concerns
- Apex Enterprise Patterns - Service Layer
- Apex Enterprise Patterns - Domain Layer
- Apex Enterprise Patterns - Selector Layer
- View slides for the Dreamforce 2013 session here
- View slides for the Dreamforce 2015 session here
Related Webinars
Related Book
Other Related Blogs