Module org.tentackle.persistence

Package org.tentackle.persist

Class AbstractPersistentOperation<T extends Operation<T>,P extends AbstractPersistentOperation<T,P>>

java.lang.Object

org.tentackle.dbms.AbstractDbOperation<P>

org.tentackle.persist.AbstractPersistentOperation<T,P>

Type Parameters:

T - the PO class (interface)

P - the operation implementation class

All Implemented Interfaces:

Serializable, DomainContextDependable, DomainContextProvider, OperationMethodCacheProvider<T>, OperationProvider<T>, PersistenceDelegate<T>, PersistentOperation<T>, ProxyDelegate<T>, org.tentackle.reflect.EffectiveClassProvider<T>, org.tentackle.reflect.Interceptable, org.tentackle.session.SessionDependable, org.tentackle.session.SessionProvider

public abstract class AbstractPersistentOperation<T extends Operation<T>,P extends AbstractPersistentOperation<T,P>>
extends AbstractDbOperation<P>
implements PersistenceDelegate<T>, PersistentOperation<T>, org.tentackle.reflect.EffectiveClassProvider<T>, OperationMethodCacheProvider<T>

A AbstractPersistentOperation provides methods that are not part of PersistentOperations and is associated to a DomainContext. Complex transactions are usually AbstractPersistentOperations. AbstractPersistentOperations are remote capable.

Author:

harald

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
AbstractPersistentOperation()	Creates an operation object without a database context.
AbstractPersistentOperation(T operation)	Creates an operation object without a database context.
AbstractPersistentOperation(T operation, DomainContext context)	Creates an operation object.
AbstractPersistentOperation(T operation, org.tentackle.session.Session session)	Creates an operation object without a domain context for a given session. Notice: the application must set the domain context.

Method Summary

Modifier and Type	Method	Description
protected void	assertDomainContextMutable()	Asserts that the domain context is mutable.
<X extends PersistentDomainObject<X>> void	configureRemoteObject(DomainContext context, X pdo)	Configures a within an operation remotely retrieved PDO.
<X extends PersistentDomainObject<X>> void	configureRemoteObjects(DomainContext context, Collection<X> pdos)	Configures a within an operation remotely retrieved collection of PDOs.
DomainContext	createValidContext()
void	determineContextId()
DomainContext	getBaseContext()
PersistentOperationClassVariables<T,P>	getClassVariables()
long	getContextId()
DomainContext	getDomainContext()	Gets the database context.
DomainDelegate<T>	getDomainDelegate()
Class<T>	getEffectiveClass()
List<Class<? super T>>	getEffectiveSuperClasses()
T	getOperation()
OperationMethodCache<T>	getOperationMethodCache()
boolean	isDomainContextImmutable()	Returns whether the domain context is immutable.
T	me()
void	setDomainContext(DomainContext context)	Sets the database context.
void	setDomainContextImmutable(boolean contextImmutable)	Sets the immutable flag of the domain context.
void	setOperation(T operation)	Sets the operation.
void	setSession(org.tentackle.session.Session session)

Methods inherited from class org.tentackle.dbms.AbstractDbOperation

getRemoteDelegate, getSession, getSessionHolder, isSessionImmutable, setSessionHolder, setSessionImmutable

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.tentackle.pdo.DomainContextProvider

on, on, op, op

Methods inherited from interface org.tentackle.pdo.OperationProvider

op

Methods inherited from interface org.tentackle.session.SessionDependable

isSessionImmutable, setSessionImmutable

Methods inherited from interface org.tentackle.session.SessionProvider

getSession

Constructor Details

AbstractPersistentOperation

public AbstractPersistentOperation(T operation,
 DomainContext context)

Creates an operation object.

Parameters:

operation - the operation object this is a delegate for

context - the database context

AbstractPersistentOperation

public AbstractPersistentOperation(T operation,
 org.tentackle.session.Session session)

Creates an operation object without a domain context for a given session.
Notice: the application must set the domain context.

Parameters:

operation - the operation object this is a delegate for

