org.opencms.search.fields

类 CmsSearchFieldConfiguration

java.lang.Object

org.opencms.search.fields.CmsSearchFieldConfiguration

所有已实现的接口:

java.lang.Comparable<CmsSearchFieldConfiguration>, I_CmsSearchFieldAppdender

直接已知子类:

CmsLuceneFieldConfiguration, CmsSolrFieldConfiguration

public class CmsSearchFieldConfiguration
extends java.lang.Object
implements java.lang.Comparable<CmsSearchFieldConfiguration>, I_CmsSearchFieldAppdender

Abstract implementation for OpenCms search field configurations.

从以下版本开始:

8.5.0

字段概要

字段

限定符和类型	字段和说明
static java.util.List<java.lang.String>	LAZY_FIELDS A list of fields that should be lazy-loaded.
static java.lang.String	STR_STANDARD The name for the standard field configuration.

构造器概要

构造器

构造器和说明
CmsSearchFieldConfiguration() Creates a new, empty field configuration.

方法概要

方法

限定符和类型	方法和说明
void	addAdditionalFields() Add the additional fields to the configuration.
void	addField(CmsSearchField field) Adds a field to this search field configuration.
void	addFields(java.util.Collection<CmsSearchField> fields) Adds fields.
protected I_CmsSearchDocument	appendCategories(I_CmsSearchDocument document, CmsObject cms, CmsResource resource, I_CmsExtractionResult extractionResult, java.util.List<CmsProperty> properties, java.util.List<CmsProperty> propertiesSearched) Extends the given document by resource category information based on properties.
protected I_CmsSearchDocument	appendContentBlob(I_CmsSearchDocument document, CmsObject cms, CmsResource resource, I_CmsExtractionResult extractionResult, java.util.List<CmsProperty> properties, java.util.List<CmsProperty> propertiesSearched) Extends the given document by a field that contains the extracted content blob.
protected I_CmsSearchDocument	appendDates(I_CmsSearchDocument document, CmsObject cms, CmsResource resource, I_CmsExtractionResult extractionResult, java.util.List<CmsProperty> properties, java.util.List<CmsProperty> propertiesSearched) Extends the given document by fields for date of creation, content and last modification.
protected I_CmsSearchDocument	appendFieldMapping(I_CmsSearchDocument document, CmsSearchField field, CmsObject cms, CmsResource resource, I_CmsExtractionResult extractionResult, java.util.List<CmsProperty> properties, java.util.List<CmsProperty> propertiesSearched) Extends the given document by the mappings for the given field.
protected I_CmsSearchDocument	appendFieldMappings(I_CmsSearchDocument document, CmsObject cms, CmsResource resource, I_CmsExtractionResult extractionResult, java.util.List<CmsProperty> properties, java.util.List<CmsProperty> propertiesSearched) Extends the given document by the configured field mappings.
I_CmsSearchDocument	appendFields(I_CmsSearchDocument document, CmsObject cms, CmsResource resource, I_CmsExtractionResult extractionResult, java.util.List<CmsProperty> properties, java.util.List<CmsProperty> propertiesSearched) Appends the specific search fields to the document.
protected I_CmsSearchDocument	appendFileSize(I_CmsSearchDocument document, CmsObject cms, CmsResource resource, I_CmsExtractionResult extractionResult, java.util.List<CmsProperty> properties, java.util.List<CmsProperty> propertiesSearched) Extends the given document by the "size" field.
protected I_CmsSearchDocument	appendLocales(I_CmsSearchDocument document, CmsObject cms, CmsResource resource, I_CmsExtractionResult extraction, java.util.List<CmsProperty> properties, java.util.List<CmsProperty> propertiesSearched) Extends the given document by the "res_locales" field.
protected I_CmsSearchDocument	appendPath(I_CmsSearchDocument document, CmsObject cms, CmsResource resource, I_CmsExtractionResult extractionResult, java.util.List<CmsProperty> properties, java.util.List<CmsProperty> propertiesSearched) Extends the given document by fields for VFS path lookup.
protected I_CmsSearchDocument	appendProperties(I_CmsSearchDocument document, CmsObject cms, CmsResource resource, I_CmsExtractionResult extraction, java.util.List<CmsProperty> properties, java.util.List<CmsProperty> propertiesSearched) Appends all direct properties, that are not empty or white space only to the document.
protected I_CmsSearchDocument	appendType(I_CmsSearchDocument document, CmsObject cms, CmsResource resource, I_CmsExtractionResult extractionResult, java.util.List<CmsProperty> properties, java.util.List<CmsProperty> propertiesSearched) Extends the given document by a field that contains the resource type name.
int	compareTo(CmsSearchFieldConfiguration obj)
I_CmsSearchDocument	createDocument(CmsObject cms, CmsResource resource, CmsSearchIndex index, I_CmsExtractionResult extraction) Creates the Lucene Document with this field configuration for the provided VFS resource, search index and content.
boolean	equals(java.lang.Object obj)
java.lang.String	getDescription() Returns the description of this field configuration.
CmsSearchField	getField(java.lang.String name) Returns the configured CmsSearchField instance with the given name.
java.util.List<java.lang.String>	getFieldNames() Returns the list of configured field names (Strings).
java.util.List<CmsSearchField>	getFields() Returns the list of configured CmsSearchField instances.
CmsSearchIndex	getIndex() Returns the index.
static java.lang.String	getLocaleExtendedName(java.lang.String lookup, java.util.Locale locale) Returns the locale extended name for the given lookup String.
static java.lang.String	getLocaleExtendedName(java.lang.String lookup, java.lang.String locale) Returns the locale extended name for the given lookup String.
java.lang.String	getName() Returns the name of this field configuration.
static java.lang.String	getParentFolderTokens(java.lang.String rootPath) Creates a space separated list of all parent folders of the given root path.
int	hashCode()
void	init() Initializes this field configuration.
protected I_CmsSearchDocument	setBoost(I_CmsSearchDocument document, CmsObject cms, CmsResource resource, I_CmsExtractionResult extractionResult, java.util.List<CmsProperty> properties, java.util.List<CmsProperty> propertiesSearched) Extends the given document with a boost factor.
void	setDescription(java.lang.String description) Sets the description of this field configuration.
void	setIndex(CmsSearchIndex index) Sets the index.
void	setName(java.lang.String name) Sets the name of this field configuration.

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

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

