|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.castor.persist.resolver.ManyRelationResolver
public abstract class ManyRelationResolver
Implementation of ResolverStrategy
for many relations.
This class carries behaviour common to 1:M and M:N relations.
Field Summary | |
---|---|
protected ClassMolder |
_classMolder
Associated ClassMolder . |
protected FieldMolder |
_fieldMolder
Associated FieldMolder . |
Constructor Summary | |
---|---|
ManyRelationResolver(ClassMolder classMolder,
FieldMolder fieldMolder,
int fieldIndex,
boolean debug)
Creates an instance of ManyRelationResolver. |
Method Summary | |
---|---|
java.lang.Object |
create(TransactionContext tx,
java.lang.Object object)
Create an object of the base class with specified identity into the persistence storage. |
void |
expireCache(TransactionContext tx,
java.lang.Object field)
Inspect the fields stored in the object passed as an argument for contained objects. |
void |
load(TransactionContext tx,
OID oid,
ProposedEntity proposedObject,
AccessMode suggestedAccessMode)
Load an object with specified identity from the persistent storage. |
abstract boolean |
markCreate(TransactionContext tx,
OID oid,
java.lang.Object object)
Walk the object model and mark object that should be created. |
abstract void |
markDelete(TransactionContext tx,
java.lang.Object object,
java.lang.Object field)
Prepare to delete an object with the specified identity. |
abstract java.lang.Object |
postCreate(TransactionContext tx,
OID oid,
java.lang.Object object,
java.lang.Object field,
Identity createdId)
Called after successful creation of an object of the base class. |
abstract UpdateFlags |
preStore(TransactionContext tx,
OID oid,
java.lang.Object object,
int timeout,
java.lang.Object field)
Check the object for modification. |
UpdateAndRemovedFlags |
removeRelation(TransactionContext tx,
java.lang.Object object,
ClassMolder relatedMolder,
java.lang.Object relatedObject)
Remove the reference of a related object from an object of the base class. |
void |
revertObject(TransactionContext tx,
OID oid,
java.lang.Object object,
java.lang.Object field)
Revert the object back to the state of begining of the transaction If the object is loaded, it will be revert as it was loaded. |
java.lang.Object |
store(TransactionContext tx,
java.lang.Object object,
java.lang.Object field)
Store a data object into the persistent storage of the base class of this ClassMolder. |
abstract void |
update(TransactionContext tx,
OID oid,
java.lang.Object object,
AccessMode suggestedAccessMode,
java.lang.Object field)
Update the object which loaded or created in the other transaction to the persistent storage. |
java.lang.Object |
updateCache(TransactionContext tx,
OID oid,
java.lang.Object object)
Update the dirty checking cache. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface org.castor.persist.resolver.ResolverStrategy |
---|
updateWhenNoTimestampSet |
Field Detail |
---|
protected ClassMolder _classMolder
ClassMolder
.
protected FieldMolder _fieldMolder
FieldMolder
.
Constructor Detail |
---|
public ManyRelationResolver(ClassMolder classMolder, FieldMolder fieldMolder, int fieldIndex, boolean debug)
classMolder
- Associated ClassMolder
fieldMolder
- Associated FieldMolder
fieldIndex
- Field index within all fields of parent class molder.debug
- ???Method Detail |
---|
public final java.lang.Object create(TransactionContext tx, java.lang.Object object)
ResolverStrategy
create
in interface ResolverStrategy
tx
- transaction in actionobject
- the object to be created
#create(org.castor.persist.TransactionContext,
java.lang.Object)
public abstract boolean markCreate(TransactionContext tx, OID oid, java.lang.Object object) throws PersistenceException
ResolverStrategy
markCreate
in interface ResolverStrategy
tx
- transaction in actionoid
- the object identity of the object to be created.object
- the object to be created
PersistenceException
ResolverStrategy.markCreate(
org.castor.persist.TransactionContext, org.exolab.castor.persist.OID,
java.lang.Object)
public abstract UpdateFlags preStore(TransactionContext tx, OID oid, java.lang.Object object, int timeout, java.lang.Object field) throws PersistenceException
ResolverStrategy
preStore
in interface ResolverStrategy
tx
- transaction in actionoid
- the object identity of the objectobject
- the data object to be checkedtimeout
- timeout of updating the lock if neededfield
- The field value as returned by the SQLEngine
PersistenceException
- If it is not possible to successfully complete this method.ResolverStrategy.preStore(
org.castor.persist.TransactionContext, org.exolab.castor.persist.OID,
java.lang.Object, int, java.lang.Object)
public final java.lang.Object store(TransactionContext tx, java.lang.Object object, java.lang.Object field)
ResolverStrategy
store
in interface ResolverStrategy
tx
- Transaction in actionobject
- the object to be storedfield
- The field value as returned by the SQLEngineResolverStrategy.store(
org.castor.persist.TransactionContext, java.lang.Object, java.lang.Object)
public abstract void update(TransactionContext tx, OID oid, java.lang.Object object, AccessMode suggestedAccessMode, java.lang.Object field) throws PersistenceException
ResolverStrategy
update
in interface ResolverStrategy
tx
- Transaction in actionoid
- the object identity of the stored objectobject
- the object to be storedsuggestedAccessMode
- Suggested access modefield
- The field value as returned by the SQLEngine
PersistenceException
- If it is not possible to successfully complete this method.ResolverStrategy.update(
org.castor.persist.TransactionContext, org.exolab.castor.persist.OID,
java.lang.Object, org.exolab.castor.mapping.AccessMode, java.lang.Object)
public final java.lang.Object updateCache(TransactionContext tx, OID oid, java.lang.Object object)
ResolverStrategy
updateCache
in interface ResolverStrategy
tx
- - transaction in actionoid
- - object's identity of the target objectobject
- - the target object
ResolverStrategy.updateCache(
org.castor.persist.TransactionContext, org.exolab.castor.persist.OID,
java.lang.Object)
public abstract void markDelete(TransactionContext tx, java.lang.Object object, java.lang.Object field) throws PersistenceException
ResolverStrategy
markDelete
in interface ResolverStrategy
tx
- - transaction in actionobject
- - the target objectfield
- The field value as returned by the SQLEngine
PersistenceException
- If it is not possible to successfully complete this method.ResolverStrategy.markDelete(
org.castor.persist.TransactionContext, java.lang.Object, java.lang.Object)
public final void revertObject(TransactionContext tx, OID oid, java.lang.Object object, java.lang.Object field) throws PersistenceException
ResolverStrategy
revertObject
in interface ResolverStrategy
tx
- - transaction in actionoid
- - the object identity of the target objectobject
- - the target objectfield
- The field value as returned by the SQLEngine
PersistenceException
- If it is not possible to successfully complete this method.ResolverStrategy.revertObject(
org.castor.persist.TransactionContext, org.exolab.castor.persist.OID,
java.lang.Object, java.lang.Object)
public final void expireCache(TransactionContext tx, java.lang.Object field) throws PersistenceException
ResolverStrategy
expireCache
in interface ResolverStrategy
tx
- The TransactionContext
field
- The field value as returned by the SQLEngine
PersistenceException
- If it is not possible to successfully complete this method.ResolverStrategy.expireCache(
org.castor.persist.TransactionContext, java.lang.Object)
public final void load(TransactionContext tx, OID oid, ProposedEntity proposedObject, AccessMode suggestedAccessMode) throws PersistenceException
ResolverStrategy
load
in interface ResolverStrategy
tx
- the TransactionContext in actionoid
- the object identity of the desired objectproposedObject
- Object holder storing information about assumed and actual object
instances.suggestedAccessMode
- the acessMode for the object
PersistenceException
- If it is not possible to successfully complete this method.ResolverStrategy.load(
org.castor.persist.TransactionContext, org.exolab.castor.persist.OID,
org.castor.persist.ProposedEntity, org.exolab.castor.mapping.AccessMode)
public abstract java.lang.Object postCreate(TransactionContext tx, OID oid, java.lang.Object object, java.lang.Object field, Identity createdId) throws PersistenceException
ResolverStrategy
postCreate
in interface ResolverStrategy
tx
- transaction in actionoid
- the object identity of the object to be created.object
- the object to be createdfield
- The field value as returned by the SQLEnginecreatedId
- ???
PersistenceException
ResolverStrategy.postCreate(
org.castor.persist.TransactionContext, org.exolab.castor.persist.OID,
java.lang.Object, java.lang.Object, org.exolab.castor.persist.spi.Identity)
public final UpdateAndRemovedFlags removeRelation(TransactionContext tx, java.lang.Object object, ClassMolder relatedMolder, java.lang.Object relatedObject)
ResolverStrategy
If the related object is PersistanceCapable, the field will be set null. If the related object is a Collection, then the related object will be removed from the Collection.
If any changed occured, transactionContext.markModified will be called, to indicate the object is modified.
It method will iterate thur all of the object's field and try to remove all the occurrence.
removeRelation
in interface ResolverStrategy
tx
- the TransactionContext of the transaction in actionobject
- the target object of the base type of this ClassMolderrelatedMolder
- the ClassMolder of the related object to be
removed from the objectrelatedObject
- the object to be removed
ResolverStrategy.removeRelation(
org.castor.persist.TransactionContext, java.lang.Object,
org.exolab.castor.persist.ClassMolder, java.lang.Object)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |