@FunctionalInterface public interface MonetaryOperator extends java.util.function.UnaryOperator<MonetaryAmount>
MonetaryAmount
that produces a
result of type MonetaryAmount
.
Examples might be an operator that rounds the amount to the nearest 1000, or one that performs currency conversion.
There are two equivalent ways of using a MonetaryOperator
. The first
is to invoke the method on this interface. The second is to use
MonetaryAmount.with(MonetaryOperator)
:
// these two lines are equivalent, but the second approach is recommended monetary = thisOperator.apply(monetary); monetary = monetary.with(thisOperator);It is recommended to use the second approach,
with(MonetaryOperator)
,
as it is a lot clearer to read in code.
MonetaryAmount
to
determine the result.
The input object must not be altered. Instead, an altered copy of the original must be returned. This provides equivalent, safe behavior for immutable and mutable monetary amounts.
This method may be called from multiple threads in parallel. It must be thread-safe when invoked.
This interface is considered to be adaptable/compatible with
java.util.function.UnaryOperator
as introduced in Java 8.
identity
andThen, apply, compose
Copyright © 2012–2015 JSR 354 - Expert Group. All rights reserved.