字段详细资料

LAZY_FIELDS

public static final java.util.List<java.lang.String> LAZY_FIELDS

A list of fields that should be lazy-loaded.

STR_STANDARD

public static final java.lang.String STR_STANDARD

The name for the standard field configuration.

另请参阅:

常量字段值

构造器详细资料

CmsSearchFieldConfiguration

public CmsSearchFieldConfiguration()

Creates a new, empty field configuration.

方法详细资料

getLocaleExtendedName

public static final java.lang.String getLocaleExtendedName(java.lang.String lookup,
                                     java.util.Locale locale)

Returns the locale extended name for the given lookup String.

参数:

lookup - the lookup String

locale - the locale

返回:

the locale extended name for the given lookup String

getLocaleExtendedName

public static final java.lang.String getLocaleExtendedName(java.lang.String lookup,
                                     java.lang.String locale)

Returns the locale extended name for the given lookup String.

参数:

lookup - the lookup String

locale - the locale

返回:

the locale extended name for the given lookup String

getParentFolderTokens

public static java.lang.String getParentFolderTokens(java.lang.String rootPath)

Creates a space separated list of all parent folders of the given root path.

参数:

rootPath - the root path to get the parent folder list for

返回:

a space separated list of all parent folders of the given root path

addAdditionalFields

public void addAdditionalFields()

从接口复制的说明: I_CmsSearchFieldAppdender

