mondrian.rolap

Class MemberCacheHelper

java.lang.Object

mondrian.rolap.MemberCacheHelper

Direct Known Subclasses:

MemberNoCacheHelper

public class MemberCacheHelper
extends Object

Encapsulation of member caching.

Author:

Will Gorman

Constructor Summary

Constructors

Constructor and Description
MemberCacheHelper(RolapHierarchy rolapHierarchy) Creates a MemberCacheHelper.

Method Summary

Modifier and Type	Method and Description
void	checkCacheStatus()
void	flushCache()
DataSourceChangeListener	getChangeListener()
List<RolapMember>	getChildrenFromCache(RolapMember member, MemberChildrenConstraint constraint) Returns the children of member if they are currently in the cache, otherwise returns null.
List<RolapMember>	getLevelMembersFromCache(RolapLevel level, TupleConstraint constraint) Returns the members of level if they are currently in the cache, otherwise returns null.
RolapMember	getMember(Object key) Retrieves the RolapMember with a given key.
RolapMember	getMember(Object key, boolean mustCheckCacheStatus) Retrieves the RolapMember with a given key.
boolean	isMutable() Returns whether the cache supports removing selected items.
Object	makeKey(RolapMember parent, Object key) Creates a key with which to getMember(Object) or putMember(Object, RolapMember) the RolapMember with a given parent and key.
void	putChildren(RolapLevel level, TupleConstraint constraint, List<RolapMember> members) Registers that the children of level are children (a list of RolapMembers).
void	putChildren(RolapMember member, MemberChildrenConstraint constraint, List<RolapMember> children) Registers that the children of member are children (a list of RolapMembers).
void	putLevelMembersInCache(RolapLevel level, TupleConstraint constraint, List<RolapMember> members) Deprecated.
Object	putMember(Object key, RolapMember value) Replaces the RolapMember with a given key and returns the previous member if any.
RolapMember	removeMember(Object key) Removes the RolapMember with a given key from the cache.
RolapMember	removeMemberAndDescendants(Object key) Removes the designated RolapMember and all its descendants.
void	setChangeListener(DataSourceChangeListener listener)

Methods inherited from class java.lang.Object

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

Constructor Detail

MemberCacheHelper

public MemberCacheHelper(RolapHierarchy rolapHierarchy)

Creates a MemberCacheHelper.

Parameters:

rolapHierarchy - Hierarchy

Method Detail

getMember

public RolapMember getMember(Object key,
                             boolean mustCheckCacheStatus)

Retrieves the RolapMember with a given key.

Parameters:

key - cache key, created by makeKey(mondrian.rolap.RolapMember, java.lang.Object)

mustCheckCacheStatus - If true, do not check cache status

Returns:

member with a given cache key

putMember

public Object putMember(Object key,
                        RolapMember value)

Replaces the RolapMember with a given key and returns the previous member if any.

Parameters:

key - cache key, created by makeKey(mondrian.rolap.RolapMember, java.lang.Object)

value - new member

Returns:

Previous member with that key, or null.

makeKey

public Object makeKey(RolapMember parent,
                      Object key)

Creates a key with which to getMember(Object) or putMember(Object, RolapMember) the RolapMember with a given parent and key.

Parameters:

parent - Parent member

key - Key of member within parent

Returns:

key with which to address this member in the cache

getMember

public RolapMember getMember(Object key)

Retrieves the RolapMember with a given key.

Parameters:

key - cache key, created by makeKey(mondrian.rolap.RolapMember, java.lang.Object)

Returns:

member with a given cache key

checkCacheStatus

public void checkCacheStatus()

putLevelMembersInCache

@Deprecated
public void putLevelMembersInCache(RolapLevel level,
                                               TupleConstraint constraint,
                                               List<RolapMember> members)

Deprecated.

Deprecated in favor of putChildren(RolapLevel, TupleConstraint, List)

putChildren

public void putChildren(RolapLevel level,
                        TupleConstraint constraint,
                        List<RolapMember> members)

Registers that the children of level are children (a list of RolapMembers).

Parameters:

level - the parent level

constraint - the condition that was used when the members were fetched. May be null for all members (no constraint)

members - list of children

getChildrenFromCache

public List<RolapMember> getChildrenFromCache(RolapMember member,
                                              MemberChildrenConstraint constraint)

Returns the children of member if they are currently in the cache, otherwise returns null.

The children may be garbage collected as soon as the returned list may be garbage collected.

Parameters:

member - the parent member

constraint - the condition that was used when the members were fetched. May be null for all members (no constraint)

Returns:

list of children, or null if not in cache

putChildren

public void putChildren(RolapMember member,
                        MemberChildrenConstraint constraint,
                        List<RolapMember> children)

Registers that the children of member are children (a list of RolapMembers).

Parameters:

member - the parent member

constraint - the condition that was used when the members were fetched. May be null for all members (no constraint)

children - list of children

getLevelMembersFromCache

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

Returns the members of level if they are currently in the cache, otherwise returns null.

The members may be garbage collected as soon as the returned list may be garbage collected.

Parameters:

level - the level whose members should be fetched

constraint - the condition that was used when the members were fetched. May be null for all members (no constraint)

Returns:

members of level, or null if not in cache

flushCache

public void flushCache()

getChangeListener

public DataSourceChangeListener getChangeListener()

setChangeListener

public void setChangeListener(DataSourceChangeListener listener)

isMutable

public boolean isMutable()

Returns whether the cache supports removing selected items. If it does, it is valid to call the removeMember(Object) and removeMemberAndDescendants(Object) methods.

REVIEW: remove isMutable and move removeMember and removeMemberAndDescendants to new interface MutableMemberCache

Returns:

true if the cache supports removing selected items.

removeMember

public RolapMember removeMember(Object key)

Removes the RolapMember with a given key from the cache. Returns the previous member with that key, or null. Optional operation: see isMutable().

Parameters:

key - cache key, created by makeKey(mondrian.rolap.RolapMember, java.lang.Object)

Returns:

previous member with that key, or null

removeMemberAndDescendants

public RolapMember removeMemberAndDescendants(Object key)

Removes the designated RolapMember and all its descendants. Returns the previous member with that key, or null. Optional operation: see isMutable().

Parameters:

key - cache key, created by makeKey(mondrian.rolap.RolapMember, java.lang.Object)

Returns:

previous member with that key, or null