Package io.jmix.ui.model.impl

Class CollectionLoaderImpl<E>

java.lang.Object

io.jmix.ui.model.impl.CollectionLoaderImpl<E>

All Implemented Interfaces:

BaseCollectionLoader, CollectionLoader<E>, DataLoader

public class CollectionLoaderImpl<E>
extends Object
implements CollectionLoader<E>

Nested Class Summary

Nested classes/interfaces inherited from interface io.jmix.ui.model.CollectionLoader

CollectionLoader.PostLoadEvent<T>, CollectionLoader.PreLoadEvent<T>

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	cacheable
protected Condition	condition
protected CollectionContainer<E>	container
protected DataContext	dataContext
protected DataManager	dataManager
protected Function<LoadContext<E>,List<E>>	delegate
protected EventHub	events
protected FetchPlan	fetchPlan
protected String	fetchPlanName
protected FetchPlanRepository	fetchPlanRepository
protected int	firstResult
protected Map<String,Serializable>	hints
protected int	maxResults
protected io.micrometer.core.instrument.MeterRegistry	meterRegistry
protected Function<DataLoader,DataLoaderMonitoringInfo>	monitoringInfoProvider
protected Map<String,Object>	parameters
protected String	query
protected List<QueryStringProcessor>	queryStringProcessors
protected Sort	sort
protected SorterFactory	sorterFactory

Constructor Summary

Constructors

Constructor	Description
CollectionLoaderImpl()

Method Summary

Modifier and Type	Method	Description
protected boolean	_load()
Subscription	addPostLoadListener(Consumer<CollectionLoader.PostLoadEvent<E>> listener)	Adds a listener to CollectionLoader.PostLoadEvent.
Subscription	addPreLoadListener(Consumer<CollectionLoader.PreLoadEvent<E>> listener)	Adds a listener to CollectionLoader.PreLoadEvent.
protected boolean	canLeadToDuplicateResultsRecursive(Condition condition)	Evaluates recursively if the condition depends on some x-to-many property so the list of loaded entities can contain duplicates.
LoadContext<E>	createLoadContext()	Returns LoadContext which is created by the parameters of this loader.
Condition	getCondition()	Returns the root condition which is used together with the query when loading entities.
CollectionContainer<E>	getContainer()	Returns the container which accepts loaded entities.
DataContext	getDataContext()	Returns data context.
FetchPlan	getFetchPlan()	Returns the fetch plan used for loading entities.
int	getFirstResult()	The position of the first instance to load, numbered from 0.
Map<String,Serializable>	getHints()
Function<LoadContext<E>,List<E>>	getLoadDelegate()	Returns a function which will be used to load data instead of standard implementation.
int	getMaxResults()	The maximum number of instances to load.
Function<DataLoader,DataLoaderMonitoringInfo>	getMonitoringInfoProvider()	Returns function that provides monitoring info about this data loader.
Object	getParameter(String name)	Returns a query parameter by its name.
Map<String,Object>	getParameters()	Returns the map of query parameters.
String	getQuery()	Returns the query which is used for loading entities.
Sort	getSort()	Returns the sort object which is used when loading.
boolean	isCacheable()	Returns true if the query for loading data is cacheable.
void	load()	Loads data to the connected container.
void	removeParameter(String name)	Removes a query parameter.
protected FetchPlan	resolveFetchPlan()
protected void	sendPostLoadEvent(List<E> entities)
protected boolean	sendPreLoadEvent(LoadContext<E> loadContext)
void	setCacheable(boolean cacheable)	Sets the query for loading data cacheable.
void	setCondition(Condition condition)	Sets the root condition which will be used together with the query when loading entities.
void	setContainer(CollectionContainer<E> container)	Sets the container which accepts loaded entities.
void	setDataContext(DataContext dataContext)	Sets the data context for the loader.
void	setFetchPlan(FetchPlan fetchPlan)	Sets the fetch plan to use for loading entities.
void	setFetchPlan(String fetchPlanName)	Sets the name of the fetch plan to use for loading entities.
void	setFirstResult(int firstResult)	Sets the position of the first instance to load, numbered from 0.
void	setHint(String hintName, Serializable value)	Sets custom hint that should be used by the query for loading data.
void	setLoadDelegate(Function<LoadContext<E>,List<E>> delegate)	Sets a function which will be used to load data instead of standard implementation.
void	setMaxResults(int maxResults)	Sets the maximum number of instances to load.
void	setMonitoringInfoProvider(Function<DataLoader,DataLoaderMonitoringInfo> monitoringInfoProvider)	Sets function that provides monitoring info about this data loader.
void	setParameter(String name, Object value)	Sets a query parameter.
void	setParameters(Map<String,Object> parameters)	Sets the map of query parameters.
void	setQuery(String query)	Sets a query which will be used for loading entities.
void	setSort(Sort sort)	Sets the sort object which is used when loading.

Methods inherited from class java.lang.Object

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

