com.atlassian.jira.bc.user.search
Class DefaultAssigneeService

java.lang.Object
  com.atlassian.jira.bc.user.search.DefaultAssigneeService

All Implemented Interfaces:

AssigneeService

public class DefaultAssigneeService
extends Object
implements AssigneeService

The main implementation of AssigneeService.

Since:

v5.0

Constructor Summary

DefaultAssigneeService(PermissionContextFactory permissionContextFactory, PermissionSchemeManager permissionSchemeManager, UserManager userManager, UserHistoryManager userHistoryManager, FeatureManager featureManager, JiraAuthenticationContext authenticationContext)

Method Summary

Collection<com.atlassian.crowd.embedded.api.User>	findAssignableUsers(String query, Issue issue, com.opensymphony.workflow.loader.ActionDescriptor actionDescriptor) Get assignable Users based on a query string and issue.
List<com.atlassian.crowd.embedded.api.User>	getAssignableUsers(Issue issue, com.opensymphony.workflow.loader.ActionDescriptor actionDescriptor) Get all Users that may have an Issue assigned to them, for a given workflow state.
Set<String>	getRecentAssigneeNamesForIssue(Issue issue) Gets ids of this issue's recent assignees, including the current assignee.
Set<String>	getRecentAssigneeNamesForUser(com.atlassian.crowd.embedded.api.User remoteUser) Returns the names of Users that have recently been assigned to issues by the specified User.
List<com.atlassian.crowd.embedded.api.User>	getSuggestedAssignees(Issue issue, com.atlassian.crowd.embedded.api.User loggedInUser, List<com.atlassian.crowd.embedded.api.User> assignableUsers) Returns a list of suggested Assignee Users for a given Issue and logged-in User.
List<com.atlassian.crowd.embedded.api.User>	getSuggestedAssignees(Set<String> suggestedAssigneeNames, List<com.atlassian.crowd.embedded.api.User> assignableUsers) Given a set of suggested names and an ordered list of assignable users, returns an order list of suggested users.
Map<String,Boolean>	makeUniqueFullNamesMap(Collection<com.atlassian.crowd.embedded.api.User> users) Converts a collection of Users to a Map where the key is the User full name and the value is true or false.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultAssigneeService

public DefaultAssigneeService(PermissionContextFactory permissionContextFactory,
                              PermissionSchemeManager permissionSchemeManager,
                              UserManager userManager,
                              UserHistoryManager userHistoryManager,
                              FeatureManager featureManager,
                              JiraAuthenticationContext authenticationContext)

Method Detail

getSuggestedAssignees

public List<com.atlassian.crowd.embedded.api.User> getSuggestedAssignees(Issue issue,
                                                                         com.atlassian.crowd.embedded.api.User loggedInUser,
                                                                         List<com.atlassian.crowd.embedded.api.User> assignableUsers)

Description copied from interface: AssigneeService

Returns a list of suggested Assignee Users for a given Issue and logged-in User.

This version accepts a pre-populated list of assignable Users to filter.

Specified by:

getSuggestedAssignees in interface AssigneeService

Parameters:

issue - Issue to get suggested Assignees for

loggedInUser - the user getting the suggestions, whose Assignee history may be queried

assignableUsers - a list of Users to filter

Returns:

List of User objects deemed relevant to the given Issue and User.

findAssignableUsers

public Collection<com.atlassian.crowd.embedded.api.User> findAssignableUsers(String query,
                                                                             Issue issue,
                                                                             @Nullable
                                                                             com.opensymphony.workflow.loader.ActionDescriptor actionDescriptor)

Description copied from interface: AssigneeService

Get assignable Users based on a query string and issue.

Matches on the start of username, Each word in Full Name & email.

Results are sorted according to the UserBestNameComparator.

Specified by:

findAssignableUsers in interface AssigneeService

Parameters:

query - String to search for.

issue - Issue to check Assignee permissions against

actionDescriptor - an ActionDescriptor describing the context in which the Assignee is being searched

Returns:

List of User objects that match criteria.

getSuggestedAssignees

public List<com.atlassian.crowd.embedded.api.User> getSuggestedAssignees(Set<String> suggestedAssigneeNames,
                                                                         List<com.atlassian.crowd.embedded.api.User> assignableUsers)

Given a set of suggested names and an ordered list of assignable users, returns an order list of suggested users.

Specified by:

getSuggestedAssignees in interface AssigneeService

Parameters:

suggestedAssigneeNames - the names of the users to return

assignableUsers - a list of Users to filter by the suggested assignee names

Returns:

a filtered List of assignable Users that are suggested as Assignees

getAssignableUsers

public List<com.atlassian.crowd.embedded.api.User> getAssignableUsers(Issue issue,
                                                                      com.opensymphony.workflow.loader.ActionDescriptor actionDescriptor)

Description copied from interface: AssigneeService

Get all Users that may have an Issue assigned to them, for a given workflow state.

The ActionDescriptor may be used to check for workflow states that only allow a subset of normally-assignable users.

Specified by:

getAssignableUsers in interface AssigneeService

Parameters:

issue - the Issue to find assignable users for

actionDescriptor - workflow action descriptor to filter users on

Returns:

a list of Users

getRecentAssigneeNamesForIssue

public Set<String> getRecentAssigneeNamesForIssue(Issue issue)

Gets ids of this issue's recent assignees, including the current assignee.

Specified by:

getRecentAssigneeNamesForIssue in interface AssigneeService

Parameters:

issue - and issue to get the change history of

Returns:

a set of ids

makeUniqueFullNamesMap

public Map<String,Boolean> makeUniqueFullNamesMap(Collection<com.atlassian.crowd.embedded.api.User> users)

Description copied from interface: AssigneeService

Converts a collection of Users to a Map where the key is the User full name and the value is true or false.

The value will be true if no other user with that exact full name exists. The value will be false if at least one other user with that exact full name exists.

Specified by:

makeUniqueFullNamesMap in interface AssigneeService

Parameters:

users - a collection of Users that may contain multiple users with the same full name

Returns:

a map of user full name Strings to a uniqueness boolean flag

getRecentAssigneeNamesForUser

public Set<String> getRecentAssigneeNamesForUser(com.atlassian.crowd.embedded.api.User remoteUser)

Description copied from interface: AssigneeService

Returns the names of Users that have recently been assigned to issues by the specified User.

Specified by:

getRecentAssigneeNamesForUser in interface AssigneeService

Parameters:

remoteUser - User to check for assignees in history manager

Returns:

a Set of assignee usernames