Package org.ametys.cms.search.content

Class ContentSearchHelper

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.cms.search.content.ContentSearchHelper

All Implemented Interfaces:

LogEnabled, Component, Contextualizable, Serviceable

public class ContentSearchHelper
extends AbstractLogEnabled
implements Component, Serviceable, Contextualizable

Component which helps content searching by providing a simple way to access content properties (either metadata or system properties).

Field Summary

Fields

Modifier and Type	Field	Description
protected ContentHelper	_contentHelper	The content helper.
protected ContentTypesHelper	_contentTypesHelper	Content Types helper
protected ContentTypeExtensionPoint	_cTypeEP	The content type extension point.
protected ContentTypesHelper	_cTypeHelper	The content type helper.
protected ServiceManager	_manager	Avalon service manager
protected AmetysObjectResolver	_resolver	The ametys object resolver.
protected SystemPropertyExtensionPoint	_sysPropEP	The system property extension point.
protected UserHelper	_userHelper	The user helper
static String	ROLE	The component role.

Constructor Summary

Constructors

Constructor	Description
ContentSearchHelper()

Method Summary

Modifier and Type	Method	Description
protected SearchField	_getSearchField(MetadataIndexingField indexingField, String[] remainingPathSegments, List<String> joinPaths, boolean addLast)	Get the search field from the indexing field and compute the join paths.
void	contextualize(Context context)
Object	getAttributeValue(Content content, String dataPath, Locale defaultLocale)	Get the value(s) of an attribute - transformed into JSONified value - of a content at given path.
Object	getAttributeValue(Content content, String dataPath, Locale defaultLocale, boolean resolveReferences)	Get the value(s) of an attribute - transformed into JSONified value - of a content at given path.
Object	getAttributeValue(Content content, String dataPath, ModelItem modelItem, Locale defaultLocale, boolean resolveReferences)	Get the value(s) of an attribute - transformed into JSONified value - of a content at given path.
Map<String,Object>	getAttributeValues(String contentId, Collection<String> dataPaths, Locale defaultLocale)	Get attributes values by their paths
Map<String,Object>	getAttributeValues(Content content, Collection<String> dataPaths, Locale defaultLocale)	Get attributes values by their paths
SearchField	getMetadataSearchField(String metadataPath, MetadataType metadataType, boolean isTypeContentWithMultilingualTitle)	Get a SearchField corresponding to a metadata.
SearchField	getMetadataSearchField(List<String> joinPaths, String metadataPath, MetadataType metadataType, boolean isTypeContentWithMultilingualTitle)	Get a SearchField corresponding to a metadata.
Optional<SearchField>	getSearchField(Collection<String> contentTypes, String fieldPath)	Get a SearchField from a field name in a batch of content types.
MetadataIndexingField	getTitleMetadataIndexingField()	Get the metadata indexing field for the "title" standard metadata.
boolean	isTitleMultilingual(MetadataDefinition def)	Determines if the given metadata definition represents a CONTENT metadata with contents with multilingual titles
boolean	isTitleMultilingual(ModelItem modelItem)	Determines if the given metadata definition represents a CONTENT metadata with contents with multilingual titles
void	service(ServiceManager manager)

Methods inherited from class org.ametys.runtime.plugin.component.AbstractLogEnabled

getLogger, setLogger

Methods inherited from class java.lang.Object

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

Field Detail

ROLE

public static final String ROLE

The component role.

_cTypeEP

protected ContentTypeExtensionPoint _cTypeEP

The content type extension point.

_cTypeHelper

protected ContentTypesHelper _cTypeHelper

The content type helper.

_contentHelper

protected ContentHelper _contentHelper

The content helper.

_sysPropEP

protected SystemPropertyExtensionPoint _sysPropEP

The system property extension point.

_resolver

protected AmetysObjectResolver _resolver

The ametys object resolver.

_userHelper

protected UserHelper _userHelper

The user helper

_contentTypesHelper

protected ContentTypesHelper _contentTypesHelper

Content Types helper

_manager

protected ServiceManager _manager

Avalon service manager

Constructor Detail

ContentSearchHelper

public ContentSearchHelper()

Method Detail

contextualize

public void contextualize(Context context)
                   throws ContextException

Specified by:

contextualize in interface Contextualizable

Throws:

ContextException

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

getTitleMetadataIndexingField

public MetadataIndexingField getTitleMetadataIndexingField()

Get the metadata indexing field for the "title" standard metadata.

Returns:

The standard title metadata indexing field.

getMetadataSearchField

public SearchField getMetadataSearchField(String metadataPath,
                                          MetadataType metadataType,
                                          boolean isTypeContentWithMultilingualTitle)

Get a SearchField corresponding to a metadata.

Parameters:

metadataPath - The metadata path.

metadataType - The metadata type.

isTypeContentWithMultilingualTitle - true if the type is Content and the linked contents have multilingual titles

