javafx.scene.control.cell

Class TreeItemPropertyValueFactory<S,T>

java.lang.Object

javafx.scene.control.cell.TreeItemPropertyValueFactory<S,T>

public class TreeItemPropertyValueFactory<S,T>
extends java.lang.Object

A convenience implementation of the Callback interface, designed specifically for use within the TreeTableColumn cell value factory. An example of how to use this class is:

 TreeTableColumn<Person,String> firstNameCol = new TreeTableColumn<Person,String>("First Name");
 firstNameCol.setCellValueFactory(new TreeItemPropertyValueFactory<Person,String>("firstName"));
 

In this example, Person is the class type of the TreeItem instances used in the TreeTableView. The class Person must be declared public. TreeItemPropertyValueFactory uses the constructor argument, "firstName", to assume that Person has a public method firstNameProperty with no formal parameters and a return type of ObservableValue<String>.

If such a method exists, then it is invoked, and additionally assumed to return an instance of Property<String>. The return value is used to populate the TreeTableCell. In addition, the TreeTableView adds an observer to the return value, such that any changes fired will be observed by the TreeTableView, resulting in the cell immediately updating.

If no such method exists, then TreeItemPropertyValueFactory assumes that Person has a public method getFirstName or isFirstName with no formal parameters and a return type of String. If such a method exists, then it is invoked, and its return value is wrapped in a ReadOnlyObjectWrapper and returned to the TreeTableCell. In this situation, the TreeTableCell will not be able to observe changes to the property, unlike in the first approach above.

For reference (and as noted in the TreeTableColumn cell value factory documentation), the long form of the code above would be the following:

 TreeTableColumn<Person,String> firstNameCol = new TreeTableColumn<Person,String>("First Name");
 
 firstNameCol.setCellValueFactory(new Callback<CellDataFeatures<Person, String>, ObservableValue<String>>() {
     public ObservableValue<String> call(CellDataFeatures<Person, String> p) {
         // p.getValue() returns the TreeItem<Person> instance for a particular
         // TreeTableView row, and the second getValue() call returns the
         // Person instance contained within the TreeItem.
         return p.getValue().getValue().firstNameProperty();
     }
  });
 
 }
 

Deploying an Application as a Module

If the referenced 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. Otherwise the call(TreeTableColumn.CellDataFeatures) method will log a warning and return null.

For example, if the Person class is in the com.foo package 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 8.0

See Also:

TreeTableColumn, TreeTableView, TreeTableCell, PropertyValueFactory, MapValueFactory

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.Class<?>	columnClass
private java.lang.String	previousProperty
private java.lang.String	property
private <any>	propertyRef

Constructor Summary

Constructors

Constructor and Description
TreeItemPropertyValueFactory(java.lang.String property) Creates a default PropertyValueFactory to extract the value from a given TableView row item reflectively, using the given property name.

Method Summary

Modifier and Type	Method and Description
<any>	call(<any> param)
private <any>	getCellDataReflectively(S rowData)
java.lang.String	getProperty() Returns the property name provided in the constructor.

Methods inherited from class java.lang.Object

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

Field Detail

property

private final java.lang.String property

columnClass

private java.lang.Class<?> columnClass

previousProperty

private java.lang.String previousProperty

propertyRef

private <any> propertyRef

Constructor Detail

TreeItemPropertyValueFactory

public TreeItemPropertyValueFactory(java.lang.String property)

Creates a default PropertyValueFactory to extract the value from a given TableView row item reflectively, using the given property name.

Parameters:

property - The name of the property with which to attempt to reflectively extract a corresponding value for in a given object.

Method Detail

call

public <any> call(<any> param)

getProperty

public final java.lang.String getProperty()

Returns the property name provided in the constructor.

Returns:

the property name provided in the constructor

getCellDataReflectively

private <any> getCellDataReflectively(S rowData)