org.ametys.web.frontoffice

Class AbstractSearchGenerator

java.lang.Object

org.apache.avalon.framework.logger.AbstractLogEnabled

org.apache.cocoon.xml.AbstractXMLProducer

org.apache.cocoon.generation.AbstractGenerator

org.apache.cocoon.generation.ServiceableGenerator

org.ametys.web.frontoffice.AbstractSearchGenerator

All Implemented Interfaces:

SolrFieldNames, SolrWebFieldNames, Poolable, Recyclable, Disposable, Component, Contextualizable, LogEnabled, Serviceable, Generator, SitemapModelComponent, XMLProducer

Direct Known Subclasses:

SearchGenerator, SearchResourcesGenerator

public abstract class AbstractSearchGenerator
extends ServiceableGenerator
implements Contextualizable, SolrWebFieldNames

Abstract class for solr search

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	AbstractSearchGenerator.Criterion Criterion class.

Field Summary

Fields

Modifier and Type	Field and Description
protected ContentHelper	_contentHelper The helper to handler contents
protected ContentTypesHelper	_contentTypesHelper The helper to handler content types
protected Context	_context The cocoon context
protected ContentTypeExtensionPoint	_cTypeExtPt The ContentType manager
protected DublinCoreMetadataProvider	_dcProvider DublinCore provider
protected MetadataManager	_metadataManager Metadata manager.
protected SAXParser	_parser The sax parser
protected AmetysObjectResolver	_resolver The Ametys resolver
protected SearcherFactory	_searcherFactory The searcher factory
protected SiteManager	_siteManager The sites manager
protected TagProviderExtensionPoint	_tagExtPt The tag extension point
protected static Pattern	_TEXTFIELD_PATTERN Textfield pattern
protected URIResolverExtensionPoint	_uriResolverEP The uri resolver extension point

Fields inherited from class org.apache.cocoon.generation.ServiceableGenerator

manager

Fields inherited from class org.apache.cocoon.generation.AbstractGenerator

objectModel, parameters, resolver, source

Fields inherited from class org.apache.cocoon.xml.AbstractXMLProducer

contentHandler, EMPTY_CONTENT_HANDLER, lexicalHandler, xmlConsumer

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

ANCESTOR_IDS, CONTENT_IDS, CONTENT_INTERESTING_DATES, DATE_FOR_SORTING, DATES_FACET, LASTNAME_FOR_SORTING, LONG_TITLE, ORPHAN, PAGE_DEPTH, PAGE_ID, PAGE_IDS, PAGE_TYPE, PRIVACY, SECTION_PAGE_TITLE, SERVICE_IDS, SHARED, SITE_NAME, SITEMAP_NAME, TEMPLATE, TITLE, TITLE_FOR_SORTING, TYPE_PAGE, TYPE_PAGE_RESOURCE

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

ACL_READ_ALLOW_ANONYMOUS, ACL_READ_ALLOW_ANY_CONNECTED_USER, ACL_READ_ALLOWED_GROUPS, ACL_READ_ALLOWED_USERS, ACL_READ_DENIED_GROUPS, ACL_READ_DENIED_USERS, ALL_CONTENT_TYPES, ALL_MIXIN_TYPES, ALL_TAGS, CONTENT_COMMENTS, CONTENT_COMMENTS_NONVALIDATED, CONTENT_COMMENTS_VALIDATED, CONTENT_CREATOR, CONTENT_LANGUAGE, CONTENT_LANGUAGES, CONTENT_LAST_CONTRIBUTOR, CONTENT_NAME, 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, LAST_MAJOR_VALIDATION, LAST_MODIFIED, LAST_VALIDATION, LENGTH, MIME_TYPES, MIXIN_TYPES, PATH, REPEATER_ENTRY_POSITION, RESOURCE_CREATOR, RESOURCE_DATE, RESOURCE_LAST_MODIFIED, RESOURCE_ROOT_ID, SUB_CONTENT, TAGS, TITLE_SORT, TYPE_CONTENT, 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

Fields inherited from interface org.apache.cocoon.generation.Generator

ROLE

Constructor Summary

Constructors

Constructor and Description
AbstractSearchGenerator()

Method Summary

