com.atlassian.jira.security.groups

Class MockGroupManager

java.lang.Object

com.atlassian.jira.security.groups.MockGroupManager

All Implemented Interfaces:

GroupManager

public class MockGroupManager
extends Object
implements GroupManager

Since:

v4.3

Constructor Summary

Constructors

Constructor and Description
MockGroupManager()
MockGroupManager(com.atlassian.crowd.embedded.api.CrowdService crowdService)

Method Summary

Modifier and Type	Method and Description
MockGroupManager	addGroup(com.atlassian.crowd.embedded.api.Group group)
com.atlassian.crowd.embedded.api.Group	addGroup(String groupName)
void	addMember(String groupName, String userName)
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<com.atlassian.crowd.embedded.api.Group>	getAllGroups() Get all groups.
Set<ApplicationUser>	getConnectUsers() Returns all the connect add-on users.
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 active, 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.
MockGroupManager	setUserMembership(ApplicationUser user, com.atlassian.crowd.embedded.api.Group... groups)
<T extends Exception> void	throwExceptionOnCreateGroup(String groupName, Exception cause)

Methods inherited from class java.lang.Object

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

Constructor Detail

MockGroupManager

public MockGroupManager()

MockGroupManager

public MockGroupManager(com.atlassian.crowd.embedded.api.CrowdService crowdService)

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)

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.

throwExceptionOnCreateGroup

public <T extends Exception> void throwExceptionOnCreateGroup(String groupName,
                                                              Exception cause)

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 active,
                                             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

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

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.

getConnectUsers

public Set<ApplicationUser> getConnectUsers()

Description copied from interface: GroupManager

Returns all the connect add-on 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 add-on users.

addGroup

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

addGroup

public MockGroupManager addGroup(com.atlassian.crowd.embedded.api.Group group)

addMember

public void addMember(String groupName,
                      String userName)

setUserMembership

public MockGroupManager setUserMembership(ApplicationUser user,
                                          com.atlassian.crowd.embedded.api.Group... groups)