com.haulmont.cuba.gui.data.impl

Class AbstractCollectionDatasource<T extends io.jmix.core.Entity,K>

java.lang.Object

com.haulmont.cuba.gui.data.impl.AbstractDatasource<T>

com.haulmont.cuba.gui.data.impl.DatasourceImpl<T>

com.haulmont.cuba.gui.data.impl.AbstractCollectionDatasource<T,K>

Type Parameters:

T - type of entity

K - type of entity ID

All Implemented Interfaces:

CollectionDatasource<T,K>, CollectionDatasource.SupportsRefreshMode<T,K>, Datasource<T>, DatasourceImplementation<T>

Direct Known Subclasses:

CollectionDatasourceImpl

Deprecated.

@Deprecated
public abstract class AbstractCollectionDatasource<T extends io.jmix.core.Entity,K>
extends DatasourceImpl<T>
implements CollectionDatasource<T,K>, CollectionDatasource.SupportsRefreshMode<T,K>

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	AbstractCollectionDatasource.ComponentValueListener Deprecated.

Nested classes/interfaces inherited from class com.haulmont.cuba.gui.data.impl.AbstractDatasource

AbstractDatasource.ItemListener

Nested classes/interfaces inherited from interface com.haulmont.cuba.gui.data.CollectionDatasource

CollectionDatasource.Aggregatable<T extends io.jmix.core.Entity,K>, CollectionDatasource.CollectionChangeEvent<T extends io.jmix.core.Entity,K>, CollectionDatasource.CollectionChangeListener<T extends io.jmix.core.Entity,K>, CollectionDatasource.Indexed<T extends io.jmix.core.Entity,K>, CollectionDatasource.Lazy<T extends io.jmix.core.Entity,K>, CollectionDatasource.Operation, CollectionDatasource.Ordered<T extends io.jmix.core.Entity,K>, CollectionDatasource.RefreshMode, CollectionDatasource.Sortable<T extends io.jmix.core.Entity,K>, CollectionDatasource.SortDelegate<T extends io.jmix.core.Entity,K>, CollectionDatasource.SupportsApplyToSelected<T extends io.jmix.core.Entity,K>, CollectionDatasource.SupportsPaging<T extends io.jmix.core.Entity,K>, CollectionDatasource.SupportsRefreshMode<T extends io.jmix.core.Entity,K>, CollectionDatasource.SupportsSortDelegate<T extends io.jmix.core.Entity,K>, CollectionDatasource.Suspendable<T extends io.jmix.core.Entity,K>, CollectionDatasource.UnmuteEventsMode

Nested classes/interfaces inherited from interface com.haulmont.cuba.gui.data.Datasource

Datasource.CommitMode, Datasource.ItemChangeEvent<T extends io.jmix.core.Entity>, Datasource.ItemChangeListener<T extends io.jmix.core.Entity>, Datasource.ItemPropertyChangeEvent<T extends io.jmix.core.Entity>, Datasource.ItemPropertyChangeListener<T extends io.jmix.core.Entity>, Datasource.State, Datasource.StateChangeEvent<T extends io.jmix.core.Entity>, Datasource.StateChangeListener<T extends io.jmix.core.Entity>

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	cacheable Deprecated.
protected AbstractCollectionDatasource.ComponentValueListener	componentValueListener Deprecated.
protected java.lang.Throwable	dataLoadError Deprecated.
protected QueryFilter	filter Deprecated.
protected boolean	listenersSuspended Deprecated.
protected int	maxResults Deprecated.
protected java.lang.String	query Deprecated.
protected ParameterInfo[]	queryParameters Deprecated.
protected CollectionDatasource.RefreshMode	refreshMode Deprecated.
protected boolean	refreshOnComponentValueChange Deprecated.
protected java.util.Map<java.lang.String,java.lang.Object>	savedParameters Deprecated.
protected boolean	softDeletion Deprecated.
protected CollectionDatasource.Sortable.SortInfo<io.jmix.core.metamodel.model.MetaPropertyPath>[]	sortInfos Deprecated.
protected java.util.LinkedList<CollectionDatasource.CollectionChangeEvent<T,K>>	suspendedEvents Deprecated.
protected UserSession	userSession Deprecated.

