JavaBeanStringProperty — OpenJavaFX 11

java.lang.Object
- javafx.beans.binding.StringExpression
- - javafx.beans.property.ReadOnlyStringProperty
  - - javafx.beans.property.StringProperty
    - - 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

См. также:

StringProperty, JavaBeanStringPropertyBuilder

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

Все методыМетоды экземпляраКонкретные методы
Модификатор и тип	Метод	Описание
`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.value.ObservableValue
getValue

Методы унаследованные от интерфейса 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.
  Обратите внимание, что в JavaFX все вызовы bind реализованы с помощью слабых слушателей. Это означает, что связанное свойство может быть удалено из памяти и перестанет обновляться.
  
  Определено в:
  
  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.

Класс JavaBeanStringProperty

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

Методы унаследованные от класса javafx.beans.property.StringProperty

Методы унаследованные от класса javafx.beans.binding.StringExpression

Методы унаследованные от класса java.lang.Object

Методы унаследованные от интерфейса javafx.beans.value.ObservableValue

Методы унаследованные от интерфейса javafx.beans.property.Property

Методы унаследованные от интерфейса javafx.beans.value.WritableValue

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

get

set

bind

unbind

isBound

getBean

getName

addListener

removeListener

addListener

removeListener

fireValueChangedEvent

dispose