com.vaadin.data.provider

Class DataCommunicator<T>

java.lang.Object

com.vaadin.server.AbstractClientConnector

com.vaadin.server.AbstractExtension

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

Type Parameters:

T - the bean type

All Implemented Interfaces:

MethodEventSource, ClientConnector, Extension, Connector, Serializable

public class DataCommunicator<T>
extends AbstractExtension

DataProvider base class. This class is the base for all DataProvider communication implementations. It uses DataGenerators to write JsonObjects representing each data object to be sent to the client-side.

Since:

8.0

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	DataCommunicator.ActiveDataHandler A class for handling currently active data and dropping data that is no longer needed.
protected class	DataCommunicator.SimpleDataRequestRpc Simple implementation of collection data provider communication.

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

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

Constructor Summary

Constructors

Constructor and Description
DataCommunicator()

Method Summary

Modifier and Type	Method and Description
void	addDataGenerator(DataGenerator<T> generator) Adds a data generator to this data communicator.
void	attach() Notifies the connector that it is connected to a VaadinSession (and therefore also to a UI).
void	beforeClientResponse(boolean initial) Initially and in the case of a reset all data should be pushed to the client.
protected DataKeyMapper<T>	createKeyMapper() Creates a DataKeyMapper to use with this DataCommunicator.
protected DataRequestRpc	createRpc() Creates a DataRequestRpc used with this DataCommunicator.
void	detach() Notifies the connector that it is detached from its VaadinSession.
protected elemental.json.JsonObject	getDataObject(T data) Creates the JsonObject for given data object.
DataProvider<T,?>	getDataProvider() Gets the current data provider from this DataCommunicator.
DataKeyMapper<T>	getKeyMapper() Gets the DataKeyMapper used by this DataCommunicator.
int	getMinPushSize() Get minimum size of data which will be sent to the client when data source is set.
protected DataCommunicatorState	getState() Returns the shared state for this connector.
protected DataCommunicatorState	getState(boolean markAsDirty) Returns the shared state for this connector.
protected void	pushData(int firstIndex, Stream<T> data) Sends given collection of data objects to the client-side.
void	refresh(T data) Informs the DataProvider that a data object has been updated.
void	removeDataGenerator(DataGenerator<T> generator) Removes a data generator from this data communicator.
void	reset() Informs the DataProvider that the collection has changed.
void	setBackEndSorting(List<QuerySortOrder> sortOrder) Sets the QuerySortOrders to use with backend sorting.
<F> SerializableConsumer<F>	setDataProvider(DataProvider<T,F> dataProvider, F initialFilter) Sets the current data provider for this DataCommunicator.
void	setInMemorySorting(Comparator<T> comparator) Sets the Comparator to use with in-memory sorting.
void	setMinPushSize(int size) Set minimum size of data which will be sent to the client when data source is set.

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

DataCommunicator

public DataCommunicator()

Method Detail

attach

public void attach()

Description copied from interface: ClientConnector

Notifies the connector that it is connected to a VaadinSession (and therefore also to a UI).

The caller of this method is #setParent(ClientConnector) if the parent is itself already attached to the session. If not, the parent will call the ClientConnector.attach() for all its children when it is attached to the session. This method is always called before the connector's data is sent to the client-side for the first time.

The attachment logic is implemented in AbstractClientConnector.

Specified by:

attach in interface ClientConnector

Overrides:

attach in class AbstractClientConnector

detach

public void detach()

Description copied from class: AbstractClientConnector

Notifies the connector that it is detached from its VaadinSession.

The caller of this method is #setParent(ClientConnector) if the parent is in the session. When the parent is detached from the session it is its responsibility to call ClientConnector.detach() for each of its children.

The AbstractClientConnector.getSession() and AbstractClientConnector.getUI() methods might return null after this method is called.

Specified by:

detach in interface ClientConnector

Overrides:

detach in class AbstractClientConnector

beforeClientResponse

public void beforeClientResponse(boolean initial)

Initially and in the case of a reset all data should be pushed to the client.

Specified by:

beforeClientResponse in interface ClientConnector

Overrides:

beforeClientResponse in class AbstractClientConnector

Parameters:

initial - true if the client-side connector will be created and initialized after this method has been invoked. false if there is already an initialized client-side connector.

addDataGenerator

public void addDataGenerator(DataGenerator<T> generator)

Adds a data generator to this data communicator. Data generators can be used to insert custom data to the rows sent to the client. If the data generator is already added, does nothing.

Parameters:

generator - the data generator to add, not null

removeDataGenerator

public void removeDataGenerator(DataGenerator<T> generator)

Removes a data generator from this data communicator. If there is no such data generator, does nothing.

Parameters:

generator - the data generator to remove, not null

getKeyMapper

public DataKeyMapper<T> getKeyMapper()

Gets the DataKeyMapper used by this DataCommunicator. Key mapper can be used to map keys sent to the client-side back to their respective data objects.

Returns:

key mapper

pushData

protected void pushData(int firstIndex,
                        Stream<T> data)

Sends given collection of data objects to the client-side.

Parameters:

firstIndex - first index of pushed data

data - data objects to send as an iterable

getDataObject

protected elemental.json.JsonObject getDataObject(T data)

Creates the JsonObject for given data object. This method calls all data generators for it.

Parameters:

data - data object to be made into a json object

Returns:

json object representing the data object

reset

public void reset()

Informs the DataProvider that the collection has changed.

refresh

public void refresh(T data)

Informs the DataProvider that a data object has been updated.

Parameters:

data - updated data object

setInMemorySorting

public void setInMemorySorting(Comparator<T> comparator)

Sets the Comparator to use with in-memory sorting.

Parameters:

comparator - comparator used to sort data

setBackEndSorting

public void setBackEndSorting(List<QuerySortOrder> sortOrder)

Sets the QuerySortOrders to use with backend sorting.

Parameters:

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

createKeyMapper

protected DataKeyMapper<T> createKeyMapper()

Creates a DataKeyMapper to use with this DataCommunicator.

This method is called from the constructor.

Returns:

key mapper

createRpc

protected DataRequestRpc createRpc()

Creates a DataRequestRpc used with this DataCommunicator.

This method is called from the constructor.

Returns:

data request rpc implementation

getDataProvider

public DataProvider<T,?> getDataProvider()

Gets the current data provider from this DataCommunicator.

Returns:

the data provider

setDataProvider

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

Sets the current data provider for this DataCommunicator.

The returned consumer can be used to set some other filter value that should be included in queries sent to the data provider. It is only valid until another data provider is set.

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

setMinPushSize

public void setMinPushSize(int size)

Set minimum size of data which will be sent to the client when data source is set.

Server doesn't send all data from data source to the client. It sends some initial chunk of data (whose size is determined as minimum between size parameter of this method and data size). Client decides whether it is able to show more data and request server to send more data (next chunk).

When component is disabled then client cannot communicate to the server side (by design, because of security reasons). It means that client will get only initial chunk of data whose size is set here.

Parameters:

size - the size of initial data to send to the client

getMinPushSize

public int getMinPushSize()

Get minimum size of data which will be sent to the client when data source is set.

Returns:

current minimum push size of initial data chunk which is sent to the client when data source is set

See Also:

setMinPushSize(int)

getState

protected DataCommunicatorState getState(boolean markAsDirty)

Description copied from class: AbstractClientConnector

Returns the shared state for this connector.

Overrides:

getState in class AbstractClientConnector

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

getState

protected DataCommunicatorState 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 AbstractClientConnector

Returns:

The shared state for this connector. Never null.