Skip navigation links

Oracle® OLAP Java API Reference
10g Release 2 (10.2)

B14348-04


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 for the CursorManager. The Source for a CursorManager is the Source that was passed to the createCursorManagerSpecification method of a DataProvider, the result of which was passed to the createCursorManager method of the DataProvider that created the CursorManager. The Source returned by the getSource method of a DynamicDefinition is the only Source that can change. A DynamicDefinition is created by a Template.

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 associated with it 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 CursorManagerSpecification associated with it has been updated.
 void cursorManagerStructureUpdated(CursorManagerUpdateEvent event)
          Called by a CursorManager when it becomes aware that the structure of the Source associated with it has changed.

 

Method Detail

cursorManagerDataUpdated

public void cursorManagerDataUpdated(CursorManagerUpdateEvent event)
Called by a CursorManager when it becomes aware that the Source associated with it 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 for which the data it specifies changes but whose structure remains the same. A Template specifies a selection of a number of values from the top or bottom of a set of the values of a measure, The structure of the query is the set of dimension selections that the Source specifies. 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 for that Template so that the selection specifies the bottom ten values. When the application commits that change into the Transaction in which the original Source was created, 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 that the CursorManager passes to the listener.

cursorManagerStructureUpdated

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

The following continues the example described in the cursorManagerDataUpdatedmethod. After changing the selection from the top ten to the bottom ten values, the end user then changes the selection of dimension values so that one of the dimension selections has fewer values. Specifying a different number of dimension values 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 that the CursorManager passes to the listener.

cursorManagerSpecificationUpdated

public void cursorManagerSpecificationUpdated(CursorManagerUpdateEvent event)
Called by a CursorManager when the CursorManagerSpecification associated with it has been updated. A call to this method indicates that the application can create new Cursor objects from the CursorManager.
Parameters:
event - The CursorManagerUpdateEvent that the CursorManager passes to the listener.

Skip navigation links

Oracle® OLAP Java API Reference
10g Release 2 (10.2)

B14348-04


Copyright © 2002, 2007, Oracle. All rights reserved.