com.levigo.util.base.glazedlists
Interface FunctionList.AdvancedFunction<A,B>
- All Superinterfaces:
- FunctionList.Function<A,B>
- Enclosing class:
- FunctionList<S,E>
public static interface FunctionList.AdvancedFunction<A,B>
- extends FunctionList.Function<A,B>
An AdvancedFunction is an extension of the simple Function interface which provides more hooks
in the lifecycle of the transformation of a source element. Specifically, it includes:
-
reevaluate(A, B)
which is called when an element is mutated in place and thus run
through this mapping function again. It provides access to the previous value returned from
this function in case it is of use when remapping the same element.
-
dispose(A, B)
which is called when an element is removed from the FunctionList and is
meant to be location that cleans up any resources the Function may have allocated. (like
Listeners for example)
If neither of these extensions to FunctionList are useful, users are encouraged to implement
only the Function interface for their forward function.
Method Summary |
void |
dispose(A sourceValue,
B transformedValue)
Perform any necessary resource cleanup on the given sourceValue and
transformedValue as they are removed from the FunctionList such as installed
listeners. |
B |
reevaluate(A sourceValue,
B transformedValue)
Evaluate the sourceValue again to produce the corresponding value in the
FunctionList. |
reevaluate
B reevaluate(A sourceValue,
B transformedValue)
- Evaluate the
sourceValue
again to produce the corresponding value in the
FunctionList. The last transformedValue
is provided as a reference when
evaluating a sourceValue
that has previously been evaluated.
- Parameters:
sourceValue
- the Object to transform (again)transformedValue
- the Object produced by this function the last time it evaluated
sourceValue
- Returns:
- the transformed version of the sourceValue
dispose
void dispose(A sourceValue,
B transformedValue)
- Perform any necessary resource cleanup on the given
sourceValue
and
transformedValue
as they are removed from the FunctionList such as installed
listeners.
- Parameters:
sourceValue
- the Object that was transformedtransformedValue
- the Object that resulted from the last transformation