Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.
View | Details | Raw Unified | Return to bug 194734 | Differences between
and this patch

Collapse All | Expand All

(-)src/org/eclipse/core/databinding/property/package.html (+35 lines)
Added Link Here
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="Matthew Hall">
6 
   <title>Package-level Javadoc</title>
7 
</head>
8 
<body>
9 
Interfaces and classes for representing and observing properties of objects.
10 
<h2>
11 
Package Specification</h2>
12 
<p>
13 
This package and its subpackages provide the <tt>IProperty</tt>,
14 
<tt>IValueProperty</tt>, <tt>IListProperty</tt>, <tt>ISetProperty</tt> and
15 
<tt>IMapProperty</tt> interfaces, along with classes
16 
which serve as base implementations of each interface.
17 
<p>
18 
Properties are intended to serve as a convenient path to creating observables
19 
for observing specific attributes of source objects.  The main goals of this
20 
API are:
21 
<ul>
22 
<li>Simplify the process of writing custom observables.  Developing custom
23 
observables correctly can be tricky, so the properties API tries to ease this
24 
burden by providing all the observable implementations.  Property implementers
25 
only need to implement a handful of methods which are used by the observables
26 
to function.
27 
<li>Simplify observation of nested properties.  Traditionally observing a
28 
nested property required creating an observable for the first property, then
29 
wrapping that observable in a master-detail observing for each successive
30 
property in the chain.  Using properties it is trivial to define a nested
31 
property and to observe that property on a particular source object.
32 
</ul>
33 
<p>
34 
</body>
35 
</html>

Return to bug 194734