com.sun.jdo.api.persistence.support

Interface InstanceCallbacks

public interface InstanceCallbacks

A PersistenceCapable class that provides callback methods for life cycle events implements this interface.

Classes which include derived fields (transient fields whose values depend on the values of persistent fields) require callbacks on specific JDO Instance life cycle events in order to correctly populate the values in these fields.

This interface defines the methods executed by the PersistenceManager for these life cycle events. If the class implements InstanceCallbacks, it must explicitly declare it in the class definition. The Reference Enhancer does not modify the declaration or any of the methods in the interface.

Method Summary

Methods

Modifier and Type	Method and Description
void	jdoPostLoad() Called after the values are loaded from the data store into this instance.
void	jdoPreClear() Called before the values in the instance are cleared.
void	jdoPreStore() Called before the values are stored from this instance to the data store.

Method Detail

jdoPostLoad

void jdoPostLoad()

Called after the values are loaded from the data store into this instance.

Derived fields should be initialized in this method.

This method is never modified by the Reference Enhancer.

jdoPreStore

void jdoPreStore()

Called before the values are stored from this instance to the data store.

Database fields that might have been affected by modified derived fields should be updated in this method.

This method is never modified by the Reference Enhancer.

jdoPreClear

void jdoPreClear()

Called before the values in the instance are cleared.

Transient fields should be cleared in this method, as they will not be affected by the jdoClear method. Associations between this instance and others in the runtime environment should be cleared.

This method is never modified by the Reference Enhancer.