org.refcodes.factory

Interface TypedLookupIdContextFactory<T,ID,CTX>

Type Parameters:

T - The expected type produced by the factory.

ID - The type of the ID being used.

CTX - The context which may influence the object being created by this factory.

public interface TypedLookupIdContextFactory<T,ID,CTX>

The TypedLookupIdContextFactory defines the functionality which must be provided in order to represent a factory for object creation of objects identified by an ID String and of a predefined type specified with a generic argument (in contrast to the LookupIdFactory, which creates instances of an expected type). Many alternative implementations of a TypedLookupIdContextFactory may may exist which construct the instances their way.

Having factories that generic as we define it here, we are able to decouple our business logic from any specific framework: Your business logic must not know anything about how the instance are generated. It mainly just needs to know how to use the TypedLookupIdContextFactory. It is up to the application "end point", i.e. a command line tool with a main-method or a web-application to finally decide which factory to use.

Depending on the implementation used or configuration provided, the TypedLookupIdContextFactory may return singletons or dedicated separate instances when queried for instances.

Method Summary

Modifier and Type	Method and Description
T	createInstance(ID aIdentifier, CTX aContext) This method creates / retrieves an instance of the configured type identified with the given identifier (name).
default T	createInstance(ID aIdentifier, CTX aContext, Properties aProperties) This method creates / retrieves an instance of the configured type identified with the given identifier (name).

Method Detail

createInstance

T createInstance(ID aIdentifier,
                 CTX aContext)

This method creates / retrieves an instance of the configured type identified with the given identifier (name).

Parameters:

aIdentifier - The name identifying the instance to be created / retrieved.

aContext - The context which may influence the object being created by this factory.

Returns:

The instance being fabricated by this factory for the given instance name (identifier).

createInstance

default T createInstance(ID aIdentifier,
                         CTX aContext,
                         Properties aProperties)

This method creates / retrieves an instance of the configured type identified with the given identifier (name).

Parameters:

aIdentifier - The name identifying the instance to be created / retrieved.

aProperties - The dynamic properties which are used to configure the desired bean.

aContext - The context which may influence the object being created by this factory.

Returns:

The instance being fabricated by this factory for the given instance name (identifier).

Throws:

ClassCastException - in case the fabricated type is not type compatible with the required type T.