org.tentackle.pdo

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

java.lang.Object

org.tentackle.persist.AbstractDbOperation<P>

org.tentackle.pdo.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>, SessionDependable, SessionProvider, Interceptable

public abstract class AbstractPersistentOperation<T extends Operation<T>,P extends AbstractPersistentOperation<T,P>>
extends AbstractDbOperation<P>
implements PersistenceDelegate<T>, PersistentOperation<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, 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() Clones the operation object.
PersistentOperation<T>	clonePersistentOperation()
DomainContext	createValidContext()
void	determineContextId()
DomainContext	getBaseContext()
PersistentOperationClassVariables<T,P>	getClassVariables() Gets the some attributes and variables common to all objects of the same class.
long	getContextId()
PersistentOperation<T>	getDelegate()
DomainContext	getDomainContext() Gets the database context.
DomainDelegate<T>	getDomainDelegate()
T	getOperation()
boolean	isDomainContextImmutable() Returns whether the domain context is immutable.
PersistentOperation<T>	newInstance()
T	opn()
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(Session session) Sets the logical db connection for this object.

Methods inherited from class org.tentackle.persist.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.DomainContextProvider

on, opn

Methods inherited from interface org.tentackle.pdo.SessionDependable

isSessionImmutable, setSessionImmutable

Methods inherited from interface org.tentackle.pdo.SessionProvider

getSession

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

clone

public P clone()

Description copied from class: AbstractDbOperation

Clones the operation object.

Overrides:

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

Returns:

a clone of this object

clonePersistentOperation

public PersistentOperation<T> clonePersistentOperation()

Specified by:

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

getClassVariables

public PersistentOperationClassVariables<T,P> getClassVariables()

Gets the some attributes and variables common to all objects of the same class. Class variables for classes derived from AbstractDbOperation are kept in an instance of DbOperationClassVariables.

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

Overrides:

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

Returns:

the class variables

setSession

public void setSession(Session session)

Sets the logical db connection for this object.

Overridden to set the Db in DomainContext as well.

Specified by:

setSession in interface SessionDependable

Overrides:

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

Parameters:

session - the session

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

opn

public T opn()

Specified by:

opn in interface PersistentOperation<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.