org.opencms.search.solr

Class CmsSolrIndex

java.lang.Object

org.opencms.search.A_CmsSearchIndex

org.opencms.search.CmsSearchIndex

org.opencms.search.solr.CmsSolrIndex

All Implemented Interfaces:

java.io.Serializable, I_CmsConfigurationParameterHandler, I_CmsSearchIndex

public class CmsSolrIndex
extends CmsSearchIndex

Implements the search within an Solr index.

Since:

8.5.0

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	DEBUG_PADDING_RIGHT A constant for debug formatting output.
static java.lang.String	DEFAULT_INDEX_NAME_OFFLINE The name of the default Solr Offline index.
static java.lang.String	DEFAULT_INDEX_NAME_ONLINE The name of the default Solr Online index.
static int	MAX_RESULTS_GALLERY The constant for an unlimited maximum number of results to return in a Solr search.
static int	MAX_RESULTS_UNLIMITED The constant for an unlimited maximum number of results to return in a Solr search.
static java.lang.String	POST_PROCESSOR Constant for additional parameter to set the post processor class name.
static java.lang.String	PROPERTY_SEARCH_EXCLUDE_VALUE_SOLR The solr exclude property.
static int	ROWS_MAX Indicates the maximum number of documents from the complete result set to return.
static java.lang.String	SOLR_HANDLER_ALLOWED_FIELDS Constant for additional parameter to set the fields the select handler should return at maximum.
static java.lang.String	SOLR_HANDLER_MAX_ALLOWED_RESULTS_AT_ALL Constant for additional parameter to set the maximal number of a result, the select handler should return.
static java.lang.String	SOLR_HANDLER_MAX_ALLOWED_RESULTS_PER_PAGE Constant for additional parameter to set the number results the select handler should return at maxium per request.
static java.lang.String	SOLR_SEARCH_MAX_PROCESSED_RESULTS Constant for additional parameter to set the maximally processed results (start + rows) for searches with this index.

Fields inherited from class org.opencms.search.CmsSearchIndex

A_PARAM_PREFIX, BACKUP_REINDEXING, DATES, DOC_META_FIELDS, EXCERPT, EXTRACT_CONTENT, IGNORE_EXPIRATION, LANGUAGEDETECTION, LUCENE_AUTO_COMMIT, LUCENE_RAM_BUFFER_SIZE_MB, MAX_HITS, MAX_HITS_DEFAULT, MAX_YEAR_RANGE, PERMISSIONS, PRIORITY, TIME_RANGE, TYPE_XMLCONTENT, VISITOR

Fields inherited from class org.opencms.search.A_CmsSearchIndex

PROPERTY_SEARCH_EXCLUDE_VALUE_ALL, PROPERTY_SEARCH_EXCLUDE_VALUE_GALLERY, USE_ALL_LOCALE

Fields inherited from interface org.opencms.search.I_CmsSearchIndex

REBUILD_MODE_AUTO, REBUILD_MODE_MANUAL, REBUILD_MODE_NEVER, REBUILD_MODE_OFFLINE

Fields inherited from interface org.opencms.configuration.I_CmsConfigurationParameterHandler

ADD_PARAMETER_METHOD, INIT_CONFIGURATION_METHOD

Constructor Summary

Constructors

Constructor and Description
CmsSolrIndex() Default constructor.
CmsSolrIndex(java.lang.String name) Public constructor to create a Solr index.

Method Summary

