javax.infobus
Class DataItemChangeSupport

java.lang.Object
  |
  +--javax.infobus.DataItemChangeSupport

Deprecated. replaced by DataItemChangeManagerSupport

public class DataItemChangeSupport
extends java.lang.Object

This class implements the methods defined by DataItemChangeManager for managing event listeners, and adds specialized methods for firing each type of change notification. A class that implements DataItemChangeManager can delegate the work for its methods to the methods defined here, and the various methods in access interfaces that allow changes to data can fire events using methods defined here.

See Also:
DataItemChangeManager

Constructor Summary
DataItemChangeSupport(java.lang.Object source)
          Deprecated. The constructor initializes an event indicating a change to a data item.
 
Method Summary
 void addDataItemChangeListener(DataItemChangeListener listener)
          Deprecated. Adds a change listener as requested by a consumer or other InfoBus component.
 void fireItemAdded(java.lang.Object changedItem, java.lang.Object changedCollection, InfoBusPropertyMap propertyMap)
          Deprecated. This method is called when one or more new items are being added to a collection.
 void fireItemDeleted(java.lang.Object changedItem, java.lang.Object changedCollection, InfoBusPropertyMap propertyMap)
          Deprecated. This method is called when one or more items are being removed from a collection.
 void fireItemRevoked(java.lang.Object changedItem, InfoBusPropertyMap propertyMap)
          Deprecated. This method is called when an item or collection is no longer available, such as when the data source is going offline.
 void fireItemValueChanged(java.lang.Object changedItem, InfoBusPropertyMap propertyMap)
          Deprecated. This method is called when an item, usually an ImmediateAccess, changes value.
 void fireRowsetCursorMoved(java.lang.Object changedItem, InfoBusPropertyMap propertyMap)
          Deprecated. This method should be called when a rowset's cursor has moved to a different row.
 void removeAllListeners()
          Deprecated. This method permits the owner of the data item using the DataItemChangeSupport to force removal of all registered listeners.
 void removeDataItemChangeListener(DataItemChangeListener listener)
          Deprecated. Removes a change listener as requested by a consumer or other InfoBus component.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DataItemChangeSupport

public DataItemChangeSupport(java.lang.Object source)
Deprecated. 
The constructor initializes an event indicating a change to a data item.
Parameters:
source - the data item object that implements the DataItemChangeManager interface, representing the source of the event. When an instance of this class is a member field for a data item, the source is a reference to the outer class that contains the instance of this class.
Method Detail

addDataItemChangeListener

public void addDataItemChangeListener(DataItemChangeListener listener)
Deprecated. 
Adds a change listener as requested by a consumer or other InfoBus component.
Parameters:
listener - the change listener object to be registered

removeDataItemChangeListener

public void removeDataItemChangeListener(DataItemChangeListener listener)
Deprecated. 
Removes a change listener as requested by a consumer or other InfoBus component.
Parameters:
listener - the change listener object to be unregistered

removeAllListeners

public void removeAllListeners()
Deprecated. 
This method permits the owner of the data item using the DataItemChangeSupport to force removal of all registered listeners. It should be called only after those listeners were delivered a DataItemRevoked event by calling DataItemChangeSupport.fireRevokedEvent AND an InfoBusItemRevokedEvent was sent on the InfoBus (by calling InfoBus.fireItemRevoked).

fireItemValueChanged

public void fireItemValueChanged(java.lang.Object changedItem,
                                 InfoBusPropertyMap propertyMap)
Deprecated. 
This method is called when an item, usually an ImmediateAccess, changes value.
Parameters:
changedItem - the Object whose value changed.
propertyMap - either null or additional information about the change.

fireItemAdded

public void fireItemAdded(java.lang.Object changedItem,
                          java.lang.Object changedCollection,
                          InfoBusPropertyMap propertyMap)
Deprecated. 
This method is called when one or more new items are being added to a collection.
Parameters:
changedItem - the Object which was added, or null to indicate that more than one item was added.
changedCollection - the collection that gained a new item.
propertyMap - either null or additional information about the change.

fireItemDeleted

public void fireItemDeleted(java.lang.Object changedItem,
                            java.lang.Object changedCollection,
                            InfoBusPropertyMap propertyMap)
Deprecated. 
This method is called when one or more items are being removed from a collection.
Parameters:
changedItem - the Object which was removed, or null to indicate that more than one item was removed.
changedCollection - the collection that lost an item.
propertyMap - either null or additional information about the change.

fireItemRevoked

public void fireItemRevoked(java.lang.Object changedItem,
                            InfoBusPropertyMap propertyMap)
Deprecated. 
This method is called when an item or collection is no longer available, such as when the data source is going offline. Unlike the other events, this event is sent to the data item passed during rendezvous, and to all sub-items in a collection hierarchy.
Parameters:
changedItem - the item or collection that is being revoked.
propertyMap - either null or additional information about the change.

fireRowsetCursorMoved

public void fireRowsetCursorMoved(java.lang.Object changedItem,
                                  InfoBusPropertyMap propertyMap)
Deprecated. 
This method should be called when a rowset's cursor has moved to a different row.
Parameters:
changedItem - the rowset whose cursor changed.
propertyMap - either null or additional information about the change.