com.kabira.store

Class Record<T>

java.lang.Object

com.kabira.store.Record<T>

Type Parameters:

T - Managed type parameter

@Managed
public abstract class Record<T>
extends java.lang.Object

Class for receiving notifications of modifications (create, update, delete) to Managed object instances.

This notifier provides an opportunity to see Managed objects modified within a transaction. For example, it could be used for updating records in a database, or for doing a Managed object change log.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Record(java.lang.Class<T> klass) Constructor.

Method Summary

Modifier and Type	Method and Description
void	created(T object) Notifier method for a created Managed object.
void	deleted(T object) Notifier method for a deleted Managed object.
static Record<?>	getNotifier(java.lang.Class<?> klass) Return the currently installed Record notifier for a Managed class.
void	modified(T object) Notifier method for a modified Managed object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Record

protected Record(java.lang.Class<T> klass)
          throws ManagedClassError

Constructor.

Creating an instance automatically installs it as the record notifier for Managed class T.

If a notifier is already installed for the class, the new instance replaces the previous instance.

Deleting a notifier automatically uninstalls it.

Notifiers are automatically deleted when the JVM shuts down. Notifiers created in other JVMs are not affected.

A separate notifier may be set for each class in a hierarchy.

If no notifier is installed for a class, it inherits the notifier of its parent.

Parameters:

klass - The Managed class base to receive notifications for.

Throws:

ManagedClassError - klass is not managed.

Method Detail

getNotifier

public static Record<?> getNotifier(java.lang.Class<?> klass)

Return the currently installed Record notifier for a Managed class. Note: Inheritance is not examined by this method. If there is no notifier for the Managed class null is returned.

Parameters:

klass - The class to search.

Returns:

Record or null.

Throws:

ManagedClassError - if klass is not managed.

created

public void created(T object)

Notifier method for a created Managed object.

Called for each object created (but not deleted) within the transaction.

Parameters:

object - The created object. This may be a subtype of the notifier's managed class type.

modified

public void modified(T object)

Notifier method for a modified Managed object.

Called for each object modified (but not created or deleted) within the transaction.

Parameters:

object - The modified object. This may be a subtype of the notifier's managed class type.

deleted

public void deleted(T object)

Notifier method for a deleted Managed object.

Called when ManagedObject.delete(java.lang.Object) is called by the application.

Parameters:

object - The deleted object. This may be a subtype of the notifier's managed class type.