Fields inherited from class com.haulmont.cuba.gui.data.impl.DatasourceImpl

dataSupplier, dsContext, item, metaClass, state, view

Fields inherited from class com.haulmont.cuba.gui.data.impl.AbstractDatasource

allowCommit, backgroundWorker, commitMode, id, itemsToCreate, itemsToDelete, itemsToUpdate, listener, listenersEnabled, loadDynamicAttributes, metadata, modified, parentDs

Constructor Summary

Constructors

Constructor and Description
AbstractCollectionDatasource() Deprecated.

Method Summary

Modifier and Type	Method and Description
void	addCollectionChangeListener(CollectionDatasource.CollectionChangeListener<? super T,K> listener) Deprecated.
protected void	checkDataLoadError() Deprecated.
void	commit() Deprecated. Performs commit
protected io.jmix.core.DataLoadContextQuery	createDataQuery(io.jmix.core.DataLoadContext context, java.util.Map<java.lang.String,java.lang.Object> params) Deprecated.
protected java.util.Comparator<T>	createEntityComparator() Deprecated.
protected void	fireCollectionChanged(CollectionDatasource.Operation operation, java.util.List<T> items) Deprecated.
LoadContext	getCompiledLoadContext() Deprecated.
int	getCount() Deprecated. Return number of rows for the current query set in the datasource.
T	getItemNN(K id) Deprecated.
protected java.lang.String	getJPQLQuery(java.util.Map<java.lang.String,java.lang.Object> parameterValues) Deprecated.
java.util.Map<java.lang.String,java.lang.Object>	getLastRefreshParameters() Deprecated. Returns the parameters last used in CollectionDatasource.refresh(Map) method or empty map if there was no refresh with parameters
protected java.lang.String	getLoggingTag(java.lang.String prefix) Deprecated.
int	getMaxResults() Deprecated.
java.lang.String	getQuery() Deprecated.
QueryFilter	getQueryFilter() Deprecated.
protected java.util.Map<java.lang.String,java.lang.Object>	getQueryParameters(java.util.Map<java.lang.String,java.lang.Object> params) Deprecated.
CollectionDatasource.RefreshMode	getRefreshMode() Deprecated.
boolean	getRefreshOnComponentValueChange() Deprecated. Whether to refresh datasource on changing value of a component which it depends on (through component$ parameter)
protected java.util.Map<java.lang.String,java.lang.Object>	getTemplateParams(java.util.Map<java.lang.String,java.lang.Object> customParams) Deprecated.
boolean	isCacheable() Deprecated.
boolean	isSoftDeletion() Deprecated.
protected java.lang.String	makeCaseInsensitive(java.lang.String value) Deprecated.
void	mute() Deprecated. Disables all event listeners on datasource data change.
protected void	prepareLoadContext(LoadContext<?> context) Deprecated.
void	removeCollectionChangeListener(CollectionDatasource.CollectionChangeListener<? super T,K> listener) Deprecated.
void	resumeListeners() Deprecated. Resume invocation of collectionChanged method of registered CollectionDatasource.CollectionChangeListeners after calling CollectionDatasource.suspendListeners().
void	setCacheable(boolean cacheable) Deprecated. Indicates that the datasource query results should be cached in the middleware query cache.
void	setItem(T item) Deprecated. Set current entity in the datasource.
void	setMaxResults(int maxResults) Deprecated. Set max number of rows.
void	setQuery(java.lang.String query) Deprecated. Set query string which is used to load data.
void	setQuery(java.lang.String query, QueryFilter filter) Deprecated. Set query string and associated filter which is used to load data.
void	setQueryFilter(QueryFilter filter) Deprecated. Set query filter which is used to load data.
void	setRefreshMode(CollectionDatasource.RefreshMode refreshMode) Deprecated.
void	setRefreshOnComponentValueChange(boolean refresh) Deprecated. Whether to refresh datasource on changing value of a component which it depends on (through component$ parameter)
void	setSoftDeletion(boolean softDeletion) Deprecated. Switch on/off Soft Deletion.
protected void	setSortDirection(LoadContext.Query q) Deprecated.
void	suspendListeners() Deprecated. Suspend invocation of collectionChanged method of registered CollectionDatasource.CollectionChangeListeners.
void	unmute(CollectionDatasource.UnmuteEventsMode mode) Deprecated. Enables all event listeners.

