Module javafx.base

Package javafx.beans.property.adapter

Class ReadOnlyJavaBeanStringProperty

java.lang.Object

javafx.beans.binding.StringExpression

javafx.beans.property.ReadOnlyStringProperty

javafx.beans.property.ReadOnlyStringPropertyBase

javafx.beans.property.adapter.ReadOnlyJavaBeanStringProperty

All Implemented Interfaces:

Observable, ReadOnlyJavaBeanProperty<String>, ReadOnlyProperty<String>, ObservableObjectValue<String>, ObservableStringValue, ObservableValue<String>

public final class ReadOnlyJavaBeanStringProperty
extends ReadOnlyStringPropertyBase
implements ReadOnlyJavaBeanProperty<String>

A ReadOnlyJavaBeanStringProperty provides an adapter between a regular read only Java Bean property of type String and a JavaFX ReadOnlyStringProperty. It cannot be created directly, but a ReadOnlyJavaBeanStringPropertyBuilder has to be used.

As a minimum, the Java Bean must implement a getter for the property. If the getter of an instance of this class is called, the property of the Java Bean is returned. If the Java Bean property is bound (i.e. it supports PropertyChangeListeners), this ReadOnlyJavaBeanStringProperty will be aware of changes in the Java Bean. Otherwise it can be notified about changes by calling fireValueChangedEvent().

Since:

JavaFX 2.1

See Also:

ReadOnlyStringProperty, ReadOnlyJavaBeanStringPropertyBuilder

Method Summary

Modifier and Type	Method	Description
void	dispose()	Signals to the JavaFX property that it will not be used anymore and any references can be removed.
void	fireValueChangedEvent()	Sends notifications to all attached InvalidationListeners and ChangeListeners.
String	get()	Returns the current value of this ObservableObjectValue<T>.
Object	getBean()	Returns the Object that contains this property.
String	getName()	Returns the name of this property.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface javafx.beans.Observable

addListener, removeListener

Methods inherited from interface javafx.beans.value.ObservableValue

addListener, getValue, removeListener

Methods inherited from class javafx.beans.property.ReadOnlyStringProperty

toString

Methods inherited from class javafx.beans.property.ReadOnlyStringPropertyBase

addListener, addListener, removeListener, removeListener

Methods inherited from class 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

Method Detail

get

public String get()

Returns the current value of this ObservableObjectValue<T>.

Specified by:

get in interface ObservableObjectValue<String>

Returns:

The current value

Throws:

UndeclaredThrowableException - if calling the getter of the Java Bean property throws an IllegalAccessException or an InvocationTargetException.

getBean

public Object getBean()

Returns the Object that contains this property. If this property is not contained in an Object, null is returned.

Specified by:

getBean in interface ReadOnlyProperty<String>

Returns:

the containing Object or null

getName

public String getName()

Returns the name of this property. If the property does not have a name, this method returns an empty String.

Specified by:

getName in interface ReadOnlyProperty<String>

Returns:

the name or an empty String

fireValueChangedEvent

public void fireValueChangedEvent()

Sends notifications to all attached InvalidationListeners and ChangeListeners. This method needs to be called, if the value of this property changes.

Specified by:

fireValueChangedEvent in interface ReadOnlyJavaBeanProperty<String>

Overrides:

fireValueChangedEvent in class ReadOnlyStringPropertyBase

dispose

public void dispose()

Signals to the JavaFX property that it will not be used anymore and any references can be removed. A call of this method usually results in the property stopping to observe the Java Bean property by unregistering its listener(s).

Specified by:

dispose in interface ReadOnlyJavaBeanProperty<String>