Класс JavaBeanLongProperty

javafx.beans.property.adapter.JavaBeanLongProperty

Все реализованные интерфейсы:: NumberExpression, Observable, JavaBeanProperty<Number>, ReadOnlyJavaBeanProperty<Number>, Property<Number>, ReadOnlyProperty<Number>, ObservableLongValue, ObservableNumberValue, ObservableValue<Number>, WritableLongValue, WritableNumberValue, WritableValue<Number>

public final class JavaBeanLongProperty extends LongProperty implements JavaBeanProperty<Number>

Класс JavaBeanLongProperty предоставляет адаптер между обычным свойством Java Bean типа long или Long и JavaFX LongProperty. Его нельзя создать напрямую, но необходимо использовать JavaBeanLongPropertyBuilder.

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

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

Если класс 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 Number> listener)`	Добавляет `ChangeListener`, который будет уведомляться всякий раз, когда значение `ObservableValue` изменяется.
`void`	`bind(ObservableValue<? extends Number> observable)`	Создает однонаправленную привязку для этого `Property`.
`void`	`dispose()`	Уведомляет свойство JavaFX о том, что оно больше не будет использоваться, и любые ссылки могут быть удалены.
`void`	`fireValueChangedEvent()`	Этот метод может быть вызван для уведомления адаптера об изменении значения Java Bean, если свойство Java Bean не привязано (т.е.
`long`	`get()`	Получить обернутое значение.
`Object`	`getBean()`	Возвращает `Object`, содержащий это свойство.
`String`	`getName()`	Возвращает имя этого свойства.
`boolean`	`isBound()`	Может использоваться для проверки, привязано ли `Property`.
`void`	`removeListener(InvalidationListener listener)`	Удаляет указанного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение `Observable` становится недоступным.
`void`	`removeListener(ChangeListener<? super Number> listener)`	Удаляет указанного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение `ObservableValue` изменяется.
`void`	`set(long value)`	Установить обернутое значение.
`String`	`toString()`	Возвращает строковое представление этого объекта `JavaBeanLongProperty`.
`void`	`unbind()`	Удалить однонаправленную привязку для этого `Property`.

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

asObject, bindBidirectional, longProperty, setValue, unbindBidirectional

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

readOnlyLongProperty

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

add, add, add, add, divide, divide, divide, divide, doubleValue, floatValue, getValue, intValue, longExpression, longExpression, longValue, multiply, multiply, multiply, multiply, negate, subtract, subtract, subtract, subtract

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

add, asString, asString, asString, divide, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThanOrEqualTo, greaterThanOrEqualTo, greaterThanOrEqualTo, greaterThanOrEqualTo, greaterThanOrEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, lessThan, lessThan, lessThan, lessThan, lessThan, lessThanOrEqualTo, lessThanOrEqualTo, lessThanOrEqualTo, lessThanOrEqualTo, lessThanOrEqualTo, multiply, numberExpression, subtract

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

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

get

public long get()

Получить обернутое значение. В отличие от WritableValue.getValue(), этот метод возвращает примитивный long. Должен быть идентичен WritableValue.getValue().

Указано в:: get в интерфейсе ObservableLongValue
Указано в:: get в интерфейсе WritableLongValue
Возвращает:: Текущее значение
Использует исключения:: UndeclaredThrowableException - если вызов геттера свойства Java Bean вызывает IllegalAccessException или InvocationTargetException.

set

public void set(long value)

Установить обернутое значение. В отличие от WritableLongValue.setValue(java.lang.Number), этот метод использует примитивный long.

Указано в:: set в интерфейсе WritableLongValue
Параметры:: value - Новое значение
Использует исключения:: UndeclaredThrowableException - если вызов геттера свойства Java Bean вызывает IllegalAccessException или InvocationTargetException.

bind

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

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

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

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

unbind

public void unbind()

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

Указано в:

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

См. также:

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

isBound

public boolean isBound()

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

Указано в:

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

Возвращает:

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

См. также:

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

getBean

public Object getBean()

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

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

getName

public String getName()

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

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

addListener

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

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

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

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

Указано в:

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

Параметры:

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

См. также:

ObservableValue.removeListener(ChangeListener)

removeListener

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

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

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

Указано в:

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

Параметры:

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

dispose

public void dispose()

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

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

toString

public String toString()

Возвращает строковое представление этого объекта JavaBeanLongProperty.

Переопределяет:: toString в классе LongProperty
Возвращает:: строковое представление этого объекта JavaBeanLongProperty.

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