org.ametys.web.indexing.solr

Class SolrPageIndexer

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.web.indexing.solr.SolrPageIndexer

All Implemented Interfaces:

SolrFieldNames, LogEnabled, SolrWebFieldNames, Component, Contextualizable, Serviceable

public class SolrPageIndexer
extends AbstractLogEnabled
implements Component, Serviceable, SolrWebFieldNames, Contextualizable

Component responsible for indexing a page with all its contents.

Field Summary

Fields

Modifier and Type	Field and Description
protected AdditionalPropertyIndexerExtensionPoint	_additionalPropertiesIndexerEP The additional property indexer extension point.
protected AmetysObjectResolver	_ametysObjectResolver The Ametys object resolver
protected Context	_context The avalon context
private ContentTypesHelper	_cTypesHelper
protected ServiceExtensionPoint	_serviceExtensionPoint The service extension point.
protected SolrClientProvider	_solrClientProvider The Solr client provider
protected SolrContentIndexer	_solrContentIndexer Solr Ametys contents indexer
protected SolrIndexer	_solrIndexer The Solr indexer
protected SolrResourceIndexer	_solrResourceIndexer Solr Ametys resources indexer
protected TagProviderExtensionPoint	_tagProviderEP The tag provider extension point.
static String	ROLE The avalon role.

Fields inherited from interface org.ametys.web.indexing.solr.SolrWebFieldNames

ATTACHMENT_PAGE_ID, CONTENT_IDS, CONTENT_INTERESTING_DATES, DATE_FOR_SORTING, DATES_FACET, FACETABLE_CONTENT_FIELD_PREFIX, LASTNAME_FOR_SORTING, ORPHAN, PAGE_ANCESTOR_IDS, PAGE_CONTENT_TYPES, PAGE_DEPTH, PAGE_IDS, PAGE_LONG_TITLE, PAGE_OUTGOING_REFEERENCES_RESOURCE_IDS, PAGE_TITLE, PAGE_TYPE, PRIVACY, SECTION_PAGE_TITLE, SERVICE_IDS, SHARED, SITE_NAME, SITE_TYPE, SITEMAP_NAME, TEMPLATE, TYPE_PAGE, TYPE_PAGE_RESOURCE

Fields inherited from interface org.ametys.cms.content.indexing.solr.SolrFieldNames

ALL_CONTENT_TYPES, ALL_MIXIN_TYPES, ALL_TAGS, ATTACHMENT_CONTENT_ID, CONTENT_COMMENTS, CONTENT_COMMENTS_NONVALIDATED, CONTENT_COMMENTS_VALIDATED, CONTENT_CREATOR, CONTENT_LANGUAGE, CONTENT_LANGUAGES, CONTENT_LAST_CONTRIBUTOR, CONTENT_NAME, CONTENT_OUTGOING_REFEERENCES_RESOURCE_IDS, CONTENT_TITLES, CONTENT_TYPE_RESOURCE, CONTENT_TYPES, CREATION_DATE, DC_CONTRIBUTOR, DC_COVERAGE, DC_CREATOR, DC_DATE, DC_DESCRIPTION, DC_FORMAT, DC_IDENTIFIER, DC_LANGUAGE, DC_PUBLISHER, DC_RELATION, DC_RIGHTS, DC_SOURCE, DC_SUBJECT, DC_TITLE, DC_TYPE, DOCUMENT_TYPE, EXCERPT, FILENAME, FULL_EXACT_WS, FULL_GENERAL, FULL_PREFIX, FULL_STEMMED_PREFIX, ID, IS_AMETYS_OBJECT, LAST_MAJOR_VALIDATION, LAST_MODIFIED, LAST_VALIDATION, LENGTH, MIME_TYPES, MIXIN_TYPES, PATH, REPEATER_ENTRY_POSITION, RESOURCE_ANCESTOR_IDS, RESOURCE_CREATOR, RESOURCE_DATE, RESOURCE_LAST_MODIFIED, RESOURCE_ROOT_ID, SIMPLE_CONTENT_PARENTS, SUB_CONTENT, TAGS, TITLE, TITLE_SORT, TYPE_CONTENT, TYPE_CONTENT_RESOURCE, TYPE_REPEATER, TYPE_RESOURCE, TYPE_WF_ENTRY, TYPE_WF_STEP, WORKFLOW_CURRENT_STEPS, WORKFLOW_CURRENT_STEPS_DV, WORKFLOW_ENTRY_STATE, WORKFLOW_HISTORY_STEPS, WORKFLOW_HISTORY_STEPS_DV, WORKFLOW_NAME, WORKFLOW_REF, WORKFLOW_REF_DV, WORKFLOW_STEP, WORKFLOW_STEP_ACTIONID, WORKFLOW_STEP_CALLER, WORKFLOW_STEP_DUEDATE, WORKFLOW_STEP_FINISHDATE, WORKFLOW_STEP_ID, WORKFLOW_STEP_OWNER, WORKFLOW_STEP_STARTDATE, WORKFLOW_STEP_STATUS

