|
Oracle OLAP Java API Reference 10g Release 1 (10.1) B10994-01 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
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 on a DataProvider
, the result of which was passed to the createCursorManager
method on the DataProvider
that created the CursorManager
. The Source
returned by the getSource
method on 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.
Cursor
, CursorManager
, CursorManagerSpecification
, DynamicDefinition
, Template
Method Summary | |
void |
cursorManagerDataUpdated(CursorManagerUpdateEvent event) 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. |
void |
cursorManagerSpecificationUpdated(CursorManagerUpdateEvent event) Called by a CursorManager when its CursorManagerSpecification has been updated. |
void |
cursorManagerStructureUpdated(CursorManagerUpdateEvent event) Called by a CursorManager when it becomes aware that the structure of its Source has changed. |
Method Detail |
public void cursorManagerDataUpdated(CursorManagerUpdateEvent event)
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. Since the structure is unchanged, the application does not need to create a new CursorManagerSpecification
or new Cursor
objects. It only needs to repaint its 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 on its listeners.
public void cursorManagerStructureUpdated(CursorManagerUpdateEvent event)
CursorManager
when it becomes aware that the structure of its Source
has changed. Since 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 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 on its listeners.
public void cursorManagerSpecificationUpdated(CursorManagerUpdateEvent event)
CursorManager
when its CursorManagerSpecification
has been updated. A call to this method indicates that the application can create new Cursor
objects from the CursorManager
.
|
Oracle OLAP Java API Reference 10g Release 1 (10.1) B10994-01 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |