stomp.jdo
Class RefreshManager

java.lang.Object
  |
  +--stomp.jdo.RefreshManager

public class RefreshManager

extends java.lang.Object

Manages links between objects that are interested in other objects being refreshed, and the event that those other objects are refreshed.

Author:

Eric Lindauer

Constructor Summary

RefreshManager()

Method Summary

void	fireObjectDeletedEvent(ObjectId id) notifies all interested listeners that the given object id was deleted, regardless of the PM that they are registered under.
void	fireObjectRefreshEvent(java.util.Collection objects, javax.jdo.PersistenceManager pm) same as fireRefreshEvent, but passes in a Collection of refreshed objects instead of ids.
void	fireObjectRefreshEvent(java.lang.Object[] pcs, javax.jdo.PersistenceManager pm)
void	fireRefreshEvent(java.util.Collection ids, javax.jdo.PersistenceManager pm) first, notifies all persistent objects that they have been refreshed.
void	fireRefreshEvent(java.lang.Object id, javax.jdo.PersistenceManager pm) Used by PersistenceManagers to notify the outside world that an object was refreshed.
void	registerListener(java.lang.Class prstClass, RefreshListener listener) registers for notification if any object of class prstClass is refreshed or deleted in the read-only PersistenceManager.
void	registerListener(java.lang.Class prstClass, RefreshListener listener, javax.jdo.PersistenceManager pm)
void	registerListener(java.lang.Object object, RefreshListener listener) registers for notification of the event that the given object was refreshed in the persistenceManager associated with the given object.
void	registerListener(java.lang.Object object, RefreshListener listener, javax.jdo.PersistenceManager pm)
void	removeListener(java.lang.Class prstClass, RefreshListener listener)
void	removeListener(java.lang.Class prstClass, RefreshListener listener, javax.jdo.PersistenceManager pm)
void	removeListener(java.lang.Object object, RefreshListener listener) Stops listening for refresh events for the given object ( in the PM associated with this object ).
void	removeObjectListener(RefreshListener listener) removes the given object specific listener from receiving any further callbacks from any object.
static RefreshManager	singleton()

Methods inherited from class java.lang.Object

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

Constructor Detail

RefreshManager

public RefreshManager()

Method Detail

singleton

public static RefreshManager singleton()

registerListener

public void registerListener(java.lang.Object object,
                             RefreshListener listener)

registers for notification of the event that the given object was refreshed in the persistenceManager associated with the given object. If the given object is not persistent, the object is registered for notification of a refresh in the read-only PM.

registerListener

public void registerListener(java.lang.Object object,
                             RefreshListener listener,
                             javax.jdo.PersistenceManager pm)

registerListener

public void registerListener(java.lang.Class prstClass,
                             RefreshListener listener)

registers for notification if any object of class prstClass is refreshed or deleted in the read-only PersistenceManager.

registerListener

public void registerListener(java.lang.Class prstClass,
                             RefreshListener listener,
                             javax.jdo.PersistenceManager pm)

fireObjectDeletedEvent

public void fireObjectDeletedEvent(ObjectId id)

notifies all interested listeners that the given object id was deleted, regardless of the PM that they are registered under.

removeObjectListener

public void removeObjectListener(RefreshListener listener)

removes the given object specific listener from receiving any further callbacks from any object.

removeListener

public void removeListener(java.lang.Object object,
                           RefreshListener listener)

Stops listening for refresh events for the given object ( in the PM associated with this object ).

removeListener

public void removeListener(java.lang.Class prstClass,
                           RefreshListener listener)

removeListener

public void removeListener(java.lang.Class prstClass,
                           RefreshListener listener,
                           javax.jdo.PersistenceManager pm)

fireRefreshEvent

public void fireRefreshEvent(java.util.Collection ids,
                             javax.jdo.PersistenceManager pm)

first, notifies all persistent objects that they have been refreshed. After that, listeners registered for callbacks are notified to take appropriate action as well.

fireObjectRefreshEvent

public void fireObjectRefreshEvent(java.util.Collection objects,
                                   javax.jdo.PersistenceManager pm)

same as fireRefreshEvent, but passes in a Collection of refreshed objects instead of ids.

fireObjectRefreshEvent

public void fireObjectRefreshEvent(java.lang.Object[] pcs,
                                   javax.jdo.PersistenceManager pm)

fireRefreshEvent

public void fireRefreshEvent(java.lang.Object id,
                             javax.jdo.PersistenceManager pm)

Used by PersistenceManagers to notify the outside world that an object was refreshed.