org.jasig.portal.groups
Class GroupMemberImpl

java.lang.Object
  org.jasig.portal.groups.GroupMemberImpl

All Implemented Interfaces:

IGroupMember, IBasicEntity

Direct Known Subclasses:

EntityGroupImpl, EntityImpl

public abstract class GroupMemberImpl
extends Object
implements IGroupMember

GroupMemberImpl summary first sentence goes here.

Version:

$Revision: 19776 $

Author:

Dan Ellentuck

See Also:

IGroupMember

Constructor Summary

GroupMemberImpl(EntityIdentifier newEntityIdentifier)
GroupMemberImpl constructor

GroupMemberImpl(String key, Class type)
GroupMemberImpl constructor

Method Summary

void	addGroup(IEntityGroup eg) Adds the key of the IEntityGroup to our Set of group keys by copying the keys, updating the copy, and replacing the old keys with the copy.
protected Set	castAndCopyHashSet(Set s) Cast a Set to a HashSet, clone it, and down cast back to Set.
boolean	contains(IGroupMember gm) Default implementation, overridden on EntityGroupImpl.
boolean	deepContains(IGroupMember gm) Default implementation, overridden on EntityGroupImpl.
Iterator	getAllContainingGroups() Returns an Iterator over the Set of this IGroupMember's recursively-retrieved parent groups.
Iterator	getAllEntities() Default implementation, overridden on EntityGroupImpl.
Iterator	getAllMembers() Default implementation, overridden on EntityGroupImpl.
protected String	getCacheKey()
protected ICompositeGroupService	getCompositeGroupService() Returns the composite group service.
Iterator	getContainingGroups() Returns an Iterator over this IGroupMember's parent groups.
Iterator	getEntities() Default implementation, overridden on EntityGroupImpl.
String	getKey() Returns the key of the underlying entity.
IEntityGroup	getMemberGroupNamed(String name) Default implementation, overridden on EntityGroupImpl.
Iterator	getMembers() Default implementation, overridden on EntityGroupImpl.
Class	getType() Returns the type of the underlying entity.
EntityIdentifier	getUnderlyingEntityIdentifier() Returns EntityIdentifier for this IGroupMember's underlying entity.
int	hashCode()
boolean	hasMembers() Default implementation, overridden on EntityGroupImpl.
boolean	isDeepMemberOf(IGroupMember gm) Answers if this IGroupMember is, recursively, a member of IGroupMember gm.
boolean	isEntity()
boolean	isGroup()
protected boolean	isKnownEntityType(Class anEntityType)
boolean	isMemberOf(IGroupMember gm) Answers if this IGroupMember is a member of IGroupMember gm.
protected Set	primGetAllContainingGroups(IGroupMember member, Set s) Returns the Set of groups in our member Collection and, recursively, in the Collections of our members.
void	removeGroup(IEntityGroup eg) Removes the key of the IEntityGroup from our Set of group keys by copying the keys, updating the copy, and replacing the old keys with the copy.
protected void	setGroupKeysInitialized(boolean newGroupKeysInitialized)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jasig.portal.groups.IGroupMember

equals, getEntityType, getLeafType

Methods inherited from interface org.jasig.portal.IBasicEntity

getEntityIdentifier

Constructor Detail

GroupMemberImpl

public GroupMemberImpl(String key,
                       Class type)
                throws GroupsException

GroupMemberImpl constructor

Throws:

GroupsException

GroupMemberImpl

public GroupMemberImpl(EntityIdentifier newEntityIdentifier)
                throws GroupsException

GroupMemberImpl constructor

Throws:

GroupsException

Method Detail

addGroup

public void addGroup(IEntityGroup eg)
              throws GroupsException

Adds the key of the IEntityGroup to our Set of group keys by copying the keys, updating the copy, and replacing the old keys with the copy. This lets us confine synchronization to the getter and setter methods for the keys.

Parameters:

eg - org.jasig.portal.groups.IEntityGroup

Throws:

GroupsException

contains

public boolean contains(IGroupMember gm)
                 throws GroupsException

Default implementation, overridden on EntityGroupImpl.

Specified by:

contains in interface IGroupMember

Parameters:

gm - org.jasig.portal.groups.IGroupMember

Returns:

boolean

Throws:

GroupsException

castAndCopyHashSet

protected Set castAndCopyHashSet(Set s)

Cast a Set to a HashSet, clone it, and down cast back to Set.

Returns:

HashSet

deepContains

public boolean deepContains(IGroupMember gm)
                     throws GroupsException

Default implementation, overridden on EntityGroupImpl.

Specified by:

deepContains in interface IGroupMember

Parameters:

gm - org.jasig.portal.groups.IGroupMember

Returns:

boolean

Throws:

GroupsException

getAllContainingGroups

public Iterator getAllContainingGroups()
                                throws GroupsException

Returns an Iterator over the Set of this IGroupMember's recursively-retrieved parent groups.

Specified by:

getAllContainingGroups in interface IGroupMember

Returns:

java.util.Iterator

Throws:

GroupsException

getAllEntities

public Iterator getAllEntities()
                        throws GroupsException

