org.opencms.search

类 CmsSearchIndex

java.lang.Object

org.opencms.search.CmsSearchIndex

所有已实现的接口:

I_CmsConfigurationParameterHandler

直接已知子类:

CmsGallerySearchIndex, CmsSolrIndex

public class CmsSearchIndex
extends java.lang.Object
implements I_CmsConfigurationParameterHandler

Abstract search index implementation.

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	A_PARAM_PREFIX A constant for the full qualified name of the CmsSearchIndex class.
static java.lang.String	BACKUP_REINDEXING Constant for additional parameter to enable optimized full index regeneration (default: false).
static java.lang.String[]	DATES Look table to quickly zero-pad days / months in date Strings.
static java.lang.String[]	DOC_META_FIELDS Constant for a field list that contains the "meta" field as well as the "content" field.
static java.lang.String	EXCERPT Constant for additional parameter to enable excerpt creation (default: true).
static java.lang.String	EXTRACT_CONTENT Constant for additional parameter for index content extraction.
static java.lang.String	IGNORE_EXPIRATION Constant for additional parameter to enable/disable language detection (default: false).
static java.lang.String	LANGUAGEDETECTION Constant for additional parameter to enable/disable language detection (default: false).
static java.lang.String	LUCENE_AUTO_COMMIT Constant for additional parameter for the Lucene index setting.
static java.lang.String	LUCENE_RAM_BUFFER_SIZE_MB Constant for additional parameter for the Lucene index setting.
static org.apache.lucene.util.Version	LUCENE_VERSION The Lucene Version used to create Query parsers and such.
static java.lang.String	MAX_HITS Constant for additional parameter for controlling how many hits are loaded at maximum (default: 1000).
static int	MAX_HITS_DEFAULT Indicates how many hits are loaded at maximum by default.
static int	MAX_YEAR_RANGE Constant for years max range span in document search.
static java.lang.String	PERMISSIONS Constant for additional parameter to enable permission checks (default: true).
static java.lang.String	PRIORITY Constant for additional parameter to set the thread priority during search.
static java.lang.String	PROPERTY_SEARCH_EXCLUDE_VALUE_ALL Special value for the search.exclude property.
static java.lang.String	PROPERTY_SEARCH_EXCLUDE_VALUE_GALLERY Special value for the search.exclude property.
static java.lang.String	REBUILD_MODE_AUTO Automatic ("auto") index rebuild mode.
static java.lang.String	REBUILD_MODE_MANUAL Manual ("manual") index rebuild mode.
static java.lang.String	REBUILD_MODE_OFFLINE Offline ("offline") index rebuild mode.
static java.lang.String	TIME_RANGE Constant for additional parameter to enable time range checks (default: true).
static java.lang.String	TYPE_XMLCONTENT The document type name for XML contents.
static java.lang.String	USE_ALL_LOCALE The use all locale.
protected static org.apache.lucene.index.StoredFieldVisitor	VISITOR A stored field visitor, that does not return the large fields: "content" and "contentblob".

从接口继承的字段 org.opencms.configuration.I_CmsConfigurationParameterHandler

ADD_PARAMETER_METHOD, INIT_CONFIGURATION_METHOD

构造器概要

构造器

构造器和说明
CmsSearchIndex() Default constructor only intended to be used by the XML configuration.
CmsSearchIndex(java.lang.String name) Creates a new CmsSearchIndex with the given name.

方法概要

方法