Modifier and Type	Method and Description
void	addConfigurationParameter(java.lang.String key, java.lang.String value) Adds a parameter.
I_CmsSearchDocument	createEmptyDocument(CmsResource resource) Creates an empty document that can be used by this search field configuration.
protected java.lang.String	createIndexBackup() Creates a backup of this index for optimized re-indexing of the whole content.
I_CmsIndexWriter	createIndexWriter(boolean create, I_CmsReport report) Creates a new index writer.
boolean	excludeFromIndex(CmsObject cms, CmsResource resource) Checks if the provided resource should be excluded from this search index.
CmsGallerySearchResultList	gallerySearch(CmsObject cms, CmsGallerySearchParameters params) Performs a search with according to the gallery search parameters.
CmsParameterConfiguration	getConfiguration() Returns the empty configuration.
java.lang.String	getCoreName() Returns the name of the core of the index.
I_CmsSearchDocument	getDocument(java.lang.String fieldname, java.lang.String term) Returns the first document where the given term matches the selected index field.
I_CmsSearchDocument	getDocument(java.lang.String fieldname, java.lang.String term, java.lang.String[] fls) Version of CmsSearchIndex.getDocument(java.lang.String, java.lang.String) where the returned fields can be restricted.
I_CmsDocumentFactory	getDocumentFactory(CmsResource res) Returns the document type factory used for the given resource in this index, or null in case the resource is not indexed by this index.
java.util.Locale	getLocaleForResource(CmsObject cms, CmsResource resource, java.util.List<java.util.Locale> availableLocales) Returns the language locale for the given resource in this index.
int	getMaxProcessedResults() Returns the maximal number of results (start + rows) that are processed for each search query unless another maximum is explicitly specified in search(CmsObject, CmsSolrQuery, boolean, ServletResponse, boolean, CmsResourceFilter, int).
I_CmsSolrPostSearchProcessor	getPostProcessor() Returns the search post processor.
static java.lang.String	getType(CmsObject cms, java.lang.String rootPath) Returns the resource type for the given root path.
protected boolean	hasPermissions(CmsObject cms, CmsSolrDocument doc, CmsResourceFilter filter) Check, if the current user has permissions on the document's resource.
protected void	indexSearcherClose() Closes the index searcher for this index.
protected void	indexSearcherOpen(java.lang.String path) Initializes the index searcher for this index.
protected void	indexSearcherUpdate() Reopens the index search reader for this index, required after the index has been changed.
void	initialize() Initializes the search index.
protected boolean	isIndexing(CmsResource res) Checks if the given resource should be indexed by this index or not.
boolean	isNoSolrServerSet() Returns a flag, indicating if the Solr server is not yet set.
CmsSearchResultList	search(CmsObject cms, CmsSearchParameters params) Deprecated. Use search(CmsObject, SolrQuery) or search(CmsObject, String) instead
CmsSolrResultList	search(CmsObject cms, CmsSolrQuery query) Default search method.
CmsSolrResultList	search(CmsObject cms, CmsSolrQuery query, boolean ignoreMaxRows) Performs a search.
CmsSolrResultList	search(CmsObject cms, CmsSolrQuery query, boolean ignoreMaxRows, CmsResourceFilter filter) Like search(CmsObject, CmsSolrQuery, boolean), but additionally a resource filter can be specified.
CmsSolrResultList	search(CmsObject cms, CmsSolrQuery query, boolean ignoreMaxRows, javax.servlet.ServletResponse response, boolean ignoreSearchExclude, CmsResourceFilter filter) Performs the actual search.
CmsSolrResultList	search(CmsObject cms, CmsSolrQuery query, boolean ignoreMaxRows, javax.servlet.ServletResponse response, boolean ignoreSearchExclude, CmsResourceFilter filter, int maxNumResults) Performs the actual search.
CmsSolrResultList	search(CmsObject cms, org.apache.solr.client.solrj.SolrQuery query) Default search method.
CmsSolrResultList	search(CmsObject cms, java.lang.String solrQuery) Performs a search.
void	select(javax.servlet.ServletResponse response, CmsObject cms, CmsSolrQuery query, boolean ignoreMaxRows) Writes the response into the writer.
void	setName(java.lang.String name) Sets the logical key/name of this search index.
void	setPostProcessor(I_CmsSolrPostSearchProcessor postProcessor) Sets the search post processor.
void	setSolrServer(org.apache.solr.client.solrj.SolrClient client) Sets the Solr server used by this index.
void	spellCheck(javax.servlet.ServletResponse res, CmsObject cms, CmsSolrQuery q) Executes a spell checking Solr query and returns the Solr query response.

Methods inherited from class org.opencms.search.CmsSearchIndex

