|
 |
|
|
org.eclipse.core.databinding.beans
Class PojoObservables
java.lang.Object
org.eclipse.core.databinding.beans.PojoObservables
-
public final class PojoObservables
- extends
Object
A factory for creating observable objects for POJOs (plain old java objects)
that conform to idea of an object with getters and setters but does not
provide
property change events
on change. This
factory is identical to
BeansObservables except for this fact.
-
Since:
- 1.1
Method Summary
|
static
IObservableFactory
|
listFactory
(
Realm realm,
String propertyName,
Class elementType)
Returns a factory for creating observable lists in the given realm,
tracking the given property of a particular pojo object |
static
IObservableFactory
|
listFactory
(
String propertyName,
Class elementType)
Returns a factory for creating observable lists in the current default
realm, tracking the given property of a particular pojo object |
static
IObservableFactory
|
mapPropertyFactory
(
Realm realm,
String propertyName)
Returns a factory for creating an observable map. |
static
IObservableFactory
|
mapPropertyFactory
(
String propertyName)
Returns a factory for creating an observable map. |
static
IObservableList
|
observeDetailList
(
IObservableValue master,
String propertyName,
Class propertyType)
Helper method for
MasterDetailObservables.detailList(master, listFactory(master.getRealm(), propertyName, propertyType), propertyType)
|
static
IObservableList
|
observeDetailList
(
Realm realm,
IObservableValue master,
String propertyName,
Class propertyType)
Deprecated. Use
observeDetailList(IObservableValue, String, Class)
instead
|
static
IObservableMap
|
observeDetailMap
(
IObservableValue master,
String propertyName)
Helper method for
MasterDetailObservables.detailMap(master, mapFactory(master.getRealm(), propertyName))
|
static
IObservableMap
|
observeDetailMap
(
Realm realm,
IObservableValue master,
String propertyName)
Deprecated. Use
observeDetailMap(IObservableValue, String)
instead
|
static
IObservableSet
|
observeDetailSet
(
IObservableValue master,
String propertyName,
Class propertyType)
Helper method for
MasterDetailObservables.detailSet(master, setFactory(master.getRealm(), propertyName), propertyType)
|
static
IObservableSet
|
observeDetailSet
(
Realm realm,
IObservableValue master,
String propertyName,
Class propertyType)
Deprecated. Use
observeDetailSet(IObservableValue, String, Class)
instead.
|
static
IObservableValue
|
observeDetailValue
(
IObservableValue master,
String propertyName,
Class propertyType)
Helper method for
MasterDetailObservables.detailValue(master, valueFactory(master.getRealm, propertyName), propertyType)
|
static
IObservableValue
|
observeDetailValue
(
Realm realm,
IObservableValue master,
String propertyName,
Class propertyType)
Deprecated. Use
observeDetailValue(IObservableValue, String, Class)
instead
|
static
IObservableList
|
observeList
(
Object pojo,
String propertyName)
Returns an observable list in the default realm tracking the
collection-typed named property of the given pojo object. |
static
IObservableList
|
observeList
(
Object pojo,
String propertyName,
Class elementType)
Returns an observable list in the default realm tracking the
collection-typed named property of the given bean object. |
static
IObservableList
|
observeList
(
Realm realm,
Object pojo,
String propertyName)
Returns an observable list in the given realm tracking the
collection-typed named property of the given pojo object. |
static
IObservableList
|
observeList
(
Realm realm,
Object pojo,
String propertyName,
Class elementType)
Returns an observable list in the given realm tracking the
collection-typed named property of the given bean object. |
static
IObservableMap
|
observeMap
(
IObservableSet domain,
Class pojoClass,
String propertyName)
Returns an observable map in the given observable set's realm tracking
the current values of the named property for the pojos in the given set. |
static
IObservableMap
|
observeMap
(
IObservableSet domain,
String propertyName)
Returns an observable map in the given observable set's realm tracking
the current values of the named property for the beans in the given set. |
static
IObservableMap
|
observeMap
(
Object pojo,
String propertyName)
Returns an observable map in the default realm tracking the map-typed
named property of the given pojo object. |
static
IObservableMap
|
observeMap
(
Object pojo,
String propertyName,
Class keyType,
Class valueType)
Returns an observable map in the default realm tracking the map-typed
named property of the given pojo object. |
static
IObservableMap
|
observeMap
(
Realm realm,
Object pojo,
String propertyName)
Returns an observable map in the given realm tracking the map-typed named
property of the given pojo object. |
static
IObservableMap
|
observeMap
(
Realm realm,
Object pojo,
String propertyName,
Class keyType,
Class valueType)
Returns an observable map in the given realm tracking the map-typed named
property of the given pojo object. |
static
IObservableMap[]
|
observeMaps
(
IObservableSet domain,
Class pojoClass,
String[] propertyNames)
Returns an array of observable maps in the given observable set's realm
tracking the current values of the named propertys for the pojos in the
given set. |
static
IObservableMap[]
|
observeMaps
(
IObservableSet domain,
String[] propertyNames)
Returns an array of observable maps in the given observable set's realm
tracking the current values of the named properties for the beans in the
given set. |
static
IObservableSet
|
observeSet
(
Object pojo,
String propertyName)
Returns an observable set in the default realm tracking the
collection-typed named property of the given pojo object. |
static
IObservableSet
|
observeSet
(
Object pojo,
String propertyName,
Class elementType)
Returns an observable set in the default realm, tracking the
collection-typed named property of the given pojo object. |
static
IObservableSet
|
observeSet
(
Realm realm,
Object pojo,
String propertyName)
Returns an observable set in the given realm tracking the
collection-typed named property of the given pojo object. |
static
IObservableSet
|
observeSet
(
Realm realm,
Object pojo,
String propertyName,
Class elementType)
Returns an observable set in the given realm tracking the
collection-typed named property of the given pojo object. |
static
IObservableValue
|
observeValue
(
Object pojo,
String propertyName)
Returns an observable value in the default realm tracking the current
value of the named property of the given pojo. |
static
IObservableValue
|
observeValue
(
Realm realm,
Object pojo,
String propertyName)
Returns an observable value in the given realm tracking the current value
of the named property of the given pojo. |
static
IObservableFactory
|
setFactory
(
Realm realm,
String propertyName)
Returns a factory for creating observable sets in the given realm,
tracking the given property of a particular pojo object |
static
IObservableFactory
|
setFactory
(
Realm realm,
String propertyName,
Class elementType)
Returns a factory for creating observable set in the given realm,
tracking the given property of a particular pojo object |
static
IObservableFactory
|
setFactory
(
String propertyName)
Returns a factory for creating observable sets in the current default
realm, tracking the given property of a particular pojo object |
static
IObservableFactory
|
setFactory
(
String propertyName,
Class elementType)
Returns a factory for creating observable set in the current default
realm, tracking the given property of a particular pojo object |
static
IObservableFactory
|
valueFactory
(
Realm realm,
String propertyName)
Returns a factory for creating observable values in the given realm,
tracking the given property of a particular pojo object |
static
IObservableFactory
|
valueFactory
(
String propertyName)
Returns a factory for creating observable values in the current default
realm, tracking the given property of a particular pojo object |
Methods inherited from class java.lang.
Object
|
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
|
PojoObservables
public PojoObservables()
observeValue
public static
IObservableValue observeValue(
Object pojo,
String propertyName)
- Returns an observable value in the default realm tracking the current
value of the named property of the given pojo.
-
-
Parameters:
-
pojo - the object -
propertyName - the name of the property. May be nested e.g. "parent.name"
-
Returns:
- an observable value tracking the current value of the named
property of the given pojo
observeValue
public static
IObservableValue observeValue(
Realm realm,
Object pojo,
String propertyName)
- Returns an observable value in the given realm tracking the current value
of the named property of the given pojo.
-
-
Parameters:
-
realm - the realm -
pojo - the object -
propertyName - the name of the property. May be nested e.g. "parent.name"
-
Returns:
- an observable value tracking the current value of the named
property of the given pojo
observeMap
public static
IObservableMap observeMap(
IObservableSet domain,
String propertyName)
- Returns an observable map in the given observable set's realm tracking
the current values of the named property for the beans in the given set.
Elements in the set which do not have the named property will have null
values, and attempts to
put
values to these elements will be ignored.
-
-
Parameters:
-
domain - the set of bean objects -
propertyName - the name of the property. May be nested e.g. "parent.name"
-
Returns:
- an observable map tracking the current values of the named
property for the beans in the given domain set
-
Since:
- 1.2
observeMap
public static
IObservableMap observeMap(
IObservableSet domain,
Class pojoClass,
String propertyName)
- Returns an observable map in the given observable set's realm tracking
the current values of the named property for the pojos in the given set.
-
-
Parameters:
-
domain - the set of pojo objects -
pojoClass - the common base type of pojo objects that may be in the set -
propertyName - the name of the property. May be nested e.g. "parent.name"
-
Returns:
- an observable map tracking the current values of the named
property for the pojos in the given domain set
observeMaps
public static
IObservableMap[] observeMaps(
IObservableSet domain,
String[] propertyNames)
- Returns an array of observable maps in the given observable set's realm
tracking the current values of the named properties for the beans in the
given set. Elements in the set which do not have the named property will
have null values, and attempts to
put values to these elements
will be ignored.
-
-
Parameters:
-
domain - the set of objects -
propertyNames - the array of property names. May be nested e.g. "parent.name"
-
Returns:
- an array of observable maps tracking the current values of the
named propertys for the beans in the given domain set
-
Since:
- 1.2
observeMaps
public static
IObservableMap[] observeMaps(
IObservableSet domain,
Class pojoClass,
String[] propertyNames)
- Returns an array of observable maps in the given observable set's realm
tracking the current values of the named propertys for the pojos in the
given set.
-
-
Parameters:
-
domain - the set of objects -
pojoClass - the common base type of objects that may be in the set -
propertyNames - the array of property names. May be nested e.g. "parent.name"
-
Returns:
- an array of observable maps tracking the current values of the
named propertys for the pojos in the given domain set
observeMap
public static
IObservableMap observeMap(
Realm realm,
Object pojo,
String propertyName)
- Returns an observable map in the given realm tracking the map-typed named
property of the given pojo object.
-
-
Parameters:
-
realm - the realm -
pojo - the pojo object -
propertyName - the name of the property
-
Returns:
- an observable map tracking the map-typed named property of the
given pojo object
observeMap
public static
IObservableMap observeMap(
Realm realm,
Object pojo,
String propertyName,
Class keyType,
Class valueType)
- Returns an observable map in the given realm tracking the map-typed named
property of the given pojo object.
-
-
Parameters:
-
realm - the realm -
pojo - the pojo object -
propertyName - the name of the property -
keyType - the element type of the observable map's key set, or
null if untyped -
valueType - the element type of the observable map's values collection, or
null if untyped
-
Returns:
- an observable map tracking the map-typed named property of the
given pojo object
-
Since:
- 1.2
observeMap
public static
IObservableMap observeMap(
Object pojo,
String propertyName)
- Returns an observable map in the default realm tracking the map-typed
named property of the given pojo object.
-
-
Parameters:
-
pojo - the pojo object -
propertyName - the name of the property
-
Returns:
- an observable map tracking the map-typed named property of the
given pojo object
-
Since:
- 1.2
observeMap
public static
IObservableMap observeMap(
Object pojo,
String propertyName,
Class keyType,
Class valueType)
- Returns an observable map in the default realm tracking the map-typed
named property of the given pojo object.
-
-
Parameters:
-
pojo - the pojo object -
propertyName - the name of the property -
keyType - the element type of the observable map's key set, or
null if untyped -
valueType - the element type of the observable map's values collection, or
null if untyped
-
Returns:
- an observable map tracking the map-typed named property of the
given pojo object
-
Since:
- 1.2
observeList
public static
IObservableList observeList(
Realm realm,
Object pojo,
String propertyName)
- Returns an observable list in the given realm tracking the
collection-typed named property of the given pojo object. The returned
list is mutable.
-
-
Parameters:
-
realm - the realm -
pojo - the object -
propertyName - the name of the collection-typed property
-
Returns:
- an observable list tracking the collection-typed named property
of the given pojo object
-
See Also:
-
observeList(Realm, Object, String, Class)
observeList
public static
IObservableList observeList(
Object pojo,
String propertyName)
- Returns an observable list in the default realm tracking the
collection-typed named property of the given pojo object. The returned
list is mutable.
-
-
Parameters:
-
pojo - the object -
propertyName - the name of the collection-typed property
-
Returns:
- an observable list tracking the collection-typed named property
of the given pojo object
-
Since:
- 1.2
-
See Also:
-
observeList(Realm, Object, String, Class)
observeList
public static
IObservableList observeList(
Realm realm,
Object pojo,
String propertyName,
Class elementType)
- Returns an observable list in the given realm tracking the
collection-typed named property of the given bean object. The returned
list is mutable. When an item is added or removed the setter is invoked
for the list on the parent bean to provide notification to other
listeners via
PropertyChangeEvents . This is done to provide
the same behavior as is expected from arrays as specified in the bean
spec in section 7.2.
-
-
Parameters:
-
realm - the realm -
pojo - the bean object -
propertyName - the name of the property -
elementType - type of the elements in the list. If null and the
property is an array the type will be inferred. If
null and the property type cannot be inferred
element type will be null .
-
Returns:
- an observable list tracking the collection-typed named property
of the given bean object
observeList
public static
IObservableList observeList(
Object pojo,
String propertyName,
Class elementType)
- Returns an observable list in the default realm tracking the
collection-typed named property of the given bean object. The returned
list is mutable. When an item is added or removed the setter is invoked
for the list on the parent bean to provide notification to other
listeners via
PropertyChangeEvents . This is done to provide
the same behavior as is expected from arrays as specified in the bean
spec in section 7.2.
-
-
Parameters:
-
pojo - the bean object -
propertyName - the name of the property -
elementType - type of the elements in the list. If null and the
property is an array the type will be inferred. If
null and the property type cannot be inferred
element type will be null .
-
Returns:
- an observable list tracking the collection-typed named property
of the given bean object
-
Since:
- 1.2
observeSet
public static
IObservableSet observeSet(
Realm realm,
Object pojo,
String propertyName)
- Returns an observable set in the given realm tracking the
collection-typed named property of the given pojo object.
-
-
Parameters:
-
realm - the realm -
pojo - the pojo object -
propertyName - the name of the property
-
Returns:
- an observable set tracking the collection-typed named property of
the given pojo object
observeSet
public static
IObservableSet observeSet(
Object pojo,
String propertyName)
- Returns an observable set in the default realm tracking the
collection-typed named property of the given pojo object.
-
-
Parameters:
-
pojo - the pojo object -
propertyName - the name of the property
-
Returns:
- an observable set tracking the collection-typed named property of
the given pojo object
-
Since:
- 1.2
observeSet
public static
IObservableSet observeSet(
Realm realm,
Object pojo,
String propertyName,
Class elementType)
- Returns an observable set in the given realm tracking the
collection-typed named property of the given pojo object.
-
-
Parameters:
-
realm - the realm -
pojo - the pojo object -
propertyName - the name of the property -
elementType - type of the elements in the set. If null and the
property is an array the type will be inferred. If
null and the property type cannot be inferred
element type will be null .
-
Returns:
- an observable set that tracks the current value of the named
property for given pojo object
observeSet
public static
IObservableSet observeSet(
Object pojo,
String propertyName,
Class elementType)
- Returns an observable set in the default realm, tracking the
collection-typed named property of the given pojo object.
-
-
Parameters:
-
pojo - the pojo object -
propertyName - the name of the property -
elementType - type of the elements in the set. If null and the
property is an array the type will be inferred. If
null and the property type cannot be inferred
element type will be null .
-
Returns:
- an observable set that tracks the current value of the named
property for given pojo object
-
Since:
- 1.2
valueFactory
public static
IObservableFactory valueFactory(
Realm realm,
String propertyName)
- Returns a factory for creating observable values in the given realm,
tracking the given property of a particular pojo object
-
-
Parameters:
-
realm - the realm to use -
propertyName - the name of the property. May be nested e.g. "parent.name"
-
Returns:
- an observable value factory
valueFactory
public static
IObservableFactory valueFactory(
String propertyName)
- Returns a factory for creating observable values in the current default
realm, tracking the given property of a particular pojo object
-
-
Parameters:
-
propertyName - the name of the property. May be nested e.g. "parent.name"
-
Returns:
- an observable value factory
-
Since:
- 1.2
listFactory
public static
IObservableFactory listFactory(
Realm realm,
String propertyName,
Class elementType)
- Returns a factory for creating observable lists in the given realm,
tracking the given property of a particular pojo object
-
-
Parameters:
-
realm - the realm to use -
propertyName - the name of the property -
elementType -
-
Returns:
- an observable list factory
listFactory
public static
IObservableFactory listFactory(
String propertyName,
Class elementType)
- Returns a factory for creating observable lists in the current default
realm, tracking the given property of a particular pojo object
-
-
Parameters:
-
propertyName - the name of the property -
elementType -
-
Returns:
- an observable list factory
-
Since:
- 1.2
setFactory
public static
IObservableFactory setFactory(
Realm realm,
String propertyName)
- Returns a factory for creating observable sets in the given realm,
tracking the given property of a particular pojo object
-
-
Parameters:
-
realm - the realm to use -
propertyName - the name of the property
-
Returns:
- an observable set factory
setFactory
public static
IObservableFactory setFactory(
String propertyName)
- Returns a factory for creating observable sets in the current default
realm, tracking the given property of a particular pojo object
-
-
Parameters:
-
propertyName - the name of the property
-
Returns:
- an observable set factory
-
Since:
- 1.2
setFactory
public static
IObservableFactory setFactory(
Realm realm,
String propertyName,
Class elementType)
- Returns a factory for creating observable set in the given realm,
tracking the given property of a particular pojo object
-
-
Parameters:
-
realm - the realm to use -
propertyName - the name of the property -
elementType - type of the elements in the set. If null and the
property is an array the type will be inferred. If
null and the property type cannot be inferred
element type will be null .
-
Returns:
- an observable set factory for creating observable sets
setFactory
public static
IObservableFactory setFactory(
String propertyName,
Class elementType)
- Returns a factory for creating observable set in the current default
realm, tracking the given property of a particular pojo object
-
-
Parameters:
-
propertyName - the name of the property -
elementType - type of the elements in the set. If null and the
property is an array the type will be inferred. If
null and the property type cannot be inferred
element type will be null .
-
Returns:
- an observable set factory for creating observable sets
-
Since:
- 1.2
mapPropertyFactory
public static
IObservableFactory mapPropertyFactory(
Realm realm,
String propertyName)
- Returns a factory for creating an observable map. The factory, when
provided with a pojo object, will create an
IObservableMap in the
given realm that tracks the map-typed named property for the specified
pojo.
-
-
Parameters:
-
realm - the realm assigned to observables created by the returned
factory. -
propertyName - the name of the property
-
Returns:
- a factory for creating
IObservableMap objects.
mapPropertyFactory
public static
IObservableFactory mapPropertyFactory(
String propertyName)
- Returns a factory for creating an observable map. The factory, when
provided with a pojo object, will create an
IObservableMap in the
current default realm that tracks the map-typed named property for the
specified pojo.
-
-
Parameters:
-
propertyName - the name of the property
-
Returns:
- a factory for creating
IObservableMap objects. -
Since:
- 1.2
observeDetailValue
public static
IObservableValue observeDetailValue(
Realm realm,
IObservableValue master,
String propertyName,
Class propertyType)
-
Deprecated. Use
observeDetailValue(IObservableValue, String, Class)
instead
- Helper method for
MasterDetailObservables.detailValue(master, valueFactory(realm,
propertyName), propertyType)
-
-
Parameters:
-
realm - -
master - -
propertyName - the property name. May be nested e.g. "parent.name" -
propertyType - can be null
-
Returns:
- an observable value that tracks the current value of the named
property for the current value of the master observable value
-
See Also:
-
MasterDetailObservables
observeDetailValue
public static
IObservableValue observeDetailValue(
IObservableValue master,
String propertyName,
Class propertyType)
- Helper method for
MasterDetailObservables.detailValue(master, valueFactory(master.getRealm, propertyName), propertyType)
-
-
Parameters:
-
master - -
propertyName - the property name. May be nested e.g. "parent.name" -
propertyType - can be null
-
Returns:
- an observable value that tracks the current value of the named
property for the current value of the master observable value
-
Since:
- 1.2
-
See Also:
-
MasterDetailObservables
observeDetailList
public static
IObservableList observeDetailList(
Realm realm,
IObservableValue master,
String propertyName,
Class propertyType)
-
Deprecated. Use
observeDetailList(IObservableValue, String, Class)
instead
- Helper method for
MasterDetailObservables.detailList(master, listFactory(realm,
propertyName, propertyType), propertyType)
-
-
Parameters:
-
realm - -
master - -
propertyName - -
propertyType - can be null
-
Returns:
- an observable list that tracks the named property for the current
value of the master observable value
-
See Also:
-
MasterDetailObservables
observeDetailList
public static
IObservableList observeDetailList(
IObservableValue master,
String propertyName,
Class propertyType)
- Helper method for
MasterDetailObservables.detailList(master, listFactory(master.getRealm(), propertyName, propertyType), propertyType)
-
-
Parameters:
-
master - -
propertyName - -
propertyType - can be null
-
Returns:
- an observable list that tracks the named property for the current
value of the master observable value
-
Since:
- 1.2
-
See Also:
-
MasterDetailObservables
observeDetailSet
public static
IObservableSet observeDetailSet(
Realm realm,
IObservableValue master,
String propertyName,
Class propertyType)
-
Deprecated. Use
observeDetailSet(IObservableValue, String, Class)
instead.
- Helper method for
MasterDetailObservables.detailSet(master, setFactory(realm,
propertyName), propertyType)
-
-
Parameters:
-
realm - -
master - -
propertyName - -
propertyType - can be null
-
Returns:
- an observable set that tracks the named property for the current
value of the master observable value
-
See Also:
-
MasterDetailObservables
observeDetailSet
public static
IObservableSet observeDetailSet(
IObservableValue master,
String propertyName,
Class propertyType)
- Helper method for
MasterDetailObservables.detailSet(master, setFactory(master.getRealm(), propertyName), propertyType)
-
-
Parameters:
-
master - -
propertyName - -
propertyType - can be null
-
Returns:
- an observable set that tracks the named property for the current
value of the master observable value
-
Since:
- 1.2
-
See Also:
-
MasterDetailObservables
observeDetailMap
public static
IObservableMap observeDetailMap(
Realm realm,
IObservableValue master,
String propertyName)
-
Deprecated. Use
observeDetailMap(IObservableValue, String)
instead
- Helper method for
MasterDetailObservables.detailMap(master, mapFactory(realm, propertyName))
-
-
Parameters:
-
realm - -
master - -
propertyName -
-
Returns:
- an observable map that tracks the map-type named property for the
current value of the master observable value.
observeDetailMap
public static
IObservableMap observeDetailMap(
IObservableValue master,
String propertyName)
- Helper method for
MasterDetailObservables.detailMap(master, mapFactory(master.getRealm(), propertyName))
-
-
Parameters:
-
master - -
propertyName -
-
Returns:
- an observable map that tracks the map-type named property for the
current value of the master observable value.
-
Since:
- 1.2
Guidelines for using Eclipse APIs.
Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.
|
|
|