com.vaadin.data.provider

Class HierarchicalDataCommunicator<T>

java.lang.Object

com.vaadin.server.AbstractClientConnector

com.vaadin.server.AbstractExtension

com.vaadin.data.provider.DataCommunicator<T>

com.vaadin.data.provider.HierarchicalDataCommunicator<T>

Type Parameters:

T - the bean type

All Implemented Interfaces:

MethodEventSource, ClientConnector, Extension, Connector, Serializable

public class HierarchicalDataCommunicator<T>
extends DataCommunicator<T>

Data communicator that handles requesting hierarchical data from HierarchicalDataProvider and sending it to client side.

Since:

8.1

Author:

Vaadin Ltd

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.vaadin.data.provider.DataCommunicator

DataCommunicator.ActiveDataHandler, DataCommunicator.SimpleDataRequestRpc

Nested classes/interfaces inherited from interface com.vaadin.server.ClientConnector

ClientConnector.AttachEvent, ClientConnector.AttachListener, ClientConnector.ConnectorErrorEvent, ClientConnector.DetachEvent, ClientConnector.DetachListener

Field Summary

Fields inherited from class com.vaadin.data.provider.DataCommunicator

reset

Constructor Summary

Constructors

Constructor and Description
HierarchicalDataCommunicator() Construct a new hierarchical data communicator backed by a TreeDataProvider.

Method Summary

Modifier and Type	Method and Description
void	collapse(T item) Collapses given item, removing all its subtrees.
void	doCollapse(T item, Optional<Integer> index) Collapses given item, removing all its subtrees.
void	doExpand(T item, Optional<Integer> index) Expands the given item at given index.
void	expand(T item) Expands the given item.
protected List<T>	fetchItemsWithRange(int offset, int limit) Fetches a list of items from the DataProvider.
HierarchicalDataProvider<T,?>	getDataProvider() Gets the current data provider from this DataCommunicator.
protected int	getDataProviderSize() Getter method for finding the size of DataProvider.
ItemCollapseAllowedProvider<T>	getItemCollapseAllowedProvider() Gets the item collapse allowed provider.
Integer	getParentIndex(T item) Returns parent index for the row or null.
protected HierarchicalDataCommunicatorState	getState() Returns the shared state for this connector.
protected HierarchicalDataCommunicatorState	getState(boolean markAsDirty) Returns the shared state for this connector.
boolean	hasChildren(T item) Returns whether given item has children.
boolean	isExpanded(T item) Returns whether given item is expanded.
void	setBackEndSorting(List<QuerySortOrder> sortOrder) Sets the QuerySortOrders to use with backend sorting.
<F> SerializableConsumer<F>	setDataProvider(DataProvider<T,F> dataProvider, F initialFilter) Set the current hierarchical data provider for this communicator.
<F> SerializableConsumer<F>	setDataProvider(HierarchicalDataProvider<T,F> dataProvider, F initialFilter) Set the current hierarchical data provider for this communicator.
protected <F> void	setFilter(F filter) Sets the filter for this DataCommunicator.
void	setInMemorySorting(Comparator<T> comparator) Sets the Comparator to use with in-memory sorting.
void	setItemCollapseAllowedProvider(ItemCollapseAllowedProvider<T> provider) Sets the item collapse allowed provider for this HierarchicalDataCommunicator.

Methods inherited from class com.vaadin.data.provider.DataCommunicator

addDataGenerator, attach, beforeClientResponse, createKeyMapper, createRpc, detach, dropAllData, getActiveDataHandler, getBackEndSorting, getClientRpc, getDataObject, getFilter, getInMemorySorting, getKeyMapper, getMinPushSize, getPushRows, getUpdatedData, onDropRows, onRequestRows, pushData, refresh, removeDataGenerator, reset, sendDataToClient, setDataProvider, setMinPushSize, setPushRows

Methods inherited from class com.vaadin.server.AbstractExtension

extend, getParent, getSupportedParentType, remove, setParent

Methods inherited from class com.vaadin.server.AbstractClientConnector

addAttachListener, addDetachListener, addExtension, addListener, addListener, addListener, addMethodInvocationToQueue, createState, encodeState, equals, fireEvent, getAllChildrenIterable, getConnectorId, getErrorHandler, getExtensions, getListeners, getResource, getRpcManager, getRpcProxy, getSession, getStateType, getUI, handleConnectorRequest, hashCode, hasListeners, isAttached, isConnectorEnabled, isThis, markAsDirty, markAsDirtyRecursive, registerRpc, registerRpc, removeAttachListener, removeDetachListener, removeExtension, removeListener, removeListener, removeListener, removeListener, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler, setResource, updateDiffstate

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.vaadin.server.ClientConnector

addAttachListener, addDetachListener, encodeState, getErrorHandler, getExtensions, getRpcManager, getStateType, getUI, handleConnectorRequest, isAttached, isConnectorEnabled, markAsDirty, markAsDirtyRecursive, removeAttachListener, removeDetachListener, removeExtension, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler

Methods inherited from interface com.vaadin.shared.Connector

getConnectorId

Constructor Detail

HierarchicalDataCommunicator

public HierarchicalDataCommunicator()

Construct a new hierarchical data communicator backed by a TreeDataProvider.

Method Detail

getState

protected HierarchicalDataCommunicatorState getState()

Description copied from class: AbstractClientConnector

Returns the shared state for this connector. The shared state object is shared between the server connector and the client connector. Changes are only communicated from the server to the client and not in the other direction.

