Package mondrian.rolap

Class RestrictedMemberReader

java.lang.Object

mondrian.rolap.DelegatingMemberReader

mondrian.rolap.RestrictedMemberReader

All Implemented Interfaces:

MemberReader, MemberSource

Direct Known Subclasses:

SmartRestrictedMemberReader

class RestrictedMemberReader
extends DelegatingMemberReader

A RestrictedMemberReader reads only the members of a hierarchy allowed by a role's access profile.

Since:

Feb 26, 2003

Author:

jhyde

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	RestrictedMemberReader.MultiCardinalityDefaultMember	This is a special subclass of DelegatingRolapMember.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) Role	role

Fields inherited from class mondrian.rolap.DelegatingMemberReader

memberReader

Constructor Summary

Constructors

Constructor	Description
RestrictedMemberReader(MemberReader memberReader, Role role)	Creates a RestrictedMemberReader.

Method Summary

Modifier and Type	Method	Description
RolapMember	getDefaultMember()
RolapMember	getLeadMember(RolapMember member, int n)	Returns the member n after member in the same level (or before, if n is negative).
void	getMemberChildren(List<RolapMember> parentMembers, List<RolapMember> children)	Returns all members which are a child of one of the members in parentMembers, sorted by ordinal.
Map<? extends Member,Access>	getMemberChildren(List<RolapMember> parentMembers, List<RolapMember> children, MemberChildrenConstraint constraint)	Populates a list of the children of a given set of Members, optionally applying a constraint.
void	getMemberChildren(RolapMember parentMember, List<RolapMember> children)	Writes all children parentMember to children.
Map<? extends Member,Access>	getMemberChildren(RolapMember parentMember, List<RolapMember> children, MemberChildrenConstraint constraint)	Populates a list of the children of a Member, optionally applying a constraint.
RolapMember	getMemberParent(RolapMember member)
List<RolapMember>	getMembersInLevel(RolapLevel level)	Returns all of the members in level whose ordinal lies between startOrdinal and endOrdinal.
List<RolapMember>	getMembersInLevel(RolapLevel level, TupleConstraint constraint)	Returns the members in the given Level, optionally applying a constraint.
List<RolapMember>	getRootMembers()	Returns all members of this hierarchy which do not have a parent, sorted by ordinal.
boolean	setCache(MemberCache cache)	Sets the cache which this MemberSource will write to.

Methods inherited from class mondrian.rolap.DelegatingMemberReader

compare, desubstitute, getHierarchy, getLevelMemberCount, getMemberBuilder, getMemberByKey, getMemberCount, getMemberRange, getMembers, lookupMember, substitute

Methods inherited from class java.lang.Object

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

Field Detail

role

final Role role

Constructor Detail

RestrictedMemberReader

RestrictedMemberReader(MemberReader memberReader,
                       Role role)

Creates a RestrictedMemberReader.

There's no filtering to be done unless either the role has restrictions on this hierarchy, or the hierarchy is ragged; there's a pre-condition to this effect.

Parameters:

memberReader - Underlying (presumably unrestricted) member reader

role - Role whose access profile to obey. The role must have restrictions on this hierarchy

Pre-condition:

role.getAccessDetails(memberReader.getHierarchy()) != null || memberReader.getHierarchy().isRagged()

Method Detail

setCache

public boolean setCache(MemberCache cache)

Description copied from interface: MemberSource

Sets the cache which this MemberSource will write to.

Cache-writeback is optional (for example, SqlMemberSource supports it, and ArrayMemberSource does not), and the return value from this method indicates whether this object supports it.

If this method returns true, the MemberSource.getMembers(), MemberSource.getRootMembers() and MemberSource.getMemberChildren(mondrian.rolap.RolapMember, java.util.List<mondrian.rolap.RolapMember>) methods must write to the cache, in addition to returning members as a return value.

Specified by:

setCache in interface MemberSource

Overrides:

setCache in class DelegatingMemberReader

Parameters:

cache - The MemberCache which the caller would like this MemberSource to write to.

Returns:

Whether this MemberSource supports cache-writeback.