Methods inherited from class com.haulmont.cuba.gui.data.impl.DatasourceImpl

__setItem, committed, getDataSupplier, getDsContext, getItem, getItemIfValid, getMetaClass, getState, getView, initialized, invalidate, refresh, setDataSupplier, setDsContext, setMetaClass, setup, setView, setView, valid

Methods inherited from class com.haulmont.cuba.gui.data.impl.AbstractDatasource

addItemChangeListener, addItemPropertyChangeListener, addParentsToNested, addStateChangeListener, attachListener, clearCommitLists, deleted, detachListener, enableListeners, fireItemChanged, fireStateChanged, getCommitMode, getEventRouter, getId, getItemsToCreate, getItemsToDelete, getItemsToUpdate, getLoadDynamicAttributes, getParent, isAllowCommit, isModified, modified, removeItemChangeListener, removeItemPropertyChangeListener, removeStateChangeListener, setAllowCommit, setCommitMode, setLoadDynamicAttributes, setModified, setParent, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.haulmont.cuba.gui.data.CollectionDatasource

addItem, clear, containsItem, excludeItem, getItem, getItemIds, getItems, includeItem, modifyItem, refresh, removeItem, revert, size, updateItem

Methods inherited from interface com.haulmont.cuba.gui.data.Datasource

addItemChangeListener, addItemPropertyChangeListener, addStateChangeListener, getCommitMode, getDataSupplier, getDsContext, getId, getItem, getItemIfValid, getLoadDynamicAttributes, getMetaClass, getState, getView, invalidate, isAllowCommit, isModified, refresh, removeItemChangeListener, removeItemPropertyChangeListener, removeStateChangeListener, setAllowCommit, setLoadDynamicAttributes, setup

Methods inherited from interface com.haulmont.cuba.gui.data.impl.DatasourceImplementation

clearCommitLists, deleted, enableListeners, getItemsToCreate, getItemsToDelete, getItemsToUpdate, getParent, modified, setCommitMode, setModified, setParent

Field Detail

query

protected java.lang.String query

Deprecated.

filter

protected QueryFilter filter

Deprecated.

maxResults

protected int maxResults

Deprecated.

queryParameters

protected ParameterInfo[] queryParameters

Deprecated.

softDeletion

protected boolean softDeletion

Deprecated.

cacheable

protected boolean cacheable

Deprecated.

componentValueListener

protected AbstractCollectionDatasource.ComponentValueListener componentValueListener

Deprecated.

refreshOnComponentValueChange

protected boolean refreshOnComponentValueChange

Deprecated.

sortInfos

protected CollectionDatasource.Sortable.SortInfo<io.jmix.core.metamodel.model.MetaPropertyPath>[] sortInfos

Deprecated.

savedParameters

protected java.util.Map<java.lang.String,java.lang.Object> savedParameters

Deprecated.

dataLoadError

protected java.lang.Throwable dataLoadError

Deprecated.

listenersSuspended

protected boolean listenersSuspended

Deprecated.

suspendedEvents

protected final java.util.LinkedList<CollectionDatasource.CollectionChangeEvent<T extends io.jmix.core.Entity,K>> suspendedEvents

Deprecated.

refreshMode

protected CollectionDatasource.RefreshMode refreshMode

Deprecated.

userSession

protected UserSession userSession

Deprecated.

Constructor Detail

AbstractCollectionDatasource

public AbstractCollectionDatasource()

Deprecated.

Method Detail

getItemNN

public T getItemNN(K id)

Deprecated.

Specified by:

getItemNN in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

Returns:

item by ID. Throws exception if not found.

setItem

public void setItem(T item)

Deprecated.

Description copied from interface: Datasource

Set current entity in the datasource.

Specified by:

setItem in interface Datasource<T extends io.jmix.core.Entity>

Overrides:

setItem in class DatasourceImpl<T extends io.jmix.core.Entity>

Parameters:

item - entity instance

getQuery

public java.lang.String getQuery()

Deprecated.

Specified by:

getQuery in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

Returns:

Query string which is used to load data. Implementation-dependent (JPQL, Groovy, etc.). Can be null.

getCompiledLoadContext

public LoadContext getCompiledLoadContext()
                                   throws java.lang.UnsupportedOperationException

Deprecated.

Specified by:

getCompiledLoadContext in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

Returns:

load context that can be used to load the same data as contained in the datasource. Can be null.

Throws:

java.lang.UnsupportedOperationException

getQueryFilter

public QueryFilter getQueryFilter()

Deprecated.

Specified by:

getQueryFilter in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

Returns:

Current query filter. Can be null.

setQuery

public void setQuery(java.lang.String query)

Deprecated.

Description copied from interface: CollectionDatasource

Set query string which is used to load data. Implementation-dependent (JPQL, Groovy, etc.).
The query may use the following parameters, distinguished by prefix:

• ds$ - current item in the specified datasource
• component$ - value of the specified UI component
• param$ - value of parameter passed to the window when opening it
• session$ - userId represents current or substituted user ID, userLogin represents current or substituted user login in lower case, any other string represents a user session attribute with this name
• custom$ - value of parameter passed to the CollectionDatasource.refresh(Map) method

Specified by:

setQuery in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

setQueryFilter

public void setQueryFilter(QueryFilter filter)

Deprecated.

Description copied from interface: CollectionDatasource

Set query filter which is used to load data. Query remains the same. Query is implementation-dependent (JPQL, Groovy, etc.).
See CollectionDatasource.setQuery(String) for the list of supported query parameters.

Specified by:

setQueryFilter in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

getMaxResults

public int getMaxResults()

Deprecated.

Specified by:

getMaxResults in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

Returns:

Max number of rows. 0 in case of no limits.

setMaxResults

public void setMaxResults(int maxResults)

Deprecated.

Description copied from interface: CollectionDatasource

Set max number of rows. 0 in case of no limits.
Implementations may or may not take this parameter into account.

Specified by:

setMaxResults in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

getLastRefreshParameters

public java.util.Map<java.lang.String,java.lang.Object> getLastRefreshParameters()

Deprecated.

Description copied from interface: CollectionDatasource

Returns the parameters last used in CollectionDatasource.refresh(Map) method or empty map if there was no refresh with parameters

Specified by:

getLastRefreshParameters in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

getRefreshOnComponentValueChange

public boolean getRefreshOnComponentValueChange()

Deprecated.

Description copied from interface: CollectionDatasource

Whether to refresh datasource on changing value of a component which it depends on (through component$ parameter)

Specified by:

getRefreshOnComponentValueChange in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

setRefreshOnComponentValueChange

public void setRefreshOnComponentValueChange(boolean refresh)

Deprecated.

Description copied from interface: CollectionDatasource

Whether to refresh datasource on changing value of a component which it depends on (through component$ parameter)

Specified by:

setRefreshOnComponentValueChange in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

setQuery

public void setQuery(java.lang.String query,
                     QueryFilter filter)

Deprecated.

Description copied from interface: CollectionDatasource

Set query string and associated filter which is used to load data. Query is implementation-dependent (JPQL, Groovy, etc.).
See CollectionDatasource.setQuery(String) for the list of supported query parameters.

Specified by:

setQuery in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

getQueryParameters

protected java.util.Map<java.lang.String,java.lang.Object> getQueryParameters(java.util.Map<java.lang.String,java.lang.Object> params)

Deprecated.

makeCaseInsensitive

protected java.lang.String makeCaseInsensitive(java.lang.String value)

Deprecated.

getJPQLQuery

protected java.lang.String getJPQLQuery(java.util.Map<java.lang.String,java.lang.Object> parameterValues)

Deprecated.

fireCollectionChanged

protected void fireCollectionChanged(CollectionDatasource.Operation operation,
                                     java.util.List<T> items)

Deprecated.

getTemplateParams

protected java.util.Map<java.lang.String,java.lang.Object> getTemplateParams(java.util.Map<java.lang.String,java.lang.Object> customParams)

Deprecated.

suspendListeners

public void suspendListeners()

Deprecated.

Description copied from interface: CollectionDatasource

