FileDocCategorySizeDatePackage
Lifecycle.javaAPI DocHibernate 3.2.52853Wed Jul 20 02:16:34 BST 2005org.hibernate.classic

Lifecycle

public interface Lifecycle
Provides callbacks from the Session to the persistent object. Persistent classes may implement this interface but they are not required to.

onSave: called just before the object is saved
onUpdate: called just before an object is updated, ie. when Session.update() is called
onDelete: called just before an object is deleted
onLoad: called just after an object is loaded

onLoad() may be used to initialize transient properties of the object from its persistent state. It may not be used to load dependent objects since the Session interface may not be invoked from inside this method.

A further intended usage of onLoad(), onSave() and onUpdate() is to store a reference to the Session for later use.

If onSave(), onUpdate() or onDelete() return VETO, the operation is silently vetoed. If a CallbackException is thrown, the operation is vetoed and the exception is passed back to the application.

Note that onSave() is called after an identifier is assigned to the object, except when identity column key generation is used.
see
CallbackException
author
Gavin King

Fields Summary
public static final boolean
VETO
Return value to veto the action (true)
public static final boolean
NO_VETO
Return value to accept the action (false)
Constructors Summary
Methods Summary
public booleanonDelete(org.hibernate.Session s)
Called when an entity is deleted.

param
s the session
return
true to veto delete
throws
CallbackException

public voidonLoad(org.hibernate.Session s, java.io.Serializable id)
Called after an entity is loaded. It is illegal to
access the Session from inside this method.
However, the object may keep a reference to the session
for later use.
param
s the session
param
id the identifier
public booleanonSave(org.hibernate.Session s)
Called when an entity is saved.
param
s the session
return
true to veto save
throws
CallbackException
public booleanonUpdate(org.hibernate.Session s)
Called when an entity is passed to Session.update().
This method is not called every time the object's
state is persisted during a flush.
param
s the session
return
true to veto update
throws
CallbackException