com.atlassian.jira.security.groups

Class DefaultGroupManager

java.lang.Object

com.atlassian.jira.security.groups.DefaultGroupManager

All Implemented Interfaces:

GroupManager

public class DefaultGroupManager
extends Object
implements GroupManager

Default implementation of GroupManager.

Since:

v3.13

Constructor Summary

Constructors

Constructor and Description
DefaultGroupManager(com.atlassian.crowd.embedded.api.CrowdService crowdService, com.atlassian.crowd.manager.directory.DirectoryManager directoryManager, DbConnectionManager dbConnectionManager, DatabaseConfigurationManager dbConfigManager, com.atlassian.crowd.embedded.api.UnfilteredCrowdService unfilteredCrowdService, FeatureManager featureManager)

Method Summary

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<String>	filterUsersInAllGroupsDirect(Collection<String> userNames, Collection<String> groupNames) Returns a collection of user names for the users that are direct members of every one of the supplied groups.
Collection<String>	getAllGroupNames() Returns the names of all groups or an empty collection if there are no groups.
Collection<com.atlassian.crowd.embedded.api.Group>	getAllGroups() Get all groups.
Set<ApplicationUser>	getConnectUsers() Deprecated.
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.
List<String>	getNamesOfDirectMembersOfGroups(Collection<String> groupNames, int limit) Returns a list of all active user names that are direct members in at least one of the supplied groups.
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<String>	getUserNamesInGroups(Collection<com.atlassian.crowd.embedded.api.Group> groups) Returns the names of all the users in a collection of groups.
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.
Collection<ApplicationUser>	getUsersInGroup(String groupName, Boolean includeInactive) Returns all the users in a group.
Page<ApplicationUser>	getUsersInGroup(String groupName, Boolean includeInactive, PageRequest pageRequest) Returns a page with users in a group.
int	getUsersInGroupCount(com.atlassian.crowd.embedded.api.Group group) Returns a count of all active users in a group.
int	getUsersInGroupCount(String groupName) Returns a count of all active 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.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultGroupManager

public DefaultGroupManager(com.atlassian.crowd.embedded.api.CrowdService crowdService,
                           com.atlassian.crowd.manager.directory.DirectoryManager directoryManager,
                           DbConnectionManager dbConnectionManager,
                           DatabaseConfigurationManager dbConfigManager,
                           com.atlassian.crowd.embedded.api.UnfilteredCrowdService unfilteredCrowdService,
                           FeatureManager featureManager)

Method Detail

getAllGroups

public Collection<com.atlassian.crowd.embedded.api.Group> getAllGroups()

Description copied from interface: GroupManager

Get all groups.

Specified by:

getAllGroups in interface GroupManager

Returns:

Collection of all Groups.

groupExists

public boolean groupExists(String groupName)

Description copied from interface: GroupManager

Returns true if the given group name exists.

Specified by:

groupExists in interface GroupManager

Parameters:

groupName - The group name.

Returns:

true if the given group name exists.

groupExists

public boolean groupExists(@Nonnull
                           com.atlassian.crowd.embedded.api.Group group)

Description copied from interface: GroupManager

Returns true if the given group exists.

Specified by:

groupExists in interface GroupManager

Parameters:

group - The group.

Returns:

true if the given group exists.

createGroup

public com.atlassian.crowd.embedded.api.Group createGroup(String groupName)
                                                   throws com.atlassian.crowd.exception.OperationNotPermittedException,
                                                          com.atlassian.crowd.exception.embedded.InvalidGroupException

Description copied from interface: GroupManager

Create a group with the given name.

Specified by:

createGroup in interface GroupManager

Parameters:

groupName - The group name.

Returns:

the newly created Group.

Throws:

com.atlassian.crowd.exception.OperationNotPermittedException - if the directory has been configured to not allow the operation to be performed

com.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.

getGroup

public com.atlassian.crowd.embedded.api.Group getGroup(String groupName)

Description copied from interface: GroupManager

Returns the Group for this groupName, else null if no such Group exists.

Specified by:

getGroup in interface GroupManager

Parameters:

groupName - The group name.

Returns:

The Group for this groupName, else null if no such Group exists.

getGroupEvenWhenUnknown

public com.atlassian.crowd.embedded.api.Group getGroupEvenWhenUnknown(String groupName)

Description copied from interface: GroupManager

Returns the Group for this groupName, if no such Group exists then a proxy unknown immutable Group object is returned.

Specified by:

getGroupEvenWhenUnknown in interface GroupManager

Parameters:

groupName - The group name.

Returns:

The Group for this groupName.

getGroupObject

public com.atlassian.crowd.embedded.api.Group getGroupObject(String groupName)

Description copied from interface: GroupManager

Returns the Group for this groupName, else null if no such Group exists.