Returns:

the search field.

getMetadataSearchField

public SearchField getMetadataSearchField(List<String> joinPaths,
                                          String metadataPath,
                                          MetadataType metadataType,
                                          boolean isTypeContentWithMultilingualTitle)

Get a SearchField corresponding to a metadata.

Parameters:

joinPaths - The join paths

metadataPath - The metadata path.

metadataType - The metadata type.

isTypeContentWithMultilingualTitle - true if the type is Content and the linked contents have multilingual titles

Returns:

the search field.

getSearchField

public Optional<SearchField> getSearchField(Collection<String> contentTypes,
                                            String fieldPath)

Get a SearchField from a field name in a batch of content types.

Parameters:

contentTypes - The content types, can be empty to search on any content type. In that case, only the title metadata and system properties will be usable in sort and facets specs.

fieldPath - The field path, can be either a system property ID or a indexing field name or path.

Returns:

The SearchField corresponding to the field path, or an empty optional if not found

_getSearchField

protected SearchField _getSearchField(MetadataIndexingField indexingField,
                                      String[] remainingPathSegments,
                                      List<String> joinPaths,
                                      boolean addLast)

Get the search field from the indexing field and compute the join paths. Can be null if the last indexing field is a custom indexing field.

Parameters:

indexingField - The initial indexing field

remainingPathSegments - The path to access the metadata or an another indexing field from the initial indexing field

joinPaths - The consecutive's path in case of joint to access the field/metadata

addLast - true to add the last join path element to the list, false otherwise.

Returns:

The search field or null if not found

isTitleMultilingual

public boolean isTitleMultilingual(MetadataDefinition def)

Determines if the given metadata definition represents a CONTENT metadata with contents with multilingual titles

Parameters:

def - The metadata definition

Returns:

true if the given metadata definition represents a CONTENT metadata with contents with multilingual titles

isTitleMultilingual

public boolean isTitleMultilingual(ModelItem modelItem)

Determines if the given metadata definition represents a CONTENT metadata with contents with multilingual titles

Parameters:

modelItem - The metadata definition

Returns:

true if the given metadata definition represents a CONTENT metadata with contents with multilingual titles

getAttributeValues

public Map<String,Object> getAttributeValues(String contentId,
                                                   Collection<String> dataPaths,
                                                   Locale defaultLocale)

Get attributes values by their paths

Parameters:

contentId - The id of content

dataPaths - The paths of data to retrieve

defaultLocale - The default locale to resolve multilingual values if the content's language is null. Can be null.

Returns:

The attributes values

getAttributeValues

public Map<String,Object> getAttributeValues(Content content,
                                                   Collection<String> dataPaths,
                                                   Locale defaultLocale)

Get attributes values by their paths

Parameters:

content - The initial content

dataPaths - The path of data to retrieve, slash-separated.

defaultLocale - The default locale to resolve multilingual values if the content's language is null. Can be null.

Returns:

The attributes values

getAttributeValue

public Object getAttributeValue(Content content,
                                String dataPath,
                                Locale defaultLocale)

Get the value(s) of an attribute - transformed into JSONified value - of a content at given path. The path can represent a path of an attribute into the content or an attribute on one or more linked contents, such as 'composite/linkedContent/secondContent/composite/attribute'. The returned value is typed.

Parameters:

content - The content

dataPath - The path to the attribute, separated by '/'

defaultLocale - The default locale to resolve multilingual values if the content's language is null. Can be null.

Returns:

The final value.

getAttributeValue

public Object getAttributeValue(Content content,
                                String dataPath,
                                Locale defaultLocale,
                                boolean resolveReferences)

Get the value(s) of an attribute - transformed into JSONified value - of a content at given path. The path can represent a path of an attribute into the content or an attribute on one or more linked contents, such as 'composite/linkedContent/secondContent/composite/attribute'.

Parameters:

content - The content

dataPath - The path to the attribute, separated by '/'

defaultLocale - The default locale to resolve multilingual values if the content's language is null. Can be null.

resolveReferences - true to generate full representation of attribute's values : the references will be resolved and the label of enumerated values will be returned.

Returns:

The final value, transformed for search.

getAttributeValue

public Object getAttributeValue(Content content,
                                String dataPath,
                                ModelItem modelItem,
                                Locale defaultLocale,
                                boolean resolveReferences)

Get the value(s) of an attribute - transformed into JSONified value - of a content at given path. The path can represent a path of an attribute into the content or an attribute on one or more linked contents, such as 'composite/linkedContent/secondContent/composite/attribute'.

Parameters:

content - The initial content.

dataPath - The path to the attribute, separated by '/'

modelItem - The attribute definition.

defaultLocale - The default locale to resolve multilingual values if the content's language is null. Can be null.

resolveReferences - true to generate full representation of attribute's values : the references will be resolved and the label of enumerated values will be returned.

Returns:

The final value, transformed for search.