Add Dynamic Application Factory

This enabled realtime dependency injection for the fflib application. By default the configuration comes from the Custom Metadata object fflib_AppBinding__mdt, but can be fully customised and extended. Initial stuff
2021-07-02 13:57:11 +01:00
parent 46276b564f
commit 039e82d73c
73 changed files with 3418 additions and 4 deletions
@@ -0,0 +1,123 @@
+/**
+ * File Name: fflib_DynamicDomainFactory
+ * Description:
+ *
+ * @author : architect ir. Wilhelmus G.J. Velzeboer
+ *
+ * Copyright (c), W.G.J. Velzeboer,
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without modification,
+ *   are permitted provided that the following conditions are met:
+ *
+ * - Redistributions of source code must retain the above author notice,
+ *      this list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright notice,
+ *      this list of conditions and the following disclaimer in the documentation
+ *      and/or other materials provided with the distribution.
+ * - Neither the name of the author nor the names of its contributors
+ *      may be used to endorse or promote products derived from this software without
+ *      specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
+ * THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+ * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+public virtual class fflib_DynamicDomainFactory
+		extends fflib_DynamicAppFactory
+		implements fflib_IDomainFactory
+{
+	public static final fflib_AppBindingType DOMAIN = fflib_AppBindingType.Domain;
+
+	protected Map<Object, fflib_IDomain> mockDomainByObjectType = new Map<Object, fflib_IDomain>();
+	protected fflib_ISelectorFactory selectorFactory;
+
+
+	public fflib_DynamicDomainFactory(fflib_IAppBindingResolver resolver, fflib_ISelectorFactory selectorFactory)
+	{
+		this.resolver = resolver;
+		this.selectorFactory = selectorFactory;
+	}
+
+	public fflib_IDomain newInstance(Set<Id> recordIds)
+	{
+		return newInstance(this.selectorFactory.selectById(recordIds));
+	}
+
+	public fflib_IDomain newInstance(Set<Id> recordIds, SObjectType sObjectType)
+	{
+		return newInstance(this.selectorFactory.selectById(recordIds, sObjectType));
+	}
+
+	public fflib_IDomain newInstance(List<SObject> records)
+	{
+		SObjectType sObjectType = records.getSObjectType();
+
+		if (sObjectType == null)
+			throw new DeveloperException('Could not determine the SObjectType of the provided records');
+
+		return newInstance(
+				(List<Object>) records,
+				(Object) sObjectType
+		);
+	}
+
+	public fflib_IDomain newInstance(List<Object> objects, Object objectType)
+	{
+		if (hasMock(objectType)) return (fflib_IDomain) getMock(objectType);
+
+		List<fflib_IAppBinding> bindings = resolver.byObject(objectType)
+				.byType(DOMAIN)
+				.resolve();
+
+		if (bindings.isEmpty())
+			throw new DeveloperException('Unable to find domain binding ' + objectType);
+
+		System.Type domainImplementationType = bindings.get(0).getImplementationType();
+
+		Object instance = domainImplementationType.newInstance();
+
+		if (!(instance instanceof fflib_IDomainConstructor))
+			throw new DeveloperException(
+					String.format(
+						'Domain implementation {0} should be an instance of fflib_IDomainConstructor',
+						new List<String> { domainImplementationType.getName() }
+					)
+			);
+
+		return ((fflib_IDomainConstructor) domainImplementationType.newInstance())
+				.construct(objects);
+	}
+
+	public fflib_IDomain newInstance(List<SObject> records, SObjectType domainSObjectType)
+	{
+		return newInstance((List<Object>) records, (Object) domainSObjectType);
+	}
+
+	public void setMock(fflib_ISObjectDomain mockDomain)
+	{
+		super.setMock(mockDomain.getType(), mockDomain);
+	}
+
+	public void setMock(Schema.SObjectType sObjectType, fflib_ISObjectDomain mockDomain)
+	{
+		super.setMock(sObjectType, mockDomain);
+	}
+
+	public void setMock(fflib_IDomain mockDomain)
+	{
+		super.setMock(mockDomain.getType(), mockDomain);
+	}
+
+	public void setMock(Object domainType, fflib_IDomain mockDomain)
+	{
+		super.setMock(domainType, mockDomain);
+	}
+
+	public class DeveloperException extends Exception {}
+}