- 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и JavaFXObjectProperty<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
-
Краткое описание методов
Все методыМетоды экземпляраКонкретные методы Модификатор и тип Метод Описание voidaddListener(InvalidationListener listener)ДобавляетInvalidationListener, который будет уведомляться всякий раз, когдаObservableстановится недействительным.voidaddListener(ChangeListener<? super T> listener)ДобавляетChangeListener, который будет уведомляться всякий раз, когда значениеObservableValueизменяется.voidbind(ObservableValue<? extends T> observable)Создает однонаправленную привязку для этогоProperty.voiddispose()Сигнализирует свойству JavaFX, что оно больше не будет использоваться, и все ссылки могут быть удалены.voidfireValueChangedEvent()Этот метод можно вызвать, чтобы уведомить адаптер об изменении значения Java Bean, если свойство Java Bean не привязано (т.е.Tget()Получить обернутое значение.ObjectgetBean()ВозвращаетObject, содержащий данное свойство.StringgetName()Возвращает имя данного свойства.booleanisBound()Может использоваться для проверки, привязано ли данноеProperty.voidremoveListener(InvalidationListener listener)Удаляет заданный слушатель из списка слушателей, которые уведомляются всякий раз, когда значениеObservableстановится недействительным.voidremoveListener(ChangeListener<? super T> listener)Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значениеObservableValueизменяется.voidset(T value)Установить обернутое значение.StringtoString()Возвращает строковое представление этого объектаJavaBeanObjectProperty.voidunbind()Удалить однонаправленную привязку для этого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 через слабые слушатели. Это означает, что связанное свойство может быть собрано сборщиком мусора и прекратить обновление.
-
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.