Class ComboBoxListDataView<T>

Constructor Detail

• ComboBoxListDataView

  public ComboBoxListDataView(DataCommunicator<T> dataCommunicator,
                              ComboBox<T> comboBox,
                              SerializableBiConsumer<SerializablePredicate<T>,SerializableComparator<T>> filterOrSortingChangedCallback)

  Creates a new instance of ComboBox in-memory data view and verifies the passed data provider is compatible with this data view implementation.

  Parameters:

  dataCommunicator - the data communicator of the ComboBox, not null

  comboBox - the ComboBox component, not null

  filterOrSortingChangedCallback - callback, which is being invoked when the ComboBox's filtering or sorting changes, not null

Method Detail

• getItems

  public Stream<T> getItems()

  Gets the items available on the ComboBox's server-side.

  Data is sorted the same way as in the ComboBox, but it does not take into account the ComboBox client-side filtering, since it doesn't change the item count on the server-side, but only makes it easier for users to search through the items in the UI. Only the server-side filtering considered, which is set by: setFilter(SerializablePredicate) or addFilter(SerializablePredicate).

  Specified by:

  getItems in interface DataView<T>

  Overrides:

  getItems in class AbstractListDataView<T>

  Returns:

  filtered and sorted items available in server-side

• getItemCount

  public int getItemCount()

  Get the full item count with filters if any set. As the item count might change at any point, it is recommended to add a listener with the DataView.addItemCountChangeListener(ComponentEventListener) method instead to get notified when the item count has changed.

  This method takes into account only the server-side filtering, which is set by: setFilter(SerializablePredicate) or addFilter(SerializablePredicate). ComboBox's client-side filter is not considered, since it doesn't change the item count on the server-side, but only makes it easier for users to search through the items in the UI.

  Specified by:

  getItemCount in interface ListDataView<T,AbstractListDataView<T>>

  Overrides:

  getItemCount in class AbstractListDataView<T>

  Returns:

  filtered item count

  See Also:

  DataView.addItemCountChangeListener(ComponentEventListener)

• setIdentifierProvider

  public void setIdentifierProvider(IdentifierProvider<T> identifierProvider)

  Description copied from interface: DataView

  Sets an identifier provider, which returns an identifier for the given item. The identifier is used for comparing the equality of items. Usage example: dataView.setIdentifiedProvider(Item::getId);.

  Specified by:

  setIdentifierProvider in interface DataView<T>

  Overrides:

  setIdentifierProvider in class AbstractDataView<T>

  Parameters:

  identifierProvider - function that returns the non-null identifier for a given item

• addItemCountChangeListener

  public Registration addItemCountChangeListener(ComponentEventListener<ItemCountChangeEvent<?>> listener)

  Add an item count change listener that is fired when the item count changes. This can happen for instance when filtering the items.

  Item count change listener is bound to the component and will be retained even if the data changes by setting of a new items or DataProvider to component.

  NOTE: when the component supports lazy loading (implements HasLazyDataView) and a count callback has not been provided, an estimate of the item count is used and increased until the actual count has been reached. When the estimate is used, the event is fired with the ItemCountChangeEvent.isItemCountEstimated() returning true.

  Combo box fires ItemCountChangeEvent and notifies all the listeners added by this method, if the items count changed due to adding or removing an item(s), or by changing the server-side filtering with setFilter(SerializablePredicate) or addFilter(SerializablePredicate).

  ComboBox's client-side filter change won't fire ItemCountChangeEvent, since it doesn't change the item count on the server-side, but only makes it easier for users to search through the items in the UI.

  Specified by:

  addItemCountChangeListener in interface DataView<T>

  Overrides:

  addItemCountChangeListener in class AbstractDataView<T>

  Parameters:

  listener - item count change listener to register

  Returns:

  registration for removing the listener

• addFilter

  public ComboBoxListDataView<T> 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 through setFilter(com.vaadin.flow.function.SerializablePredicate<T>) or addFilter(com.vaadin.flow.function.SerializablePredicate<T>). This filter is applied to data set permanently until it's changed through setFilter(com.vaadin.flow.function.SerializablePredicate<T>) or removeFilters(), in contrary with the client-side filter that can be typed in by user and does not modify the data set on server-side, but only defines which items are shown for a single request and erases on drop down close.

  This filter is bound to the component. Thus, any other component using the same DataProvider object would not be affected by setting a filter through data view of another component. A filter set by this method won't be retained when a new DataProvider is set to the component.

  Specified by:

  addFilter in interface ListDataView<T,AbstractListDataView<T>>

  Overrides:

  addFilter in class AbstractListDataView<T>

  Parameters:

  filter - the filter to add, not null

  Returns:

  ComboBoxListDataView instance

  See Also:

  setFilter(SerializablePredicate), removeFilters()

• removeFilters

  public ComboBoxListDataView<T> removeFilters()

  Removes all in-memory filters set or added.

  Specified by:

  removeFilters in interface ListDataView<T,AbstractListDataView<T>>

  Overrides:

  removeFilters in class AbstractListDataView<T>

  Returns:

  ComboBoxListDataView instance

  See Also:

  addFilter(SerializablePredicate), setFilter(SerializablePredicate)

• setFilter

  public ComboBoxListDataView<T> setFilter(SerializablePredicate<T> filter)

  Sets a filter to be applied to the data. The filter replaces any filter that has been set or added previously. null will clear all filters. This filter is applied to data set permanently until it's changed through setFilter(com.vaadin.flow.function.SerializablePredicate<T>) or removeFilters(), in contrary with the client-side filter that can be typed in by user and does not modify the data set on server-side, but only defines which items are shown for a single request and erases on drop down close.

  This filter is bound to the component. Thus, any other component using the same DataProvider object would not be affected by setting a filter through data view of another component. A filter set by this method won't be retained when a new DataProvider is set to the component.

  Specified by:

  setFilter in interface ListDataView<T,AbstractListDataView<T>>

  Overrides:

  setFilter in class AbstractListDataView<T>

  Parameters:

  filter - filter to be set, or null to clear any previously set filters

  Returns:

  ComboBoxListDataView instance

  See Also:

  addFilter(SerializablePredicate), removeFilters()