com.vaadin.data.provider

Class ListDataProvider<T>

java.lang.Object

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

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

Type Parameters:

T - data type

All Implemented Interfaces:

ConfigurableFilterDataProvider<T,SerializablePredicate<T>,SerializablePredicate<T>>, DataProvider<T,SerializablePredicate<T>>, Serializable

public class ListDataProvider<T>
extends AbstractDataProvider<T,SerializablePredicate<T>>
implements ConfigurableFilterDataProvider<T,SerializablePredicate<T>,SerializablePredicate<T>>

DataProvider wrapper for Collections. This class does not actually handle the Query parameters.

Since:

8.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ListDataProvider(Collection<T> items) Constructs a new ListDataProvider.

Method Summary

Modifier and Type	Method and Description
void	addFilter(SerializablePredicate<T> filter) Adds a filter to be applied to all queries.
<V> void	addFilter(ValueProvider<T,V> valueProvider, SerializablePredicate<V> valueFilter) Adds a filter for an item property.
<V> void	addFilterByValue(ValueProvider<T,V> valueProvider, V requiredValue) Adds a filter that requires an item property to have a specific value.
void	addSortComparator(SerializableComparator<T> comparator) Adds a comparator to the default sorting for this data provider.
<V extends Comparable<? super V>> void	addSortOrder(ValueProvider<T,V> valueProvider, SortDirection sortDirection) Adds a property and direction to the default sorting for this data provider.
void	clearFilters() Removes any filter that has been set or added previously.
Stream<T>	fetch(Query<T,SerializablePredicate<T>> query) Fetches data from this DataProvider using given query.
<Q> DataProvider<T,Q>	filteringBy(SerializableBiPredicate<T,Q> predicate) Wraps this data provider to create a new data provider that is filtered by comparing an item to the filter value provided in the query.
<V,Q> DataProvider<T,Q>	filteringBy(ValueProvider<T,V> valueProvider, SerializableBiPredicate<V,Q> predicate) Wraps this data provider to create a new data provider that is filtered by comparing an item property value to the filter value provided in the query.
<V> DataProvider<T,V>	filteringByEquals(ValueProvider<T,V> valueProvider) Wraps this data provider to create a new data provider that is filtered by testing whether the value of a property is equals to the filter value provided in the query.
DataProvider<T,String>	filteringByPrefix(ValueProvider<T,String> valueProvider) Wraps this data provider to create a new data provider that is filtered by a string by checking whether the lower case representation of an item property value starts with the lower case representation of the filter value provided in the query.
DataProvider<T,String>	filteringByPrefix(ValueProvider<T,String> valueProvider, Locale locale) Wraps this data provider to create a new data provider that is filtered by a string by checking whether the lower case representation of an item property value starts with the lower case representation of the filter value provided in the query.
DataProvider<T,String>	filteringBySubstring(ValueProvider<T,String> valueProvider) Wraps this data provider to create a new data provider that is filtered by a string by checking whether the lower case representation of the filter value provided in the query is a substring of the lower case representation of an item property value.
DataProvider<T,String>	filteringBySubstring(ValueProvider<T,String> valueProvider, Locale locale) Wraps this data provider to create a new data provider that is filtered by a string by checking whether the lower case representation of the filter value provided in the query is a substring of the lower case representation of an item property value.
Collection<T>	getItems() Returns the underlying data items.
boolean	isInMemory() Gets whether the DataProvider content all available in memory or does it use some external backend.
void	setFilter(SerializablePredicate<T> filter) Sets a filter to be applied to all queries.
<V> void	setFilter(ValueProvider<T,V> valueProvider, SerializablePredicate<V> valueFilter) Sets a filter for an item property.
<V> void	setFilterByValue(ValueProvider<T,V> valueProvider, V requiredValue) Sets a filter that requires an item property to have a specific value.
void	setSortComparator(SerializableComparator<T> comparator) Sets the comparator to use as the default sorting for this data provider.
<V extends Comparable<? super V>> void	setSortOrder(ValueProvider<T,V> valueProvider, SortDirection sortDirection) Sets the property and direction to use as the default sorting for this data provider.
int	size(Query<T,SerializablePredicate<T>> query) Gets the amount of data in this DataProvider.

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

addDataProviderListener, addListener, fireEvent, refreshAll, refreshItem

Methods inherited from class java.lang.Object

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

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

addDataProviderListener, fromCallbacks, fromFilteringCallbacks, fromStream, getId, ofCollection, ofItems, refreshAll, refreshItem, withConfigurableFilter, withConfigurableFilter, withConvertedFilter

Constructor Detail

ListDataProvider

public ListDataProvider(Collection<T> items)

Constructs a new ListDataProvider.

No protective copy is made of the list, and changes in the provided backing Collection will be visible via this data provider. The caller should copy the list if necessary.

Parameters:

items - the initial data, not null

Method Detail

getItems

public Collection<T> getItems()

Returns the underlying data items.

Returns:

the underlying data items

fetch