getLeadMember

public RolapMember getLeadMember(RolapMember member,
                                 int n)

Description copied from interface: MemberReader

Returns the member n after member in the same level (or before, if n is negative). Returns Hierarchy.getNullMember() if we run off the beginning or end of the level.

Specified by:

getLeadMember in interface MemberReader

Overrides:

getLeadMember in class DelegatingMemberReader

getMemberChildren

public void getMemberChildren(RolapMember parentMember,
                              List<RolapMember> children)

Description copied from interface: MemberSource

Writes all children parentMember to children.

If this object supports cache-writeback, also writes these members to the cache.

Specified by:

getMemberChildren in interface MemberSource

Overrides:

getMemberChildren in class DelegatingMemberReader

getMemberChildren

public Map<? extends Member,Access> getMemberChildren(RolapMember parentMember,
                                                            List<RolapMember> children,
                                                            MemberChildrenConstraint constraint)

Description copied from interface: MemberReader

Populates a list of the children of a Member, optionally applying a constraint.

Specified by:

getMemberChildren in interface MemberReader

Overrides:

getMemberChildren in class DelegatingMemberReader

Parameters:

parentMember - Members whose children to find

children - List to populate with members

constraint - Constraint

Returns:

After populating the list passed as an argument, this method returns a map of the members it just populated along with the Access information applicable. If no access control applies to the member, the map will contain null values.

getMemberChildren

public void getMemberChildren(List<RolapMember> parentMembers,
                              List<RolapMember> children)

Description copied from interface: MemberSource

Returns all members which are a child of one of the members in parentMembers, sorted by ordinal.

If this object supports cache-writeaback, also writes these members to the cache.

Specified by:

getMemberChildren in interface MemberSource

Overrides:

getMemberChildren in class DelegatingMemberReader

getMemberChildren

public Map<? extends Member,Access> getMemberChildren(List<RolapMember> parentMembers,
                                                            List<RolapMember> children,
                                                            MemberChildrenConstraint constraint)

Description copied from interface: MemberReader

Populates a list of the children of a given set of Members, optionally applying a constraint.

Specified by:

getMemberChildren in interface MemberReader

Overrides:

getMemberChildren in class DelegatingMemberReader

Parameters:

parentMembers - List of members whose children to find

children - List to populate with members

constraint - Constraint

Returns:

After populating the list passed as an argument, this method returns a map of the members it just populated along with the Access information applicable. If no access control applies to the member, the map will contain null values.

getRootMembers

public List<RolapMember> getRootMembers()

Description copied from interface: MemberSource

Returns all members of this hierarchy which do not have a parent, sorted by ordinal.

If this object supports cache-writeback, also writes these members to the cache.

Specified by:

getRootMembers in interface MemberSource

Overrides:

getRootMembers in class DelegatingMemberReader

Returns:

List of RolapMembers

getMembersInLevel

public List<RolapMember> getMembersInLevel(RolapLevel level)

Description copied from interface: MemberReader

Returns all of the members in level whose ordinal lies between startOrdinal and endOrdinal.

If this object supports cache-writeback, also writes these members to the cache.

Specified by:

getMembersInLevel in interface MemberReader

Overrides:

getMembersInLevel in class DelegatingMemberReader

Returns:

List of RolapMember

getMembersInLevel

public List<RolapMember> getMembersInLevel(RolapLevel level,
                                           TupleConstraint constraint)

Description copied from interface: MemberReader

Returns the members in the given Level, optionally applying a constraint.

Specified by:

getMembersInLevel in interface MemberReader

Overrides:

getMembersInLevel in class DelegatingMemberReader

Parameters:

level - Level

constraint - Constraint

Returns:

list of members

getDefaultMember

public RolapMember getDefaultMember()

Specified by:

getDefaultMember in interface MemberReader

Overrides:

getDefaultMember in class DelegatingMemberReader

getMemberParent

public RolapMember getMemberParent(RolapMember member)

Specified by:

getMemberParent in interface MemberReader

Overrides:

getMemberParent in class DelegatingMemberReader