com.vaadin.fluent.api

Interface FluentHasItems<THIS extends FluentHasItems<THIS,ITEM>,ITEM>

Type Parameters:

THIS - Self-referential generic THIS

ITEM - The item type in the listing

All Superinterfaces:

com.vaadin.server.ClientConnector, com.vaadin.ui.Component, com.vaadin.shared.Connector, FluentComponent<THIS>, FluentSizeable<THIS>, com.vaadin.data.HasItems<ITEM>, Serializable, com.vaadin.server.Sizeable

All Known Subinterfaces:

FluentAbstractListing<THIS,ITEM>, FluentAbstractMultiSelect<THIS,VALUE>, FluentAbstractSingleSelect<THIS,VALUE>, FluentCheckBoxGroup<THIS,VALUE>, FluentComboBox<THIS,ITEM>, FluentGrid<THIS,ITEM>, FluentHasDataProvider<THIS,ITEM>, FluentHasFilterableDataProvider<THIS,ITEM,FILTER>, FluentHasHierarchicalDataProvider<THIS,ITEM>, FluentListSelect<THIS,ITEM>, FluentNativeSelect<THIS,ITEM>, FluentRadioButtonGroup<THIS,ITEM>, FluentTree<THIS,ITEM>, FluentTreeGrid<THIS,ITEM>, FluentTwinColSelect<THIS,ITEM>

All Known Implementing Classes:

FCheckBoxGroup, FComboBox, FGrid, FListSelect, FNativeSelect, FRadioButtonGroup, FTree, FTreeGrid, FTwinColSelect

public interface FluentHasItems<THIS extends FluentHasItems<THIS,ITEM>,ITEM>
extends com.vaadin.data.HasItems<ITEM>, FluentComponent<THIS>

The base interface for fluent versions of HasItems

See Also:

HasItems

Nested Class Summary

Nested classes/interfaces inherited from interface com.vaadin.fluent.api.FluentComponent

FluentComponent.FluentFocusable<C extends FluentComponent.FluentFocusable<C>>

Nested classes/interfaces inherited from interface com.vaadin.ui.Component

com.vaadin.ui.Component.ErrorEvent, com.vaadin.ui.Component.Event, com.vaadin.ui.Component.Focusable, com.vaadin.ui.Component.Listener

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

com.vaadin.server.ClientConnector.AttachEvent, com.vaadin.server.ClientConnector.AttachListener, com.vaadin.server.ClientConnector.ConnectorErrorEvent, com.vaadin.server.ClientConnector.DetachEvent, com.vaadin.server.ClientConnector.DetachListener

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

com.vaadin.server.Sizeable.Unit

Field Summary

Fields inherited from interface com.vaadin.server.Sizeable

SIZE_UNDEFINED, UNITS_CM, UNITS_EM, UNITS_EX, UNITS_INCH, UNITS_MM, UNITS_PERCENTAGE, UNITS_PICAS, UNITS_PIXELS, UNITS_POINTS

Method Summary

Modifier and Type	Method and Description
default THIS	withItems(Collection<ITEM> items) Sets the data items of this component provided as a collection.
default THIS	withItems(ITEM... items) Sets the data items of this listing.
default THIS	withItems(Stream<ITEM> streamOfItems) Sets the data items of this listing provided as a stream.

Methods inherited from interface com.vaadin.data.HasItems

getDataProvider, setItems, setItems, setItems

Methods inherited from interface com.vaadin.fluent.api.FluentComponent

withCaption, withEnabled, withIcon, withId, withParent, withPrimaryStyleName, withStyleName, withStyleName, withVisible

Methods inherited from interface com.vaadin.ui.Component

addListener, addStyleName, addStyleNames, attach, getCaption, getDescription, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getStyleName, getUI, isEnabled, isVisible, readDesign, removeListener, removeStyleName, removeStyleNames, setCaption, setEnabled, setIcon, setId, setParent, setPrimaryStyleName, setStyleName, setVisible, writeDesign

Methods inherited from interface com.vaadin.server.ClientConnector

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

Methods inherited from interface com.vaadin.shared.Connector

getConnectorId

Methods inherited from interface com.vaadin.fluent.api.FluentSizeable

withFullHeight, withFullSize, withFullWidth, withHeight, withHeight, withSize, withUndefinedHeight, withUndefinedSize, withUndefinedWidth, withWidth, withWidth

Methods inherited from interface com.vaadin.server.Sizeable

getHeight, getHeightUnits, getWidth, getWidthUnits, setHeight, setHeight, setHeightUndefined, setSizeFull, setSizeUndefined, setWidth, setWidth, setWidthUndefined

Method Detail

withItems

default THIS withItems(Collection<ITEM> items)

Sets the data items of this component provided as a collection.

The provided items are wrapped into a ListDataProvider and this instance is used as a data provider for the setDataProvider(DataProvider) method. It means that the items collection can be accessed later on via 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.

Parameters:

items - the data items to display, not null

Returns:

this for method chaining

See Also:

HasItems.setItems(Collection)

withItems

default THIS withItems(ITEM... items)

Sets the data items of this listing.

The provided items are wrapped into a ListDataProvider and this instance is used as a data provider for the setDataProvider(DataProvider) method. It means that the items collection can be accessed later on via ListDataProvider.getItems():

 
 HasDataProvider<String> listing = new CheckBoxGroup<>();
 listing.setItems("a","b");
 ...

 Collection<String> collection = ((ListDataProvider<String>)listing.getDataProvider()).getItems();
 
 

Parameters:

items - the data items to display

Returns:

this for method chaining

See Also:

HasItems.setItems(Object...)

withItems

default THIS withItems(Stream<ITEM> streamOfItems)

Sets the data items of this listing provided as a stream.

This is just a shorthand for HasItems.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 BackEndDataProvider for more info.

The provided items are wrapped into a ListDataProvider and this instance is used as a data provider for the setDataProvider(DataProvider) method. It means that the items collection can be accessed later on via ListDataProvider.getItems():

 
 HasDataProvider<String> listing = new CheckBoxGroup<>();
 listing.setItems(Stream.of("a","b"));
 ...

 Collection<String> collection = ((ListDataProvider<String>)listing.getDataProvider()).getItems();
 
 

Parameters:

streamOfItems - the stream of data items to display, not null

Returns:

this for method chaining

See Also:

HasItems.setItems(Stream)