限定符和类型	方法和说明
void	addConfigurationParameter(java.lang.String key, java.lang.String value) Adds a parameter.
void	addSourceName(java.lang.String sourceName) Adds am index source to this search index.
protected org.apache.lucene.queries.BooleanFilter	appendCategoryFilter(CmsObject cms, org.apache.lucene.queries.BooleanFilter filter, java.util.List<java.lang.String> categories) Appends the a category filter to the given filter clause that matches all given categories.
protected org.apache.lucene.queries.BooleanFilter	appendDateCreatedFilter(org.apache.lucene.queries.BooleanFilter filter, long startTime, long endTime) Appends a date of creation filter to the given filter clause that matches the given time range.
protected org.apache.lucene.queries.BooleanFilter	appendDateLastModifiedFilter(org.apache.lucene.queries.BooleanFilter filter, long startTime, long endTime) Appends a date of last modification filter to the given filter clause that matches the given time range.
protected org.apache.lucene.queries.BooleanFilter	appendPathFilter(CmsObject cms, org.apache.lucene.queries.BooleanFilter filter, java.util.List<java.lang.String> roots) Appends the a VFS path filter to the given filter clause that matches all given root paths.
protected org.apache.lucene.queries.BooleanFilter	appendResourceTypeFilter(CmsObject cms, org.apache.lucene.queries.BooleanFilter filter, java.util.List<java.lang.String> resourceTypes) Appends the a resource type filter to the given filter clause that matches all given resource types.
boolean	checkConfiguration(CmsObject cms) Checks is this index has been configured correctly.
protected org.apache.lucene.search.Filter	createDateRangeFilter(java.lang.String fieldName, long startTime, long endTime) Creates an optimized date range filter for the date of last modification or creation.
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.
protected I_CmsIndexWriter	createIndexWriter(boolean create, I_CmsReport report) Creates a new index writer.
boolean	equals(java.lang.Object obj)
protected boolean	excludeFromIndex(CmsObject cms, CmsResource resource) Checks if the provided resource should be excluded from this search index.
protected void	extendPathFilter(java.util.List<org.apache.lucene.index.Term> terms, java.lang.String searchRoot) Extends the given path query with another term for the given search root element.
protected java.lang.String	generateIndexDirectory() Generates the directory on the RFS for this index.
org.apache.lucene.analysis.Analyzer	getAnalyzer() Returns the Lucene analyzer used for this index.
CmsParameterConfiguration	getConfiguration() Returns the parameters of this configurable class instance, or null if the class does not need any parameters.
static java.util.List<java.lang.String>	getDateRangeSpan(long startDate, long endDate) Generates a list of date terms for the optimized date range search with "daily" granularity level.
I_CmsSearchDocument	getDocument(int docId) Returns a document by document ID.
org.apache.lucene.document.Document	getDocument(java.lang.String rootPath) 已过时。 Use getDocument(String, String) instead and provide CmsSearchField.FIELD_PATH as field to search in
I_CmsSearchDocument	getDocument(java.lang.String field, java.lang.String term) Returns the first document where the given term matches the selected index field.
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.
CmsSearchFieldConfiguration	getFieldConfiguration() Returns the search field configuration of this index.
java.lang.String	getFieldConfigurationName() Returns the name of the field configuration used for this index.
I_CmsIndexWriter	getIndexWriter(I_CmsReport report, boolean create) Returns a new index writer for this index.
java.util.Locale	getLocale() Returns the language locale of 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.
java.lang.String	getLocaleString() Returns the language locale of the index as a String.
int	getMaxHits() Indicates the number of how many hits are loaded at maximum.
protected org.apache.lucene.search.Filter	getMultiTermQueryFilter(java.lang.String field, java.util.List<java.lang.String> terms) Returns a cached Lucene term query filter for the given field and terms.
protected org.apache.lucene.search.Filter	getMultiTermQueryFilter(java.lang.String field, java.lang.String terms) Returns a cached Lucene term query filter for the given field and terms.
protected org.apache.lucene.search.Filter	getMultiTermQueryFilter(java.lang.String field, java.lang.String termsStr, java.util.List<java.lang.String> termsList) Returns a cached Lucene term query filter for the given field and terms.
java.lang.String	getName() Gets the name of this index.
java.lang.String	getPath() Returns the path where this index stores it's data in the "real" file system.
int	getPriority() Returns the Thread priority for this search index.
java.lang.String	getProject() Gets the project of this index.
java.lang.String	getRebuildMode() Get the rebuild mode of this index.
protected CmsResource	getResource(CmsObject cms, I_CmsSearchDocument doc) Checks if the OpenCms resource referenced by the result document can be read by the user of the given OpenCms context.
org.apache.lucene.search.IndexSearcher	getSearcher() Returns the Lucene index searcher used for this search index.
java.util.List<java.lang.String>	getSourceNames() Returns all configured sources names of this search index.
java.util.List<CmsSearchIndexSource>	getSources() Returns all configured index sources of this search index.
protected org.apache.lucene.search.Filter	getTermQueryFilter(java.lang.String field, java.lang.String term) Returns a cached Lucene term query filter for the given field and term.
int	hashCode()
protected boolean	hasReadPermission(CmsObject cms, I_CmsSearchDocument doc) Checks if the OpenCms resource referenced by the result document can be read be the user of the given OpenCms context.
protected void	indexSearcherClose() Closes the index searcher for this index.
protected void	indexSearcherClose(org.apache.lucene.search.IndexSearcher searcher) Closes the given Lucene index searcher.
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.
protected void	indexWriterUnlock(I_CmsReport report) Unlocks the Lucene index writer of this index if required.
void	initConfiguration() Initializes a configuration after all parameters have been added.
void	initialize() Initializes the search index.
boolean	isBackupReindexing() Returns true if backup re-indexing is done by this index.
boolean	isCheckingPermissions() Returns true if permissions are checked for search results by this index.
boolean	isCheckingTimeRange() Returns true if the document time range is checked with a granularity level of seconds for search results by this index.
boolean	isCheckPermissions() Returns the checkPermissions.
boolean	isCreatingExcerpt() Returns true if an excerpt is generated by this index.
boolean	isEnabled() Returns true if this index is currently disabled.
boolean	isExtractingContent() Returns true if full text is extracted by this index.
boolean	isIgnoreExpiration() Returns the ignoreExpiration.
protected boolean	isInTimeRange(org.apache.lucene.document.Document doc, CmsSearchParameters params) Checks if the document is in the time range specified in the search parameters.
boolean	isLanguageDetection() Returns the languageDetection.
boolean	isRequireViewPermission() Returns true if a resource requires read permission to be included in the result list.
protected boolean	isSortScoring(org.apache.lucene.search.IndexSearcher searcher, org.apache.lucene.search.Sort sort) Checks if the score for the results must be calculated based on the provided sort option.
boolean	isUpdatedIncremental() Returns true in case this index is updated incremental.
protected boolean	needsPermissionCheck(I_CmsSearchDocument doc) Checks if the OpenCms resource referenced by the result document needs to be checked.
protected void	removeIndexBackup(java.lang.String path) Removes the given backup folder of this index.
void	removeSourceName(java.lang.String sourceName) Removes an index source from this search index.
CmsSearchResultList	search(CmsObject cms, CmsSearchParameters params) Performs a search on the index within the given fields.
void	setAnalyzer(org.apache.lucene.analysis.Analyzer analyzer) Sets the Lucene analyzer used for this index.
void	setCheckPermissions(boolean checkPermissions) Sets the checkPermissions.
void	setEnabled(boolean enabled) Can be used to enable / disable this index.
void	setFieldConfiguration(CmsSearchFieldConfiguration fieldConfiguration) Sets the field configuration used for this index.
void	setFieldConfigurationName(java.lang.String fieldConfigurationName) Sets the name of the field configuration used for this index.
void	setIgnoreExpiration(boolean ignoreExpiration) Sets the ignoreExpiration.
protected void	setIndexWriter(I_CmsIndexWriter writer) Sets the index writer.
void	setLanguageDetection(boolean languageDetection) Sets the languageDetection.
void	setLocale(java.util.Locale locale) Sets the locale to index resources.
void	setLocaleString(java.lang.String locale) Sets the locale to index resources as a String.
void	setMaxHits(int maxHits) Sets the number of how many hits are loaded at maximum.
void	setName(java.lang.String name) Sets the logical key/name of this search index.
void	setProject(java.lang.String project) Sets the name of the project used to index resources.
void	setRebuildMode(java.lang.String rebuildMode) Sets the rebuild mode of this search index.
void	setRequireViewPermission(boolean requireViewPermission) Controls if a resource requires view permission to be displayed in the result list.
void	shutDown() Shuts down the search index.
java.lang.String	toString() Returns the name (getName()) of this search index.

