Класс JavaBeanStringProperty

javafx.beans.property.adapter.JavaBeanStringProperty

Все реализуемые интерфейсы:: Observable, JavaBeanProperty<String>, ReadOnlyJavaBeanProperty<String>, Property<String>, ReadOnlyProperty<String>, ObservableObjectValue<String>, ObservableStringValue, ObservableValue<String>, WritableObjectValue<String>, WritableStringValue, WritableValue<String>

public final class JavaBeanStringProperty extends StringProperty implements JavaBeanProperty<String>

Класс JavaBeanStringProperty предоставляет адаптер между обычным свойством Java Bean типа String и JavaFX StringProperty. Его нельзя создать напрямую, но необходимо использовать JavaBeanStringPropertyBuilder.

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

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

Если класс 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

См. также:

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

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

Методы, объявленные в классе javafx.beans.property.StringProperty

bindBidirectional, bindBidirectional, bindBidirectional, setValue, toString, unbindBidirectional, unbindBidirectional

Методы, объявленные в классе javafx.beans.binding.StringExpression

concat, getValue, getValueSafe, greaterThan, greaterThan, greaterThanOrEqualTo, greaterThanOrEqualTo, isEmpty, isEqualTo, isEqualTo, isEqualToIgnoreCase, isEqualToIgnoreCase, isNotEmpty, isNotEqualTo, isNotEqualTo, isNotEqualToIgnoreCase, isNotEqualToIgnoreCase, isNotNull, isNull, length, lessThan, lessThan, lessThanOrEqualTo, lessThanOrEqualTo, stringExpression

Методы, объявленные в классе 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 String get()

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

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

set

public void set(String value)

Устанавливает обернутое значение. Должно быть эквивалентно WritableValue.setValue(java.lang.Object)

Указано:

set в интерфейсе WritableObjectValue<String>

Параметры:

value - Новое значение

Исключение:

UndeclaredThrowableException - если при вызове геттера свойства Java Bean возникает IllegalAccessException или InvocationTargetException.

См. также:

bind

public void bind(ObservableValue<? extends String> observable)

Создать однонаправленную привязку для этого Property.

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

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

unbind

public void unbind()

Удаляет однонаправленную привязку для этого Property. Если Property не привязан, вызов этого метода не оказывает никакого влияния.

Указано:

unbind в интерфейсе Property<String>

См. также:

isBound

public boolean isBound()

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

Указано:

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

Возвращает:

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

См. также:

getBean

public Object getBean()

Возвращает Object, содержащий это свойство. Если это свойство не содержится в Object, возвращается null.

Указано:: getBean в интерфейсе ReadOnlyProperty<String>
Возвращает:: содержащий Object или null

getName

public String getName()

Возвращает имя этого свойства. Если свойство не имеет имени, этот метод возвращает пустую String.

Указано:: getName в интерфейсе ReadOnlyProperty<String>
Возвращает:: имя или пустую String

addListener

public void addListener(ChangeListener<? super String> listener)

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

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

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

Указано:

addListener в интерфейсе ObservableValue<String>

Параметры:

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

См. также:

removeListener

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

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

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

Указано:

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

Параметры:

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<String>

dispose

public void dispose()

Сигнализирует свойству JavaFX, что оно больше не будет использоваться, и все ссылки могут быть удалены. Вызов этого метода обычно приводит к прекращению наблюдения свойством Java Bean за свойством Java Bean путем отмены регистрации его слушателя(ей).

Указано:: dispose в интерфейсе ReadOnlyJavaBeanProperty<String>

© 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.