org.exolab.castor.jdo.engine
Class JDOCallback

java.lang.Object
  org.exolab.castor.jdo.engine.JDOCallback

All Implemented Interfaces:

CallbackInterceptor

public class JDOCallback
extends Object
implements CallbackInterceptor

Version:

$Revision: 7094 $ $Date: 2005-04-17 04:29:33 -0600 (Sun, 17 Apr 2005) $

Author:

Assaf Arkin

Constructor Summary

JDOCallback()

Method Summary

void	created(Object object) Called to indicate that an object has been created.
void	creating(Object object, Database db) Called to indicate that an object is to be created in persistent storage.
Class	loaded(Object object, AccessMode accessMode) Called to indicate that the object has been loaded from persistent storage.
void	releasing(Object object, boolean committed) Called to indicate that an object has been made transient.
void	removed(Object object) Called to indicate that an object has been deleted.
void	removing(Object object) Called to indicate that an object is to be deleted.
void	storing(Object object, boolean modified) Called to indicate that an object is to be stored in persistent storage.
void	updated(Object object) Called to indicate that an object has been updated at the end of a "long" transaction.
void	using(Object object, Database db) Called to indicate that an object has been made persistent.

Methods inherited from class java.lang.Object

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

Constructor Detail

JDOCallback

public JDOCallback()

Method Detail

using

public void using(Object object,
                  Database db)

Description copied from interface: CallbackInterceptor

Called to indicate that an object has been made persistent.

Specified by:

using in interface CallbackInterceptor

Parameters:

object - The object

db - The database to which this object belongs

loaded

public Class loaded(Object object,
                    AccessMode accessMode)
             throws Exception

Description copied from interface: CallbackInterceptor

Called to indicate that the object has been loaded from persistent storage.

Specified by:

loaded in interface CallbackInterceptor

Parameters:

object - The object

Returns:

null or the extending Class. In the latter case Castor will reload the object of the given class with the same identity.

Throws:

Exception - An exception occured, the object cannot be loaded

storing

public void storing(Object object,
                    boolean modified)
             throws Exception

Description copied from interface: CallbackInterceptor

Called to indicate that an object is to be stored in persistent storage.

Specified by:

storing in interface CallbackInterceptor

Parameters:

object - The object

modified - Is the object modified?

Throws:

Exception - An exception occured, the object cannot be stored

creating

public void creating(Object object,
                     Database db)
              throws Exception

Description copied from interface: CallbackInterceptor

Called to indicate that an object is to be created in persistent storage.

Specified by:

creating in interface CallbackInterceptor

Parameters:

object - The object

db - The database in which this object will be created

Throws:

Exception

created

public void created(Object object)
             throws Exception

Description copied from interface: CallbackInterceptor

Called to indicate that an object has been created.

Specified by:

created in interface CallbackInterceptor

Parameters:

object - The object

Throws:

Exception

removing

public void removing(Object object)
              throws Exception

Description copied from interface: CallbackInterceptor

Called to indicate that an object is to be deleted.

This method is made at commit time on objects deleted during the transaction before setting their fields to null.

Specified by:

removing in interface CallbackInterceptor

Parameters:

object - The object

Throws:

Exception

removed

public void removed(Object object)
             throws Exception

Description copied from interface: CallbackInterceptor

Called to indicate that an object has been deleted.

This method is called during db.remove().

Specified by:

removed in interface CallbackInterceptor

Parameters:

object - The object

Throws:

Exception

releasing

public void releasing(Object object,
                      boolean committed)

Description copied from interface: CallbackInterceptor

Called to indicate that an object has been made transient.

This method is made at commit or rollback time on all objects that were presistent during the life time of the transaction.

Specified by:

releasing in interface CallbackInterceptor

Parameters:

object - The object

committed - True if the object has been commited, false if rollback or otherwise cancelled

updated

public void updated(Object object)
             throws Exception

Description copied from interface: CallbackInterceptor

Called to indicate that an object has been updated at the end of a "long" transaction.

Specified by:

updated in interface CallbackInterceptor

Parameters:

object - The object

Throws:

Exception