Suspend invocation of collectionChanged method of registered CollectionDatasource.CollectionChangeListeners. It makes sense in case of massive updates of the datasource by CollectionDatasource.addItem(Entity) or similar methods. After that, collectionChanged will be invoked once on CollectionDatasource.resumeListeners() call.
Usage example:

 ds.suspendListeners();
 try {
 for (Object item : items) {
 ds.addItem(item);
 }
 } finally {
 ds.resumeListeners();
 }
 

Specified by:

suspendListeners in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

resumeListeners

public void resumeListeners()

Deprecated.

Description copied from interface: CollectionDatasource

Resume invocation of collectionChanged method of registered CollectionDatasource.CollectionChangeListeners after calling CollectionDatasource.suspendListeners(). It will call collectionChanged just once, doesn't matter how many updates were issued since the previous CollectionDatasource.suspendListeners() call.
This method should be called in finally section.

Specified by:

resumeListeners in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

mute

public void mute()

Deprecated.

Description copied from interface: CollectionDatasource

Disables all event listeners on datasource data change.
Can be used with CollectionDatasource.unmute(UnmuteEventsMode) for bulk data modification as a performance optimization.

Specified by:

mute in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

unmute

public void unmute(CollectionDatasource.UnmuteEventsMode mode)

Deprecated.

Description copied from interface: CollectionDatasource

Enables all event listeners. No events are fired on this call.

Specified by:

unmute in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

isSoftDeletion

public boolean isSoftDeletion()

Deprecated.

Specified by:

isSoftDeletion in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

Returns:

true if this datasource is in Soft Delete mode.

setSoftDeletion

public void setSoftDeletion(boolean softDeletion)

Deprecated.

Description copied from interface: CollectionDatasource

Switch on/off Soft Deletion.

Specified by:

setSoftDeletion in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

isCacheable

public boolean isCacheable()

Deprecated.

Specified by:

isCacheable in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

Returns:

true if this datasource results is cacheable.

setCacheable

public void setCacheable(boolean cacheable)

Deprecated.

Description copied from interface: CollectionDatasource

Indicates that the datasource query results should be cached in the middleware query cache.

Specified by:

setCacheable in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

commit

public void commit()

Deprecated.

Description copied from interface: Datasource

Performs commit

Specified by:

commit in interface Datasource<T extends io.jmix.core.Entity>

Overrides:

commit in class DatasourceImpl<T extends io.jmix.core.Entity>

createEntityComparator

protected java.util.Comparator<T> createEntityComparator()

Deprecated.

createDataQuery

protected io.jmix.core.DataLoadContextQuery createDataQuery(io.jmix.core.DataLoadContext context,
                                                            java.util.Map<java.lang.String,java.lang.Object> params)

Deprecated.

getCount

public int getCount()

Deprecated.

Return number of rows for the current query set in the datasource.

Returns:

number of rows. In case of error returns 0 and sets dataLoadError field to the exception object

getLoggingTag

protected java.lang.String getLoggingTag(java.lang.String prefix)

Deprecated.

prepareLoadContext

protected void prepareLoadContext(LoadContext<?> context)

Deprecated.

checkDataLoadError

protected void checkDataLoadError()

Deprecated.

setSortDirection

protected void setSortDirection(LoadContext.Query q)

Deprecated.

getRefreshMode

public CollectionDatasource.RefreshMode getRefreshMode()

Deprecated.

Specified by:

getRefreshMode in interface CollectionDatasource.SupportsRefreshMode<T extends io.jmix.core.Entity,K>

setRefreshMode

public void setRefreshMode(CollectionDatasource.RefreshMode refreshMode)

Deprecated.

Specified by:

setRefreshMode in interface CollectionDatasource.SupportsRefreshMode<T extends io.jmix.core.Entity,K>

addCollectionChangeListener

public void addCollectionChangeListener(CollectionDatasource.CollectionChangeListener<? super T,K> listener)

Deprecated.

Specified by:

addCollectionChangeListener in interface CollectionDatasource<T extends io.jmix.core.Entity,K>

removeCollectionChangeListener

public void removeCollectionChangeListener(CollectionDatasource.CollectionChangeListener<? super T,K> listener)

Deprecated.

Specified by:

removeCollectionChangeListener in interface CollectionDatasource<T extends io.jmix.core.Entity,K>