#419 - updates README to call attention to UserModeDML and adds an optional constructor to UserModeDML to permit explicit SYSTEM_MODE

Author: daveespo

README.md

@@ -14,7 +14,7 @@ FFLib Apex Common
 Updates
 =======
 
-- **December 2022**, **IMPORTANT CHANGE** - Support for native Apex User Mode was added to the library (see [discussion](https://github.com/apex-enterprise-patterns/fflib-apex-common/discussions/419)). For new projects, the old `enforceCRUD` and `enforceFLS` flags on `fflib_SObjectSelector` should be considered deprecated and the constructors that take `dataAccess` arguments should be used instead. There are measurable performance benefits to using `SYSTEM_MODE` and `USER_MODE` (Apex CPU usage reduction).
+- **December 2022**, **IMPORTANT CHANGE** - Support for native Apex User Mode was added to the library (see [discussion](https://github.com/apex-enterprise-patterns/fflib-apex-common/discussions/419)). For new projects, the old `enforceCRUD` and `enforceFLS` flags on `fflib_SObjectSelector` should be considered deprecated and the constructors that take `dataAccess` arguments should be used instead. Additionally, the introduction of `fflib_SObjectUnitOfWork.UserModeDML` provides an `IDML` implementation that supports `USER_MODE` or `SYSTEM_MODE`. `fflib_SObjectUnitOfWork.SimpleDML` (the default `IDML` implementation) should be considered deprecated. There are measurable performance benefits to using `SYSTEM_MODE` and `USER_MODE` (Apex CPU usage reduction). Additionally, the use of explicit `USER_MODE` and `SYSTEM_MODE` overrides the `with sharing` and `without 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](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_source_file_format.htm).  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](https://github.com/apex-enterprise-patterns/fflib-apex-common/tree/metadata-format-prior-to-dx-source-format-conversion) 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](https://github.com/apex-enterprise-patterns/fflib-apex-mocks) must be deployed to the org before deploying this library. The sample application [here](https://github.com/apex-enterprise-patterns/fflib-apex-common-samplecode) has also been updated to demonstrate the new features!
 - **July 2014**, **IMPORTANT CHANGE**, prior **23rd July 2014**, both the ``fflib_SObjectDomain.onValidate()`` and ``fflib_SObjectDomain.onValidate(Map<Id, SObject> existingRecords)`` methods where called during an on **after update** trigger event. From this point on the ``onValidate()`` method will only be called during on **after insert**. If you still require the orignal behaviour add the line ``Configuration.enableOldOnUpdateValidateBehaviour();`` into your constructor.

sfdx-source/apex-common/main/classes/fflib_SObjectUnitOfWork.cls

@@ -123,14 +123,26 @@ public virtual class fflib_SObjectUnitOfWork
     }
 
 	public virtual class UserModeDML extends SimpleDML{
+		@TestVisible
+		private AccessLevel m_accessLevel;
+
+		public UserModeDML(){
+			this(AccessLevel.USER_MODE);
+		}
+
+		/** Supply the AccessLevel explicitly (UserModeDML uses AccessMode.USER_MODE, by default) */
+		public UserModeDML(AccessLevel access){
+			m_accessLevel = access;
+		}
+
 		public virtual override void dmlInsert(List<SObject> objList){
-			Database.insert(objList,AccessLevel.USER_MODE);
+			Database.insert(objList,m_accessLevel);
 		}
 		public virtual override void dmlUpdate(List<SObject> objList){
-			Database.update(objList,AccessLevel.USER_MODE);
+			Database.update(objList,m_accessLevel);
 		}
 		public virtual override void dmlDelete(List<SObject> objList){
-			Database.delete(objList,AccessLevel.USER_MODE);
+			Database.delete(objList,m_accessLevel);
 		}
 	}
 

sfdx-source/apex-common/test/classes/fflib_SObjectUnitOfWorkTest.cls

@@ -629,6 +629,18 @@ private with sharing class fflib_SObjectUnitOfWorkTest
         System.assertEquals(1, mockDML.recordsForInsert.size());
     }
 
+    @IsTest
+    private static void constructUserModeDML_When_DefaultConstructor_Expect_UserMode(){
+        fflib_SObjectUnitOfWork.UserModeDML dml = new fflib_SObjectUnitOfWork.UserModeDML();
+        System.assertEquals(AccessLevel.USER_MODE,dml.m_accessLevel);
+    }
+
+    @IsTest
+    private static void constructUserModeDML_When_AccessLevelSupplied_Expect_SameAccessLevel(){
+        fflib_SObjectUnitOfWork.UserModeDML dml = new fflib_SObjectUnitOfWork.UserModeDML(AccessLevel.SYSTEM_MODE);
+        System.assertEquals(AccessLevel.SYSTEM_MODE,dml.m_accessLevel);
+    }
+
     /**
      * Assert that actual events exactly match expected events (size, order and name)
      * and types match expected types