mondrian.olap
Interface SchemaReader

All Known Subinterfaces:

RolapNativeSet.SchemaReaderWithMemberReaderAvailable

All Known Implementing Classes:

DelegatingSchemaReader, RolapSchemaReader

public interface SchemaReader

A SchemaReader queries schema objects (Schema, Cube, Dimension, Hierarchy, Level, Member).

It is generally created using Connection.getSchemaReader().

Since:

Feb 24, 2003

Author:

jhyde

Method Summary

int	compareMembersHierarchically(Member m1, Member m2) Compares a pair of Members according to their order in a prefix traversal.
Member	getCalculatedMember(List<Id.Segment> nameParts) Looks up a calculated member by name.
List<Member>	getCalculatedMembers() Returns the list of calculated members.
List<Member>	getCalculatedMembers(Hierarchy hierarchy) Returns a list of calculated members in a given hierarchy.
List<Member>	getCalculatedMembers(Level level) Returns a list of calculated members in a given level.
int	getChildrenCountFromCache(Member member) Returns number of children parent of a member, if the information can be retrieved from cache.
Cube[]	getCubes() Returns the list of accessible cubes.
DataSource	getDataSource()
OlapElement	getElementChild(OlapElement parent, Id.Segment name)
OlapElement	getElementChild(OlapElement parent, Id.Segment name, MatchType matchType) Looks up the child of parent called s; returns null if no element is found.
Member	getHierarchyDefaultMember(Hierarchy hierarchy) Returns the default member of a hierarchy.
Level[]	getHierarchyLevels(Hierarchy hierarchy) Returns the accessible levels of a hierarchy.
Member[]	getHierarchyRootMembers(Hierarchy hierarchy) Returns an array of the root members of hierarchy.
Member	getLeadMember(Member member, int n) Returns a member n further along in the same level from member.
int	getLevelCardinality(Level level, boolean approximate, boolean materialize) Returns the number of members in a level, returning an approximation if acceptable.
Member[]	getLevelMembers(Level level, boolean includeCalculated) Returns the members of a level, optionally including calculated members.
Member[]	getLevelMembers(Level level, Evaluator context) Returns the members of a level, optionally filtering out members which are empty.
Member	getMemberByUniqueName(List<Id.Segment> uniqueNameParts, boolean failIfNotFound) Finds a member based upon its unique name, requiring an exact match.
Member	getMemberByUniqueName(List<Id.Segment> uniqueNameParts, boolean failIfNotFound, MatchType matchType) Finds a member based upon its unique name.
Member[]	getMemberChildren(Member member) Returns direct children of member.
Member[]	getMemberChildren(Member[] members) Returns direct children of each element of members.
Member[]	getMemberChildren(Member[] members, Evaluator context) Returns direct children of each element of members which is not empty in context.
Member[]	getMemberChildren(Member member, Evaluator context) Returns direct children of member, optimized for NON EMPTY.
int	getMemberDepth(Member member) Returns the depth of a member.
Member	getMemberParent(Member member) Returns the parent of member.
void	getMemberRange(Level level, Member startMember, Member endMember, List<Member> list) Appends to list all members between startMember and endMember (inclusive) which belong to level.
NamedSet	getNamedSet(List<Id.Segment> nameParts) Looks up a set by name.
NativeEvaluator	getNativeSetEvaluator(FunDef fun, Exp[] args, Evaluator evaluator, Calc calc) Returns an object which can evaluate an expression in native SQL, or null if this is not possible.
Parameter	getParameter(String name) Returns the definition of a parameter with a given name, or null if not found.
Role	getRole() Returns the access-control profile that this SchemaReader is implementing.
boolean	isDrillable(Member member) Returns whether a member has visible children.
boolean	isVisible(Member member) Returns whether a member is visible.
OlapElement	lookupCompound(OlapElement parent, List<Id.Segment> names, boolean failIfNotFound, int category) Looks up an MDX object by name.
OlapElement	lookupCompound(OlapElement parent, List<Id.Segment> names, boolean failIfNotFound, int category, MatchType matchType) Looks up an MDX object by name, specifying how to match if no object exactly matches the name.
Member	lookupMemberChildByName(Member parent, Id.Segment childName)
Member	lookupMemberChildByName(Member parent, Id.Segment childName, MatchType matchType) Finds a child of a member with a given name.
Member	substitute(Member member) Substitutes a member with an equivalent member which enforces the access control policy of this SchemaReader.

Method Detail

