O- the type of the nesting hierarchy's inner
public interface Nesting<O extends javafx.beans.Observable>
A nesting encapsulates a hierarchy of nested
ObservableValues, often simply called observables, and nesting steps which lead from one observable to the next.
At the top of the hierarchy stands one of the observables, the so called outer observable. A nesting step will use its value to return the next observable. The next step will use that observable's value to return the next observable and so on. All observables returned by nesting steps are called nested observables. Finally and perhaps most importantly, the last step will lead to the hierarchy's inner observable.
As nesting steps require a value to be accessible, all observables on which a step is used must provide a value.
Hence they must all implement
ObservableValue. No step is used on the inner observable so it
suffices that it implements
Employeewhich has an
Property<Address> address, where
StringProperty streetName. There might be a
Property<Employee> currentEmployee, which always holds the current employee.
In this case the hierarchy would be
currentEmployee -> address -> streetName where
the outer observable and
streetName are nested observables. Additionally,
streetName is the inner observable.
innerObservableproperty. In this case it is said to be present. The same is true if only the inner observable contains null.
If any nesting step returns null or any observable except the inner contains null as a value, the nesting hierarchy
can not be fully accessed. The inner observable is said to be missing and the
Nestingcan be created with dedicated builders. These can be obtained by starting with one of the methods in
Nestings. More details can be found there.
|Type||Property and Description|
A property holding the current inner observable in the hierarchy as an optional.
This documentation is licensed under CC-BY 4.0, attributed to Nicolai Parlog from CodeFX.