Package com.atlassian.crowd.service

Interface DirectoryEntitySearchService

@ExperimentalApi
public interface DirectoryEntitySearchService

Interface for various user searches.

Since:

3.3.0

Method Summary

Modifier and Type	Method	Description
List<Group>	searchGroups(EntityQuery<Group> groupsQuery, List<com.atlassian.crowd.embedded.api.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<com.atlassian.crowd.embedded.api.Directory> directoriesRestriction)	Returns users matching usersQuery.

Method Details

searchUsers

List<User> searchUsers(EntityQuery<User> usersQuery,
 List<com.atlassian.crowd.embedded.api.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<com.atlassian.crowd.embedded.api.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