com.atlassian.jira.application

Class MockApplicationRoleManager

java.lang.Object

com.atlassian.jira.application.MockApplicationRoleManager

All Implemented Interfaces:

ApplicationRoleManager

public class MockApplicationRoleManager
extends Object
implements ApplicationRoleManager

Since:

v7.0

Constructor Summary

Constructors

Constructor and Description
MockApplicationRoleManager()

Method Summary

Modifier and Type	Method and Description
MockApplicationRole	createRole(com.atlassian.application.api.ApplicationKey key)
Set<com.atlassian.application.api.ApplicationKey>	getDefaultApplicationKeys() Returns an immutable Set of ApplicationKeys that are configured as the default applications for new users.
Set<com.atlassian.crowd.embedded.api.Group>	getDefaultGroups(com.atlassian.application.api.ApplicationKey key) Get the default Groups associated with the ApplicationRole backed by a (potentially exceeded) license.
Set<ApplicationRole>	getDefaultRoles() Returns an immutable Set of ApplicationRoles that are configured be default for new users.
Set<com.atlassian.crowd.embedded.api.Group>	getGroupsForLicensedRoles() Get the Set of group names that have been associated with all the ApplicationRoles that have a backing (but potentially exceeded) license.
Set<ApplicationRole>	getOccupiedLicenseRolesForUser(ApplicationUser user) Returns the Set of ApplicationRoles that the given ApplicationUser occupies seats in.
int	getRemainingSeats(com.atlassian.application.api.ApplicationKey key) Retrieve the number of available (unoccupied) user seats for the ApplicationRole backed by a (potentially exceeded) license.
com.atlassian.fugue.Option<ApplicationRole>	getRole(com.atlassian.application.api.ApplicationKey key) Returns the ApplicationRole identified by the given ApplicationKey, or Option.none() if no such ApplicationRole exists.
Set<ApplicationRole>	getRoles() Returns an immutable Set of all ApplicationRoles that are backed by a (potentially exceeded) license.
Set<ApplicationRole>	getRolesForGroup(com.atlassian.crowd.embedded.api.Group group) Returns the Set of ApplicationRoles associated with the given Group, or groups for which the given group is a nested group (sub-group).
Set<ApplicationRole>	getRolesForUser(ApplicationUser user) Returns the Set of ApplicationRoles granted to the given ApplicationUser.
int	getUserCount(com.atlassian.application.api.ApplicationKey key) Retrieve the number of active users for the given ApplicationRole.
boolean	hasAnyRole(ApplicationUser user) Returns true if the given user has been assigned to any ApplicationRole that is backed by a (potentially exceeded) license.
boolean	hasExceededAllRoles(ApplicationUser user) Returns true if the user limits of all of the given user's assigned ApplicationRoles have been exceeded.
boolean	hasSeatsAvailable(com.atlassian.application.api.ApplicationKey key, int seatCount) Determines whether the ApplicationRole backed by a license has the requested number of user seats available.
boolean	isAnyRoleLimitExceeded() Returns true if the number of users assigned to any ApplicationRole exceeds the number of seats granted to that role by its license.
boolean	isRoleInstalledAndLicensed(com.atlassian.application.api.ApplicationKey key) Determines whether an application identified by the given ApplicationKey is installed and running in this JIRA instance AND has a backing license key.
boolean	isRoleLimitExceeded(com.atlassian.application.api.ApplicationKey role) Returns true if the number of users assigned to the given ApplicationRole exceeds the number of seats granted by its license.
void	removeGroupFromRoles(com.atlassian.crowd.embedded.api.Group group) Removes any/all associations of the given group from all ApplicationRoles (irrespective of whether the ApplicationRoles is backed by a license).
ApplicationRole	setRole(ApplicationRole role) Save the passed ApplicationRole information to the database.
boolean	userHasRole(ApplicationUser user, com.atlassian.application.api.ApplicationKey key) Returns true if the passed user belongs to the ApplicationRole associated with the given key.
boolean	userOccupiesRole(ApplicationUser user, com.atlassian.application.api.ApplicationKey key) Returns true if the passed user occupies a seat in the ApplicationRole associated with the given key.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.atlassian.jira.application.ApplicationRoleManager

