fflib-apex-extensions

Extensions for the fflib-apex-common Library. Introducing many advanced features on top of the Apex Enterprise Patterns

Dependencies:
This extension package is dependent on the following packages:

• fflib-apex-mocks
• fflib-apex-common

Extensions pack contents

These features are offered in this extension package:

• Application class redesigned
  A Force-DI like feature using dependency injection with the Separation of Concerns design pattern.
• Criteria evaluator
  Ability to use the same criteria filters for domains and selectors. Build SOQL WHERE clauses in an object-oriented manner. It can also evaluate a list of records against predefined conditions "(1 AND 2 AND (3 OR 4))".
• Generic UnitOfWork
  Ever want to execute a bunch of work items in a dynamic manner, and be able to control their order of execution, and run some of it in a separate execution context? Wow... that's a lot to ask.. But, the UnitOfWork will do that for you in just 88 line of code!!
  Be ware, this fflib_UnitOfWork is something different than the fflib_SObjectUnitOfwork
• Persitant Logger
  Ever want to log error messages in a Custom Object? The fflib_Logger will do it for you, even if you have a database-rollback.
• Extended domain features
  Tons of extra methods in the domains to access the (S)Objects.
• TriggerHandler Redesigned
  A complete redesign of the trigger handler, using the new Force-DI like application class in combination with the generic UnitOfWork. It brings new advanced features like; enqueueing certain parts of trigger logic, separating trigger logic clearly in a readable structure and the ability to use dependency injection.

Wiki

A full overview of the features in this extension pack and how to use them can be found in the Wiki pages of this repository. It is written in an easy readable format with lots of explanations on the design pattern Separation of Concerns, and how that apply those patterns.

A hands-on training session is also available to learn how to translate a user-story into Apex code.

Method Reference

When you rather prefer the bare overview of classes, methods and their examples, then you can find a full overview of the methods, their signatures and description in the ApexDocs.

Example Application

You can look at these examples if you like to see this extension package in action.

Migrating from apex-commons

• How to adapt when coming from fflib-apex-common

Contributing

Anyone is welcome to fork this repository and propose changes or complete new features via raising a pull-requests.

Please have read the contributing guide that will through the process to making your first contribution!

You can also have a look at the open items in the project(s), feel free to pick an item from the kanban board!

---

Change Log

Some of the changes that have major impact are listed here;

Several updates during 2022

• fflib_MockSObjectUtil

• • SetFieldvalue method overload added to fflib_MockSObjectUtil. With this you can set mul
• • tiple readonly fields.

• fflib_Ids

  • Join method added to simply join all Id values into a string, using a provided separator

• fflib_ArrayUtils

  • replaceValue, Takes two maps and replaces the value of the source with the value of the replacement, where the source value matches the replacement key.

• Minor bug fixes

  • fflib_ClassicDomainFactory: Avoid unexpected exceptions when the recordIds contains incorrect data

October 2021

• Logger functionality
  A replacement of System.Debug that is using Platform events to store log messages in a Custom Object for you to monitor
• API Upgrade to Winter'22
  All Apex classes are upgraded to API 53.0
• UnitOfWork
  Generic UnitOfWork, capable of executing work items in batch at a single instance. Each item will be executed based on its priority and can be queued in a separate execution context when necessary.
• TriggerHandler
  A redesigned trigger handler using custom metadata and the generic UnitOfWork, to dynamicaly call trigger actions.

August 2021

Added criteria based on formula; (1 OR 2) AND 3)

new fflib_Criteria()
        .formulaCriteria('(1 OR 2) AND 3')
        .equalTo(Account.AccountNumber, '0001')
        .equalTo(Account.AccountNumber, '0002')
        .equalTo(Account.ShippingCountry, 'USA')
	 
Evaluates:
     (AccountNumber = '0001' OR AccountNumber = '0001') AND ShippingCountry = 'USA'

---

Donations

We are pleased to announce that the fflib-apex-extensions Project is accepting donations in the privacy-oriented cryptocurrency Monero (XMR) at the following address:

8BMsQrdLiBvKaP87GFMPE9Wa1US79ygcp3b9kwoDq1iBW9JEYbcgpDS3hMp2p7ePWiCEKg2fdTucUbpNTtGbnvCCQZTMSu1

Thank you for your donations!