Constructor Summary

Constructors

Constructor and Description
SolrPageIndexer()

Method Summary

Modifier and Type	Method and Description
protected void	_findAndIndexFacetableField(String[] pathSegments, String lang, CompositeMetadata metadata, MetadataDefinition definition, IndexingField field, SolrInputDocument pageDocument) Index the facetable fields of a content into the page solr document
protected Date	_getLastModificationDate(Page page) Computes the last modification date of a page.
protected Date	_getLastValidationDate(Page page) Computes the last validation date of a page.
protected Set<String>	_getTagsWithAncestors(Page page) Get all the page tags with their ancestors.
protected void	_indexFacetableField(Content content, SolrInputDocument document) Index the facetable fields of a content into the page solr document
private void	_indexPage(Page page, String workspaceName, boolean indexRecursively, boolean indexAttachments)
private void	_indexPageAttachment(Resource resource, SolrInputDocument document, Page page)
protected void	_indexPageDocument(Page page, SolrInputDocument document, String workspaceName) Index a populated solr input document of type Page.
protected void	_indexResourceDocument(Resource resource, SolrInputDocument document) Index a populated solr input document of type Resource.
private void	_indexStringFields(SolrInputDocument document, String documentId, String fieldName, String fieldValue, String language)
protected void	_populateAdditionalProperties(Page page, SolrInputDocument document) Populate the solr input document by adding fields to index.
protected void	_populatePageContentsDocument(Page page, SolrInputDocument document) Index the content of the page.
protected void	_populatePageDocument(Page page, SolrInputDocument document) Populate the solr input document by adding fields to index.
protected void	_unindexPageDocument(String pageId, String workspaceName, boolean unindexRecursively, boolean unindexAttachments) Deindex a document of type Page.
void	contextualize(Context context)
void	indexPage(String pageId, boolean indexRecursively, boolean indexAttachments) Index a page and eventually its children, recursively, in all workspaces and commit By default, children pages will be actually indexed if indexRecursively is true and if those pages are not already indexed.
void	indexPage(String pageId, String workspaceName, boolean indexRecursively, boolean indexAttachments, boolean commit) Index a page and eventually its children, recursively. By default, children pages will be actually indexed if indexRecursively is true and if those pages are not already indexed.
void	indexPageAttachment(Resource resource, Page page) Index a page attachment
void	indexPageAttachments(ResourceCollection collection, Page page) Index page attachments as new entries in the index.
void	reindexPage(String pageId, boolean reindexRecursively, boolean reindexAttachments) Reindex a page by its ID for all workspaces and commit
void	reindexPage(String pageId, String workspaceName, boolean reindexRecursively, boolean reindexAttachments, boolean commit) Reindex a page by its ID.
void	service(ServiceManager manager)
void	unindexPage(String pageId, boolean unindexRecursively, boolean unindexAttachments) Un-index a page by its ID for all workspaces and commit
void	unindexPage(String pageId, String workspaceName, boolean unindexRecursively, boolean unindexAttachments, boolean commit) De-index a page (and optionally its children pages).

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 avalon role.

_solrClientProvider

protected SolrClientProvider _solrClientProvider

The Solr client provider

_solrIndexer

protected SolrIndexer _solrIndexer

The Solr indexer

_solrContentIndexer

protected SolrContentIndexer _solrContentIndexer