rolesEnabled

Constructor Detail

MockApplicationRoleManager

public MockApplicationRoleManager()

Method Detail

getRole

@Nonnull
public com.atlassian.fugue.Option<ApplicationRole> getRole(@Nonnull
                                                                    com.atlassian.application.api.ApplicationKey key)

Description copied from interface: ApplicationRoleManager

Returns the ApplicationRole identified by the given ApplicationKey, or Option.none() if no such ApplicationRole exists.

Note: ApplicationRoles returned by this method are guaranteed to be backed by a (potentially exceeded) license, however the installation state of the plugin/product that uses this role may not necessarily physically installed.

Specified by:

getRole in interface ApplicationRoleManager

Parameters:

key - the ApplicationKey of the role to search for.

Returns:

the ApplicationRole associated with the passed role identifier, or Option.none().

getRoles

@Nonnull
public Set<ApplicationRole> getRoles()

Description copied from interface: ApplicationRoleManager

Returns an immutable Set of all ApplicationRoles that are backed by a (potentially exceeded) license.

Specified by:

getRoles in interface ApplicationRoleManager

Returns:

the Set of all ApplicationRoles that are backed by a (potentially exceeded) license.

getDefaultRoles

@Nonnull
public Set<ApplicationRole> getDefaultRoles()

Description copied from interface: ApplicationRoleManager

Returns an immutable Set of ApplicationRoles that are configured be default for new users.

Specified by:

getDefaultRoles in interface ApplicationRoleManager

Returns:

the Set of ApplicationRoles that are configured be default for new users.

getDefaultApplicationKeys

@Nonnull
public Set<com.atlassian.application.api.ApplicationKey> getDefaultApplicationKeys()

Description copied from interface: ApplicationRoleManager

Returns an immutable Set of ApplicationKeys that are configured as the default applications for new users.

Specified by:

getDefaultApplicationKeys in interface ApplicationRoleManager

Returns:

the Set of ApplicationKeys that are configured as the default applications for new users.

See Also:

for defaul roles.

hasAnyRole

public boolean hasAnyRole(@Nullable
                          ApplicationUser user)

Description copied from interface: ApplicationRoleManager

Returns true if the given user has been assigned to any ApplicationRole that is backed by a (potentially exceeded) license.

Specified by:

hasAnyRole in interface ApplicationRoleManager

Returns:

true if the given user has been assigned to any ApplicationRole that is backed by a (potentially exceeded) license.

userHasRole

public boolean userHasRole(@Nullable
                           ApplicationUser user,
                           com.atlassian.application.api.ApplicationKey key)

Description copied from interface: ApplicationRoleManager

Returns true if the passed user belongs to the ApplicationRole associated with the given key. NOTE: This does not check that the application is licensed with a valid license.

Specified by:

userHasRole in interface ApplicationRoleManager

Parameters:

user - the user to check - if this is null, returns false

key - the key corresponding to the ApplicationRole

Returns:

true if the user belongs to a group of the given application

userOccupiesRole

public boolean userOccupiesRole(@Nullable
                                ApplicationUser user,
                                com.atlassian.application.api.ApplicationKey key)

Description copied from interface: ApplicationRoleManager

Returns true if the passed user occupies a seat in the ApplicationRole associated with the given key.

Specified by:

userOccupiesRole in interface ApplicationRoleManager

Parameters:

user - the user to check - if this is null, returns false

key - the key corresponding to the ApplicationRole

Returns:

true if the user occupies seat in the given application

hasExceededAllRoles

public boolean hasExceededAllRoles(@Nonnull
                                   ApplicationUser user)

Description copied from interface: ApplicationRoleManager

