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

Все реализованные интерфейсы:: 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

См. также:

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

Модификатор и тип	Метод	Описание
`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.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()

Получить обернутое значение. Оно должно быть идентично значению, возвращаемому методом 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.