oracle.dss.util.datacache
Class RelationalCachedDataSource

java.lang.Object
  |
  +--oracle.dss.util.DataAccessAdapter
        |
        +--oracle.dss.util.datacache.BaseCachedDataSource
              |
              +--oracle.dss.util.datacache.RelationalCachedDataSource

All Implemented Interfaces:

DataDirector, DataSource, Persistable, RelationalDataDirector, StringXMLizable

public class RelationalCachedDataSource

extends BaseCachedDataSource

implements RelationalDataDirector

Use this class to cache relational (table) data. The cache will contain data for the current logical page only. It does not support data manipulation (rotation, drilling, paging, etc.) To create a cache object, pass instances of DataAccess and DataDirector to the class constructor or to the copyDataSource() method. Instances of this class can be utilized as in-memory cache, or for storing cache objects in BI Beans Catalog.

See Also:

CachedDataSource

Field Summary

static java.lang.String

CACHED_DATA

Fields inherited from class oracle.dss.util.datacache.BaseCachedDataSource

COLUMN_EDGE, DATAMAP, LAYERMETADATAMAP, METADATAMAP, PAGE_EDGE, ROW_EDGE

Fields inherited from interface oracle.dss.util.DataDirector

COLUMN_EDGE, DATA_ELEMENT_EDGE, DRILL_REPLACE, DRILLSTATE_DRILLABLE, DRILLSTATE_IS_DRILLED, DRILLSTATE_NOT_DRILLABLE, GROUPSORT_END, GROUPSORT_MIDDLE, GROUPSORT_NONE, GROUPSORT_START, max_edge, NA_SUPPRESSION, NA_ZERO_SUPPRESSION, NO_SUPPRESSION, PAGE_EDGE, PIVOT_EDGES, PIVOT_MOVE_AFTER, PIVOT_MOVE_BEFORE, PIVOT_MOVE_TO, PIVOT_SWAP, ROW_EDGE, ZERO_SUPPRESSION

Constructor Summary

RelationalCachedDataSource()
Constructor

Method Summary

static RelationalCachedDataSource	createCachedDataSource(DataAccess da, DataDirector dd) Creates an instance of RelationalCachedDataSource from existing DataAccess and DataDirector
RelationalDataDirector	createRelationalDataDirector() Creates a DataDirector for relational views.
QDR	getLayerQDR(int edge, int layer, int flags) Retrieves the QDR object that represents the specified logical layer.
QDR	getMemberQDR(int edge, int[] hPos, int memberLayer, int flags) Retrieves a QDR object that represents the specified member using hierarchical addressing.
QDR	getMemberQDR(int edge, int layer, int slice, int flags) Retrieves a QDR object that represents the data value for the member at the specified edge, layer, and slice.
QDR	getSliceQDR(int edge, int slice, int flags) Retrieves a QDR object that represents the data value at the specified slice on the edge (that is, across all relevant logical layers of the slice).
QDR	getValueQDR(int row, int column, int flags) Retrieves a QDR object that represents the value at the specified row and column in the data area of the cursor.

Methods inherited from class oracle.dss.util.datacache.BaseCachedDataSource

addDataDirectorListener, copyDataSource, createCubeDataDirector, getEdgeCount, getEdgeCurrentHPos, getEdgeCurrentSlice, getEdgeExtent, getExpectedDataMap, getExpectedLayerMetadataMap, getExpectedMetadataMap, getFirstHPos, getLastHPos, getLayerCount, getLayerMetadata, getMemberDepth, getMemberExtent, getMemberHPos, getMemberMetadata, getMemberMetadata, getMemberSiblingCount, getMemberStartLayer, getMemberStartSlice, getNextHPos, getPrevHPos, getSliceLabel, getSliceMemberCount, getSupportedDataMap, getSupportedLayerMetadataMap, getSupportedMetadataMap, getValue, getXML, readXML, setExpectedDataMap, setExpectedLayerMetadataMap, setExpectedMetadataMap, setXML, writeXML

Methods inherited from class oracle.dss.util.DataAccessAdapter

cancel, changeEdgeCurrentHPos, changeEdgeCurrentSlice, deleteMemberCalc, deleteValueCalc, drill, drill, drillOK, drillOK, dropChanges, endGroupEdit, findMember, forceFetch, getDataMap, getMemberLogicalLayer, getMetadataMap, getQDRoverrideCollection, getSliceOutlineLayer, insertMemberCalc, insertValueCalc, isAutoSubmit, isCancelable, isFetched, isOutline, pivot, pivotOK, redoEdit, refresh, release, removeDataDirectorListener, reorder, revalidate, setAutoSubmit, setDataMap, setManualUpdate, setMetadataMap, setOutline, setValue, startGroupEdit, submitChanges, undoEdit, update

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface oracle.dss.util.DataDirector

