com.atlassian.crowd.integration.service
Interface GroupManager

All Known Implementing Classes:

CachingGroupManager

public interface GroupManager

Methods related to operations on groups, but not on their users.

Method Summary

SOAPGroup	addGroup(SOAPGroup group) Adds group to the Crowd server.
java.util.List	getAllGroupNames() Deprecated. Since 1.4.
SOAPGroup	getGroup(java.lang.String groupName) Given a groupName, returns a SOAPGroup that represents the group.
boolean	isGroup(java.lang.String groupName) Returns true if groupName represents a valid group, false otherwise.
void	removeGroup(java.lang.String groupName) Removes a group from Crowd.
java.util.List	searchGroups(SearchRestriction[] restrictions) Searches the list of all available groups based on the passed-in restrictions and returns a list of groups that match.
void	updateGroup(SOAPGroup group) Updates a group's details in Crowd.

Method Detail

isGroup

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

Returns true if groupName represents a valid group, false otherwise.

Parameters:

groupName - The name to check

Returns:

true if it's a group, 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.

getGroup

SOAPGroup getGroup(java.lang.String groupName)
                   throws java.rmi.RemoteException,
                          InvalidAuthorizationTokenException,
                          ObjectNotFoundException

Given a groupName, returns a SOAPGroup that represents the group. This group object will not have any membership information associated with it.

Parameters:

groupName - The name of the group to fetch

Returns:

An object representing the group, or null if it does not exist

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 - The group could not be found.

addGroup

SOAPGroup addGroup(SOAPGroup group)
                   throws java.rmi.RemoteException,
                          InvalidGroupException,
                          InvalidAuthorizationTokenException,
                          ApplicationPermissionException

Adds group to the Crowd server.

Parameters:

group - The object containing the details of the group.

Returns:

The SOAPGroup, as returned by the Crowd server.

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.

InvalidGroupException - Could not add the group - it may be malformed, or a group with that name may already exist.

ApplicationPermissionException - The application, not the user, does not have permission to add groups.

searchGroups

java.util.List searchGroups(SearchRestriction[] restrictions)
                            throws java.rmi.RemoteException,
                                   InvalidAuthorizationTokenException

Searches the list of all available groups based on the passed-in restrictions and returns a list of groups that match.

Parameters:

restrictions -

Returns:

A List of SOAPGroups that match the criteria.

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.

updateGroup

void updateGroup(SOAPGroup group)
                 throws java.rmi.RemoteException,
                        ObjectNotFoundException,
                        ApplicationPermissionException,
                        InvalidAuthorizationTokenException

Updates a group's details in Crowd.

Parameters:

group - The group to update

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 - The group to update could not be found.

ApplicationPermissionException - This application does not have the rights to update the group. Sorry.

removeGroup

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

Removes a group from Crowd.

Parameters:

groupName - The name of the group to remove.

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 - The group to remove could not be found.

ApplicationPermissionException - This application is not allowed to remove this group.

getAllGroupNames

java.util.List getAllGroupNames()
                                throws java.rmi.RemoteException,
                                       InvalidAuthorizationTokenException

Deprecated. Since 1.4.

Returns a list of all available groups. We recommend against use of this method; depending on the environment, it may prevent your app from scaling. Some large organisations build very complex group permissioning structures, with total group numbers in the tens of thousands.

Returns:

A List of Strings that list all the groups visible to this application.

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.