Modifier and Type	Method and Description
protected void	_additionalSearchProcessing(SearcherFactory.Searcher searcher) Allow to perform other searcher configuration
private String	_encodePath(String path)
private String	_getResourceExcerpt(Resource resource)
private Page	_getResourcePage(Resource resource)
private void	_saxIcon(String filename)
private void	_saxLastModifiedDate(Page page)
private void	_saxLastValidationDate(Page page)
private void	_saxPageContents(Page page)
private void	_saxSize(long size)
void	contextualize(Context context)
void	generate()
protected abstract Map<String,AbstractSearchGenerator.Criterion>	getCriteria(Request request, String siteName, String lang) Get the criteria with their value list.
protected Map<String,String>	getCriteriaValues(Map<String,AbstractSearchGenerator.Criterion> criteria, Request request) Get the criteria user values.
protected abstract Collection<String>	getDocumentTypes(Request request) Get the document types.
protected Query	getDocumentTypesQuery(Collection<String> documentTypes) Build the search query to have results matching at least one of the given document types
protected abstract Collection<String>	getFields() Get the searchable fields
protected abstract Collection<Query>	getFilterQueries(Request request, Collection<String> siteNames, String language) Get the filter queries from the request parameters.
protected int	getPageIndex(Request request) Get the page index
protected abstract List<Sort>	getPrimarySortFields(Request request) Get the primary sort fields
protected abstract Query	getQuery(Request request, Collection<String> siteNames, String language) Get the query from request parameters
protected String	getSearchMode() Get the search mode.
protected abstract Sort	getSortField(Request request) Get the sort field
protected boolean	isInputValid() Check if the input is valid.
protected void	saxAdditionalInfos() Generate any additional information.
protected void	saxAdditionalInfosOnPageHit(Page page) SAX additional information on page hit
protected void	saxContent(String contentId, String metadataSetName) SAX the metadata set of a content if exists
protected void	saxCriteria(Map<String,AbstractSearchGenerator.Criterion> criteria, Request request, SearchResults<AmetysObject> searchResults, String siteName, String lang, boolean withHitCount) SAX criteria.
protected void	saxCriterion(AbstractSearchGenerator.Criterion criterion, SearchResults<AmetysObject> searchResults, String siteName, String lang) SAX a single criterion.
protected abstract void	saxFormFields(Request request, SearchResults<AmetysObject> searchResults, String siteName, String lang) SAX the form search criteria
protected void	saxFormParameters(Request request, SearchResults<AmetysObject> searchResults, int start, int offset, String siteName, String lang) SAX the search parameters from the request parameters
protected abstract void	saxFormValues(Request request, SearchResults<AmetysObject> searchResults, int start, int offset) SAX the form search criteria values
protected abstract void	saxHits(SearchResults<AmetysObject> results, int start, int maxResults) SAX the result hits
protected void	saxPageHit(float score, float maxScore, Page page) SAX a hit of type page.
protected void	saxPagination(long totalHits, int start, int offset) SAX elements for pagination
protected void	saxResourceHit(float score, float maxScore, Resource resource) SAX a hit of type "resource".
protected void	saxServiceIdentifiers() Generate the service identifiers: service group ID, ZoneItem ID, ...
protected SearchResults<AmetysObject>	search(Request request, Collection<String> siteNames, String language, int pageIndex, int start, int maxResults) Search
protected SearchResults<AmetysObject>	search(Request request, Collection<String> siteNames, String language, int pageIndex, int start, int maxResults, boolean saxResults) Search
void	service(ServiceManager smanager)

Methods inherited from class org.apache.cocoon.generation.ServiceableGenerator

dispose

Methods inherited from class org.apache.cocoon.generation.AbstractGenerator

recycle, setup

Methods inherited from class org.apache.cocoon.xml.AbstractXMLProducer

setConsumer, setContentHandler, setLexicalHandler

Methods inherited from class org.apache.avalon.framework.logger.AbstractLogEnabled

enableLogging, getLogger, setupLogger, setupLogger, setupLogger

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.cocoon.xml.XMLProducer

setConsumer

Field Detail

_TEXTFIELD_PATTERN

protected static final Pattern _TEXTFIELD_PATTERN

Textfield pattern

_cTypeExtPt

protected ContentTypeExtensionPoint _cTypeExtPt

The ContentType manager

_siteManager

protected SiteManager _siteManager

The sites manager

_context

protected Context _context

The cocoon context

_tagExtPt

protected TagProviderExtensionPoint _tagExtPt

The tag extension point

_resolver

protected AmetysObjectResolver _resolver

The Ametys resolver

_dcProvider

protected DublinCoreMetadataProvider _dcProvider

DublinCore provider

_contentTypesHelper

protected ContentTypesHelper _contentTypesHelper

The helper to handler content types

_contentHelper

protected ContentHelper _contentHelper

The helper to handler contents

_uriResolverEP

protected URIResolverExtensionPoint _uriResolverEP

The uri resolver extension point

_metadataManager

protected MetadataManager _metadataManager

Metadata manager.

_parser

protected SAXParser _parser

The sax parser

_searcherFactory

protected SearcherFactory _searcherFactory

The searcher factory

Constructor Detail

AbstractSearchGenerator

public AbstractSearchGenerator()

Method Detail

service

public void service(ServiceManager smanager)
             throws ServiceException

Specified by:

service in interface Serviceable

Overrides:

service in class ServiceableGenerator

Throws:

ServiceException

contextualize

public void contextualize(Context context)
                   throws ContextException

Specified by:

contextualize in interface Contextualizable

Throws:

ContextException

generate

public void generate()
              throws IOException,
                     SAXException,
                     ProcessingException

Specified by:

generate in interface Generator

Throws:

IOException

SAXException

ProcessingException

search

protected SearchResults<AmetysObject> search(Request request,
                                             Collection<String> siteNames,
                                             String language,
                                             int pageIndex,
                                             int start,
                                             int maxResults)
                                      throws Exception

Search

Parameters:

request - the request

siteNames - The name of the sites to search in

language - The language code to search

pageIndex - the page index

start - The offset for search results

maxResults - The maximum number of results

Returns:

The search results

Throws:

Exception - If an error occurred during search

search

protected SearchResults<AmetysObject> search(Request request,
                                             Collection<String> siteNames,
                                             String language,
                                             int pageIndex,
                                             int start,
                                             int maxResults,
                                             boolean saxResults)
                                      throws Exception

Search

Parameters:

request - the request

siteNames - The name of the sites to search in

language - The language code to search

pageIndex - the page index

start - The offset for search results

maxResults - The maximum number of results

saxResults - false to not sax results

Returns:

The search results

Throws:

Exception - If an error occurred during search

_additionalSearchProcessing

protected void _additionalSearchProcessing(SearcherFactory.Searcher searcher)

Allow to perform other searcher configuration

Parameters:

searcher - The searcher that will be used for the search operation

getDocumentTypesQuery

protected Query getDocumentTypesQuery(Collection<String> documentTypes)

Build the search query to have results matching at least one of the given document types

Parameters:

documentTypes - The document types

Returns:

The document type query

getDocumentTypes

protected abstract Collection<String> getDocumentTypes(Request request)

Get the document types.

Parameters:

request - The request.

Returns:

the document types to search.

getSortField

protected abstract Sort getSortField(Request request)

Get the sort field

Parameters:

request - The request

Returns:

The sort field or null to sort by score

getPrimarySortFields

protected abstract List<Sort> getPrimarySortFields(Request request)

Get the primary sort fields

Parameters:

request - The request

Returns:

the list additional sort fields or empty list.

saxFormParameters

protected void saxFormParameters(Request request,
                                 SearchResults<AmetysObject> searchResults,
                                 int start,
                                 int offset,
                                 String siteName,
                                 String lang)
                          throws SAXException

SAX the search parameters from the request parameters

Parameters:

request - The request

searchResults - The search results

start - The start index

offset - The number of results

siteName - The current site name

lang - The current language

Throws:

SAXException - If an error occurs while SAXing

saxFormFields

protected abstract void saxFormFields(Request request,
                                      SearchResults<AmetysObject> searchResults,
                                      String siteName,
                                      String lang)
                               throws SAXException

SAX the form search criteria

Parameters:

request - The request

searchResults - The search results

siteName - The current site name

lang - The current language

Throws:

SAXException - if an error occurs while SAXing

saxCriteria

protected void saxCriteria(Map<String,AbstractSearchGenerator.Criterion> criteria,
                           Request request,
                           SearchResults<AmetysObject> searchResults,
                           String siteName,
                           String lang,
                           boolean withHitCount)
                    throws SAXException

SAX criteria.

Parameters:

criteria - the criteria list.

request - the request

searchResults - The search results

siteName - the name of the site

lang - the language

withHitCount - true to sax the hit count as well

Throws:

SAXException - If an error occurred while saxing the criteria

saxCriterion

protected void saxCriterion(AbstractSearchGenerator.Criterion criterion,
                            SearchResults<AmetysObject> searchResults,
                            String siteName,
                            String lang)
                     throws SAXException,
                            IOException

SAX a single criterion.

Parameters:

criterion - the criterion.

searchResults - The search results

siteName - the site name.

lang - the language.

Throws:

SAXException - If a sax error occurred

IOException - If another error occurred

saxFormValues

protected abstract void saxFormValues(Request request,
                                      SearchResults<AmetysObject> searchResults,
                                      int start,
                                      int offset)
                               throws SAXException

SAX the form search criteria values

Parameters:

request - The request

searchResults - The search results

start - The start index

offset - The number of results

Throws:

SAXException - if an error occurs while SAXing

getQuery

protected abstract Query getQuery(Request request,
                                  Collection<String> siteNames,
                                  String language)
                           throws IllegalArgumentException

Get the query from request parameters

Parameters:

request - The request

siteNames - The site names.

language - The language

Returns:

The query object.

Throws:

IllegalArgumentException - If the search field is invalid.

getFilterQueries

protected abstract Collection<Query> getFilterQueries(Request request,
                                                      Collection<String> siteNames,
                                                      String language)
                                               throws IllegalArgumentException

Get the filter queries from the request parameters.

Parameters:

request - The request.

siteNames - The site names.

language - The language.

Returns:

A collection of filter queries.

Throws:

IllegalArgumentException - If a search field is invalid.

saxHits

protected abstract void saxHits(SearchResults<AmetysObject> results,
                                int start,
                                int maxResults)
                         throws SAXException,
                                IOException

SAX the result hits

Parameters:

results - The search results.

start - The start index

maxResults - The number of results to generate.

Throws:

SAXException - If an error occurs while SAXing

IOException - If there is a low-level IO error

getFields

protected abstract Collection<String> getFields()

Get the searchable fields

Returns:

The fields

getCriteria

protected abstract Map<String,AbstractSearchGenerator.Criterion> getCriteria(Request request,
                                                                             String siteName,
                                                                             String lang)

Get the criteria with their value list.

Parameters:

request - the request.

siteName - the site name.

lang - the language

Returns:

the criteria list.

getCriteriaValues

protected Map<String,String> getCriteriaValues(Map<String,AbstractSearchGenerator.Criterion> criteria,
                                               Request request)

Get the criteria user values.

Parameters:

criteria - the criteria list.

request - the request object.

Returns:

the criteria user values.

saxPageHit

protected void saxPageHit(float score,
                          float maxScore,
                          Page page)
                   throws SAXException

SAX a hit of type page.

Parameters:

score - The score of the page

maxScore - The maximum score of the search results

page - The page

Throws:

SAXException - If an error occurs while SAXing

_saxPageContents

private void _saxPageContents(Page page)
                       throws SAXException

Throws:

SAXException

_saxLastModifiedDate

private void _saxLastModifiedDate(Page page)
                           throws SAXException

Throws:

SAXException

_saxLastValidationDate

private void _saxLastValidationDate(Page page)
                             throws SAXException

Throws:

SAXException

saxAdditionalInfosOnPageHit

protected void saxAdditionalInfosOnPageHit(Page page)
                                    throws SAXException

SAX additional information on page hit

Parameters:

page - the page

Throws:

SAXException - if something goes wrong when saxing the information

saxResourceHit

protected void saxResourceHit(float score,
                              float maxScore,
                              Resource resource)
                       throws SAXException

SAX a hit of type "resource".

Parameters:

score - The score of the page

maxScore - The maximum score of the search results

resource - The resource

Throws:

SAXException - If an error occurs while SAXing

_getResourceExcerpt

private String _getResourceExcerpt(Resource resource)

_getResourcePage

private Page _getResourcePage(Resource resource)

_encodePath

private String _encodePath(String path)

saxPagination

protected void saxPagination(long totalHits,
                             int start,
                             int offset)
                      throws SAXException

SAX elements for pagination

Parameters:

totalHits - The total number of result

start - The start index of search

offset - The max number of results per page

Throws:

SAXException - SAXException If an error occurs while SAXing

getPageIndex

protected int getPageIndex(Request request)

Get the page index

Parameters:

request - The request

Returns:

The page index

_saxIcon

private void _saxIcon(String filename)
               throws SAXException

Throws:

SAXException

_saxSize

private void _saxSize(long size)
               throws SAXException

Throws:

SAXException

saxServiceIdentifiers

protected void saxServiceIdentifiers()
                              throws SAXException,
                                     IOException,
                                     ProcessingException

Generate the service identifiers: service group ID, ZoneItem ID, ...

Throws:

SAXException - if an error occurs SAXing data.

IOException - if an error occurs SAXing data.

ProcessingException - if a processing error occurs.

saxAdditionalInfos

protected void saxAdditionalInfos()
                           throws SAXException,
                                  IOException,
                                  ProcessingException

Generate any additional information.

Throws:

SAXException - if an error occurs SAXing data.

IOException - if an error occurs SAXing data.

ProcessingException - if a processing error occurs.

getSearchMode

protected String getSearchMode()

Get the search mode.

Returns:

the search mode as a string.

isInputValid

protected boolean isInputValid()

Check if the input is valid.

Returns:

true if the input is valid, false otherwise.

saxContent

protected void saxContent(String contentId,
                          String metadataSetName)
                   throws SAXException

SAX the metadata set of a content if exists

Parameters:

contentId - the id of the content

metadataSetName - The name of metadata set to sax

Throws:

SAXException - if an exception occurs while saxing