com.atlassian.confluence.search.v2.SearchManager |
Known Indirect Subclasses |
Facade for the v2 search API.
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
SearchManager.EntityVersionPolicy | Determines how search results will be converted into entities by convertToEntities(SearchResults, EntityVersionPolicy) and
searchEntities(ISearch, EntityVersionPolicy) . |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Helper method to convert search results into a list of database entities.
| |||||||||||
This method is deprecated.
since 4.0. Use
convertToEntities(SearchResults, EntityVersionPolicy) instead.
| |||||||||||
This method is deprecated.
since 3.0. Use
search(ISearch) by passing in a ContentSearch . | |||||||||||
Perform a search with a given criteria.
| |||||||||||
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.
| |||||||||||
Perform a search with the given criteria, returning the results as a list of database entity
objects.
| |||||||||||
This method is deprecated.
since 4.0 use
searchEntities(ISearch, EntityVersionPolicy) instead.
| |||||||||||
This method is deprecated.
since 3.0. Use
searchEntities(ISearch, EntityVersionPolicy) instead.
|
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 toINDEXED_VERSION
, which
is the recommended default, the returned entities will be the same version as found in the index.
If it is set to 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.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) |
This method is deprecated.
since 4.0. Use convertToEntities(SearchResults, EntityVersionPolicy)
instead.
This method is deprecated.
since 3.0. Use search(ISearch)
by passing in a ContentSearch
.
InvalidSearchException |
---|
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.
search | the search to perform |
---|
IllegalArgumentException | if the search contains an invalid SearchQuery |
---|---|
InvalidSearchException | when this manager is unable to translate and conduct the specified search. Clients should just discard the search if this occurs. |
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.
InvalidSearchException |
---|
Perform a search with the given criteria, returning the results as a list of database entity
objects. Unlike the 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.
INDEXED_VERSION
) or the latest version of
the same content (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.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) |
IllegalArgumentException | if the search contains an invalid SearchQuery |
---|---|
InvalidSearchException | when this manager is unable to translate and conduct the specified search. Clients should just discard the search if this occurs. |
This method is deprecated.
since 4.0 use searchEntities(ISearch, EntityVersionPolicy)
instead.
InvalidSearchException |
---|
This method is deprecated.
since 3.0. Use searchEntities(ISearch, EntityVersionPolicy)
instead.
InvalidSearchException |
---|