appendCategoryFilter, appendDateCreatedFilter, appendDateLastModifiedFilter, appendPathFilter, appendResourceTypeFilter, createDateRangeFilter, extendPathFilter, generateIndexDirectory, getAnalyzer, getContentIfUnchanged, getDateRangeSpan, getDocument, getDocument, getLocaleString, getMaxHits, getMultiTermQueryFilter, getMultiTermQueryFilter, getMultiTermQueryFilter, getPath, getPriority, getResource, getResource, getSearcher, getTermQueryFilter, hasReadPermission, indexSearcherClose, isBackupReindexing, isCheckingPermissions, isCheckingTimeRange, isCheckPermissions, isCreatingExcerpt, isIgnoreExpiration, isInitialized, isInTimeRange, isRequireViewPermission, isSortScoring, needsPermissionCheck, onIndexChanged, removeIndexBackup, setAnalyzer, setCheckPermissions, setIgnoreExpiration, setMaxHits, setRequireViewPermission, shutDown, toString

Methods inherited from class org.opencms.search.A_CmsSearchIndex

addSourceName, checkConfiguration, equals, getFieldConfiguration, getFieldConfigurationName, getIndexWriter, getLocale, getName, getProject, getRebuildMode, getSourceNames, getSources, hashCode, initConfiguration, isEnabled, isExtractingContent, isLanguageDetection, isUpdatedIncremental, removeSourceName, setEnabled, setExtractContent, setFieldConfiguration, setFieldConfigurationName, setIndexWriter, setLanguageDetection, setLocale, setLocaleString, setPath, setProject, setRebuildMode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

DEFAULT_INDEX_NAME_OFFLINE

public static final java.lang.String DEFAULT_INDEX_NAME_OFFLINE

The name of the default Solr Offline index.

See Also:

Constant Field Values

DEFAULT_INDEX_NAME_ONLINE

public static final java.lang.String DEFAULT_INDEX_NAME_ONLINE

The name of the default Solr Online index.

See Also:

Constant Field Values

POST_PROCESSOR

public static final java.lang.String POST_PROCESSOR

Constant for additional parameter to set the post processor class name.

See Also:

Constant Field Values

SOLR_SEARCH_MAX_PROCESSED_RESULTS

public static final java.lang.String SOLR_SEARCH_MAX_PROCESSED_RESULTS

Constant for additional parameter to set the maximally processed results (start + rows) for searches with this index. It overwrites the global configuration from CmsSolrConfiguration.getMaxProcessedResults() for this index.

See Also:

Constant Field Values

SOLR_HANDLER_ALLOWED_FIELDS

public static final java.lang.String SOLR_HANDLER_ALLOWED_FIELDS

Constant for additional parameter to set the fields the select handler should return at maximum.

See Also:

Constant Field Values

SOLR_HANDLER_MAX_ALLOWED_RESULTS_PER_PAGE

public static final java.lang.String SOLR_HANDLER_MAX_ALLOWED_RESULTS_PER_PAGE

Constant for additional parameter to set the number results the select handler should return at maxium per request.

See Also:

Constant Field Values

SOLR_HANDLER_MAX_ALLOWED_RESULTS_AT_ALL

public static final java.lang.String SOLR_HANDLER_MAX_ALLOWED_RESULTS_AT_ALL

Constant for additional parameter to set the maximal number of a result, the select handler should return.

See Also:

Constant Field Values

PROPERTY_SEARCH_EXCLUDE_VALUE_SOLR

public static final java.lang.String PROPERTY_SEARCH_EXCLUDE_VALUE_SOLR

The solr exclude property.

See Also:

Constant Field Values

ROWS_MAX

public static final int ROWS_MAX

Indicates the maximum number of documents from the complete result set to return.

See Also:

Constant Field Values

MAX_RESULTS_UNLIMITED

public static final int MAX_RESULTS_UNLIMITED

The constant for an unlimited maximum number of results to return in a Solr search.

See Also:

Constant Field Values

MAX_RESULTS_GALLERY

public static final int MAX_RESULTS_GALLERY

The constant for an unlimited maximum number of results to return in a Solr search.

See Also:

Constant Field Values

DEBUG_PADDING_RIGHT

protected static final int DEBUG_PADDING_RIGHT