Legacy synonym for GroupManager.getGroup(String).

Specified by:

getGroupObject in interface GroupManager

Parameters:

groupName - The group name.

Returns:

The Group for this groupName, else null if no such Group exists.

See Also:

GroupManager.getGroup(String)

isUserInGroup

public boolean isUserInGroup(@Nullable
                             String username,
                             @Nullable
                             String groupname)

Description copied from interface: GroupManager

Returns true if the user is a member of the group.

Note that if the username or groupname is null, then it will return false.

Performance note: If you have a full user object, then calling one of the other isUserInGroup() methods directly is more efficient.

Specified by:

isUserInGroup in interface GroupManager

Parameters:

username - user to inspect.

groupname - group to inspect.

Returns:

true if and only if the user is a direct or indirect (nested) member of the group.

See Also:

GroupManager.isUserInGroup(ApplicationUser, Group), GroupManager.isUserInGroup(ApplicationUser, String)

isUserInGroup

public boolean isUserInGroup(@Nullable
                             ApplicationUser user,
                             @Nullable
                             com.atlassian.crowd.embedded.api.Group group)

Description copied from interface: GroupManager

Returns 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()

Specified by:

isUserInGroup in interface GroupManager

Parameters:

user - user to inspect.

group - group to inspect.

Returns:

true if and only if the user is a direct or indirect (nested) member of the group.

isUserInGroup

public boolean isUserInGroup(@Nullable
                             ApplicationUser user,
                             @Nullable
                             String groupname)

Description copied from interface: GroupManager

Returns 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.

Specified by:

isUserInGroup in interface GroupManager

Parameters:

user - user to inspect.

groupname - group to inspect.

Returns:

true if and only if the user is a direct or indirect (nested) member of the group.

getUsersInGroup

public Collection<ApplicationUser> getUsersInGroup(String groupName)

Description copied from interface: GroupManager

Returns all the users in a group.

Specified by:

getUsersInGroup in interface GroupManager

Parameters:

groupName - The group

Returns:

all the users that belongs to the group.

See Also:

#getUsersInGroup(Group)}

getUsersInGroup

public Collection<ApplicationUser> getUsersInGroup(String groupName,
                                                   Boolean includeInactive)

Description copied from interface: GroupManager

Returns all the users in a group. Allows for additional filtering by the active flag of a user.

Specified by:

getUsersInGroup in interface GroupManager

Parameters:

groupName - The group

includeInactive - if set to true inactive users will be returned as well

Returns:

all the users that belongs to the group.

getUsersInGroup

public Page<ApplicationUser> getUsersInGroup(String groupName,
                                             Boolean includeInactive,
                                             PageRequest pageRequest)

Description copied from interface: GroupManager

Returns a page with users in a group. Users are sorted by name in ascending order.

Specified by:

getUsersInGroup in interface GroupManager

Parameters:

groupName - name of the group for which users are returned

includeInactive - if set to true inactive users will be returned as well

pageRequest - parameters of the page to return

Returns:

page with the users

getUsersInGroup

public Collection<ApplicationUser> getUsersInGroup(com.atlassian.crowd.embedded.api.Group group)

Description copied from interface: GroupManager

Returns all the users in a group. This will include nested group members.

Specified by:

getUsersInGroup in interface GroupManager

Parameters:

group - The group

Returns:

all the users that belongs to the group.

See Also:

#getUsersInGroup(String)}

getUsersInGroupCount

public int getUsersInGroupCount(com.atlassian.crowd.embedded.api.Group group)

Description copied from interface: GroupManager

Returns a count of all active users in a group. This will include nested group members.

Specified by:

getUsersInGroupCount in interface GroupManager

Parameters:

group - The group

Returns:

a count of all the users that belongs to the group.

See Also:

#getUsersInGroupCount(String)}

getUsersInGroupCount

public int getUsersInGroupCount(String groupName)

Description copied from interface: GroupManager

Returns a count of all active users in a group. This will include nested group members.

Specified by:

getUsersInGroupCount in interface GroupManager

Parameters:

groupName - The group name

Returns:

a count of all the users that belongs to the group.

See Also:

#getUsersInGroupCount(Group)}

getNamesOfDirectMembersOfGroups

public List<String> getNamesOfDirectMembersOfGroups(Collection<String> groupNames,
                                                    int limit)

Description copied from interface: GroupManager

Returns a list of all active user names that are direct members in at least one of the supplied groups.

Specified by:

getNamesOfDirectMembersOfGroups in interface GroupManager

Parameters:

groupNames - A collection of group names to find direct members of

limit - A maximum number of names to return

Returns:

a list of user names

filterUsersInAllGroupsDirect

public Collection<String> filterUsersInAllGroupsDirect(Collection<String> userNames,
                                                       Collection<String> groupNames)

Description copied from interface: GroupManager