addDataDirectorListener, cancel, changeEdgeCurrentHPos, changeEdgeCurrentSlice, deleteMemberCalc, deleteValueCalc, drill, drill, drillOK, drillOK, getDataMap, getMetadataMap, getSupportedDataMap, getSupportedLayerMetadataMap, getSupportedMetadataMap, insertMemberCalc, insertValueCalc, isCancelable, isOutline, pivot, pivotOK, refresh, removeDataDirectorListener, reorder, revalidate, setDataMap, setManualUpdate, setMetadataMap, setOutline, update

Methods inherited from interface oracle.dss.util.persistence.Persistable

getPersistableAttributes, getPersistableComponents, initialize, setPersistableAttributes, setPersistableComponents

Methods inherited from interface oracle.dss.util.persistence.StringXMLizable

getXMLAsString, setXMLAsString

Field Detail

CACHED_DATA

public static final java.lang.String CACHED_DATA

Constructor Detail

RelationalCachedDataSource

public RelationalCachedDataSource()

Constructor

Method Detail

createCachedDataSource

public static RelationalCachedDataSource createCachedDataSource(DataAccess da,
DataDirector dd)

Creates an instance of RelationalCachedDataSource from existing DataAccess and DataDirector

Parameters:

1 - source DataAccess

2 - source DataDirector

Returns:

instance of RelationalCachedDataSource containing copied data

getValueQDR

public QDR getValueQDR(int row,
                       int column,
                       int flags)
                throws RowOutOfRangeException,
ColumnOutOfRangeException

Description copied from class: DataAccessAdapter

Retrieves a QDR object that represents the value at the specified row and column in the data area of the cursor.

Overrides:

getValueQDR in class DataAccessAdapter

Throws:

RowOutOfRangeException - if an error occurs.

ColumnOutOfRangeException - if an error occurs.

See Also:

DataAccess.getValueQDR(int, int, int)

getSliceQDR

public QDR getSliceQDR(int edge,
                       int slice,
                       int flags)
                throws EdgeOutOfRangeException,
SliceOutOfRangeException

Description copied from class: DataAccessAdapter

Retrieves a QDR object that represents the data value at the specified slice on the edge (that is, across all relevant logical layers of the slice).

Overrides:

getSliceQDR in class DataAccessAdapter

Throws:

EdgeOutOfRangeException - if an error occurs.

SliceOutOfRangeException - if an error occurs.

See Also:

DataAccess.getSliceQDR(int, int, int)

getMemberQDR

public QDR getMemberQDR(int edge,
                        int layer,
                        int slice,
                        int flags)
                 throws EdgeOutOfRangeException,
LayerOutOfRangeException,
SliceOutOfRangeException

Description copied from class: DataAccessAdapter

Retrieves a QDR object that represents the data value for the member at the specified edge, layer, and slice.

Overrides:

getMemberQDR in class DataAccessAdapter

Throws:

EdgeOutOfRangeException - if an error occurs.

LayerOutOfRangeException - if an error occurs.

SliceOutOfRangeException - if an error occurs.

See Also:

DataAccess.getMemberQDR(int, int, int, int)

getMemberQDR

public QDR getMemberQDR(int edge,
                        int[] hPos,
                        int memberLayer,
                        int flags)
                 throws EdgeOutOfRangeException,
LayerOutOfRangeException,
SliceOutOfRangeException

Description copied from class: DataAccessAdapter

Retrieves a QDR object that represents the specified member using hierarchical addressing.

Overrides:

getMemberQDR in class DataAccessAdapter

Throws:

EdgeOutOfRangeException - if an error occurs.

LayerOutOfRangeException - if an error occurs.

SliceOutOfRangeException - if an error occurs.

See Also:

DataAccess.getMemberQDR(int, int, int, int)

getLayerQDR

public QDR getLayerQDR(int edge,
                       int layer,
                       int flags)
                throws EdgeOutOfRangeException,
LayerOutOfRangeException

Description copied from class: DataAccessAdapter

Retrieves the QDR object that represents the specified logical layer.

Overrides:

getLayerQDR in class DataAccessAdapter

Throws:

EdgeOutOfRangeException - if an error occurs.

LayerOutOfRangeException - if an error occurs.

See Also:

DataAccess.getLayerQDR(int, int, int)

createRelationalDataDirector

public RelationalDataDirector createRelationalDataDirector()

Description copied from interface: DataSource

Creates a DataDirector for relational views.

Overrides:

createRelationalDataDirector in class BaseCachedDataSource

Following copied from interface: oracle.dss.util.DataSource

Returns:

An implementation of the RelationalDataDirector interface.