Merge remote-tracking branch 'ffdev-origin/master'

Conflicts:
	fflib/src/classes/fflib_SObjectSelector.cls
	fflib/src/classes/fflib_SObjectUnitOfWork.cls

Author: ImJohnMDaniel

README.md

@@ -36,12 +36,14 @@ Dreamforce Session and Slides
 - View slides for the **Dreamforce 2013** session [here](https://docs.google.com/file/d/0B6brfGow3cD8RVVYc1dCX2s0S1E/edit) 
 - Video recording of the **Dreamforce 2013** session [here](http://www.youtube.com/watch?v=qlq46AEAlLI).
 - Video recording of the **Advanced Apex Enterprise Dreamforce 2014** session [here](http://dreamforce.vidyard.com/watch/7QtP2628KmtXfmiwI-7B1w%20).
+- View slides for the **Dreamforce 2015** session [here](http://www.slideshare.net/andyinthecloud/building-strong-foundations-apex-enterprise-patterns)
 
 Documentation
 -------------
 
-I'm proud to have been given the opportunity to run a more detailed look at these patterns on developer.force.com. 
-
+- [Apex Sharing and applying to Apex Enterprise Patterns](http://andyinthecloud.com/2016/01/10/apex-sharing-and-applying-to-apex-enterprise-patterns/)
+- [Tips for Migrating to Apex Enterprise Patterns](http://andyinthecloud.com/2015/09/30/tips-for-migrating-to-apex-enterprise-patterns/)
+- [Great Contributions to Apex Enterprise Patterns](http://andyinthecloud.com/2015/07/25/great-contributions-to-apex-enterprise-patterns/)
 - [Unit Testing, Apex Enterprise Patterns and ApexMocks – Part 1](http://andyinthecloud.com/2015/03/22/unit-testing-with-apex-enterprise-patterns-and-apexmocks-part-1/)
 - [Unit Testing, Apex Enterprise Patterns and ApexMocks – Part 2](http://andyinthecloud.com/2015/03/29/unit-testing-apex-enterprise-patterns-and-apexmocks-part-2/)
 - [Apex Enterprise Patterns - Separation of Concerns](http://wiki.developerforce.com/page/Apex_Enterprise_Patterns_-_Separation_of_Concerns)

fflib/src/classes/fflib_Application.cls

@@ -62,6 +62,22 @@ public class fflib_Application
 			return new fflib_SObjectUnitOfWork(m_objectTypes);
 		}
 
+		/**
+		 * Returns a new fflib_SObjectUnitOfWork configured with the 
+		 *   SObjectType list specified, returns a Mock implementation
+		 *   if set via the setMock method
+		 *
+		 * @remark If mock is set, the list of SObjectType in the mock could be different
+		 *         then the list of SObjectType specified in this method call
+		 **/
+		public fflib_ISObjectUnitOfWork newInstance(List<SObjectType> objectTypes)
+		{
+			// Mock?
+			if(m_mockUow!=null)
+				return m_mockUow;
+			return new fflib_SObjectUnitOfWork(objectTypes);
+		}		
+
 		@TestVisible
 		private void setMock(fflib_ISObjectUnitOfWork mockUow)
 		{
@@ -288,6 +304,37 @@ public class fflib_Application
 			return (fflib_ISObjectDomain) domainConstructor.construct(records);
 		}	
 
+		/**
+		 * Dynamically constructs an instace of the Domain class for the given records and SObjectType
+		 *   Will return a Mock implementation if one has been provided via setMock
+		 *
+		 * @param records A list records
+		 * @param domainSObjectType SObjectType for list of records
+		 * @exception Throws an exception if the SObjectType is not specified or if constructor for Domain class was not registered for the SObjectType
+		 *
+		 * @remark Will support List<SObject> but all records in the list will be assumed to be of
+		 *         the type specified in sObjectType
+		 **/
+		public fflib_ISObjectDomain newInstance(List<SObject> records, SObjectType domainSObjectType)
+		{
+			if(domainSObjectType==null)
+				throw new DeveloperException('Must specify sObjectType');
+
+			// Mock implementation?
+			if(m_sObjectByMockDomain.containsKey(domainSObjectType))
+				return m_sObjectByMockDomain.get(domainSObjectType);
+
+			// Determine SObjectType and Apex classes for Domain class
+			Type domainConstructorClass = m_sObjectByDomainConstructorType.get(domainSObjectType);
+			if(domainConstructorClass==null)
+				throw new DeveloperException('Domain constructor class not found for SObjectType ' + domainSObjectType);
+
+			// Construct Domain class passing in the queried records
+			fflib_SObjectDomain.IConstructable2 domainConstructor = 
+				(fflib_SObjectDomain.IConstructable2) domainConstructorClass.newInstance();
+			return (fflib_ISObjectDomain) domainConstructor.construct(records, domainSObjectType);
+		}
+
 		@TestVisible
 		private void setMock(fflib_ISObjectDomain mockDomain)
 		{

fflib/src/classes/fflib_Application.cls-meta.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
-    <apiVersion>31.0</apiVersion>
+    <apiVersion>37.0</apiVersion>
     <status>Active</status>
 </ApexClass>