session - the session (must be an instance of Db).

AbstractPersistentOperation

public AbstractPersistentOperation(T operation)

Creates an operation object without a database context.

Note: the application must set the context.

Parameters:

operation - the persistent operation object this is a delegate for

AbstractPersistentOperation

public AbstractPersistentOperation()

Creates an operation object without a database context.

Method Details

getDomainDelegate

public DomainDelegate<T> getDomainDelegate()

Specified by:

getDomainDelegate in interface PersistenceDelegate<T extends Operation<T>>

getEffectiveClass

public Class<T> getEffectiveClass()

Specified by:

getEffectiveClass in interface org.tentackle.reflect.EffectiveClassProvider<T extends Operation<T>>

getEffectiveSuperClasses

public List<Class<? super T>> getEffectiveSuperClasses()

Specified by:

getEffectiveSuperClasses in interface org.tentackle.reflect.EffectiveClassProvider<T extends Operation<T>>

getClassVariables

public PersistentOperationClassVariables<T,P> getClassVariables()

In fact, PersistentOperationClassVariables is an extension of DbOperationClassVariables. So this fulfills the requirements for AbstractDbObject

Overrides:

getClassVariables in class AbstractDbOperation<P extends AbstractPersistentOperation<T,P>>

getOperationMethodCache

public OperationMethodCache<T> getOperationMethodCache()

Specified by:

getOperationMethodCache in interface OperationMethodCacheProvider<T extends Operation<T>>

setSession

public void setSession(org.tentackle.session.Session session)

Overridden to set the Db in DomainContext as well.

Specified by:

setSession in interface org.tentackle.session.SessionDependable

Overrides:

setSession in class AbstractDbOperation<P extends AbstractPersistentOperation<T,P>>

setDomainContext

public void setDomainContext(DomainContext context)

Sets the database context.

Specified by:

setDomainContext in interface DomainContextDependable

Parameters:

context - the domain context

getDomainContext

public DomainContext getDomainContext()

Gets the database context.

Specified by:

getDomainContext in interface DomainContextProvider

Returns:

the domain context

me

public T me()

Specified by:

me in interface ProxyDelegate<T extends Operation<T>>

getOperation

public T getOperation()

Specified by:

getOperation in interface OperationProvider<T extends Operation<T>>

setOperation

public void setOperation(T operation)

Sets the operation.

Parameters:

operation - the operation

determineContextId

public void determineContextId()

The default implementation does nothing (object living in a context not depending on another object).

Specified by:

determineContextId in interface DomainContextDependable

getContextId

public long getContextId()

The default implementation returns -1.

Specified by:

getContextId in interface DomainContextDependable

getBaseContext

public DomainContext getBaseContext()

The default implementation returns the PDO's DomainContext.

Specified by:

getBaseContext in interface DomainContextDependable

createValidContext

public DomainContext createValidContext()

The default implementation just returns a new DomainContext.

Specified by:

createValidContext in interface DomainContextDependable

isDomainContextImmutable

public boolean isDomainContextImmutable()

Returns whether the domain context is immutable.

Specified by:

isDomainContextImmutable in interface DomainContextDependable

Returns:

true if context cannot be changed

setDomainContextImmutable

public void setDomainContextImmutable(boolean contextImmutable)

Sets the immutable flag of the domain context.

Specified by:

setDomainContextImmutable in interface DomainContextDependable

Parameters:

contextImmutable - true if context cannot be changed

configureRemoteObject

public <X extends PersistentDomainObject<X>> void configureRemoteObject(DomainContext context,
 X pdo)

Configures a within an operation remotely retrieved PDO.

Parameters:

context - the local domain context

pdo - the PDO

configureRemoteObjects

public <X extends PersistentDomainObject<X>> void configureRemoteObjects(DomainContext context,
 Collection<X> pdos)

Configures a within an operation remotely retrieved collection of PDOs.

Parameters:

context - the local domain context

pdos - the PDOs to configure

assertDomainContextMutable

protected void assertDomainContextMutable()

Asserts that the domain context is mutable.