从类继承的方法 java.lang.Object

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

字段详细资料

A_PARAM_PREFIX

public static final java.lang.String A_PARAM_PREFIX

A constant for the full qualified name of the CmsSearchIndex class.

另请参阅:

常量字段值

BACKUP_REINDEXING

public static final java.lang.String BACKUP_REINDEXING

Constant for additional parameter to enable optimized full index regeneration (default: false).

另请参阅:

常量字段值

DATES

public static final java.lang.String[] DATES

Look table to quickly zero-pad days / months in date Strings.

DOC_META_FIELDS

public static final java.lang.String[] DOC_META_FIELDS

Constant for a field list that contains the "meta" field as well as the "content" field.

EXCERPT

public static final java.lang.String EXCERPT

Constant for additional parameter to enable excerpt creation (default: true).

另请参阅:

常量字段值

EXTRACT_CONTENT

public static final java.lang.String EXTRACT_CONTENT

Constant for additional parameter for index content extraction.

另请参阅:

常量字段值

IGNORE_EXPIRATION

public static final java.lang.String IGNORE_EXPIRATION

Constant for additional parameter to enable/disable language detection (default: false).

另请参阅:

常量字段值

LANGUAGEDETECTION

public static final java.lang.String LANGUAGEDETECTION

Constant for additional parameter to enable/disable language detection (default: false).

另请参阅:

常量字段值

LUCENE_AUTO_COMMIT

public static final java.lang.String LUCENE_AUTO_COMMIT

Constant for additional parameter for the Lucene index setting.

另请参阅:

常量字段值

LUCENE_RAM_BUFFER_SIZE_MB

public static final java.lang.String LUCENE_RAM_BUFFER_SIZE_MB

Constant for additional parameter for the Lucene index setting.

另请参阅:

常量字段值

LUCENE_VERSION

public static final org.apache.lucene.util.Version LUCENE_VERSION

The Lucene Version used to create Query parsers and such.

MAX_HITS

public static final java.lang.String MAX_HITS

Constant for additional parameter for controlling how many hits are loaded at maximum (default: 1000).

另请参阅:

常量字段值

MAX_HITS_DEFAULT

public static final int MAX_HITS_DEFAULT

Indicates how many hits are loaded at maximum by default.

