Package ch.powerunit.extensions.exceptions

Interface ObjectReturnExceptionHandlerSupport<F,L,S,T,Z extends ObjectReturnExceptionHandlerSupport<F,L,S,T,Z>>

Type Parameters:

F - the type of the java standard functional interface. For example, Function<T,R>.

L - the type of the lifted functional interface. For example, Function<T,Optional<R>>.

S - the type of the staged functional interface. For example, Function<T,CompletionStage<R>>.

T - the type of the return type of the Functional interface.

All Superinterfaces:

ExceptionHandlerSupport<F,L,Z>

All Known Subinterfaces:

BiFunctionWithException<T,U,R,E>, BinaryOperatorWithException<T,E>, DoubleFunctionWithException<R,E>, FunctionWithException<T,R,E>, IntFunctionWithException<R,E>, LongFunctionWithException<R,E>, ObjectInputFilterWithException<E>, SupplierWithException<T,E>, UnaryOperatorWithException<T,E>

public interface ObjectReturnExceptionHandlerSupport<F,L,S,T,Z extends ObjectReturnExceptionHandlerSupport<F,L,S,T,Z>>
extends ExceptionHandlerSupport<F,L,Z>

Root interface to support global operations related to exception handling for functional interface returning Object result.

Method Summary

Modifier and Type	Method	Description
default T	defaultValue()	Defines the default value (by default null) returned by the ignore and ignored method.
F	ignore()	Converts this functional interface to the corresponding java standard functional interface returning a null in case of error.
L	lift()	Converts this functional interface to a lifted one.
default Function<Exception,Optional<T>>	notThrowingHandler()	Used internally to support the exception interception.
S	stage()	Converts this functional interface to the corresponding java standard functional interface with staged result.
static <T> CompletionStage<T>	staged(Callable<T> internal)	Used internally to support the exception interception.
default Function<Exception,T>	throwingHandler()	Used internally to support the exception interception.
F	uncheck()	Converts this functional interface to the corresponding one in java and wrap exception using ExceptionHandlerSupport.exceptionMapper().
static <T> T	unchecked(Callable<T> internal, Function<Exception,T> exceptionhandler)	Used internally to support the exception interception.

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

documented, exceptionMapper

Method Detail

uncheck

F uncheck()

Converts this functional interface to the corresponding one in java and wrap exception using ExceptionHandlerSupport.exceptionMapper().

Conceptually, the exception encapsulation is done in the following way :

 (xxx) -> {
        try {
                return realaction(xxx);
        } catch (Exception e) {
                throw new exceptionMapper().apply(e);
        }
 }
 

Specified by:

uncheck in interface ExceptionHandlerSupport<F,L,S>

Returns:

the unchecked operation

See Also:

lift(), ignore()

lift

L lift()

Converts this functional interface to a lifted one. The lifted version return an Optional of the original return type.

Conceptually, this is done by :

 (xxx) -> {
        try {
                return Optional.ofNullable(realaction(xxx));
        } catch (Exception e) {
                return Optional.empty();
        }
 }
 

Specified by:

lift in interface ExceptionHandlerSupport<F,L,S>

Returns:

the lifted function

See Also:

uncheck(), ignore()

ignore

F ignore()

Converts this functional interface to the corresponding java standard functional interface returning a null in case of error.

The principle is :

 (xxx) -> {
        try {
                return realaction(xxx);
        } catch (Exception e) {
                return null;
        }
 }
 

Specified by:

ignore in interface ExceptionHandlerSupport<F,L,S>

Returns:

the operation that ignore error

See Also:

uncheck(), lift()

stage

S stage()

Converts this functional interface to the corresponding java standard functional interface with staged result.

Returns:

the operation supporting stage.

Since:

1.1.0

See Also:

CompletionStage

defaultValue

default T defaultValue()

Defines the default value (by default null) returned by the ignore and ignored method.

Returns:

the default value for the ignore/ignored method.

Since:

3.0.0

unchecked

static <T> T unchecked(Callable<T> internal,
                       Function<Exception,T> exceptionhandler)

Used internally to support the exception interception.

Type Parameters:

T - type of the return value

Parameters:

internal - the call to be done

exceptionhandler - the exception handler. May throw RuntimeException or return some default value.

Returns:

the result

Throws:

RuntimeException - in case of error

staged

static <T> CompletionStage<T> staged(Callable<T> internal)

Used internally to support the exception interception.

Type Parameters:

T - type of the return value

Parameters:

internal - the call to be done

Returns:

the completion stage

Throws:

RuntimeException - in case of error

throwingHandler

default Function<Exception,T> throwingHandler()

Used internally to support the exception interception.

Returns:

exception handler to support exception control

notThrowingHandler

default Function<Exception,Optional<T>> notThrowingHandler()

Used internally to support the exception interception.

Returns:

exception handler to ignore exception