Add the additional fields to the configuration.

I_CmsSearchFieldAppdender.appendFields(I_CmsSearchDocument, CmsObject, CmsResource, I_CmsExtractionResult, List, List)

指定者:

addAdditionalFields 在接口中 I_CmsSearchFieldAppdender

另请参阅:

I_CmsSearchFieldAppdender.addAdditionalFields()

addField

public void addField(CmsSearchField field)

Adds a field to this search field configuration.

参数:

field - the field to add

addFields

public void addFields(java.util.Collection<CmsSearchField> fields)

Adds fields.

参数:

fields - the fields to add

appendFields

public I_CmsSearchDocument appendFields(I_CmsSearchDocument document,
                               CmsObject cms,
                               CmsResource resource,
                               I_CmsExtractionResult extractionResult,
                               java.util.List<CmsProperty> properties,
                               java.util.List<CmsProperty> propertiesSearched)

Appends the specific search fields to the document.

指定者:

appendFields 在接口中 I_CmsSearchFieldAppdender

参数:

document - the document to append field(s)

cms - the CMS object used during indexing process

resource - the resource that is currently indexed

extractionResult - the extraction result of this resource

properties - CmsObject.readPropertyObjects(CmsResource, boolean) with false

propertiesSearched - CmsObject.readPropertyObjects(CmsResource, boolean) with true

返回:

the document

另请参阅:

I_CmsSearchFieldAppdender.appendFields(org.opencms.search.I_CmsSearchDocument, org.opencms.file.CmsObject, org.opencms.file.CmsResource, org.opencms.search.extractors.I_CmsExtractionResult, java.util.List, java.util.List)

compareTo

public int compareTo(CmsSearchFieldConfiguration obj)

指定者:

compareTo 在接口中 java.lang.Comparable<CmsSearchFieldConfiguration>

另请参阅:

Comparable.compareTo(java.lang.Object)

createDocument

public I_CmsSearchDocument createDocument(CmsObject cms,
                                 CmsResource resource,
                                 CmsSearchIndex index,
                                 I_CmsExtractionResult extraction)
                                   throws CmsException

Creates the Lucene Document with this field configuration for the provided VFS resource, search index and content.

This triggers the indexing process for the given VFS resource according to the configuration of the provided index.

The provided index resource contains the basic contents to index. The provided search index contains the configuration what to index, such as the locale and possible special field mappings.

参数:

cms - the OpenCms user context used to access the OpenCms VFS

resource - the resource to create the Lucene document from

index - the search index to create the Document for

extraction - the plain text content extracted from the document

返回:

the Search Document for the given VFS resource and the given search index

抛出:

CmsException - if something goes wrong

equals

public boolean equals(java.lang.Object obj)

覆盖:

equals 在类中 java.lang.Object

另请参阅:

Object.equals(java.lang.Object)

getDescription

public java.lang.String getDescription()

Returns the description of this field configuration.

返回:

the description of this field configuration

getField

public CmsSearchField getField(java.lang.String name)

Returns the configured CmsSearchField instance with the given name.

参数:

name - the search field name to look up

返回:

the configured CmsSearchField instance with the given name

getFieldNames

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

Returns the list of configured field names (Strings).

返回:

the list of configured field names (Strings)

getFields

public java.util.List<CmsSearchField> getFields()

Returns the list of configured CmsSearchField instances.

返回:

the list of configured CmsSearchField instances

getIndex

public CmsSearchIndex getIndex()

Returns the index.

返回:

the index

getName

public java.lang.String getName()

Returns the name of this field configuration.

返回:

the name of this field configuration

hashCode

public int hashCode()

覆盖:

hashCode 在类中 java.lang.Object

另请参阅:

Object.hashCode()

init

public void init()

Initializes this field configuration.

setDescription

public void setDescription(java.lang.String description)

Sets the description of this field configuration.

参数:

description - the description to set

setIndex