Returns a collection of user names for the users that are direct members of every one of the supplied groups.

Specified by:

filterUsersInAllGroupsDirect in interface GroupManager

Parameters:

userNames - A collection of user names

groupNames - A collection of groups

Returns:

a collection of user names

getUserNamesInGroup

public Collection<String> getUserNamesInGroup(com.atlassian.crowd.embedded.api.Group group)

Description copied from interface: GroupManager

Returns the names of all the users in a group. This will include nested group members.

Specified by:

getUserNamesInGroup in interface GroupManager

Parameters:

group - The group

Returns:

all the users that belongs to the group.

See Also:

#getUsersInGroup(Group)}

getUserNamesInGroups

public Collection<String> getUserNamesInGroups(Collection<com.atlassian.crowd.embedded.api.Group> groups)

Description copied from interface: GroupManager

Returns the names of all the users in a collection of groups. This will include nested group members.

Specified by:

getUserNamesInGroups in interface GroupManager

Parameters:

groups - The collection of groups

Returns:

all the users that belongs to the group.

getUserNamesInGroup

public Collection<String> getUserNamesInGroup(String groupName)

Description copied from interface: GroupManager

Returns the names of all the users in a group. This will include nested group members.

Specified by:

getUserNamesInGroup in interface GroupManager

Parameters:

groupName - The group

Returns:

all the users that belongs to the group.

See Also:

#getUsersInGroup(String)}

getDirectUsersInGroup

public Collection<ApplicationUser> getDirectUsersInGroup(com.atlassian.crowd.embedded.api.Group group)

Description copied from interface: GroupManager

Returns all the users that are direct members of the group. This will NOT include nested group members.

Specified by:

getDirectUsersInGroup in interface GroupManager

Parameters:

group - The group

Returns:

all the users that belongs to the group.

See Also:

#getUsersInGroup(String)}

getGroupsForUser

public Collection<com.atlassian.crowd.embedded.api.Group> getGroupsForUser(String userName)

Description copied from interface: GroupManager

Returns all the groups that the given user belongs to.

Specified by:

getGroupsForUser in interface GroupManager

Parameters:

userName - The user

Returns:

all the groups that the given user belongs to.

See Also:

GroupManager.getGroupNamesForUser(String)

getGroupsForUser

public Collection<com.atlassian.crowd.embedded.api.Group> getGroupsForUser(@Nonnull
                                                                           ApplicationUser user)

Description copied from interface: GroupManager

Returns all the groups that the given user belongs to.

Specified by:

getGroupsForUser in interface GroupManager

Parameters:

user - The user

Returns:

all the groups that the given user belongs to.

See Also:

GroupManager.getGroupNamesForUser(String)

getGroupNamesForUser

public Collection<String> getGroupNamesForUser(String userName)

Description copied from interface: GroupManager

Returns the names of all the groups that the given user belongs to.

Specified by:

getGroupNamesForUser in interface GroupManager

Parameters:

userName - The user

Returns:

all the groups that the given user belongs to.

See Also:

GroupManager.getGroupsForUser(String), GroupManager.getGroupNamesForUser(com.atlassian.jira.user.ApplicationUser)

getGroupNamesForUser

public Collection<String> getGroupNamesForUser(@Nonnull
                                               ApplicationUser user)

Description copied from interface: GroupManager

Returns the names of all the groups that the given user belongs to.

Specified by:

getGroupNamesForUser in interface GroupManager

Parameters:

user - The user

Returns:

all the groups that the given user belongs to.

See Also:

GroupManager.getGroupsForUser(String)

addUserToGroup

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

Description copied from interface: GroupManager

Adds a user as a member of a group.

Specified by:

addUserToGroup in interface GroupManager

Parameters:

user - The user that will become a member of the group.

group - The group that will gain a new member.

Throws:

com.atlassian.crowd.exception.GroupNotFoundException - if the group could not be found

com.atlassian.crowd.exception.UserNotFoundException - if the user could not be found

com.atlassian.crowd.exception.OperationNotPermittedException - if the directory has been configured to not allow the operation to be performed

com.atlassian.crowd.exception.OperationFailedException - If the underlying directory implementation failed to execute the operation.

getConnectUsers

@Deprecated
public Set<ApplicationUser> getConnectUsers()

Deprecated.

Description copied from interface: GroupManager

Returns all the connect app users. This will return an empty Set in JIRA Server as connect plugins are only supported in JIRA Cloud. This result does not filter out inactive users.

Specified by:

getConnectUsers in interface GroupManager

Returns:

all the connect app users.

getAllGroupNames

public Collection<String> getAllGroupNames()

Description copied from interface: GroupManager

Returns the names of all groups or an empty collection if there are no groups.

Specified by:

getAllGroupNames in interface GroupManager

Returns:

all the groups.