org.exolab.castor.jdo

Interface Persistent

public interface Persistent

A callback informs objects about changes to their state.
Version:
$Revision: 1.1.1.1 $ $Date: 2003/03/03 07:08:08 $
Author:
Assaf Arkin

Method Summary

void
jdoAfterCreate()
Called to indicate that an object has been created in persistent storage.
void
jdoAfterRemove()
Called to indicate that an object has been removed from persistent storage.
void
jdoBeforeCreate(Database db)
Called to indicate that an object is to be created in persistent storage.
void
jdoBeforeRemove()
Called to indicate that an object is to be removed from persistent storage.
Class
jdoLoad(short accessMode)
Called to indicate that the object has been loaded from persistent storage.
void
jdoPersistent(Database db)
Called to set the database to which this object belongs when this object becomes persistent.
void
jdoStore(boolean modified)
Called to indicate that an object is to be stored in persistent storage.
void
jdoTransient()
Called to indicate the object is now transient.
void
jdoUpdate()
Called to indicate that an object has been included to the current transaction by means of db.update() method (at the end of a "long " transaction).

Method Details

jdoAfterCreate

public void jdoAfterCreate()
            throws Exception
Called to indicate that an object has been created in persistent storage. This method is called during db.create().

jdoAfterRemove

public void jdoAfterRemove()
            throws Exception
Called to indicate that an object has been removed from persistent storage. This method is called during db.remove().

jdoBeforeCreate

public void jdoBeforeCreate(Database db)
            throws Exception
Called to indicate that an object is to be created in persistent storage. This method is called during db.create().
Parameters:
db - The database in which this object will be created

jdoBeforeRemove

public void jdoBeforeRemove()
            throws Exception
Called to indicate that an object is to be removed from persistent storage. This method is called during db.remove().

jdoLoad

public Class jdoLoad(short accessMode)
            throws Exception
Called to indicate that the object has been loaded from persistent storage. This method is called immediately after synchronizing an object with the database.
Returns:
the return value is discarded

jdoPersistent

public void jdoPersistent(Database db)
Called to set the database to which this object belongs when this object becomes persistent. The object may use the database to load/create/delete related objects.

Called when the object is first created as the result of a query, perior to calling jdoLoad(short), or after Database.create(Object) has been called on the object, prior to calling jdoStore(boolean).

Parameters:
db - The database to which this object belongs

jdoStore

public void jdoStore(boolean modified)
            throws Exception
Called to indicate that an object is to be stored in persistent storage. This method is called at commit time on all persistent objects in this transaction. Managed fields may not necessarily be persisted if the object has not been identified as modified.
Parameters:
modified - Is the object modified?

jdoTransient

public void jdoTransient()

jdoUpdate

public void jdoUpdate()
            throws Exception
Called to indicate that an object has been included to the current transaction by means of db.update() method (at the end of a "long " transaction).

Intalio Inc. (C) 1999-2003. All rights reserved http://www.intalio.com