mondrian.rolap

Class MemberNoCacheHelper

java.lang.Object

mondrian.rolap.MemberCacheHelper

mondrian.rolap.MemberNoCacheHelper

public class MemberNoCacheHelper
extends MemberCacheHelper

Encapsulation of member caching for no caching.

Version:

1.0

Author:

Luis F. Canals (lcanals@tasecurity.net)

Constructor Summary

Constructors

Constructor and Description
MemberNoCacheHelper()

Method Summary

Modifier and Type	Method and Description
void	checkCacheStatus()
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(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 in favor of MemberCacheHelper.putChildren(RolapLevel, TupleConstraint, List)
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 mondrian.rolap.MemberCacheHelper

flushCache, putChildren

Methods inherited from class java.lang.Object

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

Constructor Detail

MemberNoCacheHelper

public MemberNoCacheHelper()

Method Detail

getMember

public RolapMember getMember(Object key,
                             boolean mustCheckCacheStatus)

Retrieves the RolapMember with a given key.

Overrides:

getMember in class MemberCacheHelper

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.

Overrides:

putMember in class MemberCacheHelper

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.

Overrides:

makeKey in class MemberCacheHelper

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.

Overrides:

getMember in class MemberCacheHelper

Parameters:

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

Returns:

member with a given cache key

checkCacheStatus

public void checkCacheStatus()

Overrides:

checkCacheStatus in class MemberCacheHelper

putLevelMembersInCache

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

Description copied from class: MemberCacheHelper

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

Overrides:

putLevelMembersInCache in class MemberCacheHelper

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.

Overrides:

getChildrenFromCache in class MemberCacheHelper

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).

Overrides:

putChildren in class MemberCacheHelper

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.

Overrides:

getLevelMembersFromCache in class MemberCacheHelper

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

getChangeListener

public DataSourceChangeListener getChangeListener()

Overrides:

getChangeListener in class MemberCacheHelper

setChangeListener

public void setChangeListener(DataSourceChangeListener listener)

Overrides:

setChangeListener in class MemberCacheHelper

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

Overrides:

isMutable in class MemberCacheHelper

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().

Overrides:

removeMember in class MemberCacheHelper

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().

Overrides:

removeMemberAndDescendants in class MemberCacheHelper

Parameters:

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

Returns:

previous member with that key, or null