com.goldencode.p2j.persist.orm

Class DataObjectFactory

java.lang.Object

com.goldencode.p2j.persist.orm.DataObjectFactory

public class DataObjectFactory
extends java.lang.Object

A factory utility which creates two kind of proxies:

• DMOs: based on the interface received, and instance of it is created and returned. There are multiple overloaded methods which provide different level of customizations of the object to be returned;
• DTOs which extends DMOs and use one instance to delegate the unimplemented methods to them. In this case, a proxy is created and returned. The methods declared by the DTO abstract class will be invoked directly while the methods inherited from the DMO interface are delegated to the DMO instance provided.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	DataObjectFactory.DtoInvocationHandler The handler which delegates the calls unimplemented method in a DTO abstract class to a DMO instance it receives as parameter.

Field Summary

Fields

Modifier and Type	Field and Description
private static CentralLogger	LOG Logger
private Session	session

Constructor Summary

Constructors

Constructor and Description
DataObjectFactory()

Method Summary

Modifier and Type	Method and Description
<T extends DataModelObject> T	createDMO(java.lang.Class<T> clazz) Creates a new instance of a DMO.
<T extends DataModelObject> T	createDMO(java.lang.Class<T> clazz, boolean init, boolean defs, java.lang.Long pk) Creates a new instance of a DMO.
<T extends DataModelObject> T	createDMO(java.lang.Class<T> clazz, java.lang.Long pk) Creates a new instance of a DMO.
static <T> T	createDTO(java.lang.Class<T> clazz, java.lang.Object dmo) Creates a new instance of a DTO which implements a DMO interface in order to reuse the code of its implementation.
static <T> T	createDTO(java.lang.Class<T> clazz, java.lang.Object dmo, java.lang.Class<?>[] markerInterfaces) Creates a new instance of a DTO which implements a DMO interface in order to reuse the code of its implementation.
static DataObjectFactory	getInstance(Session session)

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final CentralLogger LOG

Logger

session

private Session session

Constructor Detail

DataObjectFactory

public DataObjectFactory()

Method Detail

getInstance

public static DataObjectFactory getInstance(Session session)

createDMO

public <T extends DataModelObject> T createDMO(java.lang.Class<T> clazz)

Creates a new instance of a DMO. The returned object is NOT initialized and will not have a private key set. That means the object can be used only as a POJO container for standard Java operations. Also, the caller is responsible for filling ALL fields before using the object.

Type Parameters:

T - The generic type of the object to be created. Inferred from clazz parameter.

Parameters:

clazz - The interface of the DMO object to be created.

Returns:

A new object of the class implementing the specified DMO interface.

createDMO

public <T extends DataModelObject> T createDMO(java.lang.Class<T> clazz,
                                               java.lang.Long pk)

Creates a new instance of a DMO. The returned object is NOT initialized. That means the object can be used only as a POJO container for standard Java operations. Also, the caller is responsible for filling ALL fields before using the object.

Type Parameters:

T - The generic type of the object to be created. Inferred from clazz parameter.

Parameters:

clazz - The interface of the DMO object to be created.

pk - If not null, the value is used as private key for the newly created record.

Returns:

A new object of the class implementing the specified DMO interface.

createDMO

public <T extends DataModelObject> T createDMO(java.lang.Class<T> clazz,
                                               boolean init,
                                               boolean defs,
                                               java.lang.Long pk)

Creates a new instance of a DMO.

Type Parameters:

T - The generic type of the object to be created. Inferred from clazz parameter.

Parameters:

clazz - The interface of the DMO object to be created.

init - If true, the returned object is initialized (registered with the session, a change set and internal state are prepared) for complex usage of the object.
Otherwise, the object is to be used as a POJO container instead.

defs - Valid only if init is true. Sets the default values for fields as the record was defined with INITIAL value in table definition.
Otherwise the caller is responsible for filling ALL fields before using the object.

pk - If not null, the value is used as private key for the newly created record.

Returns:

A new object of the class implementing the specified DMO interface.

createDTO

public static <T> T createDTO(java.lang.Class<T> clazz,
                              java.lang.Object dmo,
                              java.lang.Class<?>[] markerInterfaces)

Creates a new instance of a DTO which implements a DMO interface in order to reuse the code of its implementation. The returned objects wraps the DMO object and delegates the specific calls to it while directly accessing the method the DTO declares and implements directly.

Type Parameters:

T - The DTO class of the object to be returned.

Parameters:

clazz - The DTO type of the object to be returned.

dmo - An instance of the DMO interface to which the calls to 'super' class will be delegated.

markerInterfaces - The marker interfaces, can be null.

Returns:

A proxy which 'responds' to all calls from both the abstract class and the delegated object.

createDTO

public static <T> T createDTO(java.lang.Class<T> clazz,
                              java.lang.Object dmo)

Creates a new instance of a DTO which implements a DMO interface in order to reuse the code of its implementation. The returned objects wraps the DMO object and delegates the specific calls to it while directly accessing the method the DTO declares and implements directly.

Type Parameters:

T - The DTO class of the object to be returned.

Parameters:

clazz - The DTO type of the object to be returned.

dmo - An instance of the DMO interface to which the calls to 'super' class will be delegated.

Returns:

A proxy which 'responds' to all calls from both the abstract class and the delegated object.