Package com.atlassian.confluence.internal.search

Class DecoratedSearchManager

java.lang.Object

com.atlassian.confluence.internal.search.DecoratedSearchManager

All Implemented Interfaces:

SearchManager

public class DecoratedSearchManager
extends Object
implements SearchManager

Since:

7.0.1

Nested Class Summary

Nested classes/interfaces inherited from interface com.atlassian.confluence.search.v2.SearchManager

SearchManager.Categorizer<T>, SearchManager.EntityVersionPolicy

Constructor Summary

Constructors

Constructor	Description
DecoratedSearchManager(SearchManager delegate, SearchDecoratorProvider decoratorProvider)

Method Summary

Modifier and Type	Method	Description
List<Searchable>	convertToEntities(SearchResults searchResults, SearchManager.EntityVersionPolicy versionPolicy)	Helper method to convert search results into a list of database entities.
String	explain(ISearch search, long contentId)	Produce an explanation of the search query for the specified contentId.
long	scan(EnumSet<SearchIndex> indexes, SearchQuery searchQuery, Set<String> requestedFields, Consumer<Map<String,String[]>> consumer)	Execute Consumer.accept(T) for each search result.
SearchResults	search(ISearch search)	Perform a search with a given criteria.
SearchResults	search(ISearch search, Set<String> requestedFields)	Perform a search with a given criteria, the returns searchResults only have the fields requested in the projection filled out, no other fields are valid in the searchResult.
SearchResults	search(SearchWithToken search)	Perform a search against a specific version of the search index (identified by calling SearchWithToken.getSearchToken() on the specified search).
<T> Map<T,List<Map<String,String>>>	searchCategorised(ISearch search, SearchManager.Categorizer<T> categorizer)	Perform a search with the given criteria, the top results are collected per category specified by the given SearchManager.Categorizer.
List<Searchable>	searchEntities(ISearch search, SearchManager.EntityVersionPolicy versionPolicy)	Perform a search with the given criteria, returning the results as a list of database entity objects.

Methods inherited from class java.lang.Object

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

Constructor Detail

DecoratedSearchManager

public DecoratedSearchManager(SearchManager delegate,
                              SearchDecoratorProvider decoratorProvider)

Method Detail

search

public SearchResults search(ISearch search)
                     throws InvalidSearchException

Description copied from interface: SearchManager

Perform a search with a given criteria.

Will throw an InvalidSearchException if some error occurred converting the search object into a search that could be performed in the back-end. Usually this is a sign that some plugin that was used to create the search is no longer available.

If the ISearch contains no ContentStatusQuery in the search query or search filter tree the result of ContentStatusQuery.getDefaultContentStatusQuery() will be added as a top level AND query.

NOTE: the search limit will be capped at SearchConstants.MAX_LIMIT and the startOffset will be capped at SearchConstants.MAX_START_OFFSET for more efficient heap usage. See SearchResults.getNextPageSearch() for pagination.

WARNING: there is no default permissions checking behaviour provided. You MUST provide a search which specifies permissions checking. See SiteSearchPermissionsQueryFactory to add one yourself. See PredefinedSearchBuilder to build a pre-defined search which contains permission checking.

Specified by:

search in interface SearchManager

Parameters:

search - the search to perform

Returns:

the results of that search

Throws:

InvalidSearchException - when this manager is unable to translate and conduct the specified search. Clients should just discard the search if this occurs.

search

public SearchResults search(SearchWithToken search)
                     throws SearchTokenExpiredException,
                            InvalidSearchException

Description copied from interface: SearchManager

Perform a search against a specific version of the search index (identified by calling SearchWithToken.getSearchToken() on the specified search).

This can be useful for retrieving the next page of results after an initial search. The next page of results will be calculated from the version of the search index that the initial search was performed on.

Usage:

     SearchResults searchResults = searchManager.search(search);

     // fetch next page of results
     if (!searchResults.isLastPage())
         SearchResults nextPageOfSearchResults = searchManager.search(searchResults.getNextPageSearch());
 

If the SearchWithToken contains no ContentStatusQuery in the search query or search filter tree the result of ContentStatusQuery.getDefaultContentStatusQuery() will be added as a top level AND query.

NOTE: the search limit will be capped at SearchConstants.MAX_LIMIT and the startOffset will be capped at SearchConstants.MAX_START_OFFSET for more efficient heap usage. See SearchResults.getNextPageSearch() for pagination.

WARNING: there is no default permissions checking behaviour provided. You MUST provide a search which specifies permissions checking. See SiteSearchPermissionsQueryFactory to add one yourself. See PredefinedSearchBuilder to build a pre-defined search which contains permission checking.

Specified by:

search in interface SearchManager

Parameters:

search - a search that specifies a search token.

Returns:

the results of that search

Throws:

SearchTokenExpiredException - if the specified search token has expired. Clients should report this the user and / or retry the search with SearchManager.search(ISearch).

InvalidSearchException - when this manager is unable to translate and conduct the specified search. Clients should just discard the search if this occurs.

search

public SearchResults search(ISearch search,
                            Set<String> requestedFields)
                     throws InvalidSearchException

Description copied from interface: SearchManager

Perform a search with a given criteria, the returns searchResults only have the fields requested in the projection filled out, no other fields are valid in the searchResult. SearchResults will throw an FieldNotRequestedException if an attempt is made to access a field value that has not had it's key included in the projection Set.

Will throw an InvalidSearchException if some error occurred converting the search object into a search that could be performed in the back-end. Usually this is a sign that some plugin that was used to create the search is no longer available.