另请参阅:

常量字段值

MAX_YEAR_RANGE

public static final int MAX_YEAR_RANGE

Constant for years max range span in document search.

另请参阅:

常量字段值

PERMISSIONS

public static final java.lang.String PERMISSIONS

Constant for additional parameter to enable permission checks (default: true).

另请参阅:

常量字段值

PRIORITY

public static final java.lang.String PRIORITY

Constant for additional parameter to set the thread priority during search.

另请参阅:

常量字段值

PROPERTY_SEARCH_EXCLUDE_VALUE_ALL

public static final java.lang.String PROPERTY_SEARCH_EXCLUDE_VALUE_ALL

Special value for the search.exclude property.

另请参阅:

常量字段值

PROPERTY_SEARCH_EXCLUDE_VALUE_GALLERY

public static final java.lang.String PROPERTY_SEARCH_EXCLUDE_VALUE_GALLERY

Special value for the search.exclude property.

另请参阅:

常量字段值

REBUILD_MODE_AUTO

public static final java.lang.String REBUILD_MODE_AUTO

Automatic ("auto") index rebuild mode.

另请参阅:

常量字段值

REBUILD_MODE_MANUAL

public static final java.lang.String REBUILD_MODE_MANUAL

Manual ("manual") index rebuild mode.

另请参阅:

常量字段值

REBUILD_MODE_OFFLINE

public static final java.lang.String REBUILD_MODE_OFFLINE

Offline ("offline") index rebuild mode.

另请参阅:

常量字段值

TIME_RANGE

public static final java.lang.String TIME_RANGE

Constant for additional parameter to enable time range checks (default: true).

另请参阅:

常量字段值

TYPE_XMLCONTENT

public static final java.lang.String TYPE_XMLCONTENT

The document type name for XML contents.

另请参阅:

常量字段值

USE_ALL_LOCALE

public static final java.lang.String USE_ALL_LOCALE

The use all locale.

另请参阅:

常量字段值

VISITOR

protected static final org.apache.lucene.index.StoredFieldVisitor VISITOR

A stored field visitor, that does not return the large fields: "content" and "contentblob".

构造器详细资料

CmsSearchIndex

public CmsSearchIndex()

Default constructor only intended to be used by the XML configuration.

It is recommended to use the constructor CmsSearchIndex(String) as it enforces the mandatory name argument.

CmsSearchIndex

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

Creates a new CmsSearchIndex with the given name.

参数:

name - the system-wide unique name for the search index

抛出:

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

方法详细资料

getDateRangeSpan

public static java.util.List<java.lang.String> getDateRangeSpan(long startDate,
                                                long endDate)

Generates a list of date terms for the optimized date range search with "daily" granularity level.

How this works:

• For each document, terms are added for the year, the month and the day the document was modified or created) in. So for example if a document is modified at February 02, 2009, then the following terms are stored for this document: "20090202", "200902" and "2009".
• In case a date range search is done, then all possible matches for the provided rage are created as search terms and matched with the document terms.
• Consider the following use case: You want to find out if a resource has been changed in the time between November 29, 2007 and March 01, 2009. One term to match is simply "2008" because if a document was modified in 2008, then it is clearly in the date range. Other terms are "200712", "200901" and "200902", because all documents modified in these months are also a certain matches. Finally we need to add terms for "20071129", "20071130" and "20090301" to match the days in the starting and final month.

参数:

startDate - start date of the range to search in

endDate - end date of the range to search in

返回:

a list of date terms for the optimized date range search

addConfigurationParameter

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

Adds a parameter.

指定者:

addConfigurationParameter 在接口中 I_CmsConfigurationParameterHandler

参数:

key - the key/name of the parameter

value - the value of the parameter

addSourceName

public void addSourceName(java.lang.String sourceName)

Adds am index source to this search index.

参数:

sourceName - the index source name to add

checkConfiguration

public boolean checkConfiguration(CmsObject cms)

Checks is this index has been configured correctly.

In case the check fails, the enabled property is set to false

参数:

cms - a OpenCms user context to perform the checks with (should have "Administrator" permissions)

返回:

true in case the index is correctly configured and enabled after the check

另请参阅:

isEnabled()

createEmptyDocument

public I_CmsSearchDocument createEmptyDocument(CmsResource resource)

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

参数:

resource - the resource to create the document for

返回:

a new and empty document

equals

public boolean equals(java.lang.Object obj)

覆盖:

equals 在类中 java.lang.Object

另请参阅:

Object.equals(java.lang.Object)

getAnalyzer

public org.apache.lucene.analysis.Analyzer getAnalyzer()

Returns the Lucene analyzer used for this index.

返回:

the Lucene analyzer used for this index

getConfiguration

public CmsParameterConfiguration getConfiguration()

从接口复制的说明: I_CmsConfigurationParameterHandler

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

指定者:

