summaryrefslogtreecommitdiffstats
path: root/server/src/com/vaadin/data/package.html
blob: a14ea1ac88515f6861ea399b476bb1d50215c07c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
</head>

<body bgcolor="white">

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

<h2>Data binding</h2>

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

<ul>
	<li>A {@link com.vaadin.data.Property Property} represents a
	single, typed data value.

	<li>An {@link com.vaadin.data.Item Item} embodies a set of <i>Properties</i>.
	A locally unique (inside the {@link com.vaadin.data.Item Item})
	Property identifier corresponds to each Property inside the Item.</li>
	<li>A {@link com.vaadin.data.Container 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
	{@link com.vaadin.data.Container Container} for further information.</li>
</ul>

<p>For more information on the data model, see the <a
	href="http://vaadin.com/book/-/page/datamodel.html">Data model
chapter</a> in Book of Vaadin.</p>

<h2>Buffering</h2>

<p>A {@link com.vaadin.data.Buffered Buffered} implementor is able
to track and buffer changes and commit or discard them later.</p>

<h2>Validation</h2>

<p>{@link com.vaadin.data.Validator Validator} implementations are
used to validate data, typically the value of a {@link
com.vaadin.ui.Field Field}. One or more {@link com.vaadin.data.Validator
Validators} can be added to a {@link com.vaadin.data.Validatable
Validatable} implementor and then used to validate the value of the
Validatable. </p>

<!-- Put @see and @since tags down here. -->
</body>
</html>