As a side effect, marks the connector dirty so any changes done to the state will be sent to the client. Use getState(false) to avoid marking the connector as dirty.

Overrides:

getState in class DataCommunicator<T>

Returns:

The shared state for this connector. Never null.

getState

protected HierarchicalDataCommunicatorState getState(boolean markAsDirty)

Description copied from class: AbstractClientConnector

Returns the shared state for this connector.

Overrides:

getState in class DataCommunicator<T>

Parameters:

markAsDirty - true if the connector should automatically be marked dirty, false otherwise

Returns:

The shared state for this connector. Never null.

See Also:

AbstractClientConnector.getState()

fetchItemsWithRange

protected List<T> fetchItemsWithRange(int offset,
                                      int limit)

Description copied from class: DataCommunicator

Fetches a list of items from the DataProvider.

Overrides:

fetchItemsWithRange in class DataCommunicator<T>

Parameters:

offset - the starting index of the range

limit - the max number of results

Returns:

the list of items in given range

getDataProvider

public HierarchicalDataProvider<T,?> getDataProvider()

Description copied from class: DataCommunicator

Gets the current data provider from this DataCommunicator.

Overrides:

getDataProvider in class DataCommunicator<T>

Returns:

the data provider

setDataProvider

public <F> SerializableConsumer<F> setDataProvider(HierarchicalDataProvider<T,F> dataProvider,
                                                   F initialFilter)

Set the current hierarchical data provider for this communicator.

Type Parameters:

F - the filter type

Parameters:

dataProvider - the data provider to set, not null

initialFilter - the initial filter value to use, or null to not use any initial filter value

Returns:

a consumer that accepts a new filter value to use

setDataProvider

public <F> SerializableConsumer<F> setDataProvider(DataProvider<T,F> dataProvider,
                                                   F initialFilter)

Set the current hierarchical data provider for this communicator.

Overrides:

setDataProvider in class DataCommunicator<T>

Type Parameters:

F - the filter type

Parameters:

dataProvider - the data provider to set, must extend HierarchicalDataProvider, not null

initialFilter - the initial filter value to use, or null to not use any initial filter value

Returns:

a consumer that accepts a new filter value to use

collapse

public void collapse(T item)

Collapses given item, removing all its subtrees. Calling this method will have no effect if the row is already collapsed.

Parameters:

item - the item to collapse

doCollapse

public void doCollapse(T item,
                       Optional<Integer> index)

Collapses given item, removing all its subtrees. Calling this method will have no effect if the row is already collapsed. The index is provided by the client-side or calculated from a full data request.

Parameters:

item - the item to collapse

index - the index of the item

See Also:

collapse(Object)

expand

public void expand(T item)

Expands the given item. Calling this method will have no effect if the row is already expanded.

Parameters:

item - the item to expand

doExpand

public void doExpand(T item,
                     Optional<Integer> index)

Expands the given item at given index. Calling this method will have no effect if the row is already expanded. The index is provided by the client-side or calculated from a full data request.

Parameters:

item - the item to expand

index - the index of the item

See Also:

expand(Object)

hasChildren

public boolean hasChildren(T item)

Returns whether given item has children.

Parameters:

item - the item to test

Returns:

true if item has children; false if not

isExpanded

public boolean isExpanded(T item)

Returns whether given item is expanded.

Parameters:

item - the item to test

Returns:

true if item is expanded; false if not

setItemCollapseAllowedProvider

public void setItemCollapseAllowedProvider(ItemCollapseAllowedProvider<T> provider)

Sets the item collapse allowed provider for this HierarchicalDataCommunicator. The provider should return true for any item that the user can collapse.

Note: This callback will be accessed often when sending data to the client. The callback should not do any costly operations.

Parameters:

provider - the item collapse allowed provider, not null

getParentIndex

public Integer getParentIndex(T item)

Returns parent index for the row or null.

Parameters:

item - the item to find the parent of

Returns:

the parent index or null for top-level items

getItemCollapseAllowedProvider

public ItemCollapseAllowedProvider<T> getItemCollapseAllowedProvider()

Gets the item collapse allowed provider.

Returns:

the item collapse allowed provider

getDataProviderSize

protected int getDataProviderSize()

Description copied from class: DataCommunicator

Getter method for finding the size of DataProvider. Can be overridden by a subclass that uses a specific type of DataProvider and/or query.

Overrides:

getDataProviderSize in class DataCommunicator<T>

Returns:

the size of data provider with current filter

setBackEndSorting

public void setBackEndSorting(List<QuerySortOrder> sortOrder)

Description copied from class: DataCommunicator

Sets the QuerySortOrders to use with backend sorting.

Overrides:

setBackEndSorting in class DataCommunicator<T>

Parameters:

sortOrder - list of sort order information to pass to a query

setInMemorySorting

public void setInMemorySorting(Comparator<T> comparator)

Description copied from class: DataCommunicator

Sets the Comparator to use with in-memory sorting.

Overrides:

setInMemorySorting in class DataCommunicator<T>

Parameters:

comparator - comparator used to sort data

setFilter

protected <F> void setFilter(F filter)

Description copied from class: DataCommunicator

Sets the filter for this DataCommunicator. This method is used by user through the consumer method from DataCommunicator.setDataProvider(com.vaadin.data.provider.DataProvider<T, F>, F) and should not be called elsewhere.

Overrides:

setFilter in class DataCommunicator<T>

Type Parameters:

F - the filter type

Parameters:

filter - the filter