A constant for debug formatting output.

See Also:

Constant Field Values

Constructor Detail

CmsSolrIndex

public CmsSolrIndex()

Default constructor.

CmsSolrIndex

public CmsSolrIndex(java.lang.String name)
             throws CmsIllegalArgumentException

Public constructor to create a Solr index.

Parameters:

name - the name for this index.

Throws:

CmsIllegalArgumentException - if something goes wrong

Method Detail

getType

public static final java.lang.String getType(CmsObject cms,
                                             java.lang.String rootPath)

Returns the resource type for the given root path.

Parameters:

cms - the current CMS context

rootPath - the root path of the resource to get the type for

Returns:

the resource type for the given root path

addConfigurationParameter

public void addConfigurationParameter(java.lang.String key,
                                      java.lang.String value)

Description copied from class: CmsSearchIndex

Adds a parameter.

Specified by:

addConfigurationParameter in interface I_CmsConfigurationParameterHandler

Overrides:

addConfigurationParameter in class CmsSearchIndex

Parameters:

key - the key/name of the parameter

value - the value of the parameter

See Also:

CmsSearchIndex.addConfigurationParameter(java.lang.String, java.lang.String)

createEmptyDocument

public I_CmsSearchDocument createEmptyDocument(CmsResource resource)

Description copied from class: CmsSearchIndex

Creates an empty document that can be used by this search field configuration.

Specified by:

createEmptyDocument in interface I_CmsSearchIndex

Overrides:

createEmptyDocument in class CmsSearchIndex

Parameters:

resource - the resource to create the document for

Returns:

a new and empty document

See Also:

CmsSearchIndex.createEmptyDocument(org.opencms.file.CmsResource)

createIndexWriter

public I_CmsIndexWriter createIndexWriter(boolean create,
                                          I_CmsReport report)

Description copied from class: CmsSearchIndex

Creates a new index writer.

Overrides:

createIndexWriter in class CmsSearchIndex

Parameters:

create - if true a whole new index is created, if false an existing index is updated

report - the report

Returns:

the created new index writer

See Also:

CmsSearchIndex.createIndexWriter(boolean, org.opencms.report.I_CmsReport)

excludeFromIndex

public boolean excludeFromIndex(CmsObject cms,
                                CmsResource resource)

Description copied from class: A_CmsSearchIndex

Checks if the provided resource should be excluded from this search index.

Specified by:

excludeFromIndex in interface I_CmsSearchIndex

Overrides:

excludeFromIndex in class A_CmsSearchIndex

Parameters:

cms - the OpenCms context used for building the search index

resource - the resource to index

Returns:

true if the resource should be excluded, false if it should be included in this index

See Also:

A_CmsSearchIndex.excludeFromIndex(CmsObject, CmsResource)

gallerySearch

public CmsGallerySearchResultList gallerySearch(CmsObject cms,
                                                CmsGallerySearchParameters params)

Performs a search with according to the gallery search parameters.

Parameters:

cms - the cms context

params - the search parameters

Returns:

the search result

getConfiguration

public CmsParameterConfiguration getConfiguration()

Description copied from class: A_CmsSearchIndex

Returns the empty configuration. Override the method if your index is configurable.

Specified by:

getConfiguration in interface I_CmsConfigurationParameterHandler

Overrides:

getConfiguration in class CmsSearchIndex

Returns:

the parameters of this configurable class instance, or null if the class does not need any parameters

See Also:

CmsSearchIndex.getConfiguration()

getCoreName

public java.lang.String getCoreName()

Returns the name of the core of the index. NOTE: Index and core name differ since OpenCms 10.5 due to new naming rules for cores in SOLR.

Returns:

the name of the core of the index.

getDocument

public I_CmsSearchDocument getDocument(java.lang.String fieldname,
                                       java.lang.String term)

Description copied from class: CmsSearchIndex

Returns the first document where the given term matches the selected index field.

Use this method to search for documents which have unique field values, like a unique id.

Overrides:

getDocument in class CmsSearchIndex

Parameters:

fieldname - the field to search in

term - the term to search for

Returns:

the first document where the given term matches the selected index field

See Also:

CmsSearchIndex.getDocument(java.lang.String, java.lang.String)

getDocument

public I_CmsSearchDocument getDocument(java.lang.String fieldname,
                                       java.lang.String term,
                                       java.lang.String[] fls)

Version of CmsSearchIndex.getDocument(java.lang.String, java.lang.String) where the returned fields can be restricted.

Parameters:

fieldname - the field to query in

term - the query

fls - the returned fields.

Returns:

the document.

getDocumentFactory

public I_CmsDocumentFactory getDocumentFactory(CmsResource res)

Description copied from class: CmsSearchIndex

Returns the document type factory used for the given resource in this index, or null in case the resource is not indexed by this index.

A resource is indexed if the following is all true:

1. The index contains at last one index source matching the root path of the given resource.
2. For this matching index source, the document type factory needed by the resource is also configured.

Specified by:

getDocumentFactory in interface I_CmsSearchIndex

Overrides:

getDocumentFactory in class CmsSearchIndex

Parameters:

res - the resource to check

Returns:

he document type factory used for the given resource in this index, or null in case the resource is not indexed by this index

See Also:

CmsSearchIndex.getDocumentFactory(org.opencms.file.CmsResource)

getLocaleForResource

public java.util.Locale getLocaleForResource(CmsObject cms,
                                             CmsResource resource,
                                             java.util.List<java.util.Locale> availableLocales)

Returns the language locale for the given resource in this index.

Specified by:

getLocaleForResource in interface I_CmsSearchIndex

Overrides:

getLocaleForResource in class CmsSearchIndex

Parameters:

cms - the current OpenCms user context

resource - the resource to check

availableLocales - a list of locales supported by the resource

Returns:

the language locale for the given resource in this index

getMaxProcessedResults

public int getMaxProcessedResults()

Returns the maximal number of results (start + rows) that are processed for each search query unless another maximum is explicitly specified in search(CmsObject, CmsSolrQuery, boolean, ServletResponse, boolean, CmsResourceFilter, int).

Returns:

the maximal number of results (start + rows) that are processed for a search query.

getPostProcessor

public I_CmsSolrPostSearchProcessor getPostProcessor()

Returns the search post processor.

Returns:

the post processor to use

initialize

public void initialize()
                throws CmsSearchException

Description copied from class: A_CmsSearchIndex

Initializes the search index.

Specified by:

initialize in interface I_CmsSearchIndex

Overrides:

initialize in class CmsSearchIndex

Throws:

CmsSearchException - if the index source association failed or a configuration error occurred

See Also:

CmsSearchIndex.initialize()

isNoSolrServerSet

public boolean isNoSolrServerSet()

Returns a flag, indicating if the Solr server is not yet set.

Returns:

a flag, indicating if the Solr server is not yet set.

search

@Deprecated
public CmsSearchResultList search(CmsObject cms,
                                              CmsSearchParameters params)

Deprecated. Use search(CmsObject, SolrQuery) or search(CmsObject, String) instead

Not yet implemented for Solr.

#################
### DON'T USE ###
#################


Overrides:

search in class CmsSearchIndex

Parameters:

cms - the current user's Cms object

params - the parameters to use for the search

Returns:

the List of results found or an empty list

search

public CmsSolrResultList search(CmsObject cms,
                                CmsSolrQuery query)
                         throws CmsSearchException

Default search method.

Parameters:

cms - the current CMS object

query - the query

Returns:

the results

Throws:

CmsSearchException - if something goes wrong

See Also:

search(CmsObject, String)

search

public CmsSolrResultList search(CmsObject cms,
                                CmsSolrQuery query,
                                boolean ignoreMaxRows)
                         throws CmsSearchException

Performs a search.

Returns a list of 'OpenCms resource documents' (CmsSearchResource) encapsulated within the class CmsSolrResultList. This list can be accessed exactly like an List which entries are CmsSearchResource that extend CmsResource and holds the Solr implementation of I_CmsSearchDocument as member. This enables you to deal with the resulting list as you do with well known List and work on it's entries like you do on CmsResource.

What will be done with the Solr search result?

