Package com.storedobject.ui

Class ObjectTreeProvider<T extends StoredObject>

java.lang.Object

com.vaadin.flow.data.provider.AbstractDataProvider<T,com.vaadin.flow.function.SerializablePredicate<T>>

com.vaadin.flow.data.provider.hierarchy.AbstractHierarchicalDataProvider<T,com.vaadin.flow.function.SerializablePredicate<T>>

com.storedobject.ui.AbstractTreeProvider<T,T>

com.storedobject.ui.ObjectTreeProvider<T>

All Implemented Interfaces:

ResourceOwner, FilterMethods<T>, ObjectLoader<T>, ObjectChangedListener<T>, ObjectLoader<T>, ChildVisitor<T,T>, ViewFilterSupport<T>, com.vaadin.flow.data.provider.DataProvider<T,com.vaadin.flow.function.SerializablePredicate<T>>, com.vaadin.flow.data.provider.hierarchy.HierarchicalDataProvider<T,com.vaadin.flow.function.SerializablePredicate<T>>, Serializable, AutoCloseable

public class ObjectTreeProvider<T extends StoredObject>
extends AbstractTreeProvider<T,T>
implements ObjectLoader<T>, ObjectChangedListener<T>, AutoCloseable, ResourceOwner, FilterMethods<T>, ChildVisitor<T,T>

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static interface	ObjectTreeProvider.LoadCallBack

Constructor Summary

Constructors

Constructor	Description
ObjectTreeProvider(ObjectTree<T> tree)

Method Summary

Modifier and Type	Method	Description
void	applyFilterPredicate()	This method is called whenever a filter predicate is changed.
boolean	contains(T item)
void	deleted(T object)	Fired when an object is deleted.
Stream<T>	fetchChildren(com.vaadin.flow.data.provider.hierarchy.HierarchicalQuery<T,com.vaadin.flow.function.SerializablePredicate<T>> query)
T	get(int index)
int	getCacheLevel()
int	getChildCount(com.vaadin.flow.data.provider.hierarchy.HierarchicalQuery<T,com.vaadin.flow.function.SerializablePredicate<T>> query)
Filtered<T>	getData()
String	getEffectiveCondition(String condition)	Get the "effective" filter condition that must be applied for loading.
ObjectLoadFilter<T>	getFixedFilter()
Id	getId(T item)
ObjectLoadFilter<T>	getLoadFilter()	Get the load filter.
int	getObjectCount()
AutoCloseable	getResource()	Get the "resource" owned by this "resource owner".
List<T>	getRoots()
ObjectTree<T>	getTree()
boolean	hasChildren(T parent)
int	indexOf(T object)
void	inserted(T object)	Fired when a new object is inserted.
List<T>	listRoots()	Retrieves a list of root elements in the hierarchical structure.
void	load(int linkType, StoredObject master, String condition, String orderBy, boolean any)	Load the links of the given "master" instance.
void	load(ObjectIterator<T> objects)	Load the given instances.
void	load(String condition, String orderBy, boolean any)	Load the instances.
void	refreshAll()
void	refreshItem(T item)
void	refreshItem(T item, boolean refreshChildren)
void	setLoadFilter(Predicate<T> loadFilter)	Set the load filter.
int	size()	Get the instances count.
Stream<T>	streamAll()
Stream<T>	streamChildren(T parent)	Produces a stream of child elements for the given parent element.
Stream<T>	streamFiltered()
void	updated(T object)	Fired when an object is updated.

Methods inherited from class com.storedobject.ui.AbstractTreeProvider

addDataLoadedListener, clear, close, filterView, getDataProvider, getItemLabelGenerator, getObjectClass, getViewFilter, isInMemory, setFilter, setItemLabelGenerator

Methods inherited from class com.vaadin.flow.data.provider.hierarchy.AbstractHierarchicalDataProvider

withConfigurableFilter, withConfigurableFilter, withConvertedFilter

Methods inherited from class com.vaadin.flow.data.provider.AbstractDataProvider

addDataProviderListener, addListener, fireEvent

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.AutoCloseable

close

Methods inherited from interface com.storedobject.ui.util.ChildVisitor

listChildren, streamRoots, visitAll, visitAll, visitAll, visitAll, visitChildren, visitChildren, visitChildren, visitChildren

Methods inherited from interface com.vaadin.flow.data.provider.DataProvider

addDataProviderListener

Methods inherited from interface com.storedobject.core.FilterMethods

getFilterCondition, setFilter, setFilter, setFilter, setFilter, setFilter, setFilter, setLoadFilter, setViewFilter, setViewFilter

Methods inherited from interface com.vaadin.flow.data.provider.hierarchy.HierarchicalDataProvider

fetch, size

Methods inherited from interface com.storedobject.ui.ObjectChangedListener

saved, undeleted

Methods inherited from interface com.storedobject.core.ObjectLoader

applyFilter, canContain, clear, getAllowAny, getLinkType, getMaster, getObjectClass, getOrderBy, isAllowAny, load, load, load, load, load, load, load, load, load, load, load, load, load, load, load, load, load, load, load, load, reload, setLinkType, setLinkType, setMaster, setMaster, setOrderBy, setOrderBy