Field Details

dataManager

@Autowired
protected DataManager dataManager

fetchPlanRepository

@Autowired
protected FetchPlanRepository fetchPlanRepository

sorterFactory

@Autowired
protected SorterFactory sorterFactory

queryStringProcessors

@Autowired
protected List<QueryStringProcessor> queryStringProcessors

meterRegistry

@Autowired
protected io.micrometer.core.instrument.MeterRegistry meterRegistry

dataContext

protected DataContext dataContext

container

protected CollectionContainer<E> container

query

protected String query

condition

protected Condition condition

parameters

protected Map<String,Object> parameters

firstResult

protected int firstResult

maxResults

protected int maxResults

cacheable

protected boolean cacheable

fetchPlan

protected FetchPlan fetchPlan

fetchPlanName

protected String fetchPlanName

sort

protected Sort sort

hints

protected Map<String,Serializable> hints

delegate

protected Function<LoadContext<E>,List<E>> delegate

events

protected EventHub events

monitoringInfoProvider

protected Function<DataLoader,DataLoaderMonitoringInfo> monitoringInfoProvider

Constructor Details

CollectionLoaderImpl

public CollectionLoaderImpl()

Method Details

getDataContext

@Nullable
public DataContext getDataContext()

Description copied from interface: DataLoader

Returns data context. If the data context is set, all loaded instance will be merged into it.

Specified by:

getDataContext in interface DataLoader

setDataContext

public void setDataContext(@Nullable
 DataContext dataContext)

Description copied from interface: DataLoader

Sets the data context for the loader. If the data context is set, all loaded instance will be merged into it.

Specified by:

setDataContext in interface DataLoader

setMonitoringInfoProvider

public void setMonitoringInfoProvider(Function<DataLoader,DataLoaderMonitoringInfo> monitoringInfoProvider)

Description copied from interface: DataLoader

Sets function that provides monitoring info about this data loader.

Specified by:

setMonitoringInfoProvider in interface DataLoader

getMonitoringInfoProvider

public Function<DataLoader,DataLoaderMonitoringInfo> getMonitoringInfoProvider()

Description copied from interface: DataLoader

Returns function that provides monitoring info about this data loader.

Specified by:

getMonitoringInfoProvider in interface DataLoader

load

public void load()

Description copied from interface: DataLoader

Loads data to the connected container.

Specified by:

load in interface DataLoader

_load

protected boolean _load()

createLoadContext

public LoadContext<E> createLoadContext()

Description copied from interface: CollectionLoader

Returns LoadContext which is created by the parameters of this loader. The LoadContext can be used with DataManager to load data by the same conditions.

Specified by:

createLoadContext in interface CollectionLoader<E>

canLeadToDuplicateResultsRecursive

protected boolean canLeadToDuplicateResultsRecursive(Condition condition)

Evaluates recursively if the condition depends on some x-to-many property so the list of loaded entities can contain duplicates.

Parameters:

condition - condition to check

Returns:

true if duplicate results are possible, false otherwise

resolveFetchPlan

protected FetchPlan resolveFetchPlan()

sendPreLoadEvent

protected boolean sendPreLoadEvent(LoadContext<E> loadContext)

sendPostLoadEvent

protected void sendPostLoadEvent(List<E> entities)

getContainer

public CollectionContainer<E> getContainer()

Description copied from interface: CollectionLoader

Returns the container which accepts loaded entities.

Specified by:

getContainer in interface BaseCollectionLoader

Specified by:

getContainer in interface CollectionLoader<E>

Specified by:

getContainer in interface DataLoader

setContainer

public void setContainer(CollectionContainer<E> container)

Description copied from interface: CollectionLoader

Sets the container which accepts loaded entities.

Specified by:

setContainer in interface CollectionLoader<E>

getQuery

public String getQuery()

Description copied from interface: DataLoader

Returns the query which is used for loading entities.

Specified by:

getQuery in interface DataLoader

setQuery

public void setQuery(String query)

Description copied from interface: DataLoader

Sets a query which will be used for loading entities.

Specified by:

setQuery in interface DataLoader

getCondition

@Nullable
public Condition getCondition()

Description copied from interface: DataLoader

Returns the root condition which is used together with the query when loading entities.

Specified by:

getCondition in interface DataLoader

setCondition

public void setCondition(Condition condition)

Description copied from interface: DataLoader

Sets the root condition which will be used together with the query when loading entities.

Specified by:

setCondition in interface DataLoader

getParameters

public Map<String,Object> getParameters()

Description copied from interface: DataLoader

Returns the map of query parameters.

Specified by:

getParameters in interface DataLoader

setParameters

public void setParameters(Map<String,Object> parameters)

Description copied from interface: DataLoader

Sets the map of query parameters.

Specified by:

setParameters in interface DataLoader

getParameter

public Object getParameter(String name)

Description copied from interface: DataLoader

Returns a query parameter by its name.

Specified by:

