CursorManagerUpdateListener Class

About the CursorManagerUpdateListener class

CursorManagerUpdateListener is an interface that has methods that receive CursorManagerUpdateEvent objects. Oracle OLAP Services generates a CursorManagerUpdateEvent object in response to a change that occurs in a Source that is produced by a Template or when a CursorManager updates its CursorManagerSpecification. Your application can use a CursorManagerUpdateListener to listen for events that indicate it might need to create new Cursor objects from the CursorManager or to update its display of data from a Cursor.

To use a CursorManagerUpdateListener, implement the interface, create an instance of the class, and then add the CursorManagerUpdateListener to the CursorManager for a Source. When a change to the Source occurs, the CursorManager calls the appropriate method on the CursorManagerUpdateListener and passes it a CursorManagerUpdateEvent. Your application can then perform the tasks needed to generate new Cursor objects and update the display of values from the result set that the Source defines.

You can implement more than one version of the CursorManagerUpdateListener interface. You can add instances of them to the same CursorManager.

CursorManagerUpdateListener methods

A CursorManagerUpdateListener has the following methods:

Method	Return Value
cursorManagerDataUpdated	Void. Called by a CursorManager when it becomes aware that its Source has changed so that the data specified by Source is different but the structure of the Source has not changed.
cursorManagerSpecificationUpdated	Void. Called by a CursorManager when its CursorManagerSpecification has been updated.
cursorManagerStructureUpdated	Void. Called by a CursorManager when it becomes aware that the structure of its Source has changed.

About the CursorManagerUpdateEvent class

Oracle OLAP Services generates a CursorManagerUpdateEvent object in response to a change that occurs in a Source that is produced by a Template or when a CursorManager updates its CursorManagerSpecification.

You do not directly create instances of this class. Oracle OLAP Services generates CursorManagerUpdateEvent objects and passes them to the appropriate methods of any CursorManagerUpdateListener objects you have added to a CursorManager. The CursorManagerUpdateEvent has a field that indicates the type of event that occurred. A CursorManagerUpdateEvent has methods you can use to get information about it.

CursorManagerUpdateEvent fields

A CursorManagerUpdateEvent has the following fields:

Field	Meaning
CURSOR_MANAGER_DATA_UPDATED	Indicates that the Source for a CursorManager has changed so that the data specified by Source is different but the structure of the Source has not changed
CURSOR_MANAGER_SPECIFICATION_UPDATED	Indicates that the CursorManager has updated its CursorManagerSpecification.
CURSOR_MANAGER_STRUCTURE_UPDATED	Indicates that the Source for a CursorManager has changed and the structure of the Source is different.

CursorManagerUpdateEvent methods

A CursorManagerUpdateEvent has the following methods:

Method	Return Value
getCursorManager	The CursorManager that originated the event.
getID	A constant the identifies the type of event that occurred, such as CURSOR_MANAGER_STRUCTURE_UPDATED.