Module powerunit.exceptions

Package ch.powerunit.extensions.exceptions

Interface FunctionWithException<T,R,E extends Exception>

Type Parameters:

T - the type of the input to the function

R - the type of the result of the function

E - the type of the potential exception of the function

All Superinterfaces:

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

All Known Subinterfaces:

UnaryOperatorWithException<T,E>

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 FunctionWithException<T,R,E extends Exception>
extends ObjectReturnExceptionHandlerSupport<Function<T,R>,Function<T,Optional<R>>,Function<T,CompletionStage<R>>,R>

Represents a function that accepts one argument, may throw exception and produces a result.

General contract

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

See Also:

Function

Method Summary

Modifier and Type	Method	Description
default <V> FunctionWithException<T,V,E>	andThen(FunctionWithException<? super R,? extends V,? extends E> after)	Returns a composed function that first applies this function to its input, and then applies the after function to the result.
R	apply(T t)	Applies this function to the given argument.
default <U> BiFunctionWithException<T,U,R,E>	asBiFunction()	Converts a FunctionWithException to a BiFunctionWithException.
static <T,U,R,E extends Exception> BiFunctionWithException<T,U,R,E>	asBiFunction(FunctionWithException<T,R,E> function)	Converts a FunctionWithException to a BiFunctionWithException.
static <T,R,E extends Exception> Callable<R>	asCallable(FunctionWithException<T,R,E> function, T t)	Converts a FunctionWithException to a Callable.
default Callable<R>	asCallable(T t)	Converts a FunctionWithException to a Callable.
default ConsumerWithException<T,E>	asConsumer()	Converts a FunctionWithException to a ConsumerWithException.
static <T,R,E extends Exception> ConsumerWithException<T,E>	asConsumer(FunctionWithException<T,R,E> function)	Converts a FunctionWithException to a ConsumerWithException.
static <T,R,E extends Exception> RunnableWithException<E>	asRunnable(FunctionWithException<T,R,E> function, T t)	Converts a FunctionWithException to a RunnableWithException.
default RunnableWithException<E>	asRunnable(T t)	Converts a FunctionWithException to a RunnableWithException.
static <T,R,E extends Exception> SupplierWithException<R,E>	asSupplier(FunctionWithException<T,R,E> function, T t)	Converts a FunctionWithException to a SupplierWithException.
default SupplierWithException<R,E>	asSupplier(T t)	Converts a FunctionWithException to a SupplierWithException.
default <V> FunctionWithException<V,R,E>	compose(FunctionWithException<? super V,? extends T,? extends E> before)	Returns a composed function that first applies the before function to its input, and then applies this function to the result.
static <T,R,E extends Exception> FunctionWithException<T,R,E>	failing(Supplier<E> exceptionBuilder)	Returns a function that always throw exception.
static <T,E extends Exception> FunctionWithException<T,T,E>	identity()	Returns a function that always returns its input argument.
default Function<T,R>	ignore()	Converts this FunctionWithException to a lifted Function returning null in case of exception.
static <T,R,E extends Exception> Function<T,R>	ignored(FunctionWithException<T,R,E> function)	Converts a FunctionWithException to a lifted Function returning null in case of exception.
default Function<T,Optional<R>>	lift()	Converts this FunctionWithException to a lifted Function using Optional as return value.
static <T,R,E extends Exception> Function<T,Optional<R>>	lifted(FunctionWithException<T,R,E> function)	Converts a FunctionWithException to a lifted Function using Optional as return value.
default Function<T,CompletionStage<R>>	stage()	Convert this FunctionWithException to a lifted Function return CompletionStage as return value.
static <T,R,E extends Exception> Function<T,CompletionStage<R>>	staged(FunctionWithException<T,R,E> function)	Convert this FunctionWithException to a lifted Function return CompletionStage as return value.
default Function<T,R>	uncheck()	Converts this FunctionWithException to a Function that convert exception to RuntimeException.
static <T,R,E extends Exception> Function<T,R>	unchecked(FunctionWithException<T,R,E> function)	Converts a FunctionWithException to a Function that convert exception to RuntimeException.
static <T,R,E extends Exception> Function<T,R>	unchecked(FunctionWithException<T,R,E> function, Function<Exception,RuntimeException> exceptionMapper)	Converts a FunctionWithException to a Function 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.ObjectReturnExceptionHandlerSupport