Default implementation, overridden on EntityGroupImpl.

Specified by:

getAllEntities in interface IGroupMember

Returns:

java.util.Iterator

Throws:

GroupsException

getAllMembers

public Iterator getAllMembers()
                       throws GroupsException

Default implementation, overridden on EntityGroupImpl.

Specified by:

getAllMembers in interface IGroupMember

Returns:

java.util.Iterator

Throws:

GroupsException

getCacheKey

protected String getCacheKey()

Returns:

java.lang.String

getCompositeGroupService

protected ICompositeGroupService getCompositeGroupService()
                                                   throws GroupsException

Returns the composite group service.

Throws:

GroupsException

getContainingGroups

public Iterator getContainingGroups()
                             throws GroupsException

Returns an Iterator over this IGroupMember's parent groups. Synchronize the collection of keys with adds and removes.

Specified by:

getContainingGroups in interface IGroupMember

Returns:

java.util.Iterator

Throws:

GroupsException

getEntities

public Iterator getEntities()
                     throws GroupsException

Default implementation, overridden on EntityGroupImpl.

Specified by:

getEntities in interface IGroupMember

Returns:

java.util.Iterator

Throws:

GroupsException

getKey

public String getKey()

Description copied from interface: IGroupMember

Returns the key of the underlying entity.

Specified by:

getKey in interface IGroupMember

Returns:

java.lang.String

getMemberGroupNamed

public IEntityGroup getMemberGroupNamed(String name)
                                 throws GroupsException

Default implementation, overridden on EntityGroupImpl.

Specified by:

getMemberGroupNamed in interface IGroupMember

Parameters:

name - java.lang.String

Returns:

org.jasig.portal.groups.IEntityGroup

Throws:

GroupsException

getMembers

public Iterator getMembers()
                    throws GroupsException

Default implementation, overridden on EntityGroupImpl.

Specified by:

getMembers in interface IGroupMember

Returns:

java.util.Iterator

Throws:

GroupsException

getType

public Class getType()

Description copied from interface: IGroupMember

Returns the type of the underlying entity. For a group this will be IEntityGroup. For an entity, it will be the type of the underlying EntityIdentifier.

Specified by:

getType in interface IGroupMember

Returns:

java.lang.Class

getUnderlyingEntityIdentifier

public EntityIdentifier getUnderlyingEntityIdentifier()

Description copied from interface: IGroupMember

Returns EntityIdentifier for this IGroupMember's underlying entity. In the case of an IEntityGroup, it will be the EntityIdentifier for this. In the case of an IEntity, it will be the EntityIdentifier that identifies the underlying IPerson, ChannelDefinition, etc.

Specified by:

getUnderlyingEntityIdentifier in interface IGroupMember

Returns:

EntityIdentifier

hashCode

public int hashCode()

Specified by:

hashCode in interface IGroupMember

Overrides:

hashCode in class Object

Returns:

int

hasMembers

public boolean hasMembers()
                   throws GroupsException

Default implementation, overridden on EntityGroupImpl.

Specified by:

hasMembers in interface IGroupMember

Returns:

boolean

Throws:

GroupsException

isDeepMemberOf

public boolean isDeepMemberOf(IGroupMember gm)
                       throws GroupsException

Answers if this IGroupMember is, recursively, a member of IGroupMember gm.

Specified by:

isDeepMemberOf in interface IGroupMember

Parameters:

gm - org.jasig.portal.groups.IGroupMember

Returns:

boolean

Throws:

GroupsException

isEntity

public boolean isEntity()

Specified by:

isEntity in interface IGroupMember

Returns:

boolean

isGroup

public boolean isGroup()

Specified by:

isGroup in interface IGroupMember

Returns:

boolean

isKnownEntityType

protected boolean isKnownEntityType(Class anEntityType)
                             throws GroupsException

Returns:

boolean.

Throws:

GroupsException

isMemberOf

public boolean isMemberOf(IGroupMember gm)
                   throws GroupsException

Answers if this IGroupMember is a member of IGroupMember gm.

Specified by:

isMemberOf in interface IGroupMember

Parameters:

gm - org.jasig.portal.groups.IGroupMember

Returns:

boolean

Throws:

GroupsException

primGetAllContainingGroups

protected Set primGetAllContainingGroups(IGroupMember member,
                                         Set s)
                                  throws GroupsException

Returns the Set of groups in our member Collection and, recursively, in the Collections of our members.

Parameters:

member - org.jasig.portal.groups.IGroupMember - The current group member in the recursive execution.

s - java.lang.Set - A Set that groups are added to.

Returns:

java.util.Set

Throws:

GroupsException

removeGroup

public void removeGroup(IEntityGroup eg)
                 throws GroupsException

Removes the key of the IEntityGroup from our Set of group keys by copying the keys, updating the copy, and replacing the old keys with the copy. This lets us confine synchronization to the getter and setter methods for the keys.

Parameters:

eg - org.jasig.portal.groups.IEntityGroup

Throws:

GroupsException

setGroupKeysInitialized

protected void setGroupKeysInitialized(boolean newGroupKeysInitialized)

Parameters:

newGroupKeysInitialized - boolean