co.codewizards.cloudstore.core.objectfactory

Class ObjectFactory

java.lang.Object

co.codewizards.cloudstore.core.objectfactory.ObjectFactory

public class ObjectFactory
extends Object

Factory for objects.

Instead of invoking new MySomething(), devs can import ObjectFactoryUtil.* statically and then invoke createObject(MySomething.class). Thus allowing downstream projects to extend the system by providing a replacement-class. For example, if the replacement-class MyOther was registered for MySomething, the method createObject(MySomething.class) would return an instance of MyOther instead of MySomething.

However, it is urgently recommended not to use this approach, whenever it is possible to use a better solution, preferably a well-defined service (=> ServiceLoader). There are situations, e.g. data-model-classes (a.k.a. entities), where services are not possible and the ObjectFactory is the perfect solution.

In order to register a sub-class as replacement for a certain base-class, implementors have to provide a ClassExtension and register it using the ServiceLoader-mechanism.

Important: You should usually not need to access this class directly! Use ObjectFactoryUtil instead (statically import its methods).

Author:

Marco หงุ่ยตระกูล-Schulze - marco at codewizards dot co

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ObjectFactory()

Method Summary

Modifier and Type	Method and Description
<T> T	createObject(Class<T> clazz)
<T> T	createObject(Class<T> clazz, Class<?>[] parameterTypes, Object... parameters)
<T> T	createObject(Class<T> clazz, Object... parameters)
<T> ClassExtension<T>	getClassExtension(Class<T> clazz)
<T> Class<? extends T>	getExtendingClass(Class<T> clazz)
static ObjectFactory	getInstance() Gets the singleton instance of this ObjectFactory.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ObjectFactory

protected ObjectFactory()

Method Detail

getInstance

public static ObjectFactory getInstance()

Gets the singleton instance of this ObjectFactory.

Important: You should normally not invoke this method directly, but use ObjectFactoryUtil instead.

Returns:

the ObjectFactory instance; never null.

getExtendingClass

public <T> Class<? extends T> getExtendingClass(Class<T> clazz)

getClassExtension

public <T> ClassExtension<T> getClassExtension(Class<T> clazz)

createObject

public <T> T createObject(Class<T> clazz)

createObject

public <T> T createObject(Class<T> clazz,
                          Object... parameters)

createObject

public <T> T createObject(Class<T> clazz,
                          Class<?>[] parameterTypes,
                          Object... parameters)