Methods inherited from interface com.storedobject.ui.ObjectLoader

addDataLoadedListener, clear, getDelegatedLoader, setExtraFilter, setExtraFilter, setFilter, setFilter, setFixedFilter, setFixedFilter, setFixedFilter, setFixedFilter

Methods inherited from interface com.storedobject.ui.util.ViewFilterSupport

configure, configure, configure, configureMatch

Constructor Details

ObjectTreeProvider

public ObjectTreeProvider(ObjectTree<T> tree)

Method Details

getTree

public ObjectTree<T> getTree()

getRoots

public List<T> getRoots()

Specified by:

getRoots in class AbstractTreeProvider<T extends StoredObject,T extends StoredObject>

listRoots

public List<T> listRoots()

Description copied from interface: ChildVisitor

Retrieves a list of root elements in the hierarchical structure. This method provides a collection of elements that serve as entry points or origins in the structure.

Specified by:

listRoots in interface ChildVisitor<T extends StoredObject,T extends StoredObject>

Returns:

a List of elements of type P representing the root elements

streamChildren

public Stream<T> streamChildren(T parent)

Description copied from interface: ChildVisitor

Produces a stream of child elements for the given parent element. This allows traversal or processing of direct child elements in a hierarchical structure.

Specified by:

streamChildren in interface ChildVisitor<T extends StoredObject,T extends StoredObject>

Parameters:

parent - the parent element whose children are to be streamed

Returns:

a stream of child elements directly associated with the specified parent

getData

public Filtered<T> getData()

Specified by:

getData in class AbstractTreeProvider<T extends StoredObject,T extends StoredObject>

getFixedFilter

public ObjectLoadFilter<T> getFixedFilter()

Specified by:

getFixedFilter in interface ObjectLoader<T extends StoredObject>

getId

public Id getId(T item)

Specified by:

getId in interface com.vaadin.flow.data.provider.DataProvider<T extends StoredObject,com.vaadin.flow.function.SerializablePredicate<T extends StoredObject>>

contains

public boolean contains(T item)

getEffectiveCondition

public String getEffectiveCondition(String condition)

Description copied from interface: FilterMethods

Get the "effective" filter condition that must be applied for loading. The result from FilterMethods.getFilterCondition() will be passed as a parameter to this method to get a modified "condition" if required.

Specified by:

getEffectiveCondition in interface FilterMethods<T extends StoredObject>

Specified by:

getEffectiveCondition in interface ObjectLoader<T extends StoredObject>

Parameters:

condition - Condition obtained from FilterMethods.getFilterCondition().

Returns:

Modified condition or the same if no modification required.

load

public void load(String condition,
 String orderBy,
 boolean any)

Description copied from interface: ObjectLoader

Load the instances. Current "load filter" if set will be applied. If "master" is already set, "links" of the "master" will be loaded.

Specified by:

load in interface ObjectLoader<T extends StoredObject>

Parameters:

condition - Filtering condition to be applied.

orderBy - "ORDER BY" clause to use while loading.

any - Whether instanced of the subclasses to be retrieved or not.

load

public void load(int linkType,
 StoredObject master,
 String condition,
 String orderBy,
 boolean any)

Description copied from interface: ObjectLoader

Load the links of the given "master" instance. Current "load filter" if set will be applied.

Specified by:

load in interface ObjectLoader<T extends StoredObject>

Parameters:

linkType - Link type.

master - Master instance.

condition - Filtering condition to be applied.

orderBy - "ORDER BY" clause to use while loading.

any - Whether instanced of the subclasses to be retrieved or not.

load

public void load(ObjectIterator<T> objects)

Description copied from interface: ObjectLoader

Load the given instances. Current "load filter" if set will be applied. However, ObjectLoader.getOrderBy() result will be ignored. Also, the value returned by ObjectLoader.getAllowAny() will determine whether instanced of the subclasses to be restricted or not.

Specified by:

load in interface ObjectLoader<T extends StoredObject>

Specified by:

load in interface ObjectLoader<T extends StoredObject>

Parameters:

objects - Objects to be loaded.

applyFilterPredicate

public void applyFilterPredicate()

Description copied from interface: FilterMethods

This method is called whenever a filter predicate is changed. Methods with default implementation already invoke this method. If any of those methods are overridden, make sure that it invokes this method so that logic to handle filter changes can be coded here.

Note: This method is used to show the filtered result of the existing entries

Specified by:

applyFilterPredicate in interface FilterMethods<T extends StoredObject>

Specified by:

applyFilterPredicate in interface ObjectLoader<T extends StoredObject>

getObjectCount

public int getObjectCount()

Specified by:

getObjectCount in interface ObjectLoader<T extends StoredObject>

Overrides:

getObjectCount in class AbstractTreeProvider<T extends StoredObject,T extends StoredObject>

get

public T get(int index)

Specified by:

get in interface ObjectLoader<T extends StoredObject>

Overrides:

get in class AbstractTreeProvider<T extends StoredObject,T extends StoredObject>

indexOf

public int indexOf(T object)

Specified by:

indexOf in interface ObjectLoader<T extends StoredObject>

Overrides:

indexOf in class AbstractTreeProvider<T extends StoredObject,T extends StoredObject>

streamAll

public Stream<T> streamAll()

Specified by:

streamAll in interface ObjectLoader<T extends StoredObject>

Overrides:

streamAll in class AbstractTreeProvider<T extends StoredObject,T extends StoredObject>

streamFiltered

public Stream<T> streamFiltered()

Specified by:

streamFiltered in interface ObjectLoader<T extends StoredObject>

Overrides:

streamFiltered in class AbstractTreeProvider<T extends StoredObject,T extends StoredObject>

getCacheLevel

public int getCacheLevel()

Specified by:

getCacheLevel in interface ObjectLoader<T extends StoredObject>

refreshAll

public void refreshAll()

Specified by:

refreshAll in interface com.vaadin.flow.data.provider.DataProvider<T extends StoredObject,com.vaadin.flow.function.SerializablePredicate<T extends StoredObject>>

Overrides:

refreshAll in class AbstractTreeProvider<T extends StoredObject,T extends StoredObject>

refreshItem

public void refreshItem(T item)

Specified by:

refreshItem in interface com.vaadin.flow.data.provider.DataProvider<T extends StoredObject,com.vaadin.flow.function.SerializablePredicate<T extends StoredObject>>

Overrides:

refreshItem in class com.vaadin.flow.data.provider.AbstractDataProvider<T extends StoredObject,com.vaadin.flow.function.SerializablePredicate<T extends StoredObject>>

refreshItem

public void refreshItem(T item,
 boolean refreshChildren)

Specified by:

refreshItem in interface com.vaadin.flow.data.provider.DataProvider<T extends StoredObject,com.vaadin.flow.function.SerializablePredicate<T extends StoredObject>>

Overrides:

refreshItem in class com.vaadin.flow.data.provider.AbstractDataProvider<T extends StoredObject,com.vaadin.flow.function.SerializablePredicate<T extends StoredObject>>

inserted

public void inserted(T object)

Description copied from interface: ObjectChangedListener

Fired when a new object is inserted. The default implementation invokes ObjectChangedListener.saved(StoredObject).

Specified by:

inserted in interface ObjectChangedListener<T extends StoredObject>

Parameters:

object - Object.

updated

public void updated(T object)

Description copied from interface: ObjectChangedListener

Fired when an object is updated. The default implementation invokes ObjectChangedListener.saved(StoredObject).

Specified by:

updated in interface ObjectChangedListener<T extends StoredObject>

Parameters:

object - Object.

deleted

public void deleted(T object)

Description copied from interface: ObjectChangedListener

Fired when an object is deleted. The default implementation does nothing.

Specified by:

deleted in interface ObjectChangedListener<T extends StoredObject>

Parameters:

object - Object.

getResource

public AutoCloseable getResource()

Description copied from interface: ResourceOwner

Get the "resource" owned by this "resource owner".

Specified by:

getResource in interface ResourceOwner

Returns:

The "resource" owned by this "resource owner".

getLoadFilter

@Nonnull
public ObjectLoadFilter<T> getLoadFilter()

Description copied from interface: FilterMethods

Get the load filter.

Specified by:

getLoadFilter in interface FilterMethods<T extends StoredObject>

Specified by:

getLoadFilter in interface ObjectLoader<T extends StoredObject>

Returns:

Current load filter.

getChildCount

public int getChildCount(com.vaadin.flow.data.provider.hierarchy.HierarchicalQuery<T,com.vaadin.flow.function.SerializablePredicate<T>> query)

Specified by:

getChildCount in interface com.vaadin.flow.data.provider.hierarchy.HierarchicalDataProvider<T extends StoredObject,com.vaadin.flow.function.SerializablePredicate<T extends StoredObject>>

fetchChildren

public Stream<T> fetchChildren(com.vaadin.flow.data.provider.hierarchy.HierarchicalQuery<T,com.vaadin.flow.function.SerializablePredicate<T>> query)

Specified by:

fetchChildren in interface com.vaadin.flow.data.provider.hierarchy.HierarchicalDataProvider<T extends StoredObject,com.vaadin.flow.function.SerializablePredicate<T extends StoredObject>>

hasChildren

public boolean hasChildren(T parent)

Specified by:

hasChildren in interface com.vaadin.flow.data.provider.hierarchy.HierarchicalDataProvider<T extends StoredObject,com.vaadin.flow.function.SerializablePredicate<T extends StoredObject>>

setLoadFilter

public void setLoadFilter(Predicate<T> loadFilter)

Description copied from interface: FilterMethods

Set the load filter. This will be applied whenever loading takes place.

Specified by:

setLoadFilter in interface FilterMethods<T extends StoredObject>

Parameters:

loadFilter - Load filter to be applied while loading.

size

public int size()

Description copied from interface: ObjectLoader

Get the instances count.

Specified by:

size in interface ObjectLoader<T extends StoredObject>

Specified by:

size in interface ObjectLoader<T extends StoredObject>

Returns:

Count.