com.atlassian.jira.rest.v2.issue.users

Class UserPickerResourceHelperImpl

java.lang.Object

com.atlassian.jira.rest.v2.issue.users.UserPickerResourceHelperImpl

All Implemented Interfaces:

UserPickerResourceHelper

@Component
public class UserPickerResourceHelperImpl
extends Object
implements UserPickerResourceHelper

A helper for finding users

Since:

v5.2

Constructor Summary

Constructors

Constructor and Description
UserPickerResourceHelperImpl(UserSearchService userSearchService, I18nHelper i18n, AvatarService avatarService, JiraAuthenticationContext authContext, PermissionManager permissionManager)

Method Summary

Modifier and Type	Method and Description
List<ApplicationUser>	findActiveUsers(String searchString) Finds active users, throws exception if search string is null
List<ApplicationUser>	findUsers(String searchString, Boolean includeActive, Boolean includeInactive) Finds users, throws exception if search string is null
List<ApplicationUser>	findUsers(String searchString, Boolean includeActive, Boolean includeInactive, boolean allowEmptySearchString) Finds users, throws exception if search string is null
List<ApplicationUser>	findUsers(String searchString, Boolean includeActive, Boolean includeInactive, boolean allowEmptySearchString, com.google.common.base.Predicate<com.atlassian.crowd.embedded.api.User> userFilter) Finds users, throws exception if search string is null
List<ApplicationUser>	findUsers(String searchString, Boolean includeActive, Boolean includeInactive, boolean allowEmptySearchString, com.google.common.base.Predicate<com.atlassian.crowd.embedded.api.User> userFilter, Integer maxResults) Finds users, throws exception if search string is null
List<ApplicationUser>	findUsers(String searchString, UserSearchParams userSearchParams) Finds users, throws exception if search string is null
UserPickerResultsBean	findUsersAsBean(String query, Integer maxResults, Boolean showAvatar, List<String> excludeUsers) Returns a list of users matching query with highlighting.
UserPickerResultsBean	findUsersAsBean(String query, Integer maxResults, Boolean showAvatar, List<String> excludeUsers, UserSearchParams userSearchParams) Returns a list of users matching query with highlighting.
ApplicationUser	getUserByName(String userName) Returns a user if supplied userName is exact match to their username.
List<ApplicationUser>	limitUserSearch(Integer startAt, Integer maxResults, Iterable<ApplicationUser> users, Iterable<String> excludeUsers)

Methods inherited from class java.lang.Object

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

Constructor Detail

UserPickerResourceHelperImpl

@Autowired
public UserPickerResourceHelperImpl(UserSearchService userSearchService,
                                               I18nHelper i18n,
                                               AvatarService avatarService,
                                               JiraAuthenticationContext authContext,
                                               PermissionManager permissionManager)

Method Detail

findUsersAsBean

public UserPickerResultsBean findUsersAsBean(String query,
                                             Integer maxResults,
                                             Boolean showAvatar,
                                             List<String> excludeUsers)

Returns a list of users matching query with highlighting. This resource cannot be accessed anonymously.

Specified by:

findUsersAsBean in interface UserPickerResourceHelper

Parameters:

query - A string used to search username, Name or e-mail address

maxResults - the maximum number of users to return (defaults to 50). The maximum allowed value is 1000. If you specify a value that is higher than this number, your search results will be truncated.

showAvatar -

excludeUsers -

Returns:

An object containing list of matched user objects, with html representing highlighting.

findUsersAsBean

public UserPickerResultsBean findUsersAsBean(String query,
                                             Integer maxResults,
                                             Boolean showAvatar,
                                             List<String> excludeUsers,
                                             UserSearchParams userSearchParams)

Description copied from interface: UserPickerResourceHelper

Returns a list of users matching query with highlighting. This resource cannot be assessed anonymously.

Specified by:

findUsersAsBean in interface UserPickerResourceHelper

Parameters:

query - A string used to search username, Name or e-mail address. Empty query is not allowed.

maxResults - the maximum number of users to return (defaults to 50). The maximum allowed value is 1000. If you specify a value that is higher than this number, your search results will be truncated.

showAvatar - get avatar url

excludeUsers - exclude these users from search results

