oracle.dss.util.datacache
Class CachedDataSource

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

All Implemented Interfaces:

CubeDataDirector, DataDirector, DataSource, Persistable, StringXMLizable

public class CachedDataSource

extends BaseCachedDataSource

implements CubeDataDirector

Use this class to cache multidimensional (cube) 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:

RelationalCachedDataSource

Field Summary

static java.lang.String	CACHED_DATA
static java.lang.String	EXTENT

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

CachedDataSource()
Constructor

Method Summary

static CachedDataSource	createCachedDataSource(DataAccess da, DataDirector dd) Creates an instance of CachedDataSource from existing DataAccess and DataDirector
CubeDataDirector	createCubeDataDirector() Creates a DataDirector for cube-based (OLAP) 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, createRelationalDataDirector, 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

EXTENT

public static final java.lang.String EXTENT

Constructor Detail

CachedDataSource

public CachedDataSource()

Constructor

Method Detail

createCachedDataSource

public static CachedDataSource createCachedDataSource(DataAccess da,
DataDirector dd)

Creates an instance of CachedDataSource from existing DataAccess and DataDirector

Parameters:

1 - source DataAccess

2 - source DataDirector

Returns:

instance of CachedDataSource 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)

createCubeDataDirector

public CubeDataDirector createCubeDataDirector()

Description copied from interface: DataSource

Creates a DataDirector for cube-based (OLAP) views

Overrides:

createCubeDataDirector in class BaseCachedDataSource

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

Returns:

An implementation of the CubeDataDirector interface.