If the ISearch contains no ContentStatusQuery in the search query or search filter tree the result of ContentStatusQuery.getDefaultContentStatusQuery() will be added as a top level AND query.

NOTE: the search limit will be capped at SearchConstants.MAX_LIMIT and the startOffset will be capped at SearchConstants.MAX_START_OFFSET for more efficient heap usage. See SearchResults.getNextPageSearch() for pagination.

NOTE: the search limit will be capped at SearchConstants.MAX_LIMIT and the startOffset will be capped at SearchConstants.MAX_START_OFFSET for more efficient heap usage. See SearchResults.getNextPageSearch() for pagination.

WARNING: there is no default permissions checking behaviour provided. You MUST provide a search which specifies permissions checking. See SiteSearchPermissionsQueryFactory to add one yourself. See PredefinedSearchBuilder to build a pre-defined search which contains permission checking.

Specified by:

search in interface SearchManager

requestedFields - requested fields. Passing null will request all fields, and passing empty set will request none.

Returns:

the results of the search, containing only the requested fields.

Throws:

InvalidSearchException

searchEntities

public List<Searchable> searchEntities(ISearch search,
                                       SearchManager.EntityVersionPolicy versionPolicy)
                                throws InvalidSearchException

Description copied from interface: SearchManager

Perform a search with the given criteria, returning the results as a list of database entity objects. Unlike the SearchManager.convertToEntities(SearchResults, EntityVersionPolicy) method, the list of entities returned will not contain any nulls: search results that do not match a database record will be silently discarded.

The versionPolicy determines whether the entities returned should be the same version as stored in the index (SearchManager.EntityVersionPolicy.INDEXED_VERSION) or the latest version of the same content (SearchManager.EntityVersionPolicy.LATEST_VERSION). If you don't have a particular need to retrieve the latest version, it is recommended that you retrieve the indexed version so that any permission changes made to the document when updating it will be respected.

NOTE: the search limit will be capped at SearchConstants.MAX_LIMIT and the startOffset will be capped at SearchConstants.MAX_START_OFFSET for more efficient heap usage. See SearchResults.getNextPageSearch() for pagination.

WARNING: there is no default permissions checking behaviour provided. You MUST provide a search which specifies permissions checking. See SiteSearchPermissionsQueryFactory to add one yourself. See PredefinedSearchBuilder to build a pre-defined search which contains permission checking.

Specified by:

searchEntities in interface SearchManager

Parameters:

search - the search to perform

versionPolicy - whether to retrieve the indexed version of content found via search (recommended), or the latest version of content (not recommended)

Returns:

a list of Searchable objects representing the search results

Throws:

InvalidSearchException - when this manager is unable to translate and conduct the specified search. Clients should just discard the search if this occurs.

convertToEntities

public List<Searchable> convertToEntities(SearchResults searchResults,
                                          SearchManager.EntityVersionPolicy versionPolicy)

Description copied from interface: SearchManager

Helper method to convert search results into a list of database entities. Because the search index does not update at the same time as the database, a search may contain references to entities that have since been modified or deleted from the db.

Entries that have been deleted from the database are removed from the returned list of entities, so the index of the entities in the returned list may not match the indexes of the search result it corresponds to.

The behaviour for entries that have been modified in the database varies based on the versionPolicy argument. If it is set to SearchManager.EntityVersionPolicy.INDEXED_VERSION, which is the recommended default, the returned entities will be the same version as found in the index. If it is set to SearchManager.EntityVersionPolicy.LATEST_VERSION, the latest version of the content will be returned. Using the latest version is not recommended because it can mean permissions added to the document when it was most recently updated may not be respected.

Specified by:

convertToEntities in interface SearchManager

Parameters:

searchResults - the results of a search from this manager

versionPolicy - whether to retrieve the indexed version of content found via search (recommended), or the latest version of content (not recommended)

Returns:

the entities represented by that search result. List may be empty if the search returned no results, or may contain null values where the result does not map to a valid database record.

explain

public String explain(ISearch search,
                      long contentId)

Description copied from interface: SearchManager

Produce an explanation of the search query for the specified contentId.

Specified by:

explain in interface SearchManager

searchCategorised

public <T> Map<T,List<Map<String,String>>> searchCategorised(ISearch search,
                                                                         SearchManager.Categorizer<T> categorizer)
                                                                  throws InvalidSearchException

Description copied from interface: SearchManager

Perform a search with the given criteria, the top results are collected per category specified by the given SearchManager.Categorizer. If the ISearch contains no ContentStatusQuery in the search query or search filter tree the result of ContentStatusQuery.getDefaultContentStatusQuery() will be added as a top level AND query.

Specified by:

searchCategorised in interface SearchManager

Throws:

InvalidSearchException

scan

public long scan(EnumSet<SearchIndex> indexes,
                 SearchQuery searchQuery,
                 Set<String> requestedFields,
                 Consumer<Map<String,String[]>> consumer)
          throws InvalidSearchException

Description copied from interface: SearchManager

Execute Consumer.accept(T) for each search result. This method enables memory optimised implementation that doesn't need to allocate memory to hold the entire search result.

If the SearchQuery contains no ContentStatusQuery in the query tree the result of ContentStatusQuery.getDefaultContentStatusQuery() will be added as a top level AND query.

WARNING: there is no default permissions checking behaviour provided. You MUST provide a search which specifies permissions checking. See SiteSearchPermissionsQueryFactory to add one yourself. See PredefinedSearchBuilder to build a pre-defined search which contains permission checking.

Specified by:

scan in interface SearchManager

Returns:

The total number of hits

Throws:

InvalidSearchException