Returns true if the user limits of all of the given user's assigned ApplicationRoles have been exceeded. The user limit of an ApplicationRole is exceeded when the combined number of users assigned to that role (through assigned groups) exceeds the number of seats granted for that role in its license.

Note: this method does NOT take into account whether licenses for application roles are expired; this must be tested separately.

Specified by:

hasExceededAllRoles in interface ApplicationRoleManager

Parameters:

user - the user whose roles will be checked.

Returns:

true if all of the user's roles have user counts that exceed the number of seats granted by licenses.

isAnyRoleLimitExceeded

public boolean isAnyRoleLimitExceeded()

Description copied from interface: ApplicationRoleManager

Returns true if the number of users assigned to any ApplicationRole exceeds the number of seats granted to that role by its license.

Note: this method does NOT take into account whether licenses for installed roles are expired; this must be tested separately.

Specified by:

isAnyRoleLimitExceeded in interface ApplicationRoleManager

Returns:

true if the number of users for any role is greater than the number of seats granted to that role by its license.

isRoleLimitExceeded

public boolean isRoleLimitExceeded(@Nonnull
                                   com.atlassian.application.api.ApplicationKey role)

Description copied from interface: ApplicationRoleManager

Returns true if the number of users assigned to the given ApplicationRole exceeds the number of seats granted by its license. This method unconditionally returns false if the passed role is not considered to be installed (ie: backed by a license).

Note: this method does NOT take into account whether licenses for installed roles are expired; this must be tested separately.

Specified by:

isRoleLimitExceeded in interface ApplicationRoleManager

Parameters:

role - the identifier of the ApplicationRole.

Returns:

true if the installed ApplicationRole is exceeded or false otherwise.

getRolesForUser

public Set<ApplicationRole> getRolesForUser(@Nonnull
                                            ApplicationUser user)

Description copied from interface: ApplicationRoleManager

Returns the Set of ApplicationRoles granted to the given ApplicationUser.

Specified by:

getRolesForUser in interface ApplicationRoleManager

Parameters:

user - the user whose roles will be checked.

Returns:

the Set of ApplicationRoles for the given user.

getOccupiedLicenseRolesForUser

public Set<ApplicationRole> getOccupiedLicenseRolesForUser(@Nonnull
                                                           ApplicationUser user)

Description copied from interface: ApplicationRoleManager

Returns the Set of ApplicationRoles that the given ApplicationUser occupies seats in. ApplicationUser has to actively take a seat in the returned ApplicationRoles eg. for an ApplicationUser who has access to SOFTWARE and implicitly (or explicitly) CORE, they will only have SOFTWARE returned. For an ApplicationUser who has explicit access to SOFTWARE and CORE - with the SOFTWARE license exceeded, this will return both as the user effectively occupies a seat in both CORE and SOFTWARE now.

Specified by:

getOccupiedLicenseRolesForUser in interface ApplicationRoleManager

Parameters:

user - the user whose roles will be checked.

Returns:

the Set of ApplicationRoles that the given user is actively taking seats.

getRolesForGroup

public Set<ApplicationRole> getRolesForGroup(@Nonnull
                                             com.atlassian.crowd.embedded.api.Group group)

Description copied from interface: ApplicationRoleManager

Returns the Set of ApplicationRoles associated with the given Group, or groups for which the given group is a nested group (sub-group).

Specified by:

getRolesForGroup in interface ApplicationRoleManager

Parameters:

group - the group which roles will be checked.

Returns:

the Set of ApplicationRoles associated with the group or its super-groups.

getGroupsForLicensedRoles

@Nonnull
public Set<com.atlassian.crowd.embedded.api.Group> getGroupsForLicensedRoles()

Description copied from interface: ApplicationRoleManager

Get the Set of group names that have been associated with all the ApplicationRoles that have a backing (but potentially exceeded) license.

Specified by:

getGroupsForLicensedRoles in interface ApplicationRoleManager

Returns:

Groups associated with all the ApplicationRoles that have a backing (but potentially exceeded) license.

