|
78
|
1 <!doctype html public "-//w3c//dtd html 4.0 transitional//en">
|
|
|
2 <html>
|
|
|
3 <head>
|
|
|
4 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
|
|
5 <meta name="Author" content="IBM">
|
|
|
6 <meta name="GENERATOR" content="Mozilla/4.5 [en] (Win98; I) [Netscape]">
|
|
|
7 <title>Package-level Javadoc</title>
|
|
|
8 </head>
|
|
|
9 <body>
|
|
|
10 Provides classes for binding observable objects, for example UI widgets and model objects.
|
|
|
11 <h2>
|
|
|
12 Package Specification</h2>
|
|
|
13 <p>
|
|
|
14 This package provides classes that can be used to synchronize state between pairs of
|
|
|
15 observable objects with optional data type conversion and validation.
|
|
|
16 <p>
|
|
|
17 A <tt>DataBindingContext</tt> is used to manage a list of <tt>Bindings</tt>
|
|
|
18 with their validation results.
|
|
|
19 </p>
|
|
|
20 <p>
|
|
|
21 Concrete subclasses of <tt>Binding</tt> synchronize state between two observables,
|
|
|
22 called the target observable and the model observable. Usually, the binding will
|
|
|
23 first copy the current state of the model observable to the target observable and
|
|
|
24 from then on track changes on both sides, reacting to changes on one side by
|
|
|
25 performing the corresponding change on the other side.
|
|
|
26 </p>
|
|
|
27 <p>
|
|
|
28 For each binding, two <tt>UpdateValueStrategy</tt> or <tt>UpdateListStrategy</tt> objects (one
|
|
|
29 for each direction) is used to control how the binding should synchronize, and can be used to
|
|
|
30 specify data type converters and validators.
|
|
|
31 </p>
|
|
|
32 <p>
|
|
|
33 <tt>AggregateValidationStatus</tt> allows clients to aggregate the current validation
|
|
|
34 statuses of a list of bindings, typically obtained from a data binding context.
|
|
|
35 </p>
|
|
|
36 <p>
|
|
|
37 For advanced validation, conversion, or similar requirements that affect the way
|
|
|
38 state is copied from one side to the other, subclasses of <tt>UpdateValueStrategy</tt>
|
|
|
39 or <tt>UpdateListStrategy</tt> can be created.
|
|
|
40 </p>
|
|
|
41 </body>
|
|
|
42 </html>
|
