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

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

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

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

См. также:

WritableObjectValue.get()

bind

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

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

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

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

unbind

public void unbind()

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

Определено в:

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

См. также:

Property.bind(javafx.beans.value.ObservableValue)

isBound

public boolean isBound()

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

Определено в:

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

Возвращает:

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

См. также:

Property.bind(javafx.beans.value.ObservableValue)

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

См. также:

ObservableValue.removeListener(ChangeListener)

removeListener

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

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

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

Определено в:

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

Параметры:

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

dispose

public void dispose()

Сигнализирует свойству JavaFX, что оно больше не будет использоваться, и все ссылки могут быть удалены. Вызов этого метода обычно приводит к тому, что свойство перестает наблюдать за свойством 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.