oracle.olapi.data.cursor
Interface CursorManagerUpdateListener

public interface CursorManagerUpdateListener

An interface for a listener object that a CursorManager notifies when a change occurs to the Source associated with the CursorManager. You can use a CursorManagerUpdateListener to notify the display portion of your application that changes have occurred in the query generation portion of your application.

Method Summary

void	cursorManagerDataUpdated(CursorManagerUpdateEvent event) Called by a CursorManager when it becomes aware that the Source has changed so that the data specified by Source is different but the structure of the Source has not changed.
void	cursorManagerSpecificationUpdated(CursorManagerUpdateEvent event) Called by a CursorManager when the CursorInfoSpecification associated with it has been updated.
void	cursorManagerStructureUpdated(CursorManagerUpdateEvent event) Called by a CursorManager when it becomes aware that the structure has changed of the Source associated with it.

Method Detail

cursorManagerDataUpdated

void cursorManagerDataUpdated(CursorManagerUpdateEvent event)

Called by a CursorManager when it becomes aware that the Source has changed so that the data specified by Source is different but the structure of the Source has not changed. Because the structure is unchanged, the application does not need to create a new CursorManagerSpecification or new Cursor objects. It only needs to repaint the display of the data.

The following is an example of a Source whose structure remains the same even though the data that it specifies has changed:

• A Template selects a number of values from the top or bottom of a set of the values of a measure. The selection of dimension members detemines the set of measure values. The structure of the resulting query is determined by the set of dimension members.
• An application creates a Source through the Template that represents a selection of the top ten measure values.
• The end user then changes the selection measure values to specify the bottom ten values.
• When the application commits the Transaction after the change, the data selection that the Source represents changes but the structure of the Source does not change.
• The CursorManager is notified that the data specified by the Source has changed.
• The CursorManager then calls this method of the listeners associated with it.

Parameters:

event - The CursorManagerUpdateEvent generated by the the CursorManager.

cursorManagerStructureUpdated

void cursorManagerStructureUpdated(CursorManagerUpdateEvent event)

Called by a CursorManager when it becomes aware that the structure has changed of the Source associated with it. Because the structure has changed, the application must create a new CursorManagerSpecification for the CursorManager and then create new Cursor objects.

To continue the example described in the cursorManagerDataUpdated method: after changing the selection from the top ten to the bottom ten values, the end user then changes the selection of members of one of the dimensions of the measure so that the selection has fewer members. Specifying a different number of dimension members changes the structure of the query. When the application commits that change into the Transaction in which the original Source was created, the structure of the Source is then different. The CursorManager is notified that the structure has changed and it calls this method of the listeners associated with it.

Parameters:

event - The CursorManagerUpdateEvent generated by the the CursorManager.

cursorManagerSpecificationUpdated

void cursorManagerSpecificationUpdated(CursorManagerUpdateEvent event)

Called by a CursorManager when the CursorInfoSpecification associated with it has been updated. When the listener receives a CursorManagerUpdateEvent, the application can create new Cursor objects from the CursorManager.

Parameters:

event - The CursorManagerUpdateEvent generated by the the CursorManager.