com.atlassian.confluence.plugins.rest.resources

Class SearchService

java.lang.Object

com.atlassian.confluence.plugins.rest.resources.AbstractResource

com.atlassian.confluence.plugins.rest.resources.SearchService

public class SearchService
extends AbstractResource

A service providing search results using the Confluence search with various parameters.

Field Summary

Fields inherited from class com.atlassian.confluence.plugins.rest.resources.AbstractResource

authContext, uriInfo, userAccessor

Constructor Summary

Constructors

Constructor and Description
SearchService(UserAccessor userAccessor, RestSearchService searchService, SpacePermissionManager spacePermissionManager)

Method Summary

Modifier and Type	Method and Description
javax.ws.rs.core.Response	doContentNameSearch(String query, String type, String spaceKey, Set<String> attachmentType, Set<String> label, boolean groupResults, boolean searchParentName, String preferredSpaceKey, int startIndex, Integer pageSize, Integer maxResultsPerGroup) Search is performed on the name of content only e.g.
javax.ws.rs.core.Response	doGroupSearch(String query, int maxResults) Group specific search.
javax.ws.rs.core.Response	doSearch(String query, String type, String search, int startIndex, Integer pageSize, Integer maxResults, String spaceKey, Set<String> attachmentType, Set<String> label, boolean groupResults, boolean searchParentName, String preferredSpaceKey, Integer maxResultsPerGroup) Search Confluence using the given parameters.
javax.ws.rs.core.Response	doSiteSearch(String query, String type, String spaceKey, Set<String> attachmentType, Set<String> label, int startIndex, Integer pageSize) Site wide Confluence search.
javax.ws.rs.core.Response	doUserOrGroupSearch(String query, int maxResults) User and group specific search.
javax.ws.rs.core.Response	doUserSearch(String query, int maxResults) User specific search.

Methods inherited from class com.atlassian.confluence.plugins.rest.resources.AbstractResource

createRequestContext, getAnonymousUserUriBuilder, getAttachmentUriBuilder, getContentUriBuilder, getCurrentUser, getMissingUserUriBuilder, getSpaceUriBuilder, getUserUriBuilder

Methods inherited from class java.lang.Object

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

Constructor Detail

SearchService

public SearchService(UserAccessor userAccessor,
                     RestSearchService searchService,
                     SpacePermissionManager spacePermissionManager)

Method Detail

doSearch

public javax.ws.rs.core.Response doSearch(String query,
                                          String type,
                                          String search,
                                          int startIndex,
                                          Integer pageSize,
                                          Integer maxResults,
                                          String spaceKey,
                                          Set<String> attachmentType,
                                          Set<String> label,
                                          boolean groupResults,
                                          boolean searchParentName,
                                          String preferredSpaceKey,
                                          Integer maxResultsPerGroup)

Search Confluence using the given parameters.

Parameters:

query - Query string.

type - Content types to search for. Can be one of: PAGE, COMMENT, BLOG, ATTACHMENT, PERSONAL_INFORMATION, SPACE_DESCRIPTION, PERSONAL_SPACE_DESCRIPTION, RAW or USER_STATUS. You can specify multiple types by passing a comma separated list like: &type=mail,blog

search - The type of search. Can be one of: name, site (case sensitive, if no match is found site is assumed).

startIndex - Start index for site/ungrouped name searches.

pageSize - Max size of page for site/ungrouped name searches.

spaceKey - Keys of spaces to search in. If not specified, Confluence searches in all spaces.

attachmentType - Attachment types to search in. If not specified, Confluence searches all attachments. Can be one or more of: PDF IMAGE, XML, HTML, TEXT, WORD, EXCEL, POWERPOINT, JAVA_SOURCE, JAVA_ARCHIVE, ZIP. You can specify multiple types like this: ?attachmentType=image&attachmentType=pdf

label - Filters the results for content with the specified labels, if not specified all results are returned. Format is namespace:label, e.g. global:label. Namespaces: global, my, team, and system.

groupResults - indicates whether results should be grouped (default is true) for name searches

searchParentName - indicates whether search should include the parent name (e.g. a page title for an attachment) for name searches

preferredSpaceKey - the space key that is used to search by

Returns:

doSiteSearch

public javax.ws.rs.core.Response doSiteSearch(String query,
                                              String type,
                                              String spaceKey,
                                              Set<String> attachmentType,
                                              Set<String> label,
                                              int startIndex,
                                              Integer pageSize)

Site wide Confluence search.

Parameters:

query - query string

type - content types to search for

spaceKey - keys of spaces to search in, if not specified it searches in all spaces

attachmentType - attachment types to search in, if not specified it searches all attachments

startIndex - start index of search results

pageSize - max page size of search results

label - Filters the results for content with the specified labels, if not specified all results are returned. Format is namespace:label, e.g. global:label. Namespaces: global, my, team, and system.

doContentNameSearch

public javax.ws.rs.core.Response doContentNameSearch(String query,
                                                     String type,
                                                     String spaceKey,
                                                     Set<String> attachmentType,
                                                     Set<String> label,
                                                     boolean groupResults,
                                                     boolean searchParentName,
                                                     String preferredSpaceKey,
                                                     int startIndex,
                                                     Integer pageSize,
                                                     Integer maxResultsPerGroup)

Search is performed on the name of content only e.g. title of page, name of attachment

Parameters:

query - query string

type - content types to search for

spaceKey - keys of spaces to search in, if not specified it searches in all spaces

attachmentType - attachment types to search in, if not specified it searches all attachments

label - Filters the results for content with the specified labels, if not specified all results are returned. Format is namespace:label, e.g. global:label. Namespaces: global, my, team, and system.

groupResults - indicates whether results should be grouped (default is true)

searchParentName - indicates whether search should include the parent name (e.g. a page title for an attachment)

startIndex - start index of search results (ignored when groupResults is true)

pageSize - max page size of search results (ignored when groupResults is true)

doUserSearch

public javax.ws.rs.core.Response doUserSearch(String query,
                                              int maxResults)

User specific search. Searches on username and full name.

Parameters:

query - query string

maxResults - maximum number of search results

doGroupSearch

public javax.ws.rs.core.Response doGroupSearch(String query,
                                               int maxResults)

Group specific search. Searches on group name.

Parameters:

query - The group name (or the start of the group name)

maxResults - maximum number of search results

doUserOrGroupSearch

public javax.ws.rs.core.Response doUserOrGroupSearch(String query,
                                                     int maxResults)

User and group specific search. Searches on username, full name and group name.

Parameters:

query - The name (or the start of the name)

maxResults - maximum number of search results