Class PojoObservables

java.lang.Object
org.eclipse.core.databinding.beans.PojoObservables

@Deprecated public final class PojoObservables extends Object
Deprecated.
This class will be removed in a future release. See https://bugs.eclipse.org/bugs/show_bug.cgi?id=546820 for more information. Use PojoProperties instead.
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
Restriction:
  • Constructor Details

    • PojoObservables

      public PojoObservables()
      Deprecated.
  • Method Details

    • observeValue

      @Deprecated public static IObservableValue observeValue(Object pojo, String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableValue observeValue(Realm realm, Object pojo, String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableMap observeMap(IObservableSet domain, String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableMap observeMap(IObservableSet domain, Class pojoClass, String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableMap[] observeMaps(IObservableSet domain, String[] propertyNames)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableMap[] observeMaps(IObservableSet domain, Class pojoClass, String[] propertyNames)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableMap observeMap(Realm realm, Object pojo, String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableMap observeMap(Realm realm, Object pojo, String propertyName, Class keyType, Class valueType)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableMap observeMap(Object pojo, String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableMap observeMap(Object pojo, String propertyName, Class keyType, Class valueType)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableList observeList(Realm realm, Object pojo, String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableList observeList(Object pojo, String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableList observeList(Realm realm, Object pojo, String propertyName, Class elementType)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableList observeList(Object pojo, String propertyName, Class elementType)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableSet observeSet(Realm realm, Object pojo, String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableSet observeSet(Object pojo, String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableSet observeSet(Realm realm, Object pojo, String propertyName, Class elementType)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableSet observeSet(Object pojo, String propertyName, Class elementType)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableFactory valueFactory(Realm realm, String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableFactory valueFactory(String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableFactory listFactory(Realm realm, String propertyName, Class elementType)
      Deprecated.
      use PojoProperties instead
      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 - the element type of the returned list property
      Returns:
      an observable list factory
    • listFactory

      @Deprecated public static IObservableFactory listFactory(String propertyName, Class elementType)
      Deprecated.
      use PojoProperties instead
      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 - the element type of the returned list property
      Returns:
      an observable list factory
      Since:
      1.2
    • setFactory

      @Deprecated public static IObservableFactory setFactory(Realm realm, String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableFactory setFactory(String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableFactory setFactory(Realm realm, String propertyName, Class elementType)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableFactory setFactory(String propertyName, Class elementType)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableFactory mapPropertyFactory(Realm realm, String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableFactory mapPropertyFactory(String propertyName)
      Deprecated.
      use PojoProperties instead
      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

      @Deprecated public static IObservableValue observeDetailValue(Realm realm, IObservableValue master, String propertyName, Class propertyType)
      Helper method for MasterDetailObservables.detailValue(master, valueFactory(realm, propertyName), propertyType)
      Parameters:
      realm - the realm
      master - the master observable value
      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:
    • observeDetailValue

      @Deprecated public static IObservableValue observeDetailValue(IObservableValue master, String propertyName, Class propertyType)
      Deprecated.
      use PojoProperties instead
      Helper method for MasterDetailObservables.detailValue(master, valueFactory(master.getRealm, propertyName), propertyType)
      Parameters:
      master - the master observable value
      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:
    • observeDetailList

      @Deprecated public static IObservableList observeDetailList(Realm realm, IObservableValue master, String propertyName, Class propertyType)
      Helper method for MasterDetailObservables.detailList(master, listFactory(realm, propertyName, propertyType), propertyType)
      Parameters:
      realm - the realm
      master - the observable value
      propertyName - name of the property
      propertyType - can be null
      Returns:
      an observable list that tracks the named property for the current value of the master observable value
      See Also:
    • observeDetailList

      @Deprecated public static IObservableList observeDetailList(IObservableValue master, String propertyName, Class propertyType)
      Deprecated.
      use PojoProperties instead
      Helper method for MasterDetailObservables.detailList(master, listFactory(master.getRealm(), propertyName, propertyType), propertyType)
      Parameters:
      master - the master observable value
      propertyName - name of the property
      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:
    • observeDetailSet

      @Deprecated public static IObservableSet observeDetailSet(Realm realm, IObservableValue master, String propertyName, Class propertyType)
      Helper method for MasterDetailObservables.detailSet(master, setFactory(realm, propertyName), propertyType)
      Parameters:
      realm - the realm
      master - the master observable value
      propertyName - the property name
      propertyType - can be null
      Returns:
      an observable set that tracks the named property for the current value of the master observable value
      See Also:
    • observeDetailSet

      @Deprecated public static IObservableSet observeDetailSet(IObservableValue master, String propertyName, Class propertyType)
      Deprecated.
      use PojoProperties instead
      Helper method for MasterDetailObservables.detailSet(master, setFactory(master.getRealm(), propertyName), propertyType)
      Parameters:
      master - the observable value
      propertyName - the property name
      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:
    • observeDetailMap

      @Deprecated public static IObservableMap observeDetailMap(Realm realm, IObservableValue master, String propertyName)
      Helper method for MasterDetailObservables.detailMap(master, mapFactory(realm, propertyName))
      Parameters:
      realm - the realm
      master - the observable value
      propertyName - name of the property
      Returns:
      an observable map that tracks the map-type named property for the current value of the master observable value.
    • observeDetailMap

      @Deprecated public static IObservableMap observeDetailMap(IObservableValue master, String propertyName)
      Deprecated.
      use PojoProperties instead
      Helper method for MasterDetailObservables.detailMap(master, mapFactory(master.getRealm(), propertyName))
      Parameters:
      master - the master observable value
      propertyName - name of the property
      Returns:
      an observable map that tracks the map-type named property for the current value of the master observable value.
      Since:
      1.2