public Stream<T> fetch(Query<T,SerializablePredicate<T>> query)

Description copied from interface: DataProvider

Fetches data from this DataProvider using given query.

Specified by:

fetch in interface DataProvider<T,SerializablePredicate<T>>

Parameters:

query - given query to request data

Returns:

the result of the query request: a stream of data objects, not null

isInMemory

public boolean isInMemory()

Description copied from interface: DataProvider

Gets whether the DataProvider content all available in memory or does it use some external backend.

Specified by:

isInMemory in interface DataProvider<T,SerializablePredicate<T>>

Returns:

true if all data is in memory; false if not

size

public int size(Query<T,SerializablePredicate<T>> query)

Description copied from interface: DataProvider

Gets the amount of data in this DataProvider.

Specified by:

size in interface DataProvider<T,SerializablePredicate<T>>

Parameters:

query - query with sorting and filtering

Returns:

the size of the data provider

setSortComparator

public void setSortComparator(SerializableComparator<T> comparator)

Sets the comparator to use as the default sorting for this data provider. This overrides the sorting set by any other method that manipulates the default sorting of this data provider.

The default sorting is used if the query defines no sorting. The default sorting is also used to determine the ordering of items that are considered equal by the sorting defined in the query.

Parameters:

comparator - a comparator to use, or null to clear any previously set sort order

See Also:

setSortOrder(ValueProvider, SortDirection), addSortComparator(SerializableComparator)

setSortOrder

public <V extends Comparable<? super V>> void setSortOrder(ValueProvider<T,V> valueProvider,
                                                           SortDirection sortDirection)

Sets the property and direction to use as the default sorting for this data provider. This overrides the sorting set by any other method that manipulates the default sorting of this data provider.

The default sorting is used if the query defines no sorting. The default sorting is also used to determine the ordering of items that are considered equal by the sorting defined in the query.

Parameters:

valueProvider - the value provider that defines the property do sort by, not null

sortDirection - the sort direction to use, not null

See Also:

setSortComparator(SerializableComparator), addSortOrder(ValueProvider, SortDirection)

addSortComparator

public void addSortComparator(SerializableComparator<T> comparator)

Adds a comparator to the default sorting for this data provider. If no default sorting has been defined, then the provided comparator will be used as the default sorting. If a default sorting has been defined, then the provided comparator will be used to determine the ordering of items that are considered equal by the previously defined default sorting.

The default sorting is used if the query defines no sorting. The default sorting is also used to determine the ordering of items that are considered equal by the sorting defined in the query.

Parameters:

comparator - a comparator to add, not null

See Also:

setSortComparator(SerializableComparator), addSortOrder(ValueProvider, SortDirection)

addSortOrder

public <V extends Comparable<? super V>> void addSortOrder(ValueProvider<T,V> valueProvider,
                                                           SortDirection sortDirection)

Adds a property and direction to the default sorting for this data provider. If no default sorting has been defined, then the provided sort order will be used as the default sorting. If a default sorting has been defined, then the provided sort order will be used to determine the ordering of items that are considered equal by the previously defined default sorting.

The default sorting is used if the query defines no sorting. The default sorting is also used to determine the ordering of items that are considered equal by the sorting defined in the query.

Parameters:

valueProvider - the value provider that defines the property do sort by, not null

sortDirection - the sort direction to use, not null

See Also:

setSortOrder(ValueProvider, SortDirection), addSortComparator(SerializableComparator)

setFilter

public void setFilter(SerializablePredicate<T> filter)

Sets a filter to be applied to all queries. The filter replaces any filter that has been set or added previously.

Specified by:

setFilter in interface ConfigurableFilterDataProvider<T,SerializablePredicate<T>,SerializablePredicate<T>>

Parameters:

filter - the filter to set, or null to remove any set filters

See Also:

setFilter(ValueProvider, SerializablePredicate), setFilterByValue(ValueProvider, Object), addFilter(SerializablePredicate)

addFilter

public void addFilter(SerializablePredicate<T> filter)

Adds a filter to be applied to all queries. The filter will be used in addition to any filter that has been set or added previously.

Parameters:

filter - the filter to add, not null

See Also:

addFilter(ValueProvider, SerializablePredicate), addFilterByValue(ValueProvider, Object), setFilter(SerializablePredicate)

clearFilters

public void clearFilters()

Removes any filter that has been set or added previously.

See Also:

setFilter(SerializablePredicate)

setFilter

public <V> void setFilter(ValueProvider<T,V> valueProvider,
                          SerializablePredicate<V> valueFilter)

Sets a filter for an item property. The filter replaces any filter that has been set or added previously.

Parameters:

valueProvider - value provider that gets the property value, not null

valueFilter - filter for testing the property value, not null

See Also:

setFilter(SerializablePredicate), setFilterByValue(ValueProvider, Object), addFilter(ValueProvider, SerializablePredicate)

addFilter

public <V> void addFilter(ValueProvider<T,V> valueProvider,
                          SerializablePredicate<V> valueFilter)