Solr Ametys contents indexer

_solrResourceIndexer

protected SolrResourceIndexer _solrResourceIndexer

Solr Ametys resources indexer

_additionalPropertiesIndexerEP

protected AdditionalPropertyIndexerExtensionPoint _additionalPropertiesIndexerEP

The additional property indexer extension point.

_tagProviderEP

protected TagProviderExtensionPoint _tagProviderEP

The tag provider extension point.

_serviceExtensionPoint

protected ServiceExtensionPoint _serviceExtensionPoint

The service extension point.

_ametysObjectResolver

protected AmetysObjectResolver _ametysObjectResolver

The Ametys object resolver

_context

protected Context _context

The avalon context

_cTypesHelper

private ContentTypesHelper _cTypesHelper

Constructor Detail

SolrPageIndexer

public SolrPageIndexer()

Method Detail

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

contextualize

public void contextualize(Context context)
                   throws ContextException

Specified by:

contextualize in interface Contextualizable

Throws:

ContextException

indexPage

public void indexPage(String pageId,
                      boolean indexRecursively,
                      boolean indexAttachments)
               throws Exception

Index a page and eventually its children, recursively, in all workspaces and commit
By default, children pages will be actually indexed if indexRecursively is true and if those pages are not already indexed.

Parameters:

pageId - the page to be indexed.

indexRecursively - to also process children pages.

indexAttachments - to index page attachments

Throws:

Exception - if an error occurs during indexation.

indexPage

public void indexPage(String pageId,
                      String workspaceName,
                      boolean indexRecursively,
                      boolean indexAttachments,
                      boolean commit)
               throws IndexingException

Index a page and eventually its children, recursively.
By default, children pages will be actually indexed if indexRecursively is true and if those pages are not already indexed.

Parameters:

pageId - the page to be indexed.

workspaceName - the workspace where to index

indexRecursively - to also process children pages.

indexAttachments - to index page attachments

commit - Commit the indexation

Throws:

IndexingException - if an error occurs during indexation.

_indexPage

private void _indexPage(Page page,
                        String workspaceName,
                        boolean indexRecursively,
                        boolean indexAttachments)
                 throws IndexingException

Throws:

IndexingException

_populatePageDocument

protected void _populatePageDocument(Page page,
                                     SolrInputDocument document)
                              throws Exception

Populate the solr input document by adding fields to index.

Parameters:

page - the page to index.

document - the solr input document

Throws:

Exception - if something goes wrong when processing the indexation of the page

_indexStringFields

private void _indexStringFields(SolrInputDocument document,
                                String documentId,
                                String fieldName,
                                String fieldValue,
                                String language)

_getTagsWithAncestors

protected Set<String> _getTagsWithAncestors(Page page)

Get all the page tags with their ancestors.

Parameters:

page - The page.

Returns:

All the page tags with their ancestors.

_populatePageContentsDocument

protected void _populatePageContentsDocument(Page page,
                                             SolrInputDocument document)
                                      throws Exception

Index the content of the page.

Parameters:

page - the page to index.

document - the document to populate.

Throws:

Exception - if an error occurs.

_indexFacetableField

protected void _indexFacetableField(Content content,
                                    SolrInputDocument document)

Index the facetable fields of a content into the page solr document

Parameters:

content - The content

document - The main page solr document.

_findAndIndexFacetableField

protected void _findAndIndexFacetableField(String[] pathSegments,
                                           String lang,
                                           CompositeMetadata metadata,
                                           MetadataDefinition definition,
                                           IndexingField field,
                                           SolrInputDocument pageDocument)

Index the facetable fields of a content into the page solr document

Parameters:

pathSegments - The path of metadata

lang - The language

metadata - The parent composite metadata

definition - The metadata definition

field - The indexing field

pageDocument - The Solr page document

_getLastModificationDate

protected Date _getLastModificationDate(Page page)

Computes the last modification date of a page.

Parameters:

page - the page.

Returns:

the last modification date or null.

_getLastValidationDate

protected Date _getLastValidationDate(Page page)

Computes the last validation date of a page.

Parameters:

page - the page.

Returns:

the last validation date or null.

_populateAdditionalProperties

