com.atlassian.crowd.service

Interface DirectoryEntitySearchService

All Known Implementing Classes:

DirectoryEntitySearchServiceImpl

@ExperimentalApi
public interface DirectoryEntitySearchService

Interface for various user searches.

Since:

3.3.0

Method Summary

Modifier and Type	Method and Description
List<Group>	searchGroups(EntityQuery<Group> groupsQuery, List<Directory> directoriesRestriction) Returns groups matching groupsQuery.
List<User>	searchPotentialMembers(EntityQuery<User> usersQuery, long directoryId, String groupName) Returns users that can be assigned as members of the specified group.
List<User>	searchUsers(EntityQuery<User> usersQuery, List<Directory> directoriesRestriction) Returns users matching usersQuery.

Method Detail

searchUsers

List<User> searchUsers(EntityQuery<User> usersQuery,
                       List<Directory> directoriesRestriction)
                throws DirectoryNotFoundException,
                       OperationFailedException,
                       IllegalAccessException,
                       UserNotFoundException,
                       FeatureInaccessibleException

Returns users matching usersQuery. Requires a user context, and only allows searches in directories that the current user can administer.

Parameters:

usersQuery - users query

directoriesRestriction - if not empty, search will be restricted to the specified directories

Returns:

list of matching users with stable sort. User existing in multiple directories won't be merged.

Throws:

DirectoryNotFoundException

OperationFailedException

IllegalAccessException

UserNotFoundException

FeatureInaccessibleException

searchPotentialMembers

List<User> searchPotentialMembers(EntityQuery<User> usersQuery,
                                  long directoryId,
                                  String groupName)
                           throws DirectoryNotFoundException,
                                  GroupNotFoundException,
                                  OperationFailedException,
                                  UserNotFoundException,
                                  FeatureInaccessibleException

Returns users that can be assigned as members of the specified group.

Parameters:

usersQuery - users query

directoryId - directory id of the group

groupName - group name

Returns:

list of matching users with stable sort.

Throws:

DirectoryNotFoundException

GroupNotFoundException

OperationFailedException

UserNotFoundException

FeatureInaccessibleException

searchGroups

List<Group> searchGroups(EntityQuery<Group> groupsQuery,
                         List<Directory> directoriesRestriction)
                  throws DirectoryNotFoundException,
                         OperationFailedException,
                         IllegalAccessException,
                         UserNotFoundException,
                         FeatureInaccessibleException

Returns groups matching groupsQuery. Requires a user context, and only allows searches in directories that the current user can administer.

Parameters:

groupsQuery - groups query

directoriesRestriction - if not empty, search will be restricted to the specified directories

Returns:

list of matching groups with stable sort. Group existing in multiple directories won't be merged.

Throws:

DirectoryNotFoundException

OperationFailedException

IllegalAccessException

UserNotFoundException

FeatureInaccessibleException