CallbackHandler (DataNucleus Core 5.0.11-SNAPSHOT API)

All Known Implementing Classes:

BeanValidatorHandler, NullCallbackHandler
```
public interface CallbackHandler
```
CallBack handlers receive notification of events on persistent objects. Handlers are responsible for invoking event listeners/callback methods on Callback or Listener implementations. When a validation handler is set, the prePersist, preStore and preDelete callbacks will be routed through to this validation handler.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`addListener(Object listener, Class[] classes)` Adds a new listener to this handler.
`void`	`close()` Clear any objects to release resources.
`void`	`postAttach(Object pc, Object detachedPC)` Callback after the object is attached.
`void`	`postClear(Object pc)` Callback after the fields of the object are cleared.
`void`	`postCreate(Object pc)` Callback after the object has been created.
`void`	`postDelete(Object pc)` Callback after the object is deleted.
`void`	`postDetach(Object pc, Object detachedPC)` Callback after the object is detached.
`void`	`postDirty(Object pc)` Callback after the object is made dirty.
`void`	`postLoad(Object pc)` Callback after the fields of the object are loaded.
`void`	`postRefresh(Object pc)` Callback after the fields of the object are refreshed.
`void`	`postStore(Object pc)` Callback after the object is stored.
`void`	`preAttach(Object detachedPC)` Callback before the object is attached.
`void`	`preClear(Object pc)` Callback before the fields of the object are cleared.
`void`	`preDelete(Object pc)` Callback before the object is deleted.
`void`	`preDetach(Object pc)` Callback before the object is detached.
`void`	`preDirty(Object pc)` Callback before the object is made dirty.
`void`	`prePersist(Object pc)` Callback before the object is persisted (just before the lifecycle state change).
`void`	`preStore(Object pc)` Callback before the object is stored.
`void`	`removeListener(Object listener)` Remove a listener for this handler.
`void`	`setValidationListener(CallbackHandler handler)` Method to set the listener for validation callbacks.

- Method Detail
  - setValidationListener
```
void setValidationListener(CallbackHandler handler)
```
    Method to set the listener for validation callbacks.
    
    Parameters:
    
    handler - Handler for validation callbacks
  - postCreate
```
void postCreate(Object pc)
```
    Callback after the object has been created.
    
    Parameters:
    
    pc - The Object
  - prePersist
```
void prePersist(Object pc)
```
    Callback before the object is persisted (just before the lifecycle state change).
    
    Parameters:
    
    pc - The Object
  - preStore
```
void preStore(Object pc)
```
    Callback before the object is stored.
    
    Parameters:
    
    pc - The Object
  - postStore
```
void postStore(Object pc)
```
    Callback after the object is stored.
    
    Parameters:
    
    pc - The Object
  - preClear
```
void preClear(Object pc)
```
    Callback before the fields of the object are cleared.
    
    Parameters:
    
    pc - The Object
  - postClear
```
void postClear(Object pc)
```
    Callback after the fields of the object are cleared.
    
    Parameters:
    
    pc - The Object
  - preDelete
```
void preDelete(Object pc)
```
    Callback before the object is deleted.
    
    Parameters:
    
    pc - The Object
  - postDelete
```
void postDelete(Object pc)
```
    Callback after the object is deleted.
    
    Parameters:
    
    pc - The Object
  - preDirty
```
void preDirty(Object pc)
```
    Callback before the object is made dirty.
    
    Parameters:
    
    pc - The Object
  - postDirty
```
void postDirty(Object pc)
```
    Callback after the object is made dirty.
    
    Parameters:
    
    pc - The Object
  - postLoad
```
void postLoad(Object pc)
```
    Callback after the fields of the object are loaded.
    
    Parameters:
    
    pc - The Object
  - postRefresh
```
void postRefresh(Object pc)
```
    Callback after the fields of the object are refreshed.
    
    Parameters:
    
    pc - The Object
  - preDetach
```
void preDetach(Object pc)
```
    Callback before the object is detached.
    
    Parameters:
    
    pc - The Object
  - postDetach
```
void postDetach(Object pc,
                Object detachedPC)
```
    Callback after the object is detached.
    
    Parameters:
    
    pc - The Object
    
    detachedPC - The detached object
  - preAttach
```
void preAttach(Object detachedPC)
```
    Callback before the object is attached.
    
    Parameters:
    
    detachedPC - The Object
  - postAttach
```
void postAttach(Object pc,
                Object detachedPC)
```
    Callback after the object is attached.
    
    Parameters:
    
    pc - The attached Object
    
    detachedPC - The detached object
  - addListener
```
void addListener(Object listener,
                 Class[] classes)
```
    Adds a new listener to this handler.
    
    Parameters:
    
    listener - the listener instance
    
    classes - the persistent classes which events are fired for the listener
  - removeListener
```
void removeListener(Object listener)
```
    Remove a listener for this handler.
    
    Parameters:
    
    listener - the listener instance
  - close
```
void close()
```
    Clear any objects to release resources.

Interface CallbackHandler

Method Summary

Method Detail

setValidationListener

postCreate

prePersist

preStore

postStore

preClear

postClear

preDelete

postDelete

preDirty

postDirty

postLoad

postRefresh

preDetach

postDetach

preAttach

postAttach

addListener

removeListener

close