Interface that is implemented by containers which allow reducing their visible contents based on a set of filters. This interface has been renamed from {@link Filterable}, and implementing the new {@link Filterable} instead of or in addition to {@link SimpleFilterable}is recommended. This interface might be removed in future Vaadin versions.
When a set of filters are set, only items that match all the filters are included in the visible contents of the container. Still new items that do not match filters can be added to the container. Multiple filters can be added and the container remembers the state of the filters. When multiple filters are added, all filters must match for an item to be visible in the container.
When an {@link Ordered} or {@link Indexed} container is filtered, alloperations of these interfaces should only use the filtered contents and the filtered indices to the container.
How filtering is performed when a {@link Hierarchical} containerimplements {@link SimpleFilterable} is implementation specific and shouldbe documented in the implementing class.
Adding items (if supported) to a filtered {@link Ordered} or{@link Indexed} container should insert them immediately after theindicated visible item. The unfiltered position of items added at index 0, at index {@link com.vaadin.data.Container#size()} or at an undefinedposition is up to the implementation.
The functionality of SimpleFilterable can be implemented using the {@link Filterable} API and {@link SimpleStringFilter}.
@since 5.0 (renamed from Filterable to SimpleFilterable in 6.6)