removeGroupFromRoles

public void removeGroupFromRoles(@Nonnull
                                 com.atlassian.crowd.embedded.api.Group group)

Description copied from interface: ApplicationRoleManager

Removes any/all associations of the given group from all ApplicationRoles (irrespective of whether the ApplicationRoles is backed by a license).

Specified by:

removeGroupFromRoles in interface ApplicationRoleManager

Parameters:

group - the group to remove.

isRoleInstalledAndLicensed

public boolean isRoleInstalledAndLicensed(@Nonnull
                                          com.atlassian.application.api.ApplicationKey key)

Description copied from interface: ApplicationRoleManager

Determines whether an application identified by the given ApplicationKey is installed and running in this JIRA instance AND has a backing license key.

Specified by:

isRoleInstalledAndLicensed in interface ApplicationRoleManager

Parameters:

key - the key that identifies the ApplicationRole backed by a (potentially exceeded) license.

Returns:

true when the ApplicationRole backed by a (potentially exceeded) license has an associated application installed and running in this JIRA instance.

setRole

@Nonnull
public ApplicationRole setRole(@Nonnull
                                        ApplicationRole role)

Description copied from interface: ApplicationRoleManager

Save the passed ApplicationRole information to the database. This method will only accept the passed role if:

1. The role is backed by a (potentially exceeded) license.
2. The role only contains currently valid groups.
3. The default group are not a subset of the groups in the role.

Specified by:

setRole in interface ApplicationRoleManager

Parameters:

role - the role to save.

Returns:

the role as persisted to the database.

getUserCount

public int getUserCount(@Nonnull
                        com.atlassian.application.api.ApplicationKey key)

Description copied from interface: ApplicationRoleManager

Retrieve the number of active users for the given ApplicationRole. It will uniquely count all users who are found in the groups associated with the application.

Specified by:

getUserCount in interface ApplicationRoleManager

Parameters:

key - the key that identifies the ApplicationRole.

Returns:

the number of active users for the given ApplicationRole, or zero if the ApplicationRole does not exist.

getRemainingSeats

public int getRemainingSeats(@Nonnull
                             com.atlassian.application.api.ApplicationKey key)

Description copied from interface: ApplicationRoleManager

Retrieve the number of available (unoccupied) user seats for the ApplicationRole backed by a (potentially exceeded) license.

Specified by:

getRemainingSeats in interface ApplicationRoleManager

Parameters:

key - the key that identifies the licensed ApplicationRole.

Returns:

the number of remaining users seats. Will return zero when there are more users than seats licensed, the ApplicationRole is not valid or there are as many active users as seats in the license. When the license is unlimited, it will return minus one (-1)

See Also:

for finding occupied user seats.

hasSeatsAvailable

public boolean hasSeatsAvailable(@Nonnull
                                 com.atlassian.application.api.ApplicationKey key,
                                 int seatCount)

Description copied from interface: ApplicationRoleManager

Determines whether the ApplicationRole backed by a license has the requested number of user seats available.

Specified by:

hasSeatsAvailable in interface ApplicationRoleManager

Parameters:

key - the key that identifies the ApplicationRole.

seatCount - the number of user seats that this ApplicationRole should have capacity for.

Returns:

true if the ApplicationRole for the provided ApplicationKey has the number of user seats available. false if the there are not enough seats available.

getDefaultGroups

@Nonnull
public Set<com.atlassian.crowd.embedded.api.Group> getDefaultGroups(@Nonnull
                                                                             com.atlassian.application.api.ApplicationKey key)

Description copied from interface: ApplicationRoleManager

Get the default Groups associated with the ApplicationRole backed by a (potentially exceeded) license.

Specified by:

getDefaultGroups in interface ApplicationRoleManager

Parameters:

key - the key that identifies the ApplicationRole.

Returns:

the Set of default groups associated with the ApplicationRole.

createRole

public MockApplicationRole createRole(com.atlassian.application.api.ApplicationKey key)