public void setIndex(CmsSearchIndex index)

Sets the index.

参数:

index - the index to set

setName

public void setName(java.lang.String name)

Sets the name of this field configuration.

参数:

name - the name to set

appendCategories

protected I_CmsSearchDocument appendCategories(I_CmsSearchDocument document,
                                   CmsObject cms,
                                   CmsResource resource,
                                   I_CmsExtractionResult extractionResult,
                                   java.util.List<CmsProperty> properties,
                                   java.util.List<CmsProperty> propertiesSearched)
                                        throws CmsException

Extends the given document by resource category information based on properties.

参数:

document - the document to extend

cms - the OpenCms context used for building the search index

resource - the resource that is indexed

extractionResult - the plain text extraction result from the resource

properties - the list of all properties directly attached to the resource (not searched)

propertiesSearched - the list of all searched properties of the resource

返回:

the document extended by resource category information

抛出:

CmsException - if something goes wrong

appendContentBlob

protected I_CmsSearchDocument appendContentBlob(I_CmsSearchDocument document,
                                    CmsObject cms,
                                    CmsResource resource,
                                    I_CmsExtractionResult extractionResult,
                                    java.util.List<CmsProperty> properties,
                                    java.util.List<CmsProperty> propertiesSearched)

Extends the given document by a field that contains the extracted content blob.

参数:

document - the document to extend

cms - the OpenCms context used for building the search index

resource - the resource that is indexed

extractionResult - the plain text extraction result from the resource

properties - the list of all properties directly attached to the resource (not searched)

propertiesSearched - the list of all searched properties of the resource

返回:

the document extended by a field that contains the extracted content blob

appendDates

protected I_CmsSearchDocument appendDates(I_CmsSearchDocument document,
                              CmsObject cms,
                              CmsResource resource,
                              I_CmsExtractionResult extractionResult,
                              java.util.List<CmsProperty> properties,
                              java.util.List<CmsProperty> propertiesSearched)

Extends the given document by fields for date of creation, content and last modification.

参数:

document - the document to extend

cms - the OpenCms context used for building the search index

resource - the resource that is indexed

extractionResult - the plain text extraction result from the resource

properties - the list of all properties directly attached to the resource (not searched)

propertiesSearched - the list of all searched properties of the resource

返回:

the document extended by fields for date of creation, content and last modification

appendFieldMapping

protected I_CmsSearchDocument appendFieldMapping(I_CmsSearchDocument document,
                                     CmsSearchField field,
                                     CmsObject cms,
                                     CmsResource resource,
                                     I_CmsExtractionResult extractionResult,
                                     java.util.List<CmsProperty> properties,
                                     java.util.List<CmsProperty> propertiesSearched)

Extends the given document by the mappings for the given field.

参数:

document - the document to extend

field - the field to create the mappings for

cms - the OpenCms context used for building the search index

resource - the resource that is indexed

extractionResult - the plain text extraction result from the resource

properties - the list of all properties directly attached to the resource (not searched)

propertiesSearched - the list of all searched properties of the resource

返回:

the document extended by the mappings for the given field

appendFieldMappings

protected I_CmsSearchDocument appendFieldMappings(I_CmsSearchDocument document,
                                      CmsObject cms,
                                      CmsResource resource,
                                      I_CmsExtractionResult extractionResult,
                                      java.util.List<CmsProperty> properties,
                                      java.util.List<CmsProperty> propertiesSearched)

Extends the given document by the configured field mappings.

参数:

document - the document to extend

cms - the OpenCms context used for building the search index

resource - the resource that is indexed

extractionResult - the plain text extraction result from the resource

properties - the list of all properties directly attached to the resource (not searched)

propertiesSearched - the list of all searched properties of the resource

返回:

the document extended by the configured field mappings

appendFileSize

