com.vaadin.data.HasItems Maven / Gradle / Ivy
/*
* Copyright (C) 2000-2024 Vaadin Ltd
*
* This program is available under Vaadin Commercial License and Service Terms.
*
* See for the full
* license.
*/
package com.vaadin.data;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
import java.util.stream.Collectors;
import java.util.stream.Stream;
import com.vaadin.data.provider.BackEndDataProvider;
import com.vaadin.data.provider.DataProvider;
import com.vaadin.data.provider.ListDataProvider;
import com.vaadin.ui.Component;
/**
* A component that displays a collection of items.
*
* @author Vaadin Ltd
*
* @since 8.0
*
* @param
* the type of the displayed item
*/
public interface HasItems extends Component {
/**
* Returns the source of data items used by this listing.
*
* @return the data provider, not null
*/
public DataProvider getDataProvider();
/**
* Sets the data items of this component provided as a collection.
*
* The provided items are wrapped into a {@link ListDataProvider} and this
* instance is used as a data provider for the
* {@link HasDataProvider#setDataProvider(DataProvider)} method. It means
* that the items collection can be accessed later on via
* {@link ListDataProvider#getItems()}:
*
*
*
* HasDataProvider<String> listing = new CheckBoxGroup<>();
* listing.setItems(Arrays.asList("a","b"));
* ...
*
* Collection<String> collection = ((ListDataProvider<String>)listing.getDataProvider()).getItems();
*
*
*
* The provided collection instance may be used as-is. Subsequent
* modification of the collection might cause inconsistent data to be shown
* in the component unless it is explicitly instructed to read the data
* again.
*
* @param items
* the data items to display, not null
*
*/
public void setItems(Collection items);
/**
* Sets the data items of this listing.
*
* The provided items are wrapped into a {@link ListDataProvider} and this
* instance is used as a data provider for the
* {@link HasDataProvider#setDataProvider(DataProvider)} method. It means that the items
* collection can be accessed later on via
* {@link ListDataProvider#getItems()}:
*
*
*
* HasDataProvider<String> listing = new CheckBoxGroup<>();
* listing.setItems("a","b");
* ...
*
* Collection<String> collection = ((ListDataProvider<String>)listing.getDataProvider()).getItems();
*
*
*
*
* @see #setItems(Collection)
*
* @param items
* the data items to display
*/
public default void setItems(@SuppressWarnings("unchecked") T... items) {
setItems(new ArrayList<>(Arrays.asList(items)));
}
/**
* Sets the data items of this listing provided as a stream.
*
* This is just a shorthand for {@link #setItems(Collection)}, that
* collects objects in the stream to a list. Thus, using this method,
* instead of its array and Collection variations, doesn't save any memory.
* If you have a large data set to bind, using a lazy data provider is
* recommended. See {@link BackEndDataProvider} for more info.
*
* The provided items are wrapped into a {@link ListDataProvider} and this
* instance is used as a data provider for the
* {@link HasDataProvider#setDataProvider(DataProvider)} method. It means that the items
* collection can be accessed later on via
* {@link ListDataProvider#getItems()}:
*
*
*
* HasDataProvider<String> listing = new CheckBoxGroup<>();
* listing.setItems(Stream.of("a","b"));
* ...
*
* Collection<String> collection = ((ListDataProvider<String>)listing.getDataProvider()).getItems();
*
*
*
*
* @see #setItems(Collection)
*
* @param streamOfItems
* the stream of data items to display, not {@code null}
*/
public default void setItems(Stream streamOfItems) {
setItems(streamOfItems.collect(Collectors.toList()));
}
}