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 and Description
static String	CHECK_QUERY_CACHE_PROPERTY
static String	CORE_SESSION_PROPERTY
static String	LANGUAGE_PROPERTY
static String	USE_UNRESTRICTED_SESSION_PROPERTY Boolean property stating that query should be unrestricted.

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

DEFAULT_MAX_PAGE_SIZE, DEFAULT_MAX_PAGE_SIZE_RUNTIME_PROP, PAGE_LIMIT_UNKNOWN, UNKNOWN_SIZE, UNKNOWN_SIZE_AFTER_QUERY

Constructor Summary

Constructors

Constructor and Description
CoreQueryAndFetchPageProvider()

Method Summary

Methods

Modifier and Type	Method and Description
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.
void	refresh() Refresh hook, to override for custom behavior

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

addSortInfo, firstPage, getAggregateDefinitions, getAggregates, getCurrentEntry, getCurrentHigherNonEmptyPageIndex, getCurrentPageIndex, getCurrentPageOffset, getCurrentPageSize, getCurrentPageStatus, getDefinition, getError, getErrorMessage, getMaxNumberOfEmptyPages, getMaxPageSize, getMinMaxPageSize, getName, getNumberOfPages, getPageLimit, getPageSize, getParameters, getProperties, getResultsCount, getSearchDocumentModel, getSortInfo, getSortInfoIndex, getSortInfos, hasAggregateSupport, hasChangedParameters, hasError, isLastPageAvailable, isNextEntryAvailable, isNextPageAvailable, isPreviousEntryAvailable, isPreviousPageAvailable, isSortable, last, lastPage, next, nextEntry, nextPage, previous, previousEntry, previousPage, rewind, setCurrentEntry, setCurrentEntryIndex, setCurrentHigherNonEmptyPageIndex, setCurrentPage, setCurrentPageIndex, setCurrentPageOffset, setDefinition, setMaxPageSize, setName, setPageProviderChangedListener, setPageSize, setParameters, setProperties, setResultsCount, setSearchDocumentModel, setSelectedEntries, setSortable, setSortInfo, setSortInfo, setSortInfos

Methods inherited from class java.lang.Object

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

Field Detail

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

Constructor Detail

CoreQueryAndFetchPageProvider

public CoreQueryAndFetchPageProvider()

Method Detail

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

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>>

getCurrentQuery

public String getCurrentQuery()

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>>