org.jasig.portal.groups.pags
Class PersonAttributesGroupStore

java.lang.Object
  org.jasig.portal.groups.pags.PersonAttributesGroupStore

All Implemented Interfaces:

IEntityGroupStore, IEntitySearcher, IEntityStore, IGroupConstants

public class PersonAttributesGroupStore
extends Object
implements IEntityGroupStore, IEntityStore, IEntitySearcher

The Person Attributes Group Store uses attributes stored in the IPerson object to determine group membership. It can use attributes from any data source supported by the PersonDirectory service.

Version:

$Revision: 19776 $

Author:

Al Wold

Nested Class Summary

static class	PersonAttributesGroupStore.GroupDefinition
static class	PersonAttributesGroupStore.TestGroup

Field Summary

Fields inherited from interface org.jasig.portal.groups.IGroupConstants

CHANNEL_CATEGORIES, CONTAINS, ENDS_WITH, EVERYONE, IS, NODE_SEPARATOR, PORTAL_ADMINISTRATORS, STARTS_WITH

Constructor Summary

PersonAttributesGroupStore()

Method Summary

boolean	contains(IEntityGroup group, IGroupMember member) Answers if group contains member.
void	delete(IEntityGroup group) Delete this IEntityGroup from the data store.
IEntityGroup	find(String key) Returns an instance of the IEntityGroup from the data store.
Iterator	findContainingGroups(IGroupMember member) Returns an Iterator over the Collection of IEntityGroups that the IGroupMember belongs to.
Iterator	findEntitiesForGroup(IEntityGroup group) Returns an Iterator over the Collection of IEntities that are members of this IEntityGroup.
ILockableEntityGroup	findLockable(String key) Returns an instance of the ILockableEntityGroup from the data store.
String[]	findMemberGroupKeys(IEntityGroup group) Returns a String[] containing the keys of IEntityGroups that are members of this IEntityGroup.
Iterator<IEntityGroup>	findMemberGroups(IEntityGroup group) Returns an Iterator over the Collection of IEntityGroups that are members of this IEntityGroup.
IEntityGroup	newInstance(Class entityType)
IEntity	newInstance(String key)
IEntity	newInstance(String key, Class type)
EntityIdentifier[]	searchForEntities(String query, int method, Class type) Find EntityIdentifiers for entities whose name matches the query string according to the specified method and is of the specified type
EntityIdentifier[]	searchForGroups(String query, int method, Class leaftype) Find EntityIdentifiers for groups whose name matches the query string according to the specified method and matches the provided leaf type
void	update(IEntityGroup group) Adds or updates the IEntityGroup AND ITS MEMBERSHIPS to the data store, as appropriate.
void	updateMembers(IEntityGroup group) Commits the group memberships of the IEntityGroup to the data store.

Methods inherited from class java.lang.Object

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

Constructor Detail

PersonAttributesGroupStore

public PersonAttributesGroupStore()

Method Detail

contains

public boolean contains(IEntityGroup group,
                        IGroupMember member)
                 throws GroupsException

Description copied from interface: IEntityGroupStore

Answers if group contains member.

Specified by:

contains in interface IEntityGroupStore

Parameters:

group - org.jasig.portal.groups.IEntityGroup

member - org.jasig.portal.groups.IGroupMember

Returns:

boolean

Throws:

GroupsException

delete

public void delete(IEntityGroup group)
            throws GroupsException

Description copied from interface: IEntityGroupStore

Delete this IEntityGroup from the data store.

Specified by:

delete in interface IEntityGroupStore

Parameters:

group - org.jasig.portal.groups.IEntityGroup

Throws:

GroupsException

find

public IEntityGroup find(String key)
                  throws GroupsException

Description copied from interface: IEntityGroupStore

Returns an instance of the IEntityGroup from the data store.

Specified by:

find in interface IEntityGroupStore

Parameters:

key - java.lang.String

Returns:

org.jasig.portal.groups.IEntityGroup

Throws:

GroupsException

findContainingGroups

public Iterator findContainingGroups(IGroupMember member)
                              throws GroupsException

Description copied from interface: IEntityGroupStore

Returns an Iterator over the Collection of IEntityGroups that the IGroupMember belongs to.

Specified by:

findContainingGroups in interface IEntityGroupStore

Parameters:

member - org.jasig.portal.groups.IEntityGroup

Returns:

java.util.Iterator

Throws:

GroupsException

findEntitiesForGroup

public Iterator findEntitiesForGroup(IEntityGroup group)
                              throws GroupsException

Description copied from interface: IEntityGroupStore

Returns an Iterator over the Collection of IEntities that are members of this IEntityGroup.

Specified by:

findEntitiesForGroup in interface IEntityGroupStore

Parameters:

group - org.jasig.portal.groups.IEntityGroup

Returns:

java.util.Iterator

Throws:

GroupsException

findLockable

public ILockableEntityGroup findLockable(String key)
                                  throws GroupsException

Description copied from interface: IEntityGroupStore

Returns an instance of the ILockableEntityGroup from the data store.

Specified by:

findLockable in interface IEntityGroupStore

Parameters:

key - java.lang.String

Returns:

org.jasig.portal.groups.IEntityGroup

Throws:

GroupsException

findMemberGroupKeys

public String[] findMemberGroupKeys(IEntityGroup group)
                             throws GroupsException

Description copied from interface: IEntityGroupStore

Returns a String[] containing the keys of IEntityGroups that are members of this IEntityGroup. In a composite group system, a group may contain a member group from a different service. This is called a foreign membership, and is only possible in an internally-managed service. A group store in such a service can return the key of a foreign member group, but not the group itself, which can only be returned by its local store.

Specified by:

findMemberGroupKeys in interface IEntityGroupStore

Parameters:

group - org.jasig.portal.groups.IEntityGroup

Returns:

String[]

Throws:

GroupsException

findMemberGroups

public Iterator<IEntityGroup> findMemberGroups(IEntityGroup group)
                                        throws GroupsException

Description copied from interface: IEntityGroupStore

Returns an Iterator over the Collection of IEntityGroups that are members of this IEntityGroup.

Specified by:

findMemberGroups in interface IEntityGroupStore

Parameters:

group - org.jasig.portal.groups.IEntityGroup

Returns:

java.util.Iterator

Throws:

GroupsException

newInstance

public IEntityGroup newInstance(Class entityType)
                         throws GroupsException

Specified by:

newInstance in interface IEntityGroupStore

Returns:

org.jasig.portal.groups.IEntityGroup

Throws:

GroupsException

searchForGroups

public EntityIdentifier[] searchForGroups(String query,
                                          int method,
                                          Class leaftype)
                                   throws GroupsException

Description copied from interface: IEntityGroupStore

Find EntityIdentifiers for groups whose name matches the query string according to the specified method and matches the provided leaf type

Specified by:

searchForGroups in interface IEntityGroupStore

Throws:

GroupsException

update

public void update(IEntityGroup group)
            throws GroupsException

Description copied from interface: IEntityGroupStore

Adds or updates the IEntityGroup AND ITS MEMBERSHIPS to the data store, as appropriate.

Specified by:

update in interface IEntityGroupStore

Parameters:

group - org.jasig.portal.groups.IEntityGroup

Throws:

GroupsException

updateMembers

public void updateMembers(IEntityGroup group)
                   throws GroupsException

Description copied from interface: IEntityGroupStore

Commits the group memberships of the IEntityGroup to the data store.

Specified by:

updateMembers in interface IEntityGroupStore

Parameters:

group - org.jasig.portal.groups.IEntityGroup

Throws:

GroupsException

newInstance

public IEntity newInstance(String key,
                           Class type)
                    throws GroupsException

Specified by:

newInstance in interface IEntityStore

Parameters:

key - java.lang.String - the entity's key

type - java.lang.Class - the entity's Type

Returns:

org.jasig.portal.groups.IEntity

Throws:

GroupsException

newInstance

public IEntity newInstance(String key)
                    throws GroupsException

Specified by:

newInstance in interface IEntityStore

Parameters:

key - java.lang.String

Returns:

org.jasig.portal.groups.IEntity

Throws:

GroupsException

searchForEntities

public EntityIdentifier[] searchForEntities(String query,
                                            int method,
                                            Class type)
                                     throws GroupsException

Description copied from interface: IEntitySearcher

Find EntityIdentifiers for entities whose name matches the query string according to the specified method and is of the specified type

Specified by:

searchForEntities in interface IEntitySearcher

Throws:

GroupsException