Module  javafx.base
软件包  javafx.beans.binding

Class ObjectBinding<T>

  • 参数类型
    T - 包装的类型 Object
    All Implemented Interfaces:
    Binding<T> ， Observable ， ObservableObjectValue<T> ， ObservableValue<T> 

    public abstract class ObjectBinding<T>
extends ObjectExpression<T>
implements Binding<T>
    提供实现Object的Object所需的大部分功能的基类。

    ObjectBinding提供了一个简单的无效方案。 扩展类可以通过调用bind(Observable...)来注册依赖关系。 如果注册的依赖关系中的一个变为无效，则该ObjectBinding被标记为无效。 用unbind(Observable...)听取依赖关系可以停止。

    为了提供该类的具体实现，必须实现方法computeValue() ，以基于依赖关系的当前状态来计算该绑定的值。 当get()被调用无效绑定时被调用。

    有关可以扩展这个基类的示例，请参阅DoubleBinding 。

    从以下版本开始：
    JavaFX 2.0
    另请参见：
    Binding ， ObjectExpression

    • 构造方法详细信息

      • ObjectBinding

        public ObjectBinding​()

    • 方法详细信息

      • addListener

        public void addListener​(InvalidationListener listener)
        说明从界面Observable复制
        添加一个InvalidationListener ，当Observable变得无效时，它将被通知。 如果同一个监听器被多次添加，那么它将被多次通知。 也就是说，没有检查确保唯一性。

        请注意，相同的实际InvalidationListener实例可能会安全注册为不同的Observables 。

        Observable存储对侦听器的强引用，这将阻止侦听器被垃圾回收，并可能导致内存泄漏。 建议您在使用后通过调用removeListener注销侦听器，或使用WeakInvalidationListener的实例避免此情况。

        Specified by:
        addListener在接口 Observable
        参数
        listener - listener注册
        另请参见：
        Observable.removeListener(InvalidationListener)

      • removeListener

        public void removeListener​(InvalidationListener listener)
        描述从界面Observable复制
        从监听器列表中删除给定的监听器，每当Observable的值变为无效时通知Observable 。

        如果给定的侦听器以前没有被注册过（即它从未被添加过），那么这个方法调用是一个无操作的。 如果以前已经添加，那么它将被删除。 如果多次添加，那么只有第一次出现将被删除。

        Specified by:
        removeListener在接口 Observable
        参数
        listener - 要删除的侦听器
        另请参见：
        Observable.addListener(InvalidationListener)

      • addListener

        public void addListener​(ChangeListener<? super T> listener)
        说明从界面ObservableValue复制
        添加一个ChangeListener ，当ObservableValue的值发生变化时，它将被通知。 如果同一个监听器被多次添加，那么它将被多次通知。 也就是说，没有检查确保唯一性。

        请注意，相同的实际ChangeListener实例可以安全地注册到不同的ObservableValues 。

        ObservableValue存储对监听器的强烈引用，这将阻止侦听器被垃圾回收，并可能导致内存泄漏。 建议您在使用后通过调用removeListener注销监听器，或使用WeakChangeListener的实例避免此情况。

        Specified by:
        addListener在接口 ObservableValue<T>
        参数
        listener - listener注册
        另请参见：
        ObservableValue.removeListener(ChangeListener)

      • removeListener

        public void removeListener​(ChangeListener<? super T> listener)
        描述从接口ObservableValue复制
        从监听器列表中删除给定的监听器，当ObservableValue的值发生变化时通知ObservableValue 。

        如果给定的侦听器以前没有被注册过（即它从未被添加过），那么这个方法调用是一个无操作的。 如果以前已经添加，那么它将被删除。 如果多次添加，那么只有第一次出现将被删除。

        Specified by:
        removeListener在接口 ObservableValue<T>
        参数
        listener - 要删除的侦听器
        另请参见：
        ObservableValue.addListener(ChangeListener)

      • bind

        protected final void bind​(Observable... dependencies)
        开始观察更改的依赖关系。 如果其中一个依赖关系的值发生变化，则绑定被标记为无效。
        参数
        dependencies - 依赖关系观察

      • unbind

        protected final void unbind​(Observable... dependencies)
        停止观察更改的依赖关系。
        参数
        dependencies - 停止观察的依赖关系

      • dispose

        public void dispose​()
        默认实现为 dispose() ，为空。
        Specified by:
        dispose在接口 Binding<T>

      • get

        public final T get​()
        返回computeValue()的结果。 仅当绑定无效时才调用方法computeValue() 。 如果绑定从上一次调用get()以来没有变为无效，结果将被缓存并返回。
        Specified by:
        get在接口 ObservableObjectValue<T>
        结果
        当前值

      • onInvalidating

        protected void onInvalidating​()
        如果此绑定变为无效，那么onInvalidating（）方法可以被扩展类覆盖。 默认实现为空。

      • invalidate

        public final void invalidate​()
        说明从界面Binding复制
        将绑定标记为无效。 这迫使重新计算Binding下次请求时的值。
        Specified by:
        invalidate在接口 Binding<T>

      • isValid

        public final boolean isValid​()
        说明从界面Binding复制
        检查绑定是否有效。
        Specified by:
        isValid在接口 Binding<T>
        结果
        true如果 Binding有效，否则为 false

      • computeValue

        protected abstract T computeValue​()
        计算此绑定的当前值。

        扩展ObjectBinding类必须提供computeValue的实现。

        结果
        当前值

      • toString

        public String toString​()
        返回此 ObjectBinding对象的字符串表示形式。
        重写：
        toString在 Object
        结果
        这个 ObjectBinding对象的字符串表示形式。