org.xblackcat.sjpu.util.function

Interface FunctionEx<T,R,E extends java.lang.Throwable>

Type Parameters:

T - the type of the input to the function

R - the type of the result of the function

E - the type of exception could be thrown while performing operation

All Known Subinterfaces:

UnaryOperatorEx<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 FunctionEx<T,R,E extends java.lang.Throwable>

Represents a function that accepts one argument and produces a result.

This is a functional interface whose functional method is apply(Object).

Since:

1.8

Method Summary

Modifier and Type	Method and Description
default <V> FunctionEx<T,V,E>	andThen(FunctionEx<? super R,? extends V,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 <V> FunctionEx<V,R,E>	compose(FunctionEx<? super V,? extends T,E> before) Returns a composed function that first applies the before function to its input, and then applies this function to the result.
default <C extends java.lang.Throwable> FunctionEx<T,R,C>	cover(java.util.function.BiFunction<java.lang.String,java.lang.Throwable,C> coverage)
default <C extends java.lang.Throwable> FunctionEx<T,R,C>	cover(java.util.function.Function<java.lang.Throwable,java.lang.String> text, java.util.function.BiFunction<java.lang.String,java.lang.Throwable,C> coverage)
default <C extends java.lang.Throwable> FunctionEx<T,R,C>	cover(java.lang.String exceptionText, java.util.function.BiFunction<java.lang.String,java.lang.Throwable,C> coverage)
default <C extends java.lang.Throwable> FunctionEx<T,R,C>	cover(java.util.function.Supplier<java.lang.String> text, java.util.function.BiFunction<java.lang.String,java.lang.Throwable,C> coverage)
default SupplierEx<R,E>	fix(T t)
static <T,E extends java.lang.Throwable> FunctionEx<T,T,E>	identity() Returns a function that always returns its input argument.
default java.util.function.Function<T,R>	unchecked()
default java.util.function.Function<T,R>	unchecked(java.util.function.BiFunction<java.lang.String,java.lang.Throwable,? extends java.lang.RuntimeException> cover)
default java.util.function.Function<T,R>	unchecked(java.util.function.Function<java.lang.Throwable,java.lang.String> text, java.util.function.BiFunction<java.lang.String,java.lang.Throwable,? extends java.lang.RuntimeException> cover)
default java.util.function.Function<T,R>	unchecked(java.lang.String exceptionText, java.util.function.BiFunction<java.lang.String,java.lang.Throwable,? extends java.lang.RuntimeException> cover)
default java.util.function.Function<T,R>	unchecked(java.util.function.Supplier<java.lang.String> text, java.util.function.BiFunction<java.lang.String,java.lang.Throwable,? extends java.lang.RuntimeException> cover)

Method Detail

identity

static <T,E extends java.lang.Throwable> FunctionEx<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

Returns:

a function that always returns its input argument

apply

R apply(T t)
 throws E extends java.lang.Throwable

Applies this function to the given argument.

Parameters:

t - the function argument

Returns:

the function result

Throws:

E extends java.lang.Throwable

compose

default <V> FunctionEx<V,R,E> compose(FunctionEx<? super V,? extends T,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:

java.lang.NullPointerException - if before is null

See Also:

andThen(FunctionEx)

andThen

default <V> FunctionEx<T,V,E> andThen(FunctionEx<? super R,? extends V,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:

java.lang.NullPointerException - if after is null

See Also:

compose(FunctionEx)

fix

default SupplierEx<R,E> fix(T t)

cover

default <C extends java.lang.Throwable> FunctionEx<T,R,C> cover(java.lang.String exceptionText,
                                                                java.util.function.BiFunction<java.lang.String,java.lang.Throwable,C> coverage)

cover

default <C extends java.lang.Throwable> FunctionEx<T,R,C> cover(java.util.function.BiFunction<java.lang.String,java.lang.Throwable,C> coverage)

cover

default <C extends java.lang.Throwable> FunctionEx<T,R,C> cover(java.util.function.Supplier<java.lang.String> text,
                                                                java.util.function.BiFunction<java.lang.String,java.lang.Throwable,C> coverage)

cover

default <C extends java.lang.Throwable> FunctionEx<T,R,C> cover(java.util.function.Function<java.lang.Throwable,java.lang.String> text,
                                                                java.util.function.BiFunction<java.lang.String,java.lang.Throwable,C> coverage)

unchecked

default java.util.function.Function<T,R> unchecked(java.lang.String exceptionText,
                                                   java.util.function.BiFunction<java.lang.String,java.lang.Throwable,? extends java.lang.RuntimeException> cover)

unchecked

default java.util.function.Function<T,R> unchecked()

unchecked

default java.util.function.Function<T,R> unchecked(java.util.function.BiFunction<java.lang.String,java.lang.Throwable,? extends java.lang.RuntimeException> cover)

unchecked

default java.util.function.Function<T,R> unchecked(java.util.function.Supplier<java.lang.String> text,
                                                   java.util.function.BiFunction<java.lang.String,java.lang.Throwable,? extends java.lang.RuntimeException> cover)

unchecked

default java.util.function.Function<T,R> unchecked(java.util.function.Function<java.lang.Throwable,java.lang.String> text,
                                                   java.util.function.BiFunction<java.lang.String,java.lang.Throwable,? extends java.lang.RuntimeException> cover)