getConfiguration 在接口中 I_CmsConfigurationParameterHandler

返回:

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

另请参阅:

I_CmsConfigurationParameterHandler.getConfiguration()

getDocument

public I_CmsSearchDocument getDocument(int docId)

Returns a document by document ID.

参数:

docId - the id to get the document for

返回:

the CMS specific document

getDocument

@Deprecated
public org.apache.lucene.document.Document getDocument(java.lang.String rootPath)

已过时。 Use getDocument(String, String) instead and provide CmsSearchField.FIELD_PATH as field to search in

Returns the Lucene document with the given root path from the index.

参数:

rootPath - the root path of the document to get

返回:

the Lucene document with the given root path from the index

getDocument

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

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.

参数:

field - the field to search in

term - the term to search for

返回:

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

getDocumentFactory

public 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.

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.

参数:

res - the resource to check

返回:

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

getFieldConfiguration

public CmsSearchFieldConfiguration getFieldConfiguration()

Returns the search field configuration of this index.

返回:

the search field configuration of this index

getFieldConfigurationName

public java.lang.String getFieldConfigurationName()

Returns the name of the field configuration used for this index.

返回:

the name of the field configuration used for this index

getIndexWriter

public I_CmsIndexWriter getIndexWriter(I_CmsReport report,
                              boolean create)
                                throws CmsIndexException

Returns a new index writer for this index.

参数:

report - the report to write error messages on

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

返回:

a new instance of IndexWriter

抛出:

CmsIndexException - if the index can not be opened

getLocale

public java.util.Locale getLocale()

Returns the language locale of this index.

返回:

the language locale of this index, for example "en"

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.

参数:

cms - the current OpenCms user context

resource - the resource to check

availableLocales - a list of locales supported by the resource

返回:

the language locale for the given resource in this index

getLocaleString

public java.lang.String getLocaleString()

Returns the language locale of the index as a String.

返回:

the language locale of the index as a String

另请参阅:

getLocale()

getMaxHits

public int getMaxHits()

Indicates the number of how many hits are loaded at maximum.

The number of maximum documents to load from the index must be specified. The default of this setting is MAX_HITS_DEFAULT (5000). This means that at maximum 5000 results are returned from the index. Please note that this number may be reduced further because of OpenCms read permissions or per-user file visibility settings not controlled in the index.

返回:

the number of how many hits are loaded at maximum

从以下版本开始:

7.5.1

getName

public java.lang.String getName()

Gets the name of this index.

返回:

the name of the index

getPath

public java.lang.String getPath()

Returns the path where this index stores it's data in the "real" file system.

返回:

the path where this index stores it's data in the "real" file system

getPriority

public int getPriority()

Returns the Thread priority for this search index.

返回:

the Thread priority for this search index

getProject

public java.lang.String getProject()

Gets the project of this index.

返回:

the project of the index, i.e. "online"

getRebuildMode

public java.lang.String getRebuildMode()

Get the rebuild mode of this index.

返回:

the current rebuild mode

getSearcher

public org.apache.lucene.search.IndexSearcher getSearcher()

Returns the Lucene index searcher used for this search index.

返回:

the Lucene index searcher used for this search index

getSourceNames

public java.util.List<java.lang.String> getSourceNames()

Returns all configured sources names of this search index.

返回:

a list with all configured sources names of this search index

getSources

public java.util.List<CmsSearchIndexSource> getSources()

Returns all configured index sources of this search index.

返回:

all configured index sources of this search index

hashCode

public int hashCode()

覆盖:

hashCode 在类中 java.lang.Object

另请参阅:

Object.hashCode()

initConfiguration

public void initConfiguration()

从接口复制的说明: I_CmsConfigurationParameterHandler

Initializes a configuration after all parameters have been added.

指定者:

initConfiguration 在接口中 I_CmsConfigurationParameterHandler

另请参阅:

I_CmsConfigurationParameterHandler.initConfiguration()

initialize

public void initialize()
                throws CmsSearchException

Initializes the search index.

抛出:

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

isBackupReindexing

public boolean isBackupReindexing()

Returns true if backup re-indexing is done by this index.

This is an optimization method by which the old extracted content is reused in order to save performance when re-indexing.

返回:

true if backup re-indexing is done by this index

从以下版本开始:

7.5.1

isCheckingPermissions

public boolean isCheckingPermissions()

Returns true if permissions are checked for search results by this index.

If permission checks are not required, they can be turned off in the index search configuration parameters in opencms-search.xml. Not checking permissions will improve performance.

This is can be of use in scenarios when you know that all search results are always readable, which is usually true for public websites that do not have personalized accounts.

Please note that even if a result is returned where the current user has no read permissions, the user can not actually access this document. It will only appear in the search result list, but if the user clicks the link to open the document he will get an error.

返回:

true if permissions are checked for search results by this index

isCheckingTimeRange

