RolapSchema (Pentaho Community Edition Project: mondrian 8.3.0.1-377 API)

java.lang.Object
- mondrian.rolap.RolapSchema

All Implemented Interfaces:

Annotated, Schema
```
public class RolapSchema
extends Object
implements Schema
```
A RolapSchema is a collection of RolapCubes and shared RolapDimensions. It is shared betweeen RolapConnections. It caches MemberReaders, etc.

Since:

26 July, 2001

Author:

jhyde

See Also:

RolapConnection

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

class RolapSchema.RolapStarRegistry
RolapStarRegistry is a registry for RolapStars.

Nested Classes
Modifier and Type	Class and Description
`class`	`RolapSchema.RolapStarRegistry` `RolapStarRegistry` is a registry for `RolapStar`s.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`protected void`	`addCube(RolapCube cube)` Adds a cube to the cube name map.
`static boolean`	`cacheContains(RolapSchema rolapSchema)`
`Cube`	`createCube(String xml)` Creates a cube by parsing an XML string.
`Dimension`	`createDimension(Cube cube, String xml)` Creates a dimension in the given cube by parsing an XML string.
`boolean`	`equals(Object o)`
`protected void`	`finalCleanUp()` Performs a sweep of the JDBC tables caches and the segment data.
`protected void`	`finalize()`
`protected void`	`flushJdbcSchema()` Clears the cache of JDBC tables for the aggs.
`protected void`	`flushSegments()`
`Map<String,Annotation>`	`getAnnotationMap()` Returns a list of annotations.
`ByteString`	`getChecksum()` Returns the checksum of this schema.
`List<RolapCube>`	`getCubeList()`
`Cube[]`	`getCubes()` Returns a list of all cubes in this schema.
`List<RolapCube>`	`getCubesWithStar(RolapStar star)`
`DataSourceChangeListener`	`getDataSourceChangeListener()`
`Role`	`getDefaultRole()`
`Dialect`	`getDialect()` Returns this schema's SQL dialect.
`FunTable`	`getFunTable()` Returns this schema's function table.
`String`	`getId()` Returns this schema instance unique ID.
`RolapConnection`	`getInternalConnection()` Connection for purposes of parsing and validation.
`SchemaKey`	`getKey()` Returns this schema instance unique key.
`protected org.apache.log4j.Logger`	`getLogger()`
`String`	`getName()` Returns the name of this schema.
`NamedSet`	`getNamedSet(org.olap4j.mdx.IdentifierSegment segment)`
`NamedSet`	`getNamedSet(String name)`
`Parameter[]`	`getParameters()` Returns this schema's parameters.
`static List<RolapSchema>`	`getRolapSchemas()`
`RolapSchema.RolapStarRegistry`	`getRolapStarRegistry()`
`Date`	`getSchemaLoadDate()` Returns when this schema was last loaded.
`SchemaReader`	`getSchemaReader()` Creates a `SchemaReader` without any access control.
`Hierarchy[]`	`getSharedHierarchies()` Returns a list of shared dimensions in this schema.
`RolapStar`	`getStar(List<String> starKey)`
`RolapStar`	`getStar(String factTableName)`
`Collection<RolapStar>`	`getStars()`
`List<Exception>`	`getWarnings()` Returns a list of warnings and errors that occurred while loading this schema.
`MondrianDef.Schema`	`getXMLSchema()`
`int`	`hashCode()`
`protected void`	`load(String catalogUrl, String catalogStr)` Deprecated. API changed to also pass Mondrian connection properties
`protected void`	`load(String catalogUrl, String catalogStr, Util.PropertyList connectInfo)` Method called by all constructors to load the catalog into DOM and build application mdx and sql objects.
`protected RolapCube`	`lookupCube(String cubeName)` Finds a cube called 'cube' in the current catalog, or return null if no cube exists.
`Cube`	`lookupCube(String cube, boolean failIfNotFound)` Finds a cube called `cube` in this schema; if no cube exists, `failIfNotFound` controls whether to raise an error or return `null`.
`Role`	`lookupRole(String role)` Finds a role with a given name in the current catalog, or returns `null` if no such role exists.
`protected MondrianDef.CalculatedMember`	`lookupXmlCalculatedMember(String calcMemberName, String cubeName)` Returns an xmlCalculatedMember called 'calcMemberName' in the cube called 'cubeName' or return null if no calculatedMember or xmlCube by those name exists.
`boolean`	`removeCube(String cubeName)` Removes a cube.
`Set<String>`	`roleNames()`
`void`	`setDataSourceChangeListener(DataSourceChangeListener dataSourceChangeListener)`

