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, Cloneable, DomainContextDependable, DomainContextProvider, OperationHolder<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>

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

Author:

harald

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and 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 connection.

Method Summary

Modifier and Type	Method and Description
protected void	assertDomainContextMutable() Asserts that the domain context is mutable.
P	clone()
PersistentOperation<T>	clonePersistentOperation()
DomainContext	createValidContext()
void	determineContextId()
DomainContext	getBaseContext()
PersistentOperationClassVariables<T,P>	getClassVariables()
long	getContextId()
PersistentOperation<T>	getDelegate()
DomainContext	getDomainContext() Gets the database context.
DomainDelegate<T>	getDomainDelegate()
Class<T>	getEffectiveClass()
List<Class<? super T>>	getEffectiveSuperClasses()
T	getOperation()
boolean	isDomainContextImmutable() Returns whether the domain context is immutable.
T	me()
PersistentOperation<T>	newInstance()
T	operation()
void	setDomainContext(DomainContext context) Sets the database context.
void	setDomainContextImmutable(boolean contextImmutable) Sets the immutable flag of the domain context.
void	setOperation(T po)
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

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

Methods inherited from interface org.tentackle.pdo.OperationHolder

op

Methods inherited from interface org.tentackle.pdo.DomainContextProvider

on, op

Methods inherited from interface org.tentackle.session.SessionDependable

isSessionImmutable, setSessionImmutable

Methods inherited from interface org.tentackle.session.SessionProvider

getSession

Methods inherited from interface org.tentackle.reflect.EffectiveClassProvider

getEffectiveClass

Constructor Detail

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 connection.

Note: the application must set the context.

Parameters:

operation - the operation object this is a delegate for

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

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 Detail

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>>

clone

public P clone()

Overrides:

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

clonePersistentOperation

public PersistentOperation<T> clonePersistentOperation()

Specified by:

clonePersistentOperation in interface PersistentOperation<T extends Operation<T>>

getClassVariables

public PersistentOperationClassVariables<T,P> getClassVariables()

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

Overrides:

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

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

getDelegate

public PersistentOperation<T> getDelegate()

Specified by:

getDelegate in interface PersistentOperation<T extends Operation<T>>

newInstance

public PersistentOperation<T> newInstance()

Specified by:

newInstance in interface PersistentOperation<T extends Operation<T>>

operation

public T operation()

Specified by:

operation in interface PersistentOperation<T extends Operation<T>>

me

public T me()

Specified by:

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

getOperation

public T getOperation()

Specified by:

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

setOperation

public void setOperation(T po)

Specified by:

setOperation in interface OperationHolder<T extends Operation<T>>

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

assertDomainContextMutable

protected void assertDomainContextMutable()

Asserts that the domain context is mutable.