getParameter in interface DataLoader

setParameter

public void setParameter(String name,
 @Nullable
 Object value)

Description copied from interface: DataLoader

Sets a query parameter.

Specified by:

setParameter in interface DataLoader

removeParameter

public void removeParameter(String name)

Description copied from interface: DataLoader

Removes a query parameter.

Specified by:

removeParameter in interface DataLoader

getFirstResult

public int getFirstResult()

Description copied from interface: BaseCollectionLoader

The position of the first instance to load, numbered from 0. Returns 0 if BaseCollectionLoader.setFirstResult(int) was not called.

Specified by:

getFirstResult in interface BaseCollectionLoader

setFirstResult

public void setFirstResult(int firstResult)

Description copied from interface: BaseCollectionLoader

Sets the position of the first instance to load, numbered from 0.

Specified by:

setFirstResult in interface BaseCollectionLoader

getMaxResults

public int getMaxResults()

Description copied from interface: BaseCollectionLoader

The maximum number of instances to load. Returns Integer.MAX_VALUE if BaseCollectionLoader.setMaxResults(int) was not called.

Specified by:

getMaxResults in interface BaseCollectionLoader

setMaxResults

public void setMaxResults(int maxResults)

Description copied from interface: BaseCollectionLoader

Sets the maximum number of instances to load.

Specified by:

setMaxResults in interface BaseCollectionLoader

setHint

public void setHint(String hintName,
 Serializable value)

Description copied from interface: DataLoader

Sets custom hint that should be used by the query for loading data.

Specified by:

setHint in interface DataLoader

getHints

public Map<String,Serializable> getHints()

Specified by:

getHints in interface DataLoader

Returns:

custom hints which are used by the query for loading data.

isCacheable

public boolean isCacheable()

Description copied from interface: CollectionLoader

Returns true if the query for loading data is cacheable.

Specified by:

isCacheable in interface CollectionLoader<E>

setCacheable

public void setCacheable(boolean cacheable)

Description copied from interface: CollectionLoader

Sets the query for loading data cacheable.

Specified by:

setCacheable in interface CollectionLoader<E>

getFetchPlan

public FetchPlan getFetchPlan()

Description copied from interface: CollectionLoader

Returns the fetch plan used for loading entities.

Specified by:

getFetchPlan in interface CollectionLoader<E>

setFetchPlan

public void setFetchPlan(FetchPlan fetchPlan)

Description copied from interface: CollectionLoader

Sets the fetch plan to use for loading entities.

Specified by:

setFetchPlan in interface CollectionLoader<E>

setFetchPlan

public void setFetchPlan(String fetchPlanName)

Description copied from interface: CollectionLoader

Sets the name of the fetch plan to use for loading entities.

Specified by:

setFetchPlan in interface CollectionLoader<E>

getSort

@Nullable
public Sort getSort()

Description copied from interface: BaseCollectionLoader

Returns the sort object which is used when loading.

Specified by:

getSort in interface BaseCollectionLoader

setSort

public void setSort(@Nullable
 Sort sort)

Description copied from interface: BaseCollectionLoader

Sets the sort object which is used when loading.

Specified by:

setSort in interface BaseCollectionLoader

getLoadDelegate

public Function<LoadContext<E>,List<E>> getLoadDelegate()

Description copied from interface: CollectionLoader

Returns a function which will be used to load data instead of standard implementation.

Specified by:

getLoadDelegate in interface CollectionLoader<E>

setLoadDelegate

public void setLoadDelegate(Function<LoadContext<E>,List<E>> delegate)

Description copied from interface: CollectionLoader

Sets a function which will be used to load data instead of standard implementation.

Specified by:

setLoadDelegate in interface CollectionLoader<E>

addPreLoadListener

public Subscription addPreLoadListener(Consumer<CollectionLoader.PreLoadEvent<E>> listener)

Description copied from interface: CollectionLoader

Adds a listener to CollectionLoader.PreLoadEvent.

You can also add an event listener declaratively using a controller method annotated with Subscribe:

    @Subscribe(id = "fooDl", target = Target.DATA_LOADER)
     private void onFooDlPreLoad(CollectionLoader.PreLoadEvent event) {
         // handle event here
     }
 

Specified by:

addPreLoadListener in interface CollectionLoader<E>

Parameters:

listener - listener

Returns:

subscription

addPostLoadListener

public Subscription addPostLoadListener(Consumer<CollectionLoader.PostLoadEvent<E>> listener)

Description copied from interface: CollectionLoader

Adds a listener to CollectionLoader.PostLoadEvent.

You can also add an event listener declaratively using a controller method annotated with Subscribe:

    @Subscribe(id = "fooDl", target = Target.DATA_LOADER)
     private void onFooDlPostLoad(CollectionLoader.PostLoadEvent event) {
         // handle event here
     }
 

Specified by:

addPostLoadListener in interface CollectionLoader<E>

Parameters:

listener - listener

Returns:

subscription