getRole

Role getRole()

Returns the access-control profile that this SchemaReader is implementing.

getHierarchyRootMembers

Member[] getHierarchyRootMembers(Hierarchy hierarchy)

Returns an array of the root members of hierarchy.

Parameters:

hierarchy - Hierarchy

See Also:

getCalculatedMembers(Hierarchy)

getChildrenCountFromCache

int getChildrenCountFromCache(Member member)

Returns number of children parent of a member, if the information can be retrieved from cache. Otherwise -1 is returned

getLevelCardinality

int getLevelCardinality(Level level,
                        boolean approximate,
                        boolean materialize)

Returns the number of members in a level, returning an approximation if acceptable.

Parameters:

level - Level

approximate - Whether an approximation is acceptable

materialize - Whether to go to disk if no approximation for the count is available and the members are not in cache. If false, returns Integer.MIN_VALUE if value is not in cache.

substitute

Member substitute(Member member)

Substitutes a member with an equivalent member which enforces the access control policy of this SchemaReader.

getMemberChildren

Member[] getMemberChildren(Member member)

Returns direct children of member.

Pre-condition:

member != null

Post-condition:

return != null

getMemberChildren

Member[] getMemberChildren(Member member,
                           Evaluator context)

Returns direct children of member, optimized for NON EMPTY.

If context == null then there is no context and all members are returned - then its identical to getMemberChildren(Member). If context is not null, the resulting members may be restricted to those members that have a non empty row in the fact table for context. Wether or not optimization is possible depends on the SchemaReader implementation.

getMemberChildren

Member[] getMemberChildren(Member[] members)

Returns direct children of each element of members.

Pre-condition:

members != null

Post-condition:

return != null

Parameters:

members - Array of members

Returns:

array of child members

getMemberChildren

Member[] getMemberChildren(Member[] members,
                           Evaluator context)

Returns direct children of each element of members which is not empty in context.

Pre-condition:

members != null

Post-condition:

return != null

Parameters:

members - Array of members

context - Evaluation context

Returns:

array of child members

getMemberParent

Member getMemberParent(Member member)

Returns the parent of member.

Pre-condition:

member != null

Parameters:

member - Member

Returns:

null if member is a root member

getMemberDepth

int getMemberDepth(Member member)

Returns the depth of a member.

This may not be the same as member.getLevel(). getDepth() for three reasons:

1. Access control. The most senior visible member has level 0. If the client is not allowed to see the "All" and "Nation" levels of the "Store" hierarchy, then members of the "State" level will have depth 0.
2. Parent-child hierarchies. Suppose Fred reports to Wilma, and Wilma reports to no one. "All Employees" has depth 0, Wilma has depth 1, and Fred has depth 2. Fred and Wilma are both in the "Employees" level, which has depth 1.
3. Ragged hierarchies. If Israel has only one, hidden, province then the depth of Tel Aviv, Israel is 2, whereas the depth of another city, San Francisco, CA, USA is 3.

getMemberByUniqueName

Member getMemberByUniqueName(List<Id.Segment> uniqueNameParts,
                             boolean failIfNotFound,
                             MatchType matchType)

Finds a member based upon its unique name.

Parameters:

uniqueNameParts - Unique name of member

failIfNotFound - Whether to throw an error, as opposed to returning null, if there is no such member.

matchType - indicates the match mode; if not specified, EXACT

Returns:

The member, or null if not found

getMemberByUniqueName

Member getMemberByUniqueName(List<Id.Segment> uniqueNameParts,
                             boolean failIfNotFound)

Finds a member based upon its unique name, requiring an exact match.

This method is equivalent to calling getMemberByUniqueName(java.util.List, boolean, MatchType) with MatchType.EXACT.

Parameters:

uniqueNameParts - Unique name of member

failIfNotFound - Whether to throw an error, as opposed to returning null, if there is no such member.

Returns:

The member, or null if not found

lookupCompound

OlapElement lookupCompound(OlapElement parent,
                           List<Id.Segment> names,
                           boolean failIfNotFound,
                           int category,
                           MatchType matchType)

Looks up an MDX object by name, specifying how to match if no object exactly matches the name.

Resolves a name such as '[Products].[Product Department].[Produce]' by resolving the components ('Products', and so forth) one at a time.

Pre-condition:

parent != null

Post-condition:

!(failIfNotFound && return == null)

Parameters:

parent - Parent element to search in

names - Exploded compound name, such as {"Products", "Product Department", "Produce"}