Methods inherited from class java.lang.Object
clone, getClass, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - flushSegments
```
protected void flushSegments()
```
  - flushJdbcSchema
```
protected void flushJdbcSchema()
```
    Clears the cache of JDBC tables for the aggs.
  - finalCleanUp
```
protected void finalCleanUp()
```
    Performs a sweep of the JDBC tables caches and the segment data. Only called internally when a schema and it's data must be refreshed.
  - finalize
```
protected void finalize()
                 throws Throwable
```
    Overrides:
    
    finalize in class Object
    
    Throws:
    
    Throwable
  - equals
```
public boolean equals(Object o)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - getLogger
```
protected org.apache.log4j.Logger getLogger()
```
  - load
```
@Deprecated
protected void load(String catalogUrl,
                                String catalogStr)
```
    Deprecated. API changed to also pass Mondrian connection properties
    
    Parameters:
    
    catalogUrl - URL of catalog
    
    catalogStr - Text of catalog, or null
  - load
```
protected void load(String catalogUrl,
                    String catalogStr,
                    Util.PropertyList connectInfo)
```
    Method called by all constructors to load the catalog into DOM and build application mdx and sql objects.
    
    Parameters:
    
    catalogUrl - URL of catalog
    
    catalogStr - Text of catalog, or null
    
    connectInfo - Mondrian connection properties
  - getSchemaLoadDate
```
public Date getSchemaLoadDate()
```
    Description copied from interface: Schema
    
    Returns when this schema was last loaded.
    
    Specified by:
    
    getSchemaLoadDate in interface Schema
    
    Returns:
    
    Date and time when this schema was last loaded
  - getWarnings
```
public List<Exception> getWarnings()
```
    Description copied from interface: Schema
    
    Returns a list of warnings and errors that occurred while loading this schema.
    
    Specified by:
    
    getWarnings in interface Schema
    
    Returns:
    
    list of warnings
  - getDefaultRole
```
public Role getDefaultRole()
```
  - getXMLSchema
```
public MondrianDef.Schema getXMLSchema()
```
  - getName
```
public String getName()
```
    Description copied from interface: Schema
    
    Returns the name of this schema.
    
    Specified by:
    
    getName in interface Schema
  - getId
```
public String getId()
```
    Returns this schema instance unique ID.
    
    Specified by:
    
    getId in interface Schema
    
    Returns:
    
    A string representing the schema ID.
  - getKey
```
public SchemaKey getKey()
```
    Returns this schema instance unique key.
    
    Returns:
    
    a SchemaKey.
  - getAnnotationMap
```
public Map<String,Annotation> getAnnotationMap()
```
    Description copied from interface: Annotated
    
    Returns a list of annotations.
    The map may be empty, never null.
    
    Specified by:
    
    getAnnotationMap in interface Annotated
    
    Returns:
    
    Map from annotation name to annotations.
  - getDialect
```
public Dialect getDialect()
```
    Returns this schema's SQL dialect.
    NOTE: This method is not cheap. The implementation gets a connection from the connection pool.
    
    Returns:
    
    dialect
  - createDimension
```
public Dimension createDimension(Cube cube,
                                 String xml)
```
    Description copied from interface: Schema
    
    Creates a dimension in the given cube by parsing an XML string. The XML string must be either a <Dimension> or a <DimensionUsage>. Returns the dimension created.
    
    Specified by:
    
    createDimension in interface Schema
  - createCube
```
public Cube createCube(String xml)
```
    Description copied from interface: Schema
    
    Creates a cube by parsing an XML string. Returns the cube created.
    
    Specified by:
    
    createCube in interface Schema
  - getRolapSchemas
```
public static List<RolapSchema> getRolapSchemas()
```
  - cacheContains
```
public static boolean cacheContains(RolapSchema rolapSchema)
```
  - lookupCube
```
public Cube lookupCube(String cube,
                       boolean failIfNotFound)
```
    Description copied from interface: Schema
    
    Finds a cube called cube in this schema; if no cube exists, failIfNotFound controls whether to raise an error or return null.
    
    Specified by:
    
    lookupCube in interface Schema
  - lookupCube
```
protected RolapCube lookupCube(String cubeName)
```
    Finds a cube called 'cube' in the current catalog, or return null if no cube exists.
  - lookupXmlCalculatedMember
```
protected MondrianDef.CalculatedMember lookupXmlCalculatedMember(String calcMemberName,
                                                                 String cubeName)