public boolean isCheckingTimeRange()

Returns true if the document time range is checked with a granularity level of seconds for search results by this index.

Since OpenCms 8.0, time range checks are always done if CmsSearchParameters.setMinDateLastModified(long) or any of the corresponding methods are used. This is done very efficiently using optimized Lucene filers. However, the granularity of these checks are done only on a daily basis, which means that you can only find "changes made yesterday" but not "changes made last hour". For normal limitation of search results, a daily granularity should be enough.

If time range checks with a granularity level of seconds are required, they can be turned on in the index search configuration parameters in opencms-search.xml. Not checking the time range with a granularity level of seconds will improve performance.

By default the granularity level of seconds is turned off since OpenCms 8.0

返回:

true if the document time range is checked with a granularity level of seconds for search results by this index

isCheckPermissions

public boolean isCheckPermissions()

Returns the checkPermissions.

返回:

the checkPermissions

isCreatingExcerpt

public boolean isCreatingExcerpt()

Returns true if an excerpt is generated by this index.

If no except is required, generation can be turned off in the index search configuration parameters in opencms-search.xml. Not generating an excerpt will improve performance.

返回:

true if an excerpt is generated by this index

isEnabled

public boolean isEnabled()

Returns true if this index is currently disabled.

返回:

true if this index is currently disabled

isExtractingContent

public boolean isExtractingContent()

Returns true if full text is extracted by this index.

Full text content extraction can be turned off in the index search configuration parameters in opencms-search.xml. Not extraction the full text information will highly improve performance.

返回:

true if full text is extracted by this index

isIgnoreExpiration

public boolean isIgnoreExpiration()

Returns the ignoreExpiration.

返回:

the ignoreExpiration

isLanguageDetection

public boolean isLanguageDetection()

Returns the languageDetection.

返回:

the languageDetection

isRequireViewPermission

public boolean isRequireViewPermission()

Returns true if a resource requires read permission to be included in the result list.

返回:

true if a resource requires read permission to be included in the result list

isUpdatedIncremental

public boolean isUpdatedIncremental()

Returns true in case this index is updated incremental.

An index is updated incremental if the index rebuild mode as defined by getRebuildMode() is either set to "auto" or "offline". Moreover, at least one update must have been written to the index already.

返回:

true in case this index is updated incremental

removeSourceName

public void removeSourceName(java.lang.String sourceName)

Removes an index source from this search index.

参数:

sourceName - the index source name to remove

search

public CmsSearchResultList search(CmsObject cms,
                         CmsSearchParameters params)
                           throws CmsSearchException

Performs a search on the index within the given fields.

The result is returned as List with entries of type I_CmsSearchResult.

参数:

cms - the current user's Cms object

params - the parameters to use for the search

返回:

the List of results found or an empty list

抛出:

CmsSearchException - if something goes wrong

setAnalyzer

public void setAnalyzer(org.apache.lucene.analysis.Analyzer analyzer)

Sets the Lucene analyzer used for this index.

参数:

analyzer - the Lucene analyzer to set

setCheckPermissions

public void setCheckPermissions(boolean checkPermissions)

Sets the checkPermissions.

参数:

checkPermissions - the checkPermissions to set

setEnabled

public void setEnabled(boolean enabled)

Can be used to enable / disable this index.

参数:

enabled - the state of the index to set

setFieldConfiguration

public void setFieldConfiguration(CmsSearchFieldConfiguration fieldConfiguration)

Sets the field configuration used for this index.

参数:

fieldConfiguration - the field configuration to set

setFieldConfigurationName

public void setFieldConfigurationName(java.lang.String fieldConfigurationName)

Sets the name of the field configuration used for this index.

参数:

fieldConfigurationName - the name of the field configuration to set

setIgnoreExpiration

public void setIgnoreExpiration(boolean ignoreExpiration)

Sets the ignoreExpiration.

参数:

ignoreExpiration - the ignoreExpiration to set

setLanguageDetection

public void setLanguageDetection(boolean languageDetection)

Sets the languageDetection.

参数:

languageDetection - the languageDetection to set

setLocale

public void setLocale(java.util.Locale locale)

Sets the locale to index resources.

参数:

locale - the locale to index resources

setLocaleString

public void setLocaleString(java.lang.String locale)

Sets the locale to index resources as a String.

参数:

locale - the locale to index resources

另请参阅:

setLocale(Locale)

setMaxHits

public void setMaxHits(int maxHits)

Sets the number of how many hits are loaded at maximum.

This must be set at least to 50, or this setting is ignored.

参数:

maxHits - the number of how many hits are loaded at maximum to set

从以下版本开始:

7.5.1

另请参阅:

getMaxHits()

setName

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

Sets the logical key/name of this search index.

参数:

name - the logical key/name of this search index

抛出:

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

setProject

public void setProject(java.lang.String project)

Sets the name of the project used to index resources.

