Package com.vaadin.data

Contains interfaces for the data layer, mainly for binding typed data and data collections to components, and for validating data.

Data binding

The package contains a three-tiered structure for typed data objects and collections of them:

• A Property represents a single, typed data value.
• An Item embodies a set of Properties. A locally unique (inside the Item) Property identifier corresponds to each Property inside the Item.
• A Container contains a set of Items, each corresponding to a locally unique Item identifier. Note that Container imposes a few restrictions on the data stored in it, see Container for further information.

For more information on the data model, see the Data model chapter in Book of Vaadin.

Buffering

A Buffered implementor is able to track and buffer changes and commit or discard them later.

Validation

Validator implementations are used to validate data, typically the value of a Field. One or more Validators can be added to a Validatable implementor and then used to validate the value of the Validatable.

Interface Summary

Interface	Description
Buffered	Defines the interface to commit and discard changes to an object, supporting buffering.
BufferedValidatable	This interface defines the combination of Validatable and Buffered interfaces.
Collapsible	Container needed by large lazy loading hierarchies displayed e.g.
Container	A specialized set of identified Items.
Container.Editor	Interface implemented by the editor classes supporting editing the Container.
Container.Filter	Filter interface for container filtering.
Container.Filterable	Interface that is implemented by containers which allow reducing their visible contents based on a set of filters.
Container.Hierarchical	Interface for Container classes whose Items can be arranged hierarchically.
Container.Indexed	Interface for Container classes whose Items can be accessed by their position in the container.
Container.Indexed.ItemAddEvent	An Event object specifying information about the added items.
Container.Indexed.ItemRemoveEvent	An Event object specifying information about the removed items.
Container.ItemSetChangeEvent	An Event object specifying the Container whose Item set has changed (items added, removed or reordered).
Container.ItemSetChangeListener	Container Item set change listener interface.
Container.ItemSetChangeNotifier	The interface for adding and removing ItemSetChangeEvent listeners.
Container.Ordered	Interface for Container classes whose Items can be traversed in order.
Container.PropertySetChangeEvent	An Event object specifying the Container whose Property set has changed.
Container.PropertySetChangeListener	The listener interface for receiving PropertySetChangeEvent objects.
Container.PropertySetChangeNotifier	The interface for adding and removing PropertySetChangeEvent listeners.
Container.SimpleFilterable	Interface that is implemented by containers which allow reducing their visible contents based on a set of filters.
Container.Sortable	Interface for Container classes whose Items can be sorted.
Container.Viewer	Interface implemented by viewer classes capable of using a Container as a data source.
Item	Provides a mechanism for handling a set of Properties, each associated to a locally unique non-null identifier.
Item.Editor	Interface implemented by the Editor classes capable of editing the Item.
Item.PropertySetChangeEvent	An Event object specifying the Item whose contents has been changed through the Property interface.
Item.PropertySetChangeListener	The listener interface for receiving PropertySetChangeEvent objects.
Item.PropertySetChangeNotifier	The interface for adding and removing PropertySetChangeEvent listeners.
Item.Viewer	Interface implemented by viewer classes capable of using an Item as a data source.
Property<T>	The Property is a simple data object that contains one typed value.
Property.Editor	Interface implemented by the editor classes capable of editing the Property.
Property.ReadOnlyStatusChangeEvent	An Event object specifying the Property whose read-only status has been changed.
Property.ReadOnlyStatusChangeListener	The listener interface for receiving ReadOnlyStatusChangeEvent objects.
Property.ReadOnlyStatusChangeNotifier	The interface for adding and removing ReadOnlyStatusChangeEvent listeners.
Property.Transactional<T>	A Property that is capable of handle a transaction that can end in commit or rollback.
Property.ValueChangeEvent	An Event object specifying the Property whose value has been changed.
Property.ValueChangeListener	The listener interface for receiving ValueChangeEvent objects.
Property.ValueChangeNotifier	The interface for adding and removing ValueChangeEvent listeners.
Property.Viewer	Interface implemented by the viewer classes capable of using a Property as a data source.
Validatable	Interface for validatable objects.
Validator	Interface that implements a method for validating if an Object is valid or not.

Class Summary

Class	Description
ContainerHelpers	Contains helper methods for containers that can be used to ease development of containers in Vaadin.

Exception Summary

Exception	Description
Buffered.SourceException	An exception that signals that one or more exceptions occurred while a buffered object tried to access its data source or if there is a problem in processing a data source.
Property.ReadOnlyException	Exception object that signals that a requested Property modification failed because it's in read-only mode.
Validator.EmptyValueException	A specific type of Validator.InvalidValueException that indicates that validation failed because the value was empty.
Validator.InvalidValueException	Exception that is thrown by a Validator when a value is invalid.