com.atlassian.crowd.integration.service
Interface GroupMembershipManager

All Known Implementing Classes:

CachingGroupMembershipManager

public interface GroupMembershipManager

This interface allows applications to query relationships between users and groups.

Method Summary

void	addMembership(java.lang.String userName, java.lang.String groupName) Adds a user identified by userName to the group identified by groupName.
java.util.List	getMembers(java.lang.String groupName) Obtains a list of all users in the group identified by groupName, sorted naturally.
java.util.List	getMemberships(java.lang.String userName) Deprecated. Since 1.4
boolean	isMember(java.lang.String userName, java.lang.String groupName) Returns true if the user represented by userName is a member of groupName
void	removeMembership(java.lang.String userName, java.lang.String groupName) Removes a user identified by userName from the group identified by groupName.

Method Detail

isMember

boolean isMember(java.lang.String userName,
                 java.lang.String groupName)
                 throws java.rmi.RemoteException,
                        InvalidAuthorizationTokenException

Returns true if the user represented by userName is a member of groupName

Parameters:

userName - The user to check

groupName - The group to check.

Returns:

true if a member, false otherwise.

Throws:

java.rmi.RemoteException - A communication error occurred - the Crowd server may not be available.

InvalidAuthorizationTokenException - The application (not the user) was not authenticated correctly.

addMembership

void addMembership(java.lang.String userName,
                   java.lang.String groupName)
                   throws java.rmi.RemoteException,
                          InvalidAuthorizationTokenException,
                          ObjectNotFoundException,
                          ApplicationPermissionException

Adds a user identified by userName to the group identified by groupName. If the user is already a member of the group, this method will return successfully.

Parameters:

userName - The user to add

groupName - The group the user will be added to

Throws:

java.rmi.RemoteException - A communication error occurred - the Crowd server may not be available.

InvalidAuthorizationTokenException - The application (not the user) was not authenticated correctly.

ObjectNotFoundException - Either the user or the group could not be found

ApplicationPermissionException - This application does not have permission to update group memberships.

removeMembership

void removeMembership(java.lang.String userName,
                      java.lang.String groupName)
                      throws java.rmi.RemoteException,
                             InvalidAuthorizationTokenException,
                             ObjectNotFoundException,
                             ApplicationPermissionException

Removes a user identified by userName from the group identified by groupName. If the user was not a member of the group, this method will return successfully.

Parameters:

userName - The user to remove

groupName - The group the user will be added from

Throws:

java.rmi.RemoteException - A communication error occurred - the Crowd server may not be available.

InvalidAuthorizationTokenException - The application (not the user) was not authenticated correctly.

ObjectNotFoundException - Either the user or the group could not be found

ApplicationPermissionException - This application does not have permission to update group memberships.

getMemberships

java.util.List getMemberships(java.lang.String userName)
                              throws java.rmi.RemoteException,
                                     InvalidAuthorizationTokenException,
                                     ObjectNotFoundException

Deprecated. Since 1.4

Obtains a list of all groups that the user identified by userName belongs to, sorted naturally.

This can be a slow call, particularly on some LDAP directories, and so should be avoided. Use isMember() instead.

Parameters:

userName - The user whose group memberships are desired.

Returns:

A List of Strings containing all the groups the user belongs to, or an empty List

Throws:

java.rmi.RemoteException - A communication error occurred - the Crowd server may not be available.

InvalidAuthorizationTokenException - The application (not the user) was not authenticated correctly.

ObjectNotFoundException - If the user could not be found.

getMembers

java.util.List getMembers(java.lang.String groupName)
                          throws java.rmi.RemoteException,
                                 InvalidAuthorizationTokenException,
                                 ObjectNotFoundException

Obtains a list of all users in the group identified by groupName, sorted naturally.

This is a fairly fast call, but implementors should still be using isMember() wherever practicable.

Parameters:

groupName - The group whose member users are desired.

Returns:

A List of Strings containing all the users in the group, or an empty list.

Throws:

java.rmi.RemoteException - A communication error occurred - the Crowd server may not be available.

InvalidAuthorizationTokenException - The application (not the user) was not authenticated correctly.

ObjectNotFoundException - If the group could not be found.