protected I_CmsSearchDocument appendFileSize(I_CmsSearchDocument document,
                                 CmsObject cms,
                                 CmsResource resource,
                                 I_CmsExtractionResult extractionResult,
                                 java.util.List<CmsProperty> properties,
                                 java.util.List<CmsProperty> propertiesSearched)

Extends the given document by the "size" field.

参数:

document - the document to extend

cms - the OpenCms context used for building the search index

resource - the resource that is indexed

extractionResult - the plain text extraction result from the resource

properties - the list of all properties directly attached to the resource (not searched)

propertiesSearched - the list of all searched properties of the resource

返回:

the document extended by the resource locales

appendLocales

protected I_CmsSearchDocument appendLocales(I_CmsSearchDocument document,
                                CmsObject cms,
                                CmsResource resource,
                                I_CmsExtractionResult extraction,
                                java.util.List<CmsProperty> properties,
                                java.util.List<CmsProperty> propertiesSearched)

Extends the given document by the "res_locales" field.

参数:

document - the document to extend

cms - the OpenCms context used for building the search index

resource - the resource that is indexed

extraction - the plain text extraction result from the resource

properties - the list of all properties directly attached to the resource (not searched)

propertiesSearched - the list of all searched properties of the resource

返回:

the document extended by the resource locales

appendPath

protected I_CmsSearchDocument appendPath(I_CmsSearchDocument document,
                             CmsObject cms,
                             CmsResource resource,
                             I_CmsExtractionResult extractionResult,
                             java.util.List<CmsProperty> properties,
                             java.util.List<CmsProperty> propertiesSearched)

Extends the given document by fields for VFS path lookup.

参数:

document - the document to extend

cms - the OpenCms context used for building the search index

resource - the resource that is indexed

extractionResult - the plain text extraction result from the resource

properties - the list of all properties directly attached to the resource (not searched)

propertiesSearched - the list of all searched properties of the resource

返回:

the document extended by fields for VFS path lookup

appendProperties

protected I_CmsSearchDocument appendProperties(I_CmsSearchDocument document,
                                   CmsObject cms,
                                   CmsResource resource,
                                   I_CmsExtractionResult extraction,
                                   java.util.List<CmsProperty> properties,
                                   java.util.List<CmsProperty> propertiesSearched)

Appends all direct properties, that are not empty or white space only to the document.

参数:

document - the document to extend

cms - the OpenCms context used for building the search index

resource - the resource that is indexed

extraction - the plain text extraction result from the resource

properties - the list of all properties directly attached to the resource (not searched)

propertiesSearched - the list of all searched properties of the resource

返回:

the document extended by resource category information

appendType

protected I_CmsSearchDocument appendType(I_CmsSearchDocument document,
                             CmsObject cms,
                             CmsResource resource,
                             I_CmsExtractionResult extractionResult,
                             java.util.List<CmsProperty> properties,
                             java.util.List<CmsProperty> propertiesSearched)
                                  throws CmsLoaderException

Extends the given document by a field that contains the resource type name.

参数:

document - the document to extend

cms - the OpenCms context used for building the search index

resource - the resource that is indexed

extractionResult - the plain text extraction result from the resource

properties - the list of all properties directly attached to the resource (not searched)

propertiesSearched - the list of all searched properties of the resource

返回:

the document extended by a field that contains the resource type name

抛出:

CmsLoaderException - in case of errors identifying the resource type name

setBoost

protected I_CmsSearchDocument setBoost(I_CmsSearchDocument document,
                           CmsObject cms,
                           CmsResource resource,
                           I_CmsExtractionResult extractionResult,
                           java.util.List<CmsProperty> properties,
                           java.util.List<CmsProperty> propertiesSearched)

Extends the given document with a boost factor.

参数:

document - the document to extend

cms - the OpenCms context used for building the search index

resource - the resource that is indexed

extractionResult - the plain text extraction result from the resource

properties - the list of all properties directly attached to the resource (not searched)

propertiesSearched - the list of all searched properties of the resource

返回:

the document extended by a boost factor