Module powerunit.exceptions

Package ch.powerunit.extensions.exceptions

Interface UnaryOperatorWithException<T,E extends Exception>

Type Parameters:

T - the type of the operand and result of the operator

All Superinterfaces:

ExceptionHandlerSupport<T,E>, FunctionWithException<T,T,E>, ObjectReturnExceptionHandlerSupport<Function<T,R>,Function<T,Optional<R>>,Function<T,CompletionStage<R>>,R>

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface UnaryOperatorWithException<T,E extends Exception>
extends FunctionWithException<T,T,E>

Represents an operation on a single operand that produces a result of the same type as its operand. This is a specialization of FunctionWithException for the case where the operand and result are of the same type.

As this interface must return the same type of the input, a lifted version which returns Optional is not possible.

General contract

• T apply(T t) throws E - The functional method.
• uncheck - Return a UnaryOperator<T>
• lift - Return a Function<T,Optional<T>
• ignore - Return a UnaryOperator<T>

See Also:

FunctionWithException, UnaryOperator

Method Summary

Modifier and Type	Method	Description
static <T,E extends Exception> UnaryOperatorWithException<T,E>	failing(Supplier<E> exceptionBuilder)	Returns a unary operator that always throw exception.
static <T,E extends Exception> UnaryOperatorWithException<T,E>	identity()	Returns a unary operator that always returns its input argument.
default UnaryOperator<T>	ignore()	Converts this UnaryOperatorWithException to a lifted UnaryOperator returning null in case of exception.
static <T,E extends Exception> UnaryOperator<T>	ignored(UnaryOperatorWithException<T,E> function)	Converts a UnaryOperatorWithException to a lifted UnaryOperator returning null in case of exception.
static <T,E extends Exception> Function<T,Optional<T>>	lifted(UnaryOperatorWithException<T,E> function)	Converts a UnaryOperatorWithException to a lifted Function returning Optional.
default UnaryOperator<T>	uncheck()	Converts this UnaryOperatorWithException to a UnaryOperator that wraps exception to RuntimeException.
static <T,E extends Exception> UnaryOperator<T>	unchecked(UnaryOperatorWithException<T,E> function)	Converts a UnaryOperatorWithException to a UnaryOperator that wraps exception to RuntimeException.
static <T,E extends Exception> UnaryOperator<T>	unchecked(UnaryOperatorWithException<T,E> function, Function<Exception,RuntimeException> exceptionMapper)	Converts a UnaryOperatorWithException to a UnaryOperator that wraps exception to RuntimeException by using the provided mapping function.

Methods inherited from interface ch.powerunit.extensions.exceptions.ExceptionHandlerSupport

exceptionMapper, exceptionMapperFor

Methods inherited from interface ch.powerunit.extensions.exceptions.FunctionWithException

andThen, apply, asBiFunction, asBiFunction, asCallable, asCallable, asConsumer, asConsumer, asRunnable, asRunnable, asSupplier, asSupplier, compose, ignored, lift, lifted, stage, staged, unchecked, unchecked

Methods inherited from interface ch.powerunit.extensions.exceptions.ObjectReturnExceptionHandlerSupport

notThrowingHandler, staged, throwingHandler, unchecked

Method Detail

uncheck

default UnaryOperator<T> uncheck()

Converts this UnaryOperatorWithException to a UnaryOperator that wraps exception to RuntimeException.

Specified by:

uncheck in interface ExceptionHandlerSupport<T,E extends Exception>

Specified by:

uncheck in interface FunctionWithException<T,T,E extends Exception>

Specified by:

uncheck in interface ObjectReturnExceptionHandlerSupport<Function<T,R>,Function<T,Optional<R>>,Function<T,CompletionStage<R>>,R>

Returns:

the unchecked function

See Also:

FunctionWithException.unchecked(FunctionWithException), FunctionWithException.unchecked(FunctionWithException, Function)

ignore

default UnaryOperator<T> ignore()

Converts this UnaryOperatorWithException to a lifted UnaryOperator returning null in case of exception.

Specified by:

ignore in interface ExceptionHandlerSupport<T,E extends Exception>

Specified by:

ignore in interface FunctionWithException<T,T,E extends Exception>

Specified by:

ignore in interface ObjectReturnExceptionHandlerSupport<Function<T,R>,Function<T,Optional<R>>,Function<T,CompletionStage<R>>,R>

Returns:

the function that ignore error

See Also:

FunctionWithException.ignored(FunctionWithException)

identity

static <T,E extends Exception> UnaryOperatorWithException<T,E> identity()

Returns a unary operator that always returns its input argument.

Type Parameters:

T - the type of the input and output of the operator

E - the type of the potential exception

Returns:

a unary operator that always returns its input argument

See Also:

Function.identity()

failing

static <T,E extends Exception> UnaryOperatorWithException<T,E> failing(Supplier<E> exceptionBuilder)

Returns a unary operator that always throw exception.

Type Parameters:

T - the type of the input and output of the operator

E - the type of the exception

Parameters:

exceptionBuilder - the supplier to create the exception

Returns:

a function that always throw exception

unchecked

static <T,E extends Exception> UnaryOperator<T> unchecked(UnaryOperatorWithException<T,E> function)

Converts a UnaryOperatorWithException to a UnaryOperator that wraps exception to RuntimeException.

Type Parameters:

T - the type of the input and output of the operator

E - the type of the potential exception

Parameters:

function - to be unchecked

Returns:

the unchecked exception

Throws:

NullPointerException - if function is null

See Also:

uncheck(), unchecked(UnaryOperatorWithException, Function)

unchecked

static <T,E extends Exception> UnaryOperator<T> unchecked(UnaryOperatorWithException<T,E> function,
                                                          Function<Exception,RuntimeException> exceptionMapper)

Converts a UnaryOperatorWithException to a UnaryOperator that wraps exception to RuntimeException by using the provided mapping function.

Type Parameters:

T - the type of the input and output of the operator

E - the type of the potential exception

Parameters:

function - the be unchecked

exceptionMapper - a function to convert the exception to the runtime exception.

Returns:

the unchecked exception

Throws:

NullPointerException - if function or exceptionMapper is null

See Also:

uncheck(), unchecked(UnaryOperatorWithException)

lifted

static <T,E extends Exception> Function<T,Optional<T>> lifted(UnaryOperatorWithException<T,E> function)

Converts a UnaryOperatorWithException to a lifted Function returning Optional.

Type Parameters:

T - the type of the input and output of the operator

E - the type of the potential exception

Parameters:

function - to be lifted

Returns:

the lifted function

Throws:

NullPointerException - if function is null

See Also:

ignore()

ignored

static <T,E extends Exception> UnaryOperator<T> ignored(UnaryOperatorWithException<T,E> function)

Converts a UnaryOperatorWithException to a lifted UnaryOperator returning null in case of exception.

Type Parameters:

T - the type of the input and output of the operator

E - the type of the potential exception

Parameters:

function - to be lifted

Returns:

the lifted function

Throws:

NullPointerException - if function is null

See Also:

ignore()