Class PojoObservables


  • public final class PojoObservables
    extends Object
    Deprecated.
    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
    • Constructor Detail

      • PojoObservables

        public PojoObservables()
        Deprecated.
    • Method Detail

      • observeValue

        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

        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

        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

        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

        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

        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

        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

        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

        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

        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

        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

        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

        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

        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

        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

        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

        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

        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

        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

        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

        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 -
        Returns:
        an observable list factory
      • listFactory

        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 -
        Returns:
        an observable list factory
        Since:
        1.2
      • setFactory

        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

        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

        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

        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

        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

        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

        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 -
        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​(IObservableValue master,
                                                        String propertyName,
                                                        Class propertyType)
        Deprecated.
        use PojoProperties instead
        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​(IObservableValue master,
                                                      String propertyName,
                                                      Class propertyType)
        Deprecated.
        use PojoProperties instead
        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​(IObservableValue master,
                                                      String propertyName)
        Deprecated.
        use PojoProperties instead
        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