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

java.lang.Object
  extended by 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


Copyright © 2002-2012 Atlassian. All Rights Reserved.