org.codefx.libfx.nesting

Class NestingObserver<O extends javafx.beans.Observable>

java.lang.Object

org.codefx.libfx.nesting.NestingObserver<O>

Type Parameters:

O - the type of the nesting hierarchy's inner Observable

public final class NestingObserver<O extends javafx.beans.Observable>
extends Object

Usability class which observes a Nesting and executes some methods when the nesting's innerObservable changes. These are the methods and the order in which they are called:

1. if the old inner observable was present, a method is called with that observable as its argument; the method is specified during building (see withOldInnerObservable)
2. if the new inner observable is present, a method is called with that observable as its argument; the method is specified during building (see withNewInnerObservable)
3. in every case, another method is called with two Booleans as its arguments which indicate whether the old and the new observable were/are present; the method is specified during building (see whenInnerObservableChanges)

These methods are also called once during construction. At this point, there is of course no old inner observable present.

The observer is created with a NestingObserver.NestingObserverBuilder which can be obtained from forNesting. After setting some of the methods mentioned above, the observer is built by calling NestingObserver.NestingObserverBuilder.observe().

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NestingObserver.NestingObserverBuilder<O extends javafx.beans.Observable> Builds a NestingObserver.

Method Summary

Modifier and Type	Method and Description
static <O extends javafx.beans.Observable> NestingObserver.NestingObserverBuilder<O>	forNesting(Nesting<O> nesting) Starts building a new NestingObserver which observes the specified nesting.

Methods inherited from class java.lang.Object

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

Method Detail

forNesting

public static <O extends javafx.beans.Observable> NestingObserver.NestingObserverBuilder<O> forNesting(Nesting<O> nesting)

Starts building a new NestingObserver which observes the specified nesting.

Type Parameters:

O - the type of the nesting hierarchy's inner Observable

Parameters:

nesting - the observed Nesting

Returns:

a new NestingObserver.NestingObserverBuilder