org.castor.persist.resolver

Class ManyToManyRelationResolver

java.lang.Object

org.castor.persist.resolver.BaseRelationResolver

org.castor.persist.resolver.ManyRelationResolver

org.castor.persist.resolver.ManyToManyRelationResolver

All Implemented Interfaces:

ResolverStrategy

public final class ManyToManyRelationResolver
extends ManyRelationResolver

Implementation of ResolverStrategy for M:N relations.

Since:

0.9.9

Author:

Werner Guttmann

Field Summary

Fields inherited from class org.castor.persist.resolver.BaseRelationResolver

_classMolder, _fieldMolder

Constructor Summary

Constructors

Constructor and Description
ManyToManyRelationResolver(ClassMolder classMolder, FieldMolder fieldMolder, int fieldIndex) Creates an instance of ManyToManyRelationResolver.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	markCreate(TransactionContext tx, OID oid, Object object) Walk the object model and mark object that should be created.
void	markDelete(TransactionContext tx, Object object, Object field) Prepare to delete an object with the specified identity.
Object	postCreate(TransactionContext tx, OID oid, Object object, Object field, Identity createdId) Called after successful creation of an object of the base class.
UpdateFlags	preStore(TransactionContext tx, OID oid, Object object, int timeout, Object field) Check the object for modification.
void	update(TransactionContext tx, OID oid, Object object, AccessMode suggestedAccessMode, Object field) Update the object which loaded or created in the other transaction to the persistent storage.
boolean	updateWhenNoTimestampSet(TransactionContext tx, OID oid, Object object, AccessMode suggestedAccessMode) Update the object which loaded or created in the other transaction to the persistent storage.

Methods inherited from class org.castor.persist.resolver.ManyRelationResolver

create, expireCache, load, removeRelation, revertObject, store, updateCache

Methods inherited from class org.castor.persist.resolver.BaseRelationResolver

isCascadingCreate, isCascadingDelete, isCascadingUpdate

Methods inherited from class java.lang.Object

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

Constructor Detail

ManyToManyRelationResolver

public ManyToManyRelationResolver(ClassMolder classMolder,
                          FieldMolder fieldMolder,
                          int fieldIndex)

Creates an instance of ManyToManyRelationResolver.

Parameters:

classMolder - Associated ClassMolder.

fieldMolder - Associated FieldMolder.

fieldIndex - Field index within all fields of parent class molder.

Method Detail

markCreate

public boolean markCreate(TransactionContext tx,
                 OID oid,
                 Object object)
                   throws PersistenceException

Description copied from interface: ResolverStrategy

Walk the object model and mark object that should be created.

Specified by:

markCreate in interface ResolverStrategy

Specified by:

markCreate in class ManyRelationResolver

Parameters:

tx - transaction in action

oid - the object identity of the object to be created.

object - the object to be created

Returns:

true if there's objects that should be created

Throws:

PersistenceException

See Also:

#markCreate(org.castor.persist.TransactionContext, org.exolab.castor.persist.OID, java.lang.Object)

markDelete

public void markDelete(TransactionContext tx,
              Object object,
              Object field)
                throws PersistenceException

Description copied from interface: ResolverStrategy

Prepare to delete an object with the specified identity. If any sub-object should be deleted along with the target object, it should be deleted by this method.

Specified by:

markDelete in interface ResolverStrategy

Specified by:

markDelete in class ManyRelationResolver

Parameters:

tx - - transaction in action

object - - the target object

field - The field value as returned by the SQLEngine

Throws:

PersistenceException - If it is not possible to successfully complete this method.

See Also:

#markDelete(org.castor.persist.TransactionContext, java.lang.Object, java.lang.Object)

preStore

public UpdateFlags preStore(TransactionContext tx,
                   OID oid,
                   Object object,
                   int timeout,
                   Object field)
                     throws PersistenceException

Description copied from interface: ResolverStrategy

Check the object for modification. If dpendent object is dereferenced, it method will remove the object thru the transaction. If an related object is dereferenced, it method will make sure the formally object will be dereferenced from the other side as well. This method is called in prepare (for commit) state of the transaction. This method indicates if the object needed to be persist or cache should be update using TransactionContext.markDelete.

Specified by:

preStore in interface ResolverStrategy

Specified by:

preStore in class ManyRelationResolver

Parameters:

tx - transaction in action

oid - the object identity of the object

object - the data object to be checked

timeout - timeout of updating the lock if needed

field - The field value as returned by the SQLEngine

Returns:

true if the object is modified

Throws:

PersistenceException - If it is not possible to successfully complete this method.

See Also:

#preStore(org.castor.persist.TransactionContext, org.exolab.castor.persist.OID, java.lang.Object, int, java.lang.Object)

update

public void update(TransactionContext tx,
          OID oid,
          Object object,
          AccessMode suggestedAccessMode,
          Object field)
            throws PersistenceException

Description copied from interface: ResolverStrategy

Update the object which loaded or created in the other transaction to the persistent storage.

Specified by:

update in interface ResolverStrategy

Specified by:

update in class ManyRelationResolver

Parameters:

tx - Transaction in action

oid - the object identity of the stored object

object - the object to be stored

suggestedAccessMode - Suggested access mode

field - The field value as returned by the SQLEngine

Throws:

PersistenceException - If it is not possible to successfully complete this method.

See Also:

#update(org.castor.persist.TransactionContext, org.exolab.castor.persist.OID, java.lang.Object, org.exolab.castor.mapping.AccessMode, java.lang.Object)

postCreate

public Object postCreate(TransactionContext tx,
                OID oid,
                Object object,
                Object field,
                Identity createdId)
                  throws PersistenceException

Description copied from interface: ResolverStrategy

Called after successful creation of an object of the base class.

Specified by:

postCreate in interface ResolverStrategy

Specified by:

postCreate in class ManyRelationResolver

Parameters:

tx - transaction in action

oid - the object identity of the object to be created.

object - the object to be created

field - The field value as returned by the SQLEngine

createdId - ???

Returns:

the identity of the object

Throws:

PersistenceException

See Also:

ManyRelationResolver.postCreate( org.castor.persist.TransactionContext, org.exolab.castor.persist.OID, java.lang.Object, java.lang.Object, org.exolab.castor.persist.spi.Identity)

updateWhenNoTimestampSet

public boolean updateWhenNoTimestampSet(TransactionContext tx,
                               OID oid,
                               Object object,
                               AccessMode suggestedAccessMode)
                                 throws PersistenceException

Description copied from interface: ResolverStrategy

Update the object which loaded or created in the other transaction to the persistent storage.

Parameters:

tx - Transaction in action

oid - the object identity of the stored object

object - the object to be stored

suggestedAccessMode - Suggested access mode

Returns:

TODO

Throws:

PersistenceException - If it is not possible to successfully complete this method.