public class DefaultGroupManager extends Object implements GroupManager
Constructor and Description |
---|
DefaultGroupManager(com.atlassian.crowd.embedded.api.CrowdService crowdService,
com.atlassian.crowd.manager.directory.DirectoryManager directoryManager) |
Modifier and Type | Method and Description |
---|---|
void |
addUserToGroup(ApplicationUser user,
com.atlassian.crowd.embedded.api.Group group)
Adds a user as a member of a group.
|
com.atlassian.crowd.embedded.api.Group |
createGroup(String groupName)
Create a group with the given name.
|
Collection<com.atlassian.crowd.embedded.api.Group> |
getAllGroups()
Get all groups.
|
Collection<ApplicationUser> |
getDirectUsersInGroup(com.atlassian.crowd.embedded.api.Group group)
Returns all the users that are direct members of the group.
|
com.atlassian.crowd.embedded.api.Group |
getGroup(String groupName)
Returns the Group for this groupName, else null if no such Group exists.
|
com.atlassian.crowd.embedded.api.Group |
getGroupEvenWhenUnknown(String groupName)
Returns the Group for this groupName, if no such Group exists then a proxy unknown immutable Group object is
returned.
|
Collection<String> |
getGroupNamesForUser(ApplicationUser user)
Returns the names of all the groups that the given user belongs to.
|
Collection<String> |
getGroupNamesForUser(String userName)
Returns the names of all the groups that the given user belongs to.
|
com.atlassian.crowd.embedded.api.Group |
getGroupObject(String groupName)
Returns the Group for this groupName, else null if no such Group exists.
|
Collection<com.atlassian.crowd.embedded.api.Group> |
getGroupsForUser(ApplicationUser user)
Returns all the groups that the given user belongs to.
|
Collection<com.atlassian.crowd.embedded.api.Group> |
getGroupsForUser(String userName)
Returns all the groups that the given user belongs to.
|
Collection<String> |
getUserNamesInGroup(com.atlassian.crowd.embedded.api.Group group)
Returns the names of all the users in a group.
|
Collection<String> |
getUserNamesInGroup(String groupName)
Returns the names of all the users in a group.
|
Collection<ApplicationUser> |
getUsersInGroup(com.atlassian.crowd.embedded.api.Group group)
Returns all the users in a group.
|
Collection<ApplicationUser> |
getUsersInGroup(String groupName)
Returns all the users in a group.
|
boolean |
groupExists(com.atlassian.crowd.embedded.api.Group group)
Returns
true if the given group exists. |
boolean |
groupExists(String groupName)
Returns
true if the given group name exists. |
boolean |
isUserInGroup(ApplicationUser user,
com.atlassian.crowd.embedded.api.Group group)
Returns
true if the user is a member of the group. |
boolean |
isUserInGroup(ApplicationUser user,
String groupname)
Returns
true if the user is a member of the named group. |
boolean |
isUserInGroup(String username,
String groupname)
Returns
true if the user is a member of the group. |
public DefaultGroupManager(com.atlassian.crowd.embedded.api.CrowdService crowdService, com.atlassian.crowd.manager.directory.DirectoryManager directoryManager)
public Collection<com.atlassian.crowd.embedded.api.Group> getAllGroups()
GroupManager
getAllGroups
in interface GroupManager
public boolean groupExists(String groupName)
GroupManager
true
if the given group name exists.groupExists
in interface GroupManager
groupName
- The group name.true
if the given group name exists.public boolean groupExists(@Nonnull com.atlassian.crowd.embedded.api.Group group)
GroupManager
true
if the given group exists.groupExists
in interface GroupManager
group
- The group.true
if the given group exists.public com.atlassian.crowd.embedded.api.Group createGroup(String groupName) throws com.atlassian.crowd.exception.OperationNotPermittedException, com.atlassian.crowd.exception.embedded.InvalidGroupException
GroupManager
createGroup
in interface GroupManager
groupName
- The group name.com.atlassian.crowd.exception.OperationNotPermittedException
- if the directory has been configured to not allow the operation to be performedcom.atlassian.crowd.exception.embedded.InvalidGroupException
- if the group already exists in ANY associated directory or the group template does not have the required properties populated.public com.atlassian.crowd.embedded.api.Group getGroup(String groupName)
GroupManager
getGroup
in interface GroupManager
groupName
- The group name.public com.atlassian.crowd.embedded.api.Group getGroupEvenWhenUnknown(String groupName)
GroupManager
getGroupEvenWhenUnknown
in interface GroupManager
groupName
- The group name.public com.atlassian.crowd.embedded.api.Group getGroupObject(String groupName)
GroupManager
GroupManager.getGroup(String)
.getGroupObject
in interface GroupManager
groupName
- The group name.GroupManager.getGroup(String)
public boolean isUserInGroup(String username, String groupname)
GroupManager
true
if the user is a member of the group.
Note that if the username or groupname is null, then it will return false.
If you have a full User object, then calling one of the other isUserInGroup() methods is more efficient.
isUserInGroup
in interface GroupManager
username
- user to inspect.groupname
- group to inspect.true
if and only if the user is a direct or indirect (nested) member of the group.public boolean isUserInGroup(ApplicationUser user, com.atlassian.crowd.embedded.api.Group group)
GroupManager
true
if the user is a member of the group.
Note that if the User or Group object is null, then it will return false. This was done to retain consistency with the old OSUser behaviour of User.inGroup() and Group.containsUser()
isUserInGroup
in interface GroupManager
user
- user to inspect.group
- group to inspect.true
if and only if the user is a direct or indirect (nested) member of the group.GroupManager.isUserInGroup(String, String)
public boolean isUserInGroup(ApplicationUser user, String groupname)
GroupManager
true
if the user is a member of the named group.
If you already have the User object, then this method is faster than the alternative of passing in the username because it saves on an unnecessary user lookup to find the correct User Directory.
isUserInGroup
in interface GroupManager
user
- user to inspect.groupname
- group to inspect.true
if and only if the user is a direct or indirect (nested) member of the group.public Collection<ApplicationUser> getUsersInGroup(String groupName)
GroupManager
getUsersInGroup
in interface GroupManager
groupName
- The group#getUsersInGroup(Group)}
public Collection<ApplicationUser> getUsersInGroup(com.atlassian.crowd.embedded.api.Group group)
GroupManager
getUsersInGroup
in interface GroupManager
group
- The group#getUsersInGroup(String)}
public Collection<String> getUserNamesInGroup(com.atlassian.crowd.embedded.api.Group group)
GroupManager
getUserNamesInGroup
in interface GroupManager
group
- The group#getUsersInGroup(Group)}
public Collection<String> getUserNamesInGroup(String groupName)
GroupManager
getUserNamesInGroup
in interface GroupManager
groupName
- The group#getUsersInGroup(String)}
public Collection<ApplicationUser> getDirectUsersInGroup(com.atlassian.crowd.embedded.api.Group group)
GroupManager
getDirectUsersInGroup
in interface GroupManager
group
- The group#getUsersInGroup(String)}
public Collection<com.atlassian.crowd.embedded.api.Group> getGroupsForUser(String userName)
GroupManager
getGroupsForUser
in interface GroupManager
userName
- The userGroupManager.getGroupNamesForUser(String)
public Collection<com.atlassian.crowd.embedded.api.Group> getGroupsForUser(ApplicationUser user)
GroupManager
getGroupsForUser
in interface GroupManager
user
- The userGroupManager.getGroupNamesForUser(String)
public Collection<String> getGroupNamesForUser(String userName)
GroupManager
getGroupNamesForUser
in interface GroupManager
userName
- The userGroupManager.getGroupsForUser(String)
,
GroupManager.getGroupNamesForUser(com.atlassian.jira.user.ApplicationUser)
public Collection<String> getGroupNamesForUser(@Nonnull ApplicationUser user)
GroupManager
getGroupNamesForUser
in interface GroupManager
user
- The userGroupManager.getGroupsForUser(String)
public void addUserToGroup(ApplicationUser user, com.atlassian.crowd.embedded.api.Group group) throws com.atlassian.crowd.exception.GroupNotFoundException, com.atlassian.crowd.exception.UserNotFoundException, com.atlassian.crowd.exception.OperationNotPermittedException, com.atlassian.crowd.exception.OperationFailedException
GroupManager
addUserToGroup
in interface GroupManager
user
- The user that will become a member of the group.group
- The group that will gain a new member.com.atlassian.crowd.exception.GroupNotFoundException
- if the group
could not be foundcom.atlassian.crowd.exception.UserNotFoundException
- if the user
could not be foundcom.atlassian.crowd.exception.OperationNotPermittedException
- if the directory has been configured to not allow the operation to be performedcom.atlassian.crowd.exception.OperationFailedException
- If the underlying directory implementation failed to execute the operation.Copyright © 2002-2015 Atlassian. All Rights Reserved.