com.vaadin.data
Interface Container.Indexed

All Superinterfaces:

Container, Container.Ordered, Serializable

All Known Implementing Classes:

AbstractBeanContainer, AbstractInMemoryContainer, BeanContainer, BeanItemContainer, HierarchicalContainer, IndexedContainer, QueryContainer, SQLContainer

Enclosing interface:

Container

public static interface Container.Indexed
extends Container.Ordered

Interface for Container classes whose Items can be accessed by their position in the container.

If the container is filtered or sorted, all indices refer to the filtered and sorted view. However, the addItemAt() methods may add items that will be filtered out after addition or moved to another position based on sorting.

Nested Class Summary

Nested classes/interfaces inherited from interface com.vaadin.data.Container

Container.Editor, Container.Filter, Container.Filterable, Container.Hierarchical, Container.Indexed, Container.ItemSetChangeEvent, Container.ItemSetChangeListener, Container.ItemSetChangeNotifier, Container.Ordered, Container.PropertySetChangeEvent, Container.PropertySetChangeListener, Container.PropertySetChangeNotifier, Container.SimpleFilterable, Container.Sortable, Container.Viewer

Method Summary

Object	addItemAt(int index) Adds a new item at given index (in the filtered view).
Item	addItemAt(int index, Object newItemId) Adds a new item at given index (in the filtered view).
Object	getIdByIndex(int index) Gets the ID of an Item by an index number.
int	indexOfId(Object itemId) Gets the index of the Item corresponding to the itemId.

Methods inherited from interface com.vaadin.data.Container.Ordered

addItemAfter, addItemAfter, firstItemId, isFirstId, isLastId, lastItemId, nextItemId, prevItemId

Methods inherited from interface com.vaadin.data.Container

addContainerProperty, addItem, addItem, containsId, getContainerProperty, getContainerPropertyIds, getItem, getItemIds, getType, removeAllItems, removeContainerProperty, removeItem, size

Method Detail

indexOfId

int indexOfId(Object itemId)

Gets the index of the Item corresponding to the itemId. The following is true for the returned index: 0 <= index < size(), or index = -1 if there is no visible item with that id in the container.

Parameters:

itemId - ID of an Item in the Container

Returns:

index of the Item, or -1 if (the filtered and sorted view of) the Container does not include the Item

getIdByIndex

Object getIdByIndex(int index)

Gets the ID of an Item by an index number.

Parameters:

index - Index of the requested id in (the filtered and sorted view of) the Container

Returns:

ID of the Item in the given index

addItemAt

Object addItemAt(int index)
                 throws UnsupportedOperationException

Adds a new item at given index (in the filtered view).

The indices of the item currently in the given position and all the following items are incremented.

This method should apply filters to the added item after inserting it, possibly hiding it immediately. If the container is being sorted, the item may be added at the correct sorted position instead of the given position. See Container.Indexed, Container.Ordered, Container.SimpleFilterable and Container.Sortable for more information.

Parameters:

index - Index (in the filtered and sorted view) to add the new item.

Returns:

item id of the created item or null if the operation fails.

Throws:

UnsupportedOperationException - if the operation is not supported by the container

addItemAt

Item addItemAt(int index,
               Object newItemId)
               throws UnsupportedOperationException

Adds a new item at given index (in the filtered view).

The indexes of the item currently in the given position and all the following items are incremented.

This method should apply filters to the added item after inserting it, possibly hiding it immediately. If the container is being sorted, the item may be added at the correct sorted position instead of the given position. See Container.Indexed, Container.SimpleFilterable and Container.Sortable for more information.

Parameters:

index - Index (in the filtered and sorted view) at which to add the new item.

newItemId - Id of the new item to be added.

Returns:

new Item or null if the operation fails.

Throws:

UnsupportedOperationException - if the operation is not supported by the container