Класс 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>

Type Parameters:: T - тип обернутого Object

All Implemented Interfaces:: 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>

Класс предоставляет адаптер между обычным свойством Java Bean типа T и JavaFX ObjectProperty<T>. Его нельзя создать напрямую, но нужно использовать JavaBeanObjectPropertyBuilder.

Как минимум, класс Java Bean должен реализовывать метод получения и установки значения свойства. Класс, а также методы получения и установки значения, должны быть объявлены как public. Если вызвать метод получения значения экземпляра этого класса, будет возвращено значение свойства Java Bean. Если вызвать метод установки значения, значение будет передано в свойство Java Bean. Если свойство Java Bean привязано (т. е. поддерживает PropertyChangeListeners), это адаптер будет отслеживать изменения в Java Bean. В противном случае, об изменениях можно сообщить, вызвав fireValueChangedEvent(). Если свойство Java Bean также ограничено (т. е. поддерживает VetoableChangeListeners), это адаптер будет отклонять изменения, если оно привязано к 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 содержащий пакет безусловно.

Since:

JavaFX 2.1

See Also:

Краткое описание методов

Модификатор и тип	Метод	Описание
`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()`	Возвращает текущее значение этого `ObservableObjectValue<T>`.
`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.Observable

subscribe

Методы, объявленные в интерфейсе javafx.beans.value.ObservableValue

flatMap, getValue, map, orElse, subscribe, subscribe, when

Методы, объявленные в интерфейсе javafx.beans.property.Property

bindBidirectional, unbindBidirectional

Методы, объявленные в интерфейсе javafx.beans.value.WritableValue

getValue, setValue

Подробное описание методов

get

public T get()

Возвращает текущее значение этого ObservableObjectValue<T>.

Определено:: 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.

См. также:

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>

См. также:

isBound

public boolean isBound()

Можно использовать для проверки, привязано ли Property.

Определено:

isBound в интерфейсе Property<T>

Возвращает:

true, если Property привязано, false в противном случае

См. также:

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 - Слушатель для регистрации

См. также:

removeListener

public void removeListener(ChangeListener<? super T> listener)

Удаляет указанного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение ObservableValue изменяется.

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

Определено:

removeListener в интерфейсе ObservableValue<T>

Параметры:

listener - Слушатель для удаления

См. также:

addListener

public void addListener(InvalidationListener listener)

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

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

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

Определено:

addListener в интерфейсе Observable

Параметры:

listener - Слушатель для регистрации

См. также:

removeListener

public void removeListener(InvalidationListener listener)

Удаляет указанного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение Observable становится недействительным.

Определено:

removeListener в интерфейсе Observable

Параметры:

listener - Слушатель для удаления

См. также:

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.