protected void _populateAdditionalProperties(Page page,
                                             SolrInputDocument document)
                                      throws Exception

Populate the solr input document by adding fields to index.

Parameters:

page - the page to index.

document - the solr input document

Throws:

Exception - if something goes wrong when processing the indexation of the page

indexPageAttachments

public void indexPageAttachments(ResourceCollection collection,
                                 Page page)
                          throws Exception

Index page attachments as new entries in the index.

Parameters:

collection - the collection of attachments

page - the page whose attachments will be indexed

Throws:

Exception - if something goes wrong when indexing the attachments of the page

indexPageAttachment

public void indexPageAttachment(Resource resource,
                                Page page)
                         throws Exception

Index a page attachment

Parameters:

resource - the page attachment as a Resource

page - the page whose attachment is going to be indexed

Throws:

Exception - if something goes wrong when processing the indexation of the page attachment

_indexPageAttachment

private void _indexPageAttachment(Resource resource,
                                  SolrInputDocument document,
                                  Page page)
                           throws Exception

Throws:

Exception

_indexPageDocument

protected void _indexPageDocument(Page page,
                                  SolrInputDocument document,
                                  String workspaceName)
                           throws SolrServerException,
                                  IOException

Index a populated solr input document of type Page.

Parameters:

page - the page from which the input document is created

document - the input document to add to the solr index

workspaceName - The workspace name

Throws:

SolrServerException - if there is an error on the Solr server

IOException - if there is a communication error with the server

_indexResourceDocument

protected void _indexResourceDocument(Resource resource,
                                      SolrInputDocument document)
                               throws SolrServerException,
                                      IOException

Index a populated solr input document of type Resource.

Parameters:

resource - the resource from which the input document is created

document - the input document

Throws:

SolrServerException - if there is an error on the server

IOException - if there is a communication error with the server

unindexPage

public void unindexPage(String pageId,
                        boolean unindexRecursively,
                        boolean unindexAttachments)
                 throws Exception

Un-index a page by its ID for all workspaces and commit

Parameters:

pageId - The page ID.

unindexRecursively - also unindex child pages if requested.

unindexAttachments - also unindex page attachments

Throws:

Exception - if an error occurs during index update.

unindexPage

public void unindexPage(String pageId,
                        String workspaceName,
                        boolean unindexRecursively,
                        boolean unindexAttachments,
                        boolean commit)
                 throws Exception

De-index a page (and optionally its children pages).

Parameters:

pageId - the page to be de-indexed.

workspaceName - The workspace where to work in

unindexRecursively - also unindex child pages if requested.

unindexAttachments - also unindex page attachments

commit - Commit the operator to Solr

Throws:

Exception - if an error occurs during index update.

_unindexPageDocument

protected void _unindexPageDocument(String pageId,
                                    String workspaceName,
                                    boolean unindexRecursively,
                                    boolean unindexAttachments)
                             throws SolrServerException,
                                    IOException,
                                    QuerySyntaxException

Deindex a document of type Page. Also deindex attachments of a page

Parameters:

pageId - the id of the page to deindex

workspaceName - The workspace name

unindexRecursively - also unindex child pages if requested.

unindexAttachments - also unindex page attachments

Throws:

SolrServerException - if there is an error on the server

IOException - if there is a communication error with the server

QuerySyntaxException - if the uri query can't be built because of a syntax error.

reindexPage

public void reindexPage(String pageId,
                        boolean reindexRecursively,
                        boolean reindexAttachments)
                 throws Exception

Reindex a page by its ID for all workspaces and commit

Parameters:

pageId - The page ID.

reindexRecursively - also reindex child pages if requested.

reindexAttachments - also reindex page attachments

Throws:

Exception - if an error occurs during index update.

reindexPage

public void reindexPage(String pageId,
                        String workspaceName,
                        boolean reindexRecursively,
                        boolean reindexAttachments,
                        boolean commit)
                 throws IndexingException

Reindex a page by its ID.

Parameters:

pageId - The page ID.

workspaceName - The workspace where to work in

reindexRecursively - also reindex child pages if requested.

reindexAttachments - also reindex page attachments

commit - Commit the operator to Solr

Throws:

IndexingException - if an error occurs during index update.