|
Oracle® OLAP Java API Reference 10g Release 2 (10.2.0.4) B14348-04 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | 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 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 |
public void cursorManagerDataUpdated(CursorManagerUpdateEvent event)
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.
event - The CursorManagerUpdateEvent that the
CursorManager passes to the listener.public void cursorManagerStructureUpdated(CursorManagerUpdateEvent event)
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.
event - The CursorManagerUpdateEvent that the
CursorManager passes to the listener.public void cursorManagerSpecificationUpdated(CursorManagerUpdateEvent event)
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.
event - The CursorManagerUpdateEvent that the
CursorManager passes to the listener.
|
Oracle® OLAP Java API Reference 10g Release 2 (10.2.0.4) B14348-04 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||