failIfNotFound - If the element is not found, determines whether to return null or throw an error

category - Type of returned element, a Category value; Category.Unknown if it doesn't matter.

matchType - indicates the match mode; if not specified, EXACT

lookupCompound

OlapElement lookupCompound(OlapElement parent,
                           List<Id.Segment> names,
                           boolean failIfNotFound,
                           int category)

Looks up an MDX object by name.

Resolves a name such as '[Products].[Product Department].[Produce]' by resolving the components ('Products', and so forth) one at a time.

Pre-condition:

parent != null

Post-condition:

!(failIfNotFound && return == null)

Parameters:

parent - Parent element to search in

names - Exploded compound name, such as {"Products", "Product Department", "Produce"}

failIfNotFound - If the element is not found, determines whether to return null or throw an error

category - Type of returned element, a Category value; Category.Unknown if it doesn't matter.

getCalculatedMember

Member getCalculatedMember(List<Id.Segment> nameParts)

Looks up a calculated member by name. If the name is not found in the current scope, returns null.

getNamedSet

NamedSet getNamedSet(List<Id.Segment> nameParts)

Looks up a set by name. If the name is not found in the current scope, returns null.

getMemberRange

void getMemberRange(Level level,
                    Member startMember,
                    Member endMember,
                    List<Member> list)

Appends to list all members between startMember and endMember (inclusive) which belong to level.

getLeadMember

Member getLeadMember(Member member,
                     int n)

Returns a member n further along in the same level from member.

Pre-condition:

member != null

compareMembersHierarchically

int compareMembersHierarchically(Member m1,
                                 Member m2)

Compares a pair of Members according to their order in a prefix traversal. (that is, it is an ancestor or a earlier ), is a sibling, or comes later in a prefix traversal.

Returns:

A negative integer if m1 is an ancestor, an earlier sibling of an ancestor, or a descendent of an earlier sibling, of m2; zero if m1 is a sibling of m2; a positive integer if m1 comes later in the prefix traversal then m2.

getElementChild

OlapElement getElementChild(OlapElement parent,
                            Id.Segment name,
                            MatchType matchType)

Looks up the child of parent called s; returns null if no element is found.

getElementChild

OlapElement getElementChild(OlapElement parent,
                            Id.Segment name)

getLevelMembers

Member[] getLevelMembers(Level level,
                         boolean includeCalculated)

Returns the members of a level, optionally including calculated members.

getLevelMembers

Member[] getLevelMembers(Level level,
                         Evaluator context)

Returns the members of a level, optionally filtering out members which are empty.

Parameters:

level - Level

context - Context for filtering

Returns:

Members of this level

getHierarchyLevels

Level[] getHierarchyLevels(Hierarchy hierarchy)

Returns the accessible levels of a hierarchy.

Pre-condition:

hierarchy != null

Post-condition:

return.length >= 1

getHierarchyDefaultMember

Member getHierarchyDefaultMember(Hierarchy hierarchy)

Returns the default member of a hierarchy. If the default member is in an inaccessible level, returns the nearest ascendant/descendant member.

isDrillable

boolean isDrillable(Member member)

Returns whether a member has visible children.

isVisible

boolean isVisible(Member member)

Returns whether a member is visible.

getCubes

Cube[] getCubes()

Returns the list of accessible cubes.

getCalculatedMembers

List<Member> getCalculatedMembers(Hierarchy hierarchy)

Returns a list of calculated members in a given hierarchy.

getCalculatedMembers

List<Member> getCalculatedMembers(Level level)

Returns a list of calculated members in a given level.

getCalculatedMembers

List<Member> getCalculatedMembers()

Returns the list of calculated members.

lookupMemberChildByName

Member lookupMemberChildByName(Member parent,
                               Id.Segment childName,
                               MatchType matchType)

Finds a child of a member with a given name.

lookupMemberChildByName

Member lookupMemberChildByName(Member parent,
                               Id.Segment childName)

getNativeSetEvaluator

NativeEvaluator getNativeSetEvaluator(FunDef fun,
                                      Exp[] args,
                                      Evaluator evaluator,
                                      Calc calc)

Returns an object which can evaluate an expression in native SQL, or null if this is not possible.

Parameters:

fun - Function

args - Arguments to the function

evaluator - Evaluator, provides context

calc -

getParameter

Parameter getParameter(String name)

Returns the definition of a parameter with a given name, or null if not found.

getDataSource

DataSource getDataSource()