Package org.eclipse.core.databinding.beans

Class 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 Detail

      • PojoObservables

        public PojoObservables()
        Deprecated.

    • Method Detail

      • 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(Realm, Object, String, Class)

      • 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(Realm, Object, String, Class)

      • 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)
        Deprecated.
        Use observeDetailValue(IObservableValue, String, Class) instead
        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:
        MasterDetailObservables

      • 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:
        MasterDetailObservables

      • 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:
        MasterDetailObservables

      • 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:
        MasterDetailObservables

      • observeDetailMap

        @Deprecated
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 - 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