参数:

project - the name of the project used to index resources

setRebuildMode

public void setRebuildMode(java.lang.String rebuildMode)

Sets the rebuild mode of this search index.

参数:

rebuildMode - the rebuild mode of this search index {auto|manual}

setRequireViewPermission

public void setRequireViewPermission(boolean requireViewPermission)

Controls if a resource requires view permission to be displayed in the result list.

By default this is false.

参数:

requireViewPermission - controls if a resource requires view permission to be displayed in the result list

shutDown

public void shutDown()

Shuts down the search index.

This will close the local Lucene index searcher instance.

toString

public java.lang.String toString()

Returns the name (getName()) of this search index.

覆盖:

toString 在类中 java.lang.Object

返回:

the name (getName()) of this search index

另请参阅:

Object.toString()

appendCategoryFilter

protected org.apache.lucene.queries.BooleanFilter appendCategoryFilter(CmsObject cms,
                                                           org.apache.lucene.queries.BooleanFilter filter,
                                                           java.util.List<java.lang.String> categories)

Appends the a category filter to the given filter clause that matches all given categories.

In case the provided List is null or empty, the original filter is left unchanged.

The original filter parameter is extended and also provided as return value.

参数:

cms - the current OpenCms search context

filter - the filter to extend

categories - the categories that will compose the filter

返回:

the extended filter clause

appendDateCreatedFilter

protected org.apache.lucene.queries.BooleanFilter appendDateCreatedFilter(org.apache.lucene.queries.BooleanFilter filter,
                                                              long startTime,
                                                              long endTime)

Appends a date of creation filter to the given filter clause that matches the given time range.

If the start time is equal to Long.MIN_VALUE and the end time is equal to Long.MAX_VALUE than the original filter is left unchanged.

The original filter parameter is extended and also provided as return value.

参数:

filter - the filter to extend

startTime - start time of the range to search in

endTime - end time of the range to search in

返回:

the extended filter clause

appendDateLastModifiedFilter

protected org.apache.lucene.queries.BooleanFilter appendDateLastModifiedFilter(org.apache.lucene.queries.BooleanFilter filter,
                                                                   long startTime,
                                                                   long endTime)

Appends a date of last modification filter to the given filter clause that matches the given time range.

If the start time is equal to Long.MIN_VALUE and the end time is equal to Long.MAX_VALUE than the original filter is left unchanged.

The original filter parameter is extended and also provided as return value.

参数:

filter - the filter to extend

startTime - start time of the range to search in

endTime - end time of the range to search in

返回:

the extended filter clause

appendPathFilter

protected org.apache.lucene.queries.BooleanFilter appendPathFilter(CmsObject cms,
                                                       org.apache.lucene.queries.BooleanFilter filter,
                                                       java.util.List<java.lang.String> roots)

Appends the a VFS path filter to the given filter clause that matches all given root paths.

In case the provided List is null or empty, the current request context site root is appended.

The original filter parameter is extended and also provided as return value.

参数:

cms - the current OpenCms search context

filter - the filter to extend

roots - the VFS root paths that will compose the filter

返回:

the extended filter clause

appendResourceTypeFilter

protected org.apache.lucene.queries.BooleanFilter appendResourceTypeFilter(CmsObject cms,
                                                               org.apache.lucene.queries.BooleanFilter filter,
                                                               java.util.List<java.lang.String> resourceTypes)

Appends the a resource type filter to the given filter clause that matches all given resource types.

In case the provided List is null or empty, the original filter is left unchanged.

The original filter parameter is extended and also provided as return value.

参数:

cms - the current OpenCms search context

filter - the filter to extend

resourceTypes - the resource types that will compose the filter

返回:

the extended filter clause

createDateRangeFilter

protected org.apache.lucene.search.Filter createDateRangeFilter(java.lang.String fieldName,
                                                    long startTime,
                                                    long endTime)

Creates an optimized date range filter for the date of last modification or creation.

If the start date is equal to Long.MIN_VALUE and the end date is equal to Long.MAX_VALUE than null is returned.

参数:

fieldName - the name of the field to search

startTime - start time of the range to search in

endTime - end time of the range to search in

返回:

an optimized date range filter for the date of last modification or creation

createIndexBackup

protected java.lang.String createIndexBackup()

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

返回:

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

createIndexWriter

protected I_CmsIndexWriter createIndexWriter(boolean create,
                                 I_CmsReport report)
                                      throws CmsIndexException

Creates a new index writer.

参数:

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

report - the report

返回:

the created new index writer

抛出:

CmsIndexException - in case the writer could not be created

另请参阅:

getIndexWriter(I_CmsReport, boolean)

excludeFromIndex

protected boolean excludeFromIndex(CmsObject cms,
                       CmsResource resource)

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

参数:

cms - the OpenCms context used for building the search index

resource - the resource to index