• Although it can happen, that there are less results returned than rows were requested (imagine an index containing less documents than requested rows) we try to guarantee the requested amount of search results and to provide a working pagination with security check.
• To be sure we get enough documents left even the permission check reduces the amount of found documents, the rows are multiplied by '5' and the current page additionally the offset is added. The count of documents we don't have enough permissions for grows with increasing page number, that's why we also multiply the rows by the current page count.
• Also make sure we perform the permission check for all found documents, so start with the first found doc.

NOTE: If latter pages than the current one are containing protected documents the total hit count will be incorrect, because the permission check ends if we have enough results found for the page to display. With other words latter pages than the current can contain documents that will first be checked if those pages are requested to be displayed, what causes a incorrect hit count.

Parameters:

cms - the current OpenCms context

ignoreMaxRows - true to return all all requested rows, false to use max rows

query - the OpenCms Solr query

Returns:

the list of found documents

Throws:

CmsSearchException - if something goes wrong

See Also:

CmsSolrResultList, CmsSearchResource, I_CmsSearchDocument, CmsSolrQuery

search

public CmsSolrResultList search(CmsObject cms,
                                CmsSolrQuery query,
                                boolean ignoreMaxRows,
                                CmsResourceFilter filter)
                         throws CmsSearchException

Like search(CmsObject, CmsSolrQuery, boolean), but additionally a resource filter can be specified. By default, the filter depends on the index.

Parameters:

cms - the current OpenCms context

ignoreMaxRows - true to return all all requested rows, false to use max rows

query - the OpenCms Solr query

filter - the resource filter to use for post-processing.

Returns:

the list of documents found.

Throws:

CmsSearchException - if something goes wrong

search

public CmsSolrResultList search(CmsObject cms,
                                CmsSolrQuery query,
                                boolean ignoreMaxRows,
                                javax.servlet.ServletResponse response,
                                boolean ignoreSearchExclude,
                                CmsResourceFilter filter)
                         throws CmsSearchException

Performs the actual search.

Parameters:

cms - the current OpenCms context

query - the OpenCms Solr query

ignoreMaxRows - true to return all all requested rows, false to use max rows

response - the servlet response to write the query result to, may also be null

ignoreSearchExclude - if set to false, only contents with search_exclude unset or "false" will be found - typical for the the non-gallery case

filter - the resource filter to use

Returns:

the found documents

Throws:

CmsSearchException - if something goes wrong

See Also:

search(CmsObject, CmsSolrQuery, boolean)

search

public CmsSolrResultList search(CmsObject cms,
                                CmsSolrQuery query,
                                boolean ignoreMaxRows,
                                javax.servlet.ServletResponse response,
                                boolean ignoreSearchExclude,
                                CmsResourceFilter filter,
                                int maxNumResults)
                         throws CmsSearchException

Performs the actual search.

To provide for correct permissions two queries are performed and the response is fused from that queries:

1. a query for permission checking, where fl, start and rows is adjusted. From this query result we take for the response:
   • facets
   • spellcheck
   • suggester
   • morelikethis
   • clusters
2. a query that collects only the resources determined by the first query and performs highlighting. From this query we take for the response:
3. result
4. highlighting

Currently not or only partly supported Solr features are:

• groups
• collapse - representatives of the collapsed group might be filtered by the permission check
• expand is disabled

Parameters:

cms - the current OpenCms context

query - the OpenCms Solr query

ignoreMaxRows - true to return all requested rows, false to use max rows

response - the servlet response to write the query result to, may also be null

ignoreSearchExclude - if set to false, only contents with search_exclude unset or "false" will be found - typical for the the non-gallery case

filter - the resource filter to use

maxNumResults - the maximal number of results to search for

Returns:

the found documents

Throws:

CmsSearchException - if something goes wrong

See Also:

search(CmsObject, CmsSolrQuery, boolean)

search

public CmsSolrResultList search(CmsObject cms,
                                org.apache.solr.client.solrj.SolrQuery query)
                         throws CmsSearchException

Default search method.

Parameters:

cms - the current CMS object

query - the query

Returns:

the results

Throws:

CmsSearchException - if something goes wrong

See Also:

search(CmsObject, String)

search

public CmsSolrResultList search(CmsObject cms,
                                java.lang.String solrQuery)
                         throws CmsSearchException

Performs a search.

Parameters:

cms - the cms object

solrQuery - the Solr query

Returns:

a list of documents

Throws:

CmsSearchException - if something goes wrong

See Also:

search(CmsObject, CmsSolrQuery, boolean)

select

public void select(javax.servlet.ServletResponse response,
                   CmsObject cms,
                   CmsSolrQuery query,
                   boolean ignoreMaxRows)
            throws java.lang.Exception

Writes the response into the writer.

NOTE: Currently not available for HTTP server.

Parameters:

response - the servlet response

cms - the CMS object to use for search

query - the Solr query

ignoreMaxRows - if to return unlimited results

Throws:

java.lang.Exception - if there is no embedded server

setName

public void setName(java.lang.String name)
             throws CmsIllegalArgumentException

Sets the logical key/name of this search index.

Specified by:

setName in interface I_CmsSearchIndex

Overrides:

setName in class A_CmsSearchIndex

Parameters:

name - the logical key/name of this search index

Throws:

CmsIllegalArgumentException - if the given name is null, empty or already taken by another search index

See Also:

I_CmsSearchIndex.setName(java.lang.String)

setPostProcessor

public void setPostProcessor(I_CmsSolrPostSearchProcessor postProcessor)

Sets the search post processor.

Parameters:

postProcessor - the search post processor to set

setSolrServer

public void setSolrServer(org.apache.solr.client.solrj.SolrClient client)

Sets the Solr server used by this index.

Parameters:

client - the server to set

spellCheck

public void spellCheck(javax.servlet.ServletResponse res,
                       CmsObject cms,
                       CmsSolrQuery q)
                throws CmsSearchException

Executes a spell checking Solr query and returns the Solr query response.

Parameters:

res - the servlet response

cms - the CMS object

q - the query

Throws:

CmsSearchException - if something goes wrong

createIndexBackup

protected java.lang.String createIndexBackup()

Description copied from class: CmsSearchIndex

Creates a backup of this index for optimized re-indexing of the whole content.

Overrides:

createIndexBackup in class CmsSearchIndex

Returns:

the path to the backup folder, or null in case no backup was created

See Also:

CmsSearchIndex.createIndexBackup()

hasPermissions

protected boolean hasPermissions(CmsObject cms,
                                 CmsSolrDocument doc,
                                 CmsResourceFilter filter)

Check, if the current user has permissions on the document's resource.

Parameters:

cms - the context

doc - the solr document (from the search result)

filter - the resource filter to use for checking permissions

Returns:

true iff the resource mirrored by the search result can be read by the current user.

indexSearcherClose

protected void indexSearcherClose()

Description copied from class: CmsSearchIndex

Closes the index searcher for this index.

Overrides:

indexSearcherClose in class CmsSearchIndex

See Also:

CmsSearchIndex.indexSearcherClose()

indexSearcherOpen

protected void indexSearcherOpen(java.lang.String path)

Description copied from class: CmsSearchIndex

Initializes the index searcher for this index.

In case there is an index searcher still open, it is closed first.

For performance reasons, one instance of the index searcher should be kept for all searches. However, if the index is updated or changed this searcher instance needs to be re-initialized.

Overrides:

indexSearcherOpen in class CmsSearchIndex

Parameters:

path - the path to the index directory

See Also:

CmsSearchIndex.indexSearcherOpen(java.lang.String)

indexSearcherUpdate

protected void indexSearcherUpdate()

Description copied from class: CmsSearchIndex

Reopens the index search reader for this index, required after the index has been changed.

Overrides:

indexSearcherUpdate in class CmsSearchIndex

See Also:

CmsSearchIndex.indexSearcherUpdate()

isIndexing

protected boolean isIndexing(CmsResource res)

Checks if the given resource should be indexed by this index or not.

Overrides:

isIndexing in class A_CmsSearchIndex

Parameters:

res - the resource candidate

Returns:

true if the given resource should be indexed or false if not