Package org.nuxeo.ecm.platform.query.nxql

Class CoreQueryAndFetchPageProvider

java.lang.Object

org.nuxeo.ecm.platform.query.api.AbstractPageProvider<Map<String,Serializable>>

org.nuxeo.ecm.platform.query.nxql.CoreQueryAndFetchPageProvider

All Implemented Interfaces:

Serializable, PageProvider<Map<String,Serializable>>

public class CoreQueryAndFetchPageProvider
extends AbstractPageProvider<Map<String,Serializable>>

Page provider performing a queryAndFetch on a core session.

It builds the query at each call so that it can refresh itself when the query changes.

The page provider property named CORE_SESSION_PROPERTY is used to pass the CoreSession instance that will perform the query. The optional property CHECK_QUERY_CACHE_PROPERTY can be set to "true" to avoid performing the query again if it did not change.

Since 6.0, the page provider property named LANGUAGE_PROPERTY allows specifying the query language (NXQL, NXTAG,...).

Also since 6.0, the page provider property named USE_UNRESTRICTED_SESSION_PROPERTY allows specifying whether the query should be run as unrestricted.

Since:

5.4

Author:

Anahide Tchertchian

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CHECK_QUERY_CACHE_PROPERTY
static final String	CORE_SESSION_PROPERTY
protected List<Map<String,Serializable>>	currentItems
static final String	LANGUAGE_PROPERTY
protected String	query
static final String	USE_UNRESTRICTED_SESSION_PROPERTY	Boolean property stating that query should be unrestricted.

Fields inherited from class org.nuxeo.ecm.platform.query.api.AbstractPageProvider

currentEntryIndex, currentHigherNonEmptyPageIndex, currentSelectPage, definition, error, errorMessage, highlights, maxPageSize, name, offset, PAGEPROVIDER_TRACK_PROPERTY_NAME, pageProviderChangedListener, pageSize, pageSizeOptions, parameters, properties, quickFilters, resultsCount, searchDocumentModel, selectedEntries, SKIPPED_SCHEMAS_FOR_SEARCHFIELD, sortable, sortInfos, tracking

Fields inherited from interface org.nuxeo.ecm.platform.query.api.PageProvider

DEFAULT_MAX_PAGE_SIZE, DEFAULT_MAX_PAGE_SIZE_RUNTIME_PROP, HIGHLIGHT_CTX_DATA, PAGE_LIMIT_UNKNOWN, SKIP_AGGREGATES_PROP, UNKNOWN_SIZE, UNKNOWN_SIZE_AFTER_QUERY

Constructor Summary

Constructors

Constructor	Description
CoreQueryAndFetchPageProvider()

Method Summary

Modifier and Type	Method	Description
protected void	buildQuery()
protected void	checkQueryCache()
protected CoreSession	getCoreSession()
List<Map<String,Serializable>>	getCurrentPage()	Returns the list of current page items.
String	getCurrentQuery()
PageSelections<Map<String,Serializable>>	getCurrentSelectPage()	Returns the current page of results wrapped in a PageSelection item.
protected String	getQueryLanguage()
protected void	pageChanged()	Page change hook, to override for custom behavior
void	refresh()	Refresh hook, to override for custom behavior
protected void	rewindSelectablePage()	Fetch a page that can be selected.
protected boolean	useUnrestrictedSession()

Methods inherited from class org.nuxeo.ecm.platform.query.api.AbstractPageProvider

addQuickFilter, addSortInfo, fireSearchEvent, firstPage, getAggregateDefinitions, getAggregates, getAvailableQuickFilters, getBooleanProperty, getCurrentEntry, getCurrentHigherNonEmptyPageIndex, getCurrentPageIndex, getCurrentPageOffset, getCurrentPageSize, getCurrentPageStatus, getDefaultMaxPageSize, getDefinition, getError, getErrorMessage, getHighlights, getMaxNumberOfEmptyPages, getMaxPageSize, getMinMaxPageSize, getName, getNumberOfPages, getPageLimit, getPageSize, getPageSizeOptions, getParameters, getParametersChanged, getProperties, getQuickFilters, getResultsCount, getResultsCountLimit, getSearchDocumentModel, getSortInfo, getSortInfoIndex, getSortInfos, hasAggregateSupport, hasChangedParameters, hasError, incorporateAggregates, isLastPageAvailable, isNextEntryAvailable, isNextPageAvailable, isPreviousEntryAvailable, isPreviousPageAvailable, isSkipAggregates, isSortable, isTrackingEnabled, lastPage, nextEntry, nextPage, notifyPageChanged, notifyRefresh, previousEntry, previousPage, searchDocumentModelChanged, setCurrentEntry, setCurrentEntryIndex, setCurrentHigherNonEmptyPageIndex, setCurrentPage, setCurrentPageIndex, setCurrentPageOffset, setDefinition, setHighlights, setMaxPageSize, setName, setPageProviderChangedListener, setPageSize, setPageSizeOptions, setParameters, setProperties, setQuickFilters, setResultsCount, setSearchDocumentModel, setSelectedEntries, setSortable, setSortInfo, setSortInfo, setSortInfos, sortInfoChanged

Methods inherited from class java.lang.Object

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

Field Details

CORE_SESSION_PROPERTY

public static final String CORE_SESSION_PROPERTY

See Also:

• Constant Field Values

CHECK_QUERY_CACHE_PROPERTY

public static final String CHECK_QUERY_CACHE_PROPERTY

See Also:

• Constant Field Values

USE_UNRESTRICTED_SESSION_PROPERTY

public static final String USE_UNRESTRICTED_SESSION_PROPERTY

Boolean property stating that query should be unrestricted.

Since:

6.0

See Also:

• Constant Field Values

LANGUAGE_PROPERTY

public static final String LANGUAGE_PROPERTY

Since:

6.0: alow specifying the query language (NXQL, NXTAG,...)

See Also:

• Constant Field Values

query

protected String query

currentItems

protected List<Map<String,Serializable>> currentItems

Constructor Details

CoreQueryAndFetchPageProvider

public CoreQueryAndFetchPageProvider()

Method Details

getCoreSession

protected CoreSession getCoreSession()

getCurrentPage

public List<Map<String,Serializable>> getCurrentPage()

Description copied from class: AbstractPageProvider

Returns the list of current page items.

Custom implementation can be added here, based on the page provider properties, parameters and WhereClauseDefinition on the PageProviderDefinition, as well as search document, sort information, etc...

Implementation of this method usually consists in setting a non-null value to a field caching current items, and nullifying this field by overriding AbstractPageProvider.pageChanged() and AbstractPageProvider.refresh().

Fields AbstractPageProvider.errorMessage and AbstractPageProvider.error can also be filled to provide accurate feedback in case an error occurs during the search.

When items are retrieved, a call to AbstractPageProvider.setResultsCount(long) should be made to ensure proper pagination as implemented in this abstract class. The implementation in CoreQueryAndFetchPageProvider is a good example when the total results count is known.

If for performance reasons, for instance, the number of results cannot be known, a fall-back strategy can be applied to provide the "next" button but not the "last" one, by calling AbstractPageProvider.getCurrentHigherNonEmptyPageIndex() and AbstractPageProvider.setCurrentHigherNonEmptyPageIndex(int). In this case, CoreQueryDocumentPageProvider is a good example.

Specified by:

getCurrentPage in interface PageProvider<Map<String,Serializable>>

Specified by:

getCurrentPage in class AbstractPageProvider<Map<String,Serializable>>

Returns:

the current page

buildQuery

protected void buildQuery()

getCurrentSelectPage

public PageSelections<Map<String,Serializable>> getCurrentSelectPage()

Description copied from interface: PageProvider

Returns the current page of results wrapped in a PageSelection item.

By default, no entry is selected, unless PageProvider.setSelectedEntries(List) has been called before.

Specified by:

getCurrentSelectPage in interface PageProvider<Map<String,Serializable>>

Overrides:

getCurrentSelectPage in class AbstractPageProvider<Map<String,Serializable>>

rewindSelectablePage

protected void rewindSelectablePage()

Fetch a page that can be selected. It loads the last page if we're targeting a page beyond the last one or the first page if there are no results to show and we're targeting anything other than the first page. Fix for NXP-8564.

checkQueryCache

protected void checkQueryCache()

useUnrestrictedSession

protected boolean useUnrestrictedSession()

getQueryLanguage

protected String getQueryLanguage()

getCurrentQuery

public String getCurrentQuery()

pageChanged

protected void pageChanged()

Description copied from class: AbstractPageProvider

Page change hook, to override for custom behavior

When overriding it, call super.pageChanged() as last statement to make sure that the PageProviderChangedListener is called with the up-to-date @{code PageProvider} state.

Overrides:

pageChanged in class AbstractPageProvider<Map<String,Serializable>>

refresh

public void refresh()

Description copied from class: AbstractPageProvider

Refresh hook, to override for custom behavior

When overriding it, call super.refresh() as last statement to make sure that the PageProviderChangedListener is called with the up-to-date @{code PageProvider} state.

Specified by:

refresh in interface PageProvider<Map<String,Serializable>>

Overrides:

refresh in class AbstractPageProvider<Map<String,Serializable>>