Package org.dellroad.stuff.vaadin7

Class SimpleContainer<T>

java.lang.Object

com.vaadin.data.util.AbstractContainer

com.vaadin.data.util.AbstractInMemoryContainer<I,String,BackedItem<T>>

org.dellroad.stuff.vaadin7.AbstractSimpleContainer<Integer,T>

org.dellroad.stuff.vaadin7.SimpleContainer<T>

Type Parameters:

T - the type of the Java objects that back each Item in the container

All Implemented Interfaces:

Container, Container.Filterable, Container.Indexed, Container.ItemSetChangeNotifier, Container.Ordered, Container.SimpleFilterable, Container.Sortable, Serializable, Connectable, PropertyExtractor<T>

public class SimpleContainer<T>
extends AbstractSimpleContainer<Integer,T>

An AbstractSimpleContainer with Integer item IDs.

Use AbstractSimpleContainer.load(java.lang.Iterable<? extends T>) to (re)load the container.

See Also:

AbstractSimpleContainer, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.vaadin.data.util.AbstractInMemoryContainer

AbstractInMemoryContainer.BaseItemAddEvent, AbstractInMemoryContainer.BaseItemRemoveEvent

Nested classes/interfaces inherited from class com.vaadin.data.util.AbstractContainer

AbstractContainer.BaseItemSetChangeEvent, AbstractContainer.BasePropertySetChangeEvent

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

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

Container.Indexed.ItemAddEvent, Container.Indexed.ItemRemoveEvent

Constructor Summary

Constructors

Modifier	Constructor	Description
	SimpleContainer()	Constructor.
	SimpleContainer(Class<? super T> type)	Constructor.
protected	SimpleContainer(Collection<? extends PropertyDef<?>> propertyDefs)	Constructor.
	SimpleContainer(PropertyExtractor<? super T> propertyExtractor)	Constructor.
	SimpleContainer(PropertyExtractor<? super T> propertyExtractor, Collection<? extends PropertyDef<?>> propertyDefs)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected Integer	generateItemId(T obj)	Create a new, unique item ID for the given object.
T	getJavaObject(Object itemId)	Get the underlying Java object corresponding to the given item ID.
protected void	resetItemIds()	Subclass hook invoked prior to each reload.

Methods inherited from class org.dellroad.stuff.vaadin7.AbstractSimpleContainer

addContainerFilter, addContainerFilter, afterReload, connect, createBackedItem, disconnect, getContainerFilters, getContainerProperty, getContainerPropertyIds, getItemIdFor, getItemIdForSame, getItemIds, getPropertyExtractor, getPropertyValue, getSortableContainerPropertyIds, getType, getUnfilteredItem, internalRemoveAllItems, load, load, removeAllContainerFilters, removeContainerFilter, removeContainerFilters, setProperties, setProperty, setPropertyExtractor, sort

Methods inherited from class com.vaadin.data.util.AbstractInMemoryContainer

addContainerProperty, addFilter, addItem, addItem, addItemAfter, addItemAfter, addItemAt, addItemAt, addItemSetChangeListener, addListener, containsId, doFilterContainer, doSort, filterAll, fireItemAdded, fireItemRemoved, fireItemsAdded, fireItemsRemoved, firstItemId, getAllItemIds, getFilteredItemIds, getFilters, getFirstVisibleItem, getIdByIndex, getItem, getItemIds, getItemSorter, getSortablePropertyIds, getVisibleItemIds, hasContainerFilters, indexOfId, internalAddItemAfter, internalAddItemAt, internalAddItemAtEnd, internalRemoveItem, isFiltered, isFirstId, isLastId, isPropertyFiltered, lastItemId, nextItemId, passesFilters, prevItemId, registerNewItem, removeAllFilters, removeAllItems, removeContainerProperty, removeFilter, removeFilters, removeItem, removeItemSetChangeListener, removeListener, setAllItemIds, setFilteredItemIds, setFilters, setItemSorter, size, sortContainer

Methods inherited from class com.vaadin.data.util.AbstractContainer

addListener, addPropertySetChangeListener, fireContainerPropertySetChange, fireContainerPropertySetChange, fireItemSetChange, fireItemSetChange, getItemSetChangeListeners, getListeners, getPropertySetChangeListeners, removeListener, removePropertySetChangeListener, setItemSetChangeListeners, setPropertySetChangeListeners

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.vaadin.data.Container

addContainerProperty, addItem, addItem, containsId, getItem, removeAllItems, removeContainerProperty, removeItem, size

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

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

Constructor Detail

SimpleContainer

public SimpleContainer()

Constructor.

After using this constructor, subsequent invocations of setPropertyExtractor() and setProperties() are required to define the properties of this container and how to extract them.

SimpleContainer

public SimpleContainer(PropertyExtractor<? super T> propertyExtractor)

Constructor.

After using this constructor, a subsequent invocation of setProperties() is required to define the properties of this container.

Parameters:

propertyExtractor - used to extract properties from the underlying Java objects; may be null but then container is not usable until one is configured via setPropertyExtractor()

SimpleContainer

protected SimpleContainer(Collection<? extends PropertyDef<?>> propertyDefs)

Constructor.

After using this constructor, a subsequent invocation of setPropertyExtractor() is required to define how to extract the properties of this container; alternately, subclasses can override getPropertyValue().

Parameters:

propertyDefs - container property definitions; null is treated like the empty set

SimpleContainer

public SimpleContainer(PropertyExtractor<? super T> propertyExtractor,
                       Collection<? extends PropertyDef<?>> propertyDefs)

Constructor.

Parameters:

propertyExtractor - used to extract properties from the underlying Java objects; may be null but then container is not usable until one is configured via setPropertyExtractor()

propertyDefs - container property definitions; null is treated like the empty set

SimpleContainer

public SimpleContainer(Class<? super T> type)

Constructor.

Properties will be determined by the @ProvidesProperty and @ProvidesPropertySort annotated methods in the given class.

Parameters:

type - class to introspect for annotated methods

Throws:

IllegalArgumentException - if type is null

IllegalArgumentException - if type has two @ProvidesProperty or @ProvidesPropertySort annotated methods for the same property

IllegalArgumentException - if a @ProvidesProperty-annotated method with no property name specified has a name which cannot be interpreted as a bean property "getter" method

See Also:

ProvidesProperty, ProvidesPropertySort, ProvidesPropertyScanner

Method Detail

getJavaObject

public T getJavaObject(Object itemId)

Description copied from class: AbstractSimpleContainer

Get the underlying Java object corresponding to the given item ID. This method ignores any filtering (i.e., filtered-out objects are still accessible).

Specified by:

getJavaObject in class AbstractSimpleContainer<Integer,T>

Parameters:

itemId - item ID

Returns:

the corresponding Java object, or null if not found

resetItemIds

protected void resetItemIds()

Description copied from class: AbstractSimpleContainer

Subclass hook invoked prior to each reload. The subclass should reset its state (e.g., issued item IDs) as required.

Specified by:

resetItemIds in class AbstractSimpleContainer<Integer,T>

generateItemId

protected Integer generateItemId(T obj)

Description copied from class: AbstractSimpleContainer

Create a new, unique item ID for the given object. This method is invoked during a reload operation, once for each container object. Both visible and filtered objects will be passed to this method.

The returned item ID must be unique, i.e., not returned by this method since the most recent invocation of AbstractSimpleContainer.resetItemIds().

Specified by:

generateItemId in class AbstractSimpleContainer<Integer,T>

Parameters:

obj - underlying container object, never null

Returns:

item ID, never null