io.jmix.ui.model

Interface CollectionContainer<E>

All Superinterfaces:

InstanceContainer<E>

All Known Subinterfaces:

CollectionPropertyContainer<E>, KeyValueCollectionContainer

All Known Implementing Classes:

CollectionContainerImpl, CollectionPropertyContainerImpl, KeyValueCollectionContainerImpl

public interface CollectionContainer<E>
extends InstanceContainer<E>

Container that holds a collection of entity instances.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	CollectionContainer.CollectionChangeEvent<T> Event sent on changes in the container items collection - adding, removing, replacing elements.
static class	CollectionContainer.UnmuteEventsMode

Nested classes/interfaces inherited from interface io.jmix.ui.model.InstanceContainer

InstanceContainer.ItemChangeEvent<T>, InstanceContainer.ItemPropertyChangeEvent<T>

Method Summary

Modifier and Type	Method and Description
io.jmix.core.common.event.Subscription	addCollectionChangeListener(java.util.function.Consumer<CollectionContainer.CollectionChangeEvent<E>> listener) Adds listener to CollectionContainer.CollectionChangeEvent.
boolean	containsItem(java.lang.Object entityOrId) Returns true if the given entity exists in the container.
E	getItem(java.lang.Object entityId) Returns entity by its id.
int	getItemIndex(java.lang.Object entityOrId) Returns the index in the items list of the given entity or -1 if there is no such entity.
E	getItemOrNull(java.lang.Object entityId) Returns entity by its id or null if the container doesn't have an entity with the given id.
java.util.List<E>	getItems() Returns immutable list of contained entities.
java.util.List<E>	getMutableItems() Returns mutable list of contained entities.
Sorter	getSorter() Returns sorter object currently set for the container.
void	replaceItem(E entity) If the item with the same id exists in the container, it is replaced with the given instance.
void	setItems(java.util.Collection<E> entities) Sets a collection of entities to the container.
void	setSorter(Sorter sorter) Sets sorter object.
void	unmute(CollectionContainer.UnmuteEventsMode mode) Enables all event listeners.

Methods inherited from interface io.jmix.ui.model.InstanceContainer

addItemChangeListener, addItemPropertyChangeListener, getEntityMetaClass, getFetchPlan, getItem, getItemOrNull, getView, mute, setFetchPlan, setItem, setView, unmute

Method Detail

getItems

java.util.List<E> getItems()

Returns immutable list of contained entities.

setItems

void setItems(@Nullable
              java.util.Collection<E> entities)

Sets a collection of entities to the container.

getMutableItems

java.util.List<E> getMutableItems()

Returns mutable list of contained entities. Changes in the list produce CollectionContainer.CollectionChangeEvent.

getItem

E getItem(java.lang.Object entityId)

Returns entity by its id.

Throws:

java.lang.IllegalArgumentException - if the container doesn't have an entity with the given id

getItemOrNull

@Nullable
E getItemOrNull(java.lang.Object entityId)

Returns entity by its id or null if the container doesn't have an entity with the given id.

getItemIndex

int getItemIndex(java.lang.Object entityOrId)

Returns the index in the items list of the given entity or -1 if there is no such entity.

Parameters:

entityOrId - entity instance or its id

containsItem

boolean containsItem(java.lang.Object entityOrId)

Returns true if the given entity exists in the container.

Parameters:

entityOrId - entity instance or its id

replaceItem

void replaceItem(E entity)

If the item with the same id exists in the container, it is replaced with the given instance. If not, the given instance is added to the items list.

Sends CollectionContainer.CollectionChangeEvent of the SET_ITEM or ADD_ITEMS type.

getSorter

@Nullable
Sorter getSorter()

Returns sorter object currently set for the container.

setSorter

void setSorter(Sorter sorter)

Sets sorter object.

unmute

void unmute(CollectionContainer.UnmuteEventsMode mode)

Enables all event listeners. Events fired on this call depend on the passed mode.

Parameters:

mode - mode

addCollectionChangeListener

io.jmix.core.common.event.Subscription addCollectionChangeListener(java.util.function.Consumer<CollectionContainer.CollectionChangeEvent<E>> listener)

Adds listener to CollectionContainer.CollectionChangeEvent.