```
    Returns an xmlCalculatedMember called 'calcMemberName' in the cube called 'cubeName' or return null if no calculatedMember or xmlCube by those name exists.
  - getCubesWithStar
```
public List<RolapCube> getCubesWithStar(RolapStar star)
```
  - addCube
```
protected void addCube(RolapCube cube)
```
    Adds a cube to the cube name map.
    
    See Also:
    
    lookupCube(String)
  - removeCube
```
public boolean removeCube(String cubeName)
```
    Description copied from interface: Schema
    
    Removes a cube.
    
    Specified by:
    
    removeCube in interface Schema
    
    Returns:
    
    Whether cube was removed
  - getCubes
```
public Cube[] getCubes()
```
    Description copied from interface: Schema
    
    Returns a list of all cubes in this schema.
    
    Specified by:
    
    getCubes in interface Schema
  - getCubeList
```
public List<RolapCube> getCubeList()
```
  - getSharedHierarchies
```
public Hierarchy[] getSharedHierarchies()
```
    Description copied from interface: Schema
    
    Returns a list of shared dimensions in this schema.
    
    Specified by:
    
    getSharedHierarchies in interface Schema
  - getNamedSet
```
public NamedSet getNamedSet(String name)
```
  - getNamedSet
```
public NamedSet getNamedSet(org.olap4j.mdx.IdentifierSegment segment)
```
  - lookupRole
```
public Role lookupRole(String role)
```
    Description copied from interface: Schema
    
    Finds a role with a given name in the current catalog, or returns null if no such role exists.
    
    Specified by:
    
    lookupRole in interface Schema
  - roleNames
```
public Set<String> roleNames()
```
  - getFunTable
```
public FunTable getFunTable()
```
    Description copied from interface: Schema
    
    Returns this schema's function table.
    
    Specified by:
    
    getFunTable in interface Schema
  - getParameters
```
public Parameter[] getParameters()
```
    Description copied from interface: Schema
    
    Returns this schema's parameters.
    
    Specified by:
    
    getParameters in interface Schema
  - getSchemaReader
```
public SchemaReader getSchemaReader()
```
    Description copied from interface: Schema
    
    Creates a SchemaReader without any access control.
    
    Specified by:
    
    getSchemaReader in interface Schema
  - getChecksum
```
public ByteString getChecksum()
```
    Returns the checksum of this schema. Returns null if RolapConnectionProperties.UseContentChecksum is set to false.
    
    Returns:
    
    MD5 checksum of this schema
  - getInternalConnection
```
public RolapConnection getInternalConnection()
```
    Connection for purposes of parsing and validation. Careful! It won't have the correct locale or access-control profile.
  - getRolapStarRegistry
```
public RolapSchema.RolapStarRegistry getRolapStarRegistry()
```
  - getStar
```
public RolapStar getStar(String factTableName)
```
  - getStar
```
public RolapStar getStar(List<String> starKey)
```
  - getStars
```
public Collection<RolapStar> getStars()
```
  - getDataSourceChangeListener
```
public DataSourceChangeListener getDataSourceChangeListener()
```
    Returns:
    
    Returns the dataSourceChangeListener.
  - setDataSourceChangeListener
```
public void setDataSourceChangeListener(DataSourceChangeListener dataSourceChangeListener)
```
    Parameters:
    
    dataSourceChangeListener - The dataSourceChangeListener to set.

Class RolapSchema

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

flushSegments

flushJdbcSchema

finalCleanUp

finalize

equals

hashCode

getLogger

load

load

getSchemaLoadDate

getWarnings

getDefaultRole

getXMLSchema

getName

getId

getKey

getAnnotationMap

getDialect

createDimension

createCube

getRolapSchemas

cacheContains

lookupCube

lookupCube

lookupXmlCalculatedMember

getCubesWithStar

addCube

removeCube

getCubes

getCubeList

getSharedHierarchies

getNamedSet

getNamedSet

lookupRole

roleNames

getFunTable

getParameters

getSchemaReader

getChecksum

getInternalConnection

getRolapStarRegistry

getStar

getStar

getStars

getDataSourceChangeListener

setDataSourceChangeListener