userSearchParams - additional search parameters. allowEmptyQuery is ignored, always treated as false.

Returns:

An object containing list of matched user objects, with html representing highlighting.

limitUserSearch

public List<ApplicationUser> limitUserSearch(Integer startAt,
                                             Integer maxResults,
                                             Iterable<ApplicationUser> users,
                                             Iterable<String> excludeUsers)

Specified by:

limitUserSearch in interface UserPickerResourceHelper

Parameters:

startAt - start the search at this index

maxResults - max results

users - search results to limit

excludeUsers - exclude these users from search results

Returns:

adjusted search results

findActiveUsers

public List<ApplicationUser> findActiveUsers(String searchString)

Description copied from interface: UserPickerResourceHelper

Finds active users, throws exception if search string is null

Specified by:

findActiveUsers in interface UserPickerResourceHelper

Parameters:

searchString - user query

Returns:

List of matching users

findUsers

public List<ApplicationUser> findUsers(String searchString,
                                       Boolean includeActive,
                                       Boolean includeInactive)

Description copied from interface: UserPickerResourceHelper

Finds users, throws exception if search string is null

Specified by:

findUsers in interface UserPickerResourceHelper

Parameters:

searchString - user query, no users returned if empty

includeActive - whether to include active users (null implies true)

includeInactive - whether to include inactive users (null implies false)

Returns:

List of matching users

findUsers

public List<ApplicationUser> findUsers(String searchString,
                                       Boolean includeActive,
                                       Boolean includeInactive,
                                       boolean allowEmptySearchString)

Description copied from interface: UserPickerResourceHelper

Finds users, throws exception if search string is null

Specified by:

findUsers in interface UserPickerResourceHelper

Parameters:

searchString - user query

includeActive - whether to include active users (null implies true)

includeInactive - whether to include inactive users (null implies false)

allowEmptySearchString - controls whether users are returned if searchString is empty

Returns:

List of matching users

findUsers

public List<ApplicationUser> findUsers(String searchString,
                                       Boolean includeActive,
                                       Boolean includeInactive,
                                       boolean allowEmptySearchString,
                                       com.google.common.base.Predicate<com.atlassian.crowd.embedded.api.User> userFilter)

Description copied from interface: UserPickerResourceHelper

Finds users, throws exception if search string is null

Specified by:

findUsers in interface UserPickerResourceHelper

Parameters:

searchString - user query

includeActive - whether to include active users (null implies true)

includeInactive - whether to include inactive users (null implies false)

allowEmptySearchString - controls whether users are returned if searchString is empty

userFilter - filter to post-process user results with. May be null for no filtering.

Returns:

List of matching users

findUsers

public List<ApplicationUser> findUsers(String searchString,
                                       Boolean includeActive,
                                       Boolean includeInactive,
                                       boolean allowEmptySearchString,
                                       com.google.common.base.Predicate<com.atlassian.crowd.embedded.api.User> userFilter,
                                       Integer maxResults)

Description copied from interface: UserPickerResourceHelper

Finds users, throws exception if search string is null

Specified by:

findUsers in interface UserPickerResourceHelper

Parameters:

searchString - user query

includeActive - whether to include active users (null implies true)

includeInactive - whether to include inactive users (null implies false)

allowEmptySearchString - controls whether users are returned if searchString is empty

userFilter - filter to post-process user results with. May be null for no filtering.

maxResults - the result limit, use null for no limit.

Returns:

List of matching users

findUsers

public List<ApplicationUser> findUsers(String searchString,
                                       UserSearchParams userSearchParams)

Description copied from interface: UserPickerResourceHelper

Finds users, throws exception if search string is null

Specified by:

findUsers in interface UserPickerResourceHelper

Parameters:

searchString - user query

userSearchParams - search parameters, including "includeActive", "includeInactive", etc. allowEmptyQuery is ignored, always treated as false.

Returns:

List of matching users

getUserByName

public ApplicationUser getUserByName(String userName)

Description copied from interface: UserPickerResourceHelper

Returns a user if supplied userName is exact match to their username.

Specified by:

getUserByName in interface UserPickerResourceHelper

Parameters:

userName - The username query

Returns:

User The exact user or null if not found.