返回:

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

extendPathFilter

protected void extendPathFilter(java.util.List<org.apache.lucene.index.Term> terms,
                    java.lang.String searchRoot)

Extends the given path query with another term for the given search root element.

参数:

terms - the path filter to extend

searchRoot - the search root to add to the path query

generateIndexDirectory

protected java.lang.String generateIndexDirectory()

Generates the directory on the RFS for this index.

返回:

the directory on the RFS for this index

getMultiTermQueryFilter

protected org.apache.lucene.search.Filter getMultiTermQueryFilter(java.lang.String field,
                                                      java.util.List<java.lang.String> terms)

Returns a cached Lucene term query filter for the given field and terms.

参数:

field - the field to use

terms - the term to use

返回:

a cached Lucene term query filter for the given field and terms

getMultiTermQueryFilter

protected org.apache.lucene.search.Filter getMultiTermQueryFilter(java.lang.String field,
                                                      java.lang.String terms)

Returns a cached Lucene term query filter for the given field and terms.

参数:

field - the field to use

terms - the term to use

返回:

a cached Lucene term query filter for the given field and terms

getMultiTermQueryFilter

protected org.apache.lucene.search.Filter getMultiTermQueryFilter(java.lang.String field,
                                                      java.lang.String termsStr,
                                                      java.util.List<java.lang.String> termsList)

Returns a cached Lucene term query filter for the given field and terms.

参数:

field - the field to use

termsStr - the terms to use as a String separated by a space ' ' char

termsList - the list of terms to use

返回:

a cached Lucene term query filter for the given field and terms

getResource

protected CmsResource getResource(CmsObject cms,
                      I_CmsSearchDocument doc)

Checks if the OpenCms resource referenced by the result document can be read by the user of the given OpenCms context. Returns the referenced CmsResource or null if the user is not permitted to read the resource.

参数:

cms - the OpenCms user context to use for permission testing

doc - the search result document to check

返回:

the referenced CmsResource or null if the user is not permitted

getTermQueryFilter

protected org.apache.lucene.search.Filter getTermQueryFilter(java.lang.String field,
                                                 java.lang.String term)

Returns a cached Lucene term query filter for the given field and term.

参数:

field - the field to use

term - the term to use

返回:

a cached Lucene term query filter for the given field and term

hasReadPermission

protected boolean hasReadPermission(CmsObject cms,
                        I_CmsSearchDocument doc)

Checks if the OpenCms resource referenced by the result document can be read be the user of the given OpenCms context.

参数:

cms - the OpenCms user context to use for permission testing

doc - the search result document to check

返回:

true if the user has read permissions to the resource

indexSearcherClose

protected void indexSearcherClose()

Closes the index searcher for this index.

另请参阅:

indexSearcherOpen(String)

indexSearcherClose

protected void indexSearcherClose(org.apache.lucene.search.IndexSearcher searcher)

Closes the given Lucene index searcher.

参数:

searcher - the searcher to close

indexSearcherOpen

protected void indexSearcherOpen(java.lang.String path)

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.

参数:

path - the path to the index directory

indexSearcherUpdate

protected void indexSearcherUpdate()

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

另请参阅:

indexSearcherOpen(String)

indexWriterUnlock

protected void indexWriterUnlock(I_CmsReport report)
                          throws CmsIndexException

Unlocks the Lucene index writer of this index if required.

参数:

report - the report to write error messages on

抛出:

CmsIndexException - if unlocking of the index is impossible for any reason

isInTimeRange

protected boolean isInTimeRange(org.apache.lucene.document.Document doc,
                    CmsSearchParameters params)

Checks if the document is in the time range specified in the search parameters.

The creation date and/or the last modification date are checked.

参数:

doc - the document to check the dates against the given time range

params - the search parameters where the time ranges are specified

返回:

true if document is in time range or not time range set otherwise false

isSortScoring

protected boolean isSortScoring(org.apache.lucene.search.IndexSearcher searcher,
                    org.apache.lucene.search.Sort sort)

Checks if the score for the results must be calculated based on the provided sort option.

Since Lucene 3 apparently the score is no longer calculated by default, but only if the searcher is explicitly told so. This methods checks if, based on the given sort, the score must be calculated.

参数:

searcher - the index searcher to prepare

sort - the sort option to use

返回:

true if the sort option should be used

needsPermissionCheck

protected boolean needsPermissionCheck(I_CmsSearchDocument doc)

Checks if the OpenCms resource referenced by the result document needs to be checked.

参数:

doc - the search result document to check

返回:

true if the document needs to be checked false otherwise

removeIndexBackup

protected void removeIndexBackup(java.lang.String path)

Removes the given backup folder of this index.

参数:

path - the backup folder to remove

setIndexWriter

protected void setIndexWriter(I_CmsIndexWriter writer)

Sets the index writer.

参数:

writer - the index writer to set