notThrowingHandler, staged, throwingHandler, unchecked

Method Detail

apply

R apply(T t)
 throws E extends Exception

Applies this function to the given argument.

Parameters:

t - the function argument

Returns:

the function result

Throws:

E - any exception

E extends Exception

See Also:

Function.apply(Object)

uncheck

default Function<T,R> uncheck()

Converts this FunctionWithException to a Function that convert exception to RuntimeException.

Specified by:

uncheck in interface ExceptionHandlerSupport<T,R>

Specified by:

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

Returns:

the unchecked function

See Also:

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

lift

default Function<T,Optional<R>> lift()

Converts this FunctionWithException to a lifted Function using Optional as return value.

Specified by:

lift in interface ExceptionHandlerSupport<T,R>

Specified by:

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

Returns:

the lifted function

See Also:

lifted(FunctionWithException), Function

ignore

default Function<T,R> ignore()

Converts this FunctionWithException to a lifted Function returning null in case of exception.

Specified by:

ignore in interface ExceptionHandlerSupport<T,R>

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:

ignored(FunctionWithException), Function

stage

default Function<T,CompletionStage<R>> stage()

Convert this FunctionWithException to a lifted Function return CompletionStage as return value.

Specified by:

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

Returns:

the lifted function

See Also:

staged(FunctionWithException), CompletionStage

compose

default <V> FunctionWithException<V,R,E> compose(FunctionWithException<? super V,? extends T,? extends E> before)

Returns a composed function that first applies the before function to its input, and then applies this function to the result. If evaluation of either function throws an exception, it is relayed to the caller of the composed function.

Type Parameters:

V - the type of input to the before function, and to the composed function

Parameters:

before - the function to apply before this function is applied

Returns:

a composed function that first applies the before function and then applies this function

Throws:

NullPointerException - if before is null

See Also:

andThen(FunctionWithException), Function.compose(Function)

andThen

default <V> FunctionWithException<T,V,E> andThen(FunctionWithException<? super R,? extends V,? extends E> after)

Returns a composed function that first applies this function to its input, and then applies the after function to the result. If evaluation of either function throws an exception, it is relayed to the caller of the composed function.

Type Parameters:

V - the type of output of the after function, and of the composed function

Parameters:

after - the function to apply after this function is applied

Returns:

a composed function that first applies this function and then applies the after function

Throws:

NullPointerException - if after is null *

See Also:

compose(FunctionWithException), Function.andThen(Function)

identity

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

Returns a function that always returns its input argument.

Type Parameters:

T - the type of the input and output objects to the function

E - the type of the potential exception

Returns:

a function that always returns its input argument

See Also:

Function.identity()

failing

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

Returns a function that always throw exception.

Type Parameters:

T - the type of the input to the function

R - the type of the result of the function

E - the type of the exception

Parameters:

exceptionBuilder - the supplier to create the exception

Returns:

a function that always throw exception

unchecked

static <T,R,E extends Exception> Function<T,R> unchecked(FunctionWithException<T,R,E> function)

Converts a FunctionWithException to a Function that convert exception to RuntimeException.

Type Parameters:

T - the type of the input to the function

R - the type of the result of the function

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(FunctionWithException, Function)

unchecked

static <T,R,E extends Exception> Function<T,R> unchecked(FunctionWithException<T,R,E> function,
                                                         Function<Exception,RuntimeException> exceptionMapper)

Converts a FunctionWithException to a Function that wraps exception to RuntimeException by using the provided mapping function.

Type Parameters:

T - the type of the input to the function

R - the type of the result of the function

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(FunctionWithException)

lifted

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

Converts a FunctionWithException to a lifted Function using Optional as return value.

Type Parameters:

T - the type of the input to the function

R - the type of the result of the function

E - the type of the potential exception

Parameters:

function - to be lifted

Returns:

the lifted function

Throws:

NullPointerException - if function is null

See Also:

lift()

ignored

static <T,R,E extends Exception> Function<T,R> ignored(FunctionWithException<T,R,E> function)

Converts a FunctionWithException to a lifted Function returning null in case of exception.

Type Parameters:

T - the type of the input to the function

R - the type of the result of the function

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()

staged

static <T,R,E extends Exception> Function<T,CompletionStage<R>> staged(FunctionWithException<T,R,E> function)

Convert this FunctionWithException to a lifted Function return CompletionStage as return value.

Type Parameters:

T - the type of the input to the function

R - the type of the result of the function

E - the type of the potential exception

Parameters:

function - to be lifted

Returns:

the lifted function

Throws:

NullPointerException - if function is null

See Also:

stage()

asConsumer

static <T,R,E extends Exception> ConsumerWithException<T,E> asConsumer(FunctionWithException<T,R,E> function)

Converts a FunctionWithException to a ConsumerWithException.

Type Parameters:

T - the type of the input to the function

R - the type of the result of the function

E - the type of the potential exception

Parameters:

function - to be converter

Returns:

the consumer

Throws:

NullPointerException - if function is null

Since:

1.2.0

asConsumer

default ConsumerWithException<T,E> asConsumer()

Converts a FunctionWithException to a ConsumerWithException.

Returns:

the consumer

Since:

1.2.0

asBiFunction

static <T,U,R,E extends Exception> BiFunctionWithException<T,U,R,E> asBiFunction(FunctionWithException<T,R,E> function)

Converts a FunctionWithException to a BiFunctionWithException.

Type Parameters:

T - the type of the input to the function

U - the type of the second input to the function

R - the type of the result of the function

E - the type of the potential exception

Parameters:

function - to be converter

Returns:

the function

Throws:

NullPointerException - if function is null

Since:

1.2.0

asBiFunction

default <U> BiFunctionWithException<T,U,R,E> asBiFunction()

Converts a FunctionWithException to a BiFunctionWithException.

Type Parameters:

U - the type of the second input to the function

Returns:

the function

Since:

1.2.0

asSupplier

static <T,R,E extends Exception> SupplierWithException<R,E> asSupplier(FunctionWithException<T,R,E> function,
                                                                       T t)

Converts a FunctionWithException to a SupplierWithException.

Type Parameters:

T - the type of the input to the function

R - the type of the result of the function

E - the type of the potential exception

Parameters:

function - to be converter

t - The input to the function.

Returns:

the supplier

Throws:

NullPointerException - if function is null

Since:

1.2.0

asSupplier

default SupplierWithException<R,E> asSupplier(T t)

Converts a FunctionWithException to a SupplierWithException.

Parameters:

t - The input to the function.

Returns:

the supplier

Since:

1.2.0

asCallable

static <T,R,E extends Exception> Callable<R> asCallable(FunctionWithException<T,R,E> function,
                                                        T t)

Converts a FunctionWithException to a Callable.

Type Parameters:

T - the type of the input to the function

R - the type of the result of the function

E - the type of the potential exception

Parameters:

function - to be converter

t - The input to the function.

Returns:

the callable

Throws:

NullPointerException - if function is null

Since:

1.2.0

asCallable

default Callable<R> asCallable(T t)

Converts a FunctionWithException to a Callable.

Parameters:

t - The input to the function.

Returns:

the callable

Since:

1.2.0

asRunnable

static <T,R,E extends Exception> RunnableWithException<E> asRunnable(FunctionWithException<T,R,E> function,
                                                                     T t)

Converts a FunctionWithException to a RunnableWithException.

Type Parameters:

T - the type of the input to the function

R - the type of the result of the function

E - the type of the potential exception

Parameters:

function - to be converter

t - The input to the function.

Returns:

the Runnable

Throws:

NullPointerException - if function is null

Since:

1.2.0

asRunnable

default RunnableWithException<E> asRunnable(T t)

Converts a FunctionWithException to a RunnableWithException.

Parameters:

t - The input to the function.

Returns:

the Runnable

Since:

1.2.0