javafx.beans.property.adapter

Class ReadOnlyJavaBeanObjectProperty<T>

java.lang.Object

<any>

javafx.beans.property.adapter.ReadOnlyJavaBeanObjectProperty<T>

All Implemented Interfaces:

ReadOnlyJavaBeanProperty<T>

public final class ReadOnlyJavaBeanObjectProperty<T>
extends <any>
implements ReadOnlyJavaBeanProperty<T>

A ReadOnlyJavaBeanObjectProperty provides an adapter between a regular read only Java Bean property of T and a JavaFX ReadOnlyObjectProperty. It cannot be created directly, but a ReadOnlyJavaBeanObjectPropertyBuilder has to be used.

As a minimum, the Java Bean class must implement a getter for the property. The class, as well as the getter method, must be declared public. 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 ReadOnlyJavaBeanObjectProperty will be aware of changes in the Java Bean. Otherwise it can be notified about changes by calling fireValueChangedEvent().

Deploying an Application as a Module

If the Java Bean class is in a named module, then it must be reflectively accessible to the javafx.base module. A class is reflectively accessible if the module opens the containing package to at least the javafx.base module.

For example, if com.foo.MyBeanClass is in the foo.app module, the module-info.java might look like this:

 module foo.app {
    opens com.foo to javafx.base;
}

Alternatively, a class is reflectively accessible if the module exports the containing package unconditionally.

Since:

JavaFX 2.1

See Also:

javafx.beans.property.ReadOnlyObjectProperty, ReadOnlyJavaBeanObjectPropertyBuilder

Field Summary

Fields

Modifier and Type	Field and Description
private java.security.AccessControlContext	acc
private ReadOnlyPropertyDescriptor	descriptor
private <any>	listener

Constructor Summary

Constructors

Constructor and Description
ReadOnlyJavaBeanObjectProperty(ReadOnlyPropertyDescriptor descriptor, java.lang.Object bean)

Method Summary

Modifier and Type	Method and Description
void	dispose() Signals to the JavaFX property that it will not be used anymore and any references can be removed.
void	fireValueChangedEvent() This method can be called to notify the adapter of a change of the Java Bean value, if the Java Bean property is not bound (i.e.
T	get()
java.lang.Object	getBean()
java.lang.String	getName()

Methods inherited from class java.lang.Object

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

Field Detail

descriptor

private final ReadOnlyPropertyDescriptor descriptor

listener

private final <any> listener

acc

private final java.security.AccessControlContext acc

Constructor Detail

ReadOnlyJavaBeanObjectProperty

ReadOnlyJavaBeanObjectProperty(ReadOnlyPropertyDescriptor descriptor,
                               java.lang.Object bean)

Method Detail

get

public T get()

Throws:

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

getBean

public java.lang.Object getBean()

getName

public java.lang.String getName()

fireValueChangedEvent

public void fireValueChangedEvent()

This method can be called to notify the adapter of a change of the Java Bean value, if the Java Bean property is not bound (i.e. it does not support PropertyChangeListeners).

Specified by:

fireValueChangedEvent in interface ReadOnlyJavaBeanProperty<T>

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