net.digitalid.utility.functional.failable

Interface FailableUnaryOperator<TYPE,EXCEPTION extends Exception>

All Superinterfaces:

FailableUnaryFunction<TYPE,TYPE,EXCEPTION>

All Known Subinterfaces:

UnaryOperator<TYPE>

@Immutable
 @Functional
public interface FailableUnaryOperator<TYPE,EXCEPTION extends Exception>
extends FailableUnaryFunction<TYPE,TYPE,EXCEPTION>

This functional interface models a failable unary operator that maps an object of type TYPE to another object of type TYPE.

Method Summary

Modifier and Type	Method and Description
default @Nonnull FailableUnaryOperator<TYPE,EXCEPTION>	after(@Nonnull FailableUnaryOperator<TYPE,? extends EXCEPTION> operator) Returns the composition of the given operator followed by this operator.
default @Nonnull FailableUnaryOperator<TYPE,EXCEPTION>	before(@Nonnull FailableUnaryOperator<TYPE,? extends EXCEPTION> operator) Returns the composition of this operator followed by the given operator.
static <TYPE,EXCEPTION extends Exception> @Nonnull FailableUnaryOperator<TYPE,EXCEPTION>	compose(@Nonnull FailableUnaryOperator<TYPE,? extends EXCEPTION> operator0, @Nonnull FailableUnaryOperator<TYPE,? extends EXCEPTION> operator1) Returns the composition of the given operators with a flexible exception type.
default @Nonnull FailableUnaryOperator<TYPE,EXCEPTION>	propagateNull() Returns a new function based on this function that propagates null instead of evaluating it.
default @Nonnull FailableUnaryOperator<TYPE,EXCEPTION>	replaceNull(TYPE defaultOutput) Returns a new function based on this function that returns the given default output for null.
default @Nonnull UnaryOperator<TYPE>	suppressExceptions() Returns a function that suppresses the exceptions of this function and returns null instead.
default @Nonnull UnaryOperator<TYPE>	suppressExceptions(@Nonnull Consumer<? super Exception> handler) Returns a function that catches the exceptions of this function, passes them to the given exception handler and returns null instead.
default @Nonnull UnaryOperator<TYPE>	suppressExceptions(@Nonnull Consumer<? super Exception> handler, TYPE defaultOutput) Returns a function that catches the exceptions of this function, passes them to the given exception handler and returns the given default output instead.
default @Nonnull UnaryOperator<TYPE>	suppressExceptions(TYPE defaultOutput) Returns a function that suppresses the exceptions of this function and returns the given default output instead.

Methods inherited from interface net.digitalid.utility.functional.failable.FailableUnaryFunction

after, before, compose, evaluate

Method Detail

suppressExceptions

@Pure
 @Nonnull
default @Nonnull UnaryOperator<TYPE> suppressExceptions(@Captured @Nonnull
                                                                        @Nonnull Consumer<? super Exception> handler,
                                                                        @Captured
                                                                        TYPE defaultOutput)

Description copied from interface: FailableUnaryFunction

Returns a function that catches the exceptions of this function, passes them to the given exception handler and returns the given default output instead.

Specified by:

suppressExceptions in interface FailableUnaryFunction<TYPE,TYPE,EXCEPTION extends Exception>

suppressExceptions

@Pure
 @Nonnull
default @Nonnull UnaryOperator<TYPE> suppressExceptions(@Captured @Nonnull
                                                                        @Nonnull Consumer<? super Exception> handler)

Description copied from interface: FailableUnaryFunction

Returns a function that catches the exceptions of this function, passes them to the given exception handler and returns null instead.

Specified by:

suppressExceptions in interface FailableUnaryFunction<TYPE,TYPE,EXCEPTION extends Exception>

suppressExceptions

@Pure
 @Nonnull
default @Nonnull UnaryOperator<TYPE> suppressExceptions(@Captured
                                                                        TYPE defaultOutput)

Description copied from interface: FailableUnaryFunction

Returns a function that suppresses the exceptions of this function and returns the given default output instead.

Specified by:

suppressExceptions in interface FailableUnaryFunction<TYPE,TYPE,EXCEPTION extends Exception>

suppressExceptions

@Pure
 @Nonnull
default @Nonnull UnaryOperator<TYPE> suppressExceptions()

Description copied from interface: FailableUnaryFunction

Returns a function that suppresses the exceptions of this function and returns null instead.

Specified by:

suppressExceptions in interface FailableUnaryFunction<TYPE,TYPE,EXCEPTION extends Exception>

compose

@Pure
 @Nonnull
static <TYPE,EXCEPTION extends Exception> @Nonnull FailableUnaryOperator<TYPE,EXCEPTION> compose(@Nonnull
                                                                                                                 @Nonnull FailableUnaryOperator<TYPE,? extends EXCEPTION> operator0,
                                                                                                                 @Nonnull
                                                                                                                 @Nonnull FailableUnaryOperator<TYPE,? extends EXCEPTION> operator1)

Returns the composition of the given operators with a flexible exception type.

before

@Pure
 @Nonnull
default @Nonnull FailableUnaryOperator<TYPE,EXCEPTION> before(@Nonnull
                                                                              @Nonnull FailableUnaryOperator<TYPE,? extends EXCEPTION> operator)

Returns the composition of this operator followed by the given operator. Unfortunately, it is not possible to make the exception type flexible.

See Also:

compose(net.digitalid.utility.functional.failable.FailableUnaryOperator, net.digitalid.utility.functional.failable.FailableUnaryOperator)

after

@Pure
 @Nonnull
default @Nonnull FailableUnaryOperator<TYPE,EXCEPTION> after(@Nonnull
                                                                             @Nonnull FailableUnaryOperator<TYPE,? extends EXCEPTION> operator)

Returns the composition of the given operator followed by this operator. Unfortunately, it is not possible to make the exception type flexible.

See Also:

compose(net.digitalid.utility.functional.failable.FailableUnaryOperator, net.digitalid.utility.functional.failable.FailableUnaryOperator)

replaceNull

@Pure
 @Nonnull
default @Nonnull FailableUnaryOperator<TYPE,EXCEPTION> replaceNull(@Captured
                                                                                   TYPE defaultOutput)

Description copied from interface: FailableUnaryFunction

Returns a new function based on this function that returns the given default output for null.

Specified by:

replaceNull in interface FailableUnaryFunction<TYPE,TYPE,EXCEPTION extends Exception>

propagateNull

@Pure
 @Nonnull
default @Nonnull FailableUnaryOperator<TYPE,EXCEPTION> propagateNull()

Description copied from interface: FailableUnaryFunction

Returns a new function based on this function that propagates null instead of evaluating it.

Specified by:

propagateNull in interface FailableUnaryFunction<TYPE,TYPE,EXCEPTION extends Exception>