Spec-Zone.ru › OpenJavaFX 11
Модуль javafx.base
Пакет javafx.beans.property.adapter

Класс JavaBeanObjectProperty<T>

  • java.lang.Object
    • javafx.beans.binding.ObjectExpression<T>
      • javafx.beans.property.ReadOnlyObjectProperty<T>
        • javafx.beans.property.ObjectProperty<T>
          • javafx.beans.property.adapter.JavaBeanObjectProperty<T>
  • Все реализуемые интерфейсы:
    Observable, JavaBeanProperty<T>, ReadOnlyJavaBeanProperty<T>, Property<T>, ReadOnlyProperty<T>, ObservableObjectValue<T>, ObservableValue<T>, WritableObjectValue<T>, WritableValue<T>
    public final class JavaBeanObjectProperty<T>
    extends ObjectProperty<T>
    implements JavaBeanProperty<T>
    Класс JavaBeanObjectProperty предоставляет адаптер между обычным свойством Java Bean типа T и JavaFX ObjectProperty<T>. Его нельзя создать напрямую, вместо этого необходимо использовать JavaBeanObjectPropertyBuilder.

    В качестве минимума, класс Java Bean должен реализовывать getter и setter для свойства. Класс, а также методы getter и setter должны быть объявлены public. Если вызовется getter экземпляра этого класса, то вернется свойство Java Bean. Если вызовется setter, значение будет передано в свойство Java Bean. Если свойство Java Bean привязано (т.е. поддерживает PropertyChangeListeners), это JavaBeanObjectProperty будет отслеживать изменения в Java Bean. В противном случае оно может быть уведомлено об изменениях с помощью вызова fireValueChangedEvent(). Если свойство Java Bean также ограничено (т.е. поддерживает VetoableChangeListeners), это JavaBeanObjectProperty будет отклонять изменения, если оно привязано к ObservableValue<Object>.

    Развертывание приложения как модуля

    Если класс Java Bean находится в именованном модуле, то он должен быть рефлективно доступен для модуля javafx.base. Класс рефлективно доступен, если модуль opens содержащий пакет, по крайней мере, до модуля javafx.base.

    Например, если com.foo.MyBeanClass находится в модуле foo.app, то module-info.java может выглядеть так:

    module foo.app {
        opens com.foo to javafx.base;
    }

    В качестве альтернативы, класс рефлективно доступен, если модуль exports содержащий пакет безусловно.

    С тех пор:
    JavaFX 2.1
    См. также:
    ObjectProperty, JavaBeanObjectPropertyBuilder
  • Краткое описание методов

    Все методыМетоды экземпляраКонкретные методы
    Модификатор и тип Метод Описание
    void addListener​(InvalidationListener listener)
    Добавляет InvalidationListener, который будет уведомляться всякий раз, когда Observable становится недействительным.
    void addListener​(ChangeListener<? super T> listener)
    Добавляет ChangeListener, который будет уведомляться всякий раз, когда значение ObservableValue изменяется.
    void bind​(ObservableValue<? extends T> observable)
    Создает однонаправленную привязку для этого Property.
    void dispose()
    Сигнализирует свойству JavaFX, что оно больше не будет использоваться, и все ссылки могут быть удалены.
    void fireValueChangedEvent()
    Этот метод можно вызвать, чтобы уведомить адаптер об изменении значения Java Bean, если свойство Java Bean не привязано (т.е.
    T get()
    Получить обернутое значение.
    Object getBean()
    Возвращает Object, содержащий данное свойство.
    String getName()
    Возвращает имя данного свойства.
    boolean isBound()
    Может использоваться для проверки, привязано ли данное Property.
    void removeListener​(InvalidationListener listener)
    Удаляет заданный слушатель из списка слушателей, которые уведомляются всякий раз, когда значение Observable становится недействительным.
    void removeListener​(ChangeListener<? super T> listener)
    Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение ObservableValue изменяется.
    void set​(T value)
    Установить обернутое значение.
    String toString()
    Возвращает строковое представление этого объекта JavaBeanObjectProperty.
    void unbind()
    Удалить однонаправленную привязку для этого Property.
    • Методы, унаследованные от класса javafx.beans.property.ObjectProperty

      bindBidirectional, setValue, unbindBidirectional
    • Методы, унаследованные от класса javafx.beans.binding.ObjectExpression

      asString, asString, asString, getValue, isEqualTo, isEqualTo, isNotEqualTo, isNotEqualTo, isNotNull, isNull, objectExpression
    • Методы, унаследованные от класса java.lang.Object

      clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    • Методы, унаследованные от интерфейса javafx.beans.value.ObservableValue

      getValue
    • Методы, унаследованные от интерфейса javafx.beans.property.Property

      bindBidirectional, unbindBidirectional
    • Методы, унаследованные от интерфейса javafx.beans.value.WritableValue

      getValue, setValue
  • Метод Detail

    • get

      public T get()
      Получить обернутое значение. Оно должно быть идентично значению, возвращаемому из WritableValue.getValue().

      Этот метод существует только для согласования API WritableObjectValue с WritableBooleanValue и подклассами WritableNumberValue

      Определено в:
      get в интерфейсе ObservableObjectValue<T>
      Определено в:
      get в интерфейсе WritableObjectValue<T>
      Возвращает:
      Текущее значение
      Исключения:
      UndeclaredThrowableException - если вызов геттера свойства Java Bean вызывает IllegalAccessException или InvocationTargetException.
    • set

      public void set​(T value)
      Установить обернутое значение. Должно быть эквивалентно WritableValue.setValue(java.lang.Object)
      Определено в:
      set в интерфейсе WritableObjectValue<T>
      Параметры:
      value - Новое значение
      Исключения:
      UndeclaredThrowableException - если вызов геттера свойства Java Bean вызывает IllegalAccessException или InvocationTargetException.
      См. также:
      WritableObjectValue.get()
    • bind

      public void bind​(ObservableValue<? extends T> observable)
      Создать однонаправленную привязку для этого Property.

      Обратите внимание, что JavaFX реализует все вызовы bind через слабые слушатели. Это означает, что связанное свойство может быть собрано сборщиком мусора и прекратить обновление.

      Определено в:
      bind в интерфейсе Property<T>
      Параметры:
      observable - Наблюдаемое свойство, к которому должно быть привязано это Property.
    • unbind

      public void unbind()
      Удалить однонаправленную привязку для этого Property. Если Property не привязан, вызов этого метода не повлияет.
      Определено в:
      unbind в интерфейсе Property<T>
      См. также:
      Property.bind(javafx.beans.value.ObservableValue)
    • isBound

      public boolean isBound()
      Может использоваться для проверки, привязан ли Property.
      Определено в:
      isBound в интерфейсе Property<T>
      Возвращает:
      true, если Property привязан, false в противном случае
      См. также:
      Property.bind(javafx.beans.value.ObservableValue)
    • getBean

      public Object getBean()
      Возвращает Object, содержащий это свойство. Если это свойство не содержится в Object, возвращается null.
      Определено в:
      getBean в интерфейсе ReadOnlyProperty<T>
      Возвращает:
      содержащий Object или null
    • getName

      public String getName()
      Возвращает имя этого свойства. Если свойство не имеет имени, этот метод возвращает пустую String.
      Определено в:
      getName в интерфейсе ReadOnlyProperty<T>
      Возвращает:
      имя или пустую String
    • addListener

      public void addListener​(ChangeListener<? super T> listener)
      Добавляет ChangeListener, который будет уведомляться всякий раз, когда значение ObservableValue изменяется. Если один и тот же слушатель добавляется более одного раза, то он будет уведомляться более одного раза. То есть, проверка на уникальность не выполняется.

      Обратите внимание, что один и тот же фактический экземпляр ChangeListener может быть безопасно зарегистрирован для разных ObservableValues.

      ObservableValue хранит сильную ссылку на слушателя, что предотвратит сборку мусора слушателя и может привести к утечке памяти. Рекомендуется либо отменить регистрацию слушателя, вызвав removeListener после использования, либо использовать экземпляр WeakChangeListener для предотвращения этой ситуации.

      Определено в:
      addListener в интерфейсе ObservableValue<T>
      Параметры:
      listener - Слушатель для регистрации
      См. также:
      ObservableValue.removeListener(ChangeListener)
    • removeListener

      public void removeListener​(ChangeListener<? super T> listener)
      Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение ObservableValue изменяется.

      Если заданный слушатель не был ранее зарегистрирован (т.е. он никогда не добавлялся), то этот вызов метода является пустым. Если он был ранее добавлен, то он будет удален. Если он был добавлен более одного раза, то будет удален только первый экземпляр.

      Определено в:
      removeListener в интерфейсе ObservableValue<T>
      Параметры:
      listener - Слушатель для удаления
      См. также:
      ObservableValue.addListener(ChangeListener)
    • addListener

      public void addListener​(InvalidationListener listener)
      Добавляет InvalidationListener, который будет уведомляться всякий раз, когда Observable становится недоступным. Если один и тот же слушатель добавляется более одного раза, то он будет уведомляться более одного раза. То есть, проверка на уникальность не выполняется.

      Обратите внимание, что один и тот же фактический экземпляр InvalidationListener может быть безопасно зарегистрирован для разных Observables.

      Observable хранит сильную ссылку на слушателя, что предотвратит сборку мусора слушателя и может привести к утечке памяти. Рекомендуется либо отменить регистрацию слушателя, вызвав removeListener после использования, либо использовать экземпляр WeakInvalidationListener для предотвращения этой ситуации.

      Определено в:
      addListener в интерфейсе Observable
      Параметры:
      listener - Слушатель для регистрации
      См. также:
      Observable.removeListener(InvalidationListener)
    • removeListener

      public void removeListener​(InvalidationListener listener)
      Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение Observable становится недоступным.

      Если заданный слушатель не был ранее зарегистрирован (т.е. он никогда не добавлялся), то этот вызов метода является пустым. Если он был ранее добавлен, то он будет удален. Если он был добавлен более одного раза, то будет удален только первый экземпляр.

      Определено в:
      removeListener в интерфейсе Observable
      Параметры:
      listener - Слушатель для удаления
      См. также:
      Observable.addListener(InvalidationListener)
    • fireValueChangedEvent

      public void fireValueChangedEvent()
      Этот метод может быть вызван для уведомления адаптера о изменении значения Java Bean, если свойство Java Bean не привязано (т.е. оно не поддерживает PropertyChangeListeners).
      Определено в:
      fireValueChangedEvent в интерфейсе ReadOnlyJavaBeanProperty<T>
    • dispose

      public void dispose()
      Сигнализирует свойству JavaFX, что оно больше не будет использоваться, и любые ссылки могут быть удалены. Вызов этого метода обычно приводит к тому, что свойство перестает наблюдать за свойством Java Bean, аннулируя его слушателя(ей).
      Определено в:
      dispose в интерфейсе ReadOnlyJavaBeanProperty<T>
    • toString

      public String toString()
      Возвращает строковое представление этого объекта JavaBeanObjectProperty.
      Переопределяет:
      toString в классе ObjectProperty<T>
      Возвращает:
      строковое представление этого объекта JavaBeanObjectProperty.

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API