db4o 7.4

com.db4o.events
Interface EventRegistry


public interface EventRegistry

Provides the interface to register event handlers for ObjectContainer events.
EventRegistry methods represent events available for registering callbacks. An EventRegistry instance can be obtained from the EventRegistryFactory. EventRegistry registry = EventRegistryFactory.forObjectContainer(container); A new callback can be registered for an event with the following code: registry.created().addListener(new EventListener4(){...});

See Also:
EventRegistryFactory, EventListener4

Method Summary
 Event4 activated()
          This event is fired after an object is activated.
 Event4 activating()
          This event is fired before an object is activated.
 Event4 classRegistered()
          This event is fired when a new class is registered with metadata.
 Event4 closing()
          This event is fired when the ObjectContainer.close() is called.
 Event4 committed()
          This event is fired after a transaction has been committed.
 Event4 committing()
          This event is fired just before a transaction is committed.
 Event4 created()
          This event is fired after an object is created (saved for the first time).
 Event4 creating()
          This event is fired before an object is saved for the first time.
 Event4 deactivated()
          This event is fired after an object is deactivated.
 Event4 deactivating()
          This event is fired before an object is deactivated.
 Event4 deleted()
          This event is fired after an object is deleted.
 Event4 deleting()
          This event is fired before an object is deleted.
 Event4 instantiated()
          This event is fired when a persistent object is instantiated.
 Event4 queryFinished()
          This event is fired upon a query end and can be used to gather query statistics.
 Event4 queryStarted()
          This event is fired upon a query start and can be used to gather query statistics.
 Event4 updated()
          This event is fired after an object is updated.
 Event4 updating()
          This event is fired before an object is updated.
 

Method Detail

queryStarted

Event4 queryStarted()
This event is fired upon a query start and can be used to gather query statistics. The query object is available from QueryEventArgs event parameter.

Returns:
event
See Also:
QueryEventArgs

queryFinished

Event4 queryFinished()
This event is fired upon a query end and can be used to gather query statistics. The query object is available from QueryEventArgs event parameter.

Returns:
event
See Also:
QueryEventArgs

creating

Event4 creating()
This event is fired before an object is saved for the first time. The object can be obtained from CancellableObjectEventArgs event parameter. The action can be cancelled using CancellableObjectEventArgs.cancel()

Returns:
event
See Also:
CancellableObjectEventArgs, ObjectContainer.store(Object)

activating

Event4 activating()
This event is fired before an object is activated. The object can be obtained from CancellableObjectEventArgs event parameter. The action can be cancelled using CancellableObjectEventArgs.cancel()

Returns:
event
See Also:
CancellableObjectEventArgs, ObjectContainer.activate(Object, int)

updating

Event4 updating()
This event is fired before an object is updated. The object can be obtained from CancellableObjectEventArgs event parameter. The action can be cancelled using CancellableObjectEventArgs.cancel()

Returns:
event
See Also:
CancellableObjectEventArgs, ObjectContainer.store(Object)

deleting

Event4 deleting()
This event is fired before an object is deleted. The object can be obtained from CancellableObjectEventArgs event parameter. The action can be cancelled using CancellableObjectEventArgs.cancel()

Returns:
event
See Also:
CancellableObjectEventArgs, ObjectContainer.delete(Object)

deactivating

Event4 deactivating()
This event is fired before an object is deactivated. The object can be obtained from CancellableObjectEventArgs event parameter. The action can be cancelled using CancellableObjectEventArgs.cancel()

Returns:
event
See Also:
CancellableObjectEventArgs, ObjectContainer.deactivate(Object, int)

activated

Event4 activated()
This event is fired after an object is activated. The object can be obtained from the ObjectEventArgs event parameter.

The event can be used to trigger some post-activation functionality.

Returns:
event
See Also:
ObjectEventArgs, ObjectContainer.activate(Object, int)

created

Event4 created()
This event is fired after an object is created (saved for the first time). The object can be obtained from the ObjectEventArgs event parameter.

The event can be used to trigger some post-creation functionality.

Returns:
event
See Also:
ObjectEventArgs, ObjectContainer.store(Object)

updated

Event4 updated()
This event is fired after an object is updated. The object can be obtained from the ObjectEventArgs event parameter.

The event can be used to trigger some post-update functionality.

Returns:
event
See Also:
ObjectEventArgs, ObjectContainer.store(Object)

deleted

Event4 deleted()
This event is fired after an object is deleted. The object can be obtained from the ObjectEventArgs event parameter.

The event can be used to trigger some post-deletion functionality.

Returns:
event
See Also:
ObjectEventArgs, ObjectContainer.delete(Object)

deactivated

Event4 deactivated()
This event is fired after an object is deactivated. The object can be obtained from the ObjectEventArgs event parameter.

The event can be used to trigger some post-deactivation functionality.

Returns:
event
See Also:
ObjectEventArgs, ObjectContainer.delete(Object)

committing

Event4 committing()
This event is fired just before a transaction is committed. The transaction and a list of the modified objects can be obtained from the CommitEventArgs event parameter.

Committing event gives a user a chance to interrupt the commit and rollback the transaction.

Returns:
event
See Also:
CommitEventArgs, ObjectContainer.commit()

committed

Event4 committed()
This event is fired after a transaction has been committed. The transaction and a list of the modified objects can be obtained from the CommitEventArgs event parameter.

The event can be used to trigger some post-commit functionality.

Returns:
event
See Also:
CommitEventArgs, ObjectContainer.commit()

instantiated

Event4 instantiated()
This event is fired when a persistent object is instantiated. The object can be obtained from the ObjectEventArgs event parameter.

Returns:
event
See Also:
ObjectEventArgs

classRegistered

Event4 classRegistered()
This event is fired when a new class is registered with metadata. The class information can be obtained from ClassEventArgs event parameter.

Returns:
event
See Also:
ClassEventArgs

closing

Event4 closing()
This event is fired when the ObjectContainer.close() is called.

Returns:
event

db4o 7.4

Copyright 2007 db4objects Inc. All rights reserved.