org.refcodes.factory

Interface UnmarshalFactory<SRC>

Type Parameters:

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

public interface UnmarshalFactory<SRC>

The UnmarshalFactory defines the functionality which must be provided in order to represent a factory for object creation of an object being of a requested type (in contrast to the TypeFactory and the SelectorFactory from an instance of a provided type. Many alternative implementations of a UnmarshalFactory 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 UnmarshalFactory. 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 UnmarshalFactory may return singletons or dedicated separate instances when queried for instances.

Method Summary

Modifier and Type	Method and Description
<T> T	toUnmarshaled(SRC aContext, Class<T> aType) This method creates / retrieves an instances of the given type from the provided instance.
default <T> T	toUnmarshaled(SRC aContext, Class<T> aType, Properties aProperties) This method creates / retrieves all instances of the given type.

Method Detail

toUnmarshaled

<T> T toUnmarshaled(SRC aContext,
                    Class<T> aType)
             throws org.refcodes.exception.UnmarshalException

This method creates / retrieves an instances of the given type from the provided instance.

Type Parameters:

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

T - The type which is to be fabricated by the factory method.

Parameters:

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

aType - The type identifying the instances to be created / retrieved.

Returns:

An instance of the required type for the given type and context.

Throws:

org.refcodes.exception.UnmarshalException - Thrown when unmarshalling / deserializing an object fails.

toUnmarshaled

default <T> T toUnmarshaled(SRC aContext,
                            Class<T> aType,
                            Properties aProperties)
                     throws org.refcodes.exception.UnmarshalException

This method creates / retrieves all instances of the given type.

Type Parameters:

T - The type which is to be fabricated by the factory method.

Parameters:

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

aType - The type identifying the instances to be created / retrieved.

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

Returns:

An instance of the required type for the given type and context.

Throws:

org.refcodes.exception.UnmarshalException - Thrown when unmarshalling / deserializing an object fails.