org.apache.jackrabbit.api.security.user

Interface Group

All Superinterfaces:

Authorizable

public interface Group
extends Authorizable

A Group is a collection of Authorizables.

Method Summary

Modifier and Type	Method and Description
boolean	addMember(Authorizable authorizable) Add a member to this Group.
java.util.Set<java.lang.String>	addMembers(java.lang.String... memberIds) Add one or more member(s) to this Group.
java.util.Iterator<Authorizable>	getDeclaredMembers()
java.util.Iterator<Authorizable>	getMembers()
boolean	isDeclaredMember(Authorizable authorizable) Test whether an Authorizable is a declared member of this group.
boolean	isMember(Authorizable authorizable)
boolean	removeMember(Authorizable authorizable) Remove a member from this Group.
java.util.Set<java.lang.String>	removeMembers(java.lang.String... memberIds) Remove one or several members from this Group.

Methods inherited from interface org.apache.jackrabbit.api.security.user.Authorizable

declaredMemberOf, getID, getPath, getPrincipal, getProperty, getPropertyNames, getPropertyNames, hasProperty, isGroup, memberOf, remove, removeProperty, setProperty, setProperty

Method Detail

getDeclaredMembers

java.util.Iterator<Authorizable> getDeclaredMembers()
                                             throws RepositoryException

Returns:

Iterator of Authorizables which are declared members of this Group.

Throws:

RepositoryException - If an error occurs.

getMembers

java.util.Iterator<Authorizable> getMembers()
                                     throws RepositoryException

Returns:

Iterator of Authorizables which are members of this Group. This includes both declared members and all authorizables that are indirect group members.

Throws:

RepositoryException - If an error occurs.

isDeclaredMember

boolean isDeclaredMember(Authorizable authorizable)
                  throws RepositoryException

Test whether an Authorizable is a declared member of this group.

Parameters:

authorizable - The Authorizable to test.

Returns:

true if the Authorizable to test is a direct member

Throws:

RepositoryException - If an error occurs.

isMember

boolean isMember(Authorizable authorizable)
          throws RepositoryException

Parameters:

authorizable - The Authorizable to test.

Returns:

true if the Authorizable to test is a direct or indirect member of this Group.

Throws:

RepositoryException - If an error occurs.

addMember

boolean addMember(Authorizable authorizable)
           throws RepositoryException

Add a member to this Group.

Parameters:

authorizable - The Authorizable to be added as member to this group.

Returns:

true if the Authorizable has successfully been added to this Group, false otherwise (e.g. unknown implementation or if it already is a member or if the passed authorizable is this group itself or for some implementation specific constraint).

Throws:

RepositoryException - If an error occurs.

addMembers

java.util.Set<java.lang.String> addMembers(java.lang.String... memberIds)
                                    throws RepositoryException

Add one or more member(s) to this Group. Note, that an implementation may define circumstances under which this method allows to add non-existing Authorizables as new members. Also an implementation may choose to (partially) postpone validation/verification util Session#save().

Parameters:

memberIds - The Ids of the authorizables to be added as members to this group.

Returns:

a set of those memberIds that could not be added or an empty set of all ids have been successfully processed. The former may include those cases where a given id cannot be resolved to an existing authorizable, one that is already member or if adding the member would create a cyclic group membership.

Throws:

RepositoryException - If one of the specified memberIds is invalid or if some other error occurs.

removeMember

boolean removeMember(Authorizable authorizable)
              throws RepositoryException

Remove a member from this Group.

Parameters:

authorizable - The Authorizable to be removed from the list of group members.

Returns:

true if the Authorizable was successfully removed. False otherwise.

Throws:

RepositoryException - If an error occurs.

removeMembers

java.util.Set<java.lang.String> removeMembers(java.lang.String... memberIds)
                                       throws RepositoryException

Remove one or several members from this Group. Note, that an implementation may define circumstances under which this method allows to remove members that (no longer) exist. An implementation may choose to (partially) postpone validation/verification util Session#save().

Parameters:

memberIds - The Ids of the authorizables to be removed from the members of this group.

Returns:

a set of those memberIds that could not be removed or an empty set if all ids have been successfully processed. The former may include those cases where a given id cannot be resolved to an existing authorizable.

Throws:

RepositoryException - If one of the specified memberIds is invalid or if some other error occurs.