Adds a filter for an item property. The filter will be used in addition to any filter that has been set or added previously.

Parameters:

valueProvider - value provider that gets the property value, not null

valueFilter - filter for testing the property value, not null

See Also:

addFilter(SerializablePredicate), addFilterByValue(ValueProvider, Object), setFilter(ValueProvider, SerializablePredicate)

setFilterByValue

public <V> void setFilterByValue(ValueProvider<T,V> valueProvider,
                                 V requiredValue)

Sets a filter that requires an item property to have a specific value. The property value and the provided value are compared using Object.equals(Object). The filter replaces any filter that has been set or added previously.

Parameters:

valueProvider - value provider that gets the property value, not null

requiredValue - the value that the property must have for the filter to pass

See Also:

setFilter(SerializablePredicate), setFilter(ValueProvider, SerializablePredicate), addFilterByValue(ValueProvider, Object)

addFilterByValue

public <V> void addFilterByValue(ValueProvider<T,V> valueProvider,
                                 V requiredValue)

Adds a filter that requires an item property to have a specific value. The property value and the provided value are compared using Object.equals(Object).The filter will be used in addition to any filter that has been set or added previously.

Parameters:

valueProvider - value provider that gets the property value, not null

requiredValue - the value that the property must have for the filter to pass

See Also:

setFilterByValue(ValueProvider, Object), addFilter(SerializablePredicate), addFilter(ValueProvider, SerializablePredicate)

filteringBy

public <Q> DataProvider<T,Q> filteringBy(SerializableBiPredicate<T,Q> predicate)

Wraps this data provider to create a new data provider that is filtered by comparing an item to the filter value provided in the query.

The predicate receives the item as the first parameter and the query filter value as the second parameter, and should return true if the corresponding item should be included. The query filter value is never null – all items are included without running the predicate if the query doesn't define any filter.

Parameters:

predicate - a predicate to use for comparing the item to the query filter, not null

Returns:

a data provider that filters accordingly, not null

filteringBy

public <V,Q> DataProvider<T,Q> filteringBy(ValueProvider<T,V> valueProvider,
                                           SerializableBiPredicate<V,Q> predicate)

Wraps this data provider to create a new data provider that is filtered by comparing an item property value to the filter value provided in the query.

The predicate receives the property value as the first parameter and the query filter value as the second parameter, and should return true if the corresponding item should be included. The query filter value is never null – all items are included without running either callback if the query doesn't define any filter.

Parameters:

valueProvider - a value provider that gets the property value, not null

predicate - a predicate to use for comparing the property value to the query filter, not null

Returns:

a data provider that filters accordingly, not null

filteringByEquals

public <V> DataProvider<T,V> filteringByEquals(ValueProvider<T,V> valueProvider)

Wraps this data provider to create a new data provider that is filtered by testing whether the value of a property is equals to the filter value provided in the query. Equality is tested using Objects.equals(Object, Object).

Parameters:

valueProvider - a value provider that gets the property value, not null

Returns:

a data provider that filters accordingly, not null

filteringBySubstring

public DataProvider<T,String> filteringBySubstring(ValueProvider<T,String> valueProvider,
                                                   Locale locale)

Wraps this data provider to create a new data provider that is filtered by a string by checking whether the lower case representation of the filter value provided in the query is a substring of the lower case representation of an item property value. The filter never passes if the item property value is null.

Parameters:

valueProvider - a value provider that gets the string property value, not null

locale - the locale to use for converting the strings to lower case, not null

Returns:

a data provider that filters accordingly, not null

filteringBySubstring

public DataProvider<T,String> filteringBySubstring(ValueProvider<T,String> valueProvider)

Wraps this data provider to create a new data provider that is filtered by a string by checking whether the lower case representation of the filter value provided in the query is a substring of the lower case representation of an item property value. Conversion to lower case is done using the locale of the current UI if available, or otherwise the default locale. The filter never passes if the item property value is null.

Parameters:

valueProvider - a value provider that gets the string property value, not null

Returns:

a data provider that filters accordingly, not null

filteringByPrefix

public DataProvider<T,String> filteringByPrefix(ValueProvider<T,String> valueProvider,
                                                Locale locale)

Wraps this data provider to create a new data provider that is filtered by a string by checking whether the lower case representation of an item property value starts with the lower case representation of the filter value provided in the query. The filter never passes if the item property value is null.

Parameters:

valueProvider - a value provider that gets the string property value, not null

locale - the locale to use for converting the strings to lower case, not null

Returns:

a data provider that filters accordingly, not null

filteringByPrefix

public DataProvider<T,String> filteringByPrefix(ValueProvider<T,String> valueProvider)

Wraps this data provider to create a new data provider that is filtered by a string by checking whether the lower case representation of an item property value starts with the lower case representation of the filter value provided in the query. Conversion to lower case is done using the locale of the current UI if available, or otherwise the default locale. The filter never passes if the item property value is null.

Parameters:

valueProvider - a value provider that gets the string property value, not null

Returns:

a data provider that filters accordingly, not null