Interface ThrowingFunction<T,R,E extends Throwable>
- Type Parameters:
T- the type of the input to the functionR- the type of the result of the function
- Functional Interface:
- This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
Represents a function that accepts one argument and produces a result.
Unlike
Function, this implementation can throw a checked exception.-
Method Summary
Modifier and TypeMethodDescriptiondefault <V> ThrowingFunction<T, V, ? extends Throwable> Returns a composed function that first applies this function to its input, and then applies theafterfunction to the result.default <V> ThrowingFunction<T, V, ? extends Throwable> andThen(ThrowingFunction<? super R, ? extends V, ? extends Throwable> after) Returns a composed function that first applies this function to its input, and then applies theafterfunction to the result.Applies this function to the given argument.default <V> ThrowingFunction<V, R, ? extends Throwable> Returns a composed function that first applies thebeforefunction to its input, and then applies this function to the result.default <V> ThrowingFunction<V, R, ? extends Throwable> compose(ThrowingFunction<? super V, ? extends T, ? extends Throwable> before) Returns a composed function that first applies thebeforefunction to its input, and then applies this function to the result.static <T> ThrowingFunction<T, T, ? extends Throwable> identity()Returns a function that always returns its input argument.
-
Method Details
-
apply
Applies this function to the given argument.- Parameters:
t- the function argument- Returns:
- the function result
- Throws:
E
-
compose
default <V> ThrowingFunction<V,R, compose? extends Throwable> (Function<? super V, ? extends T> before) Returns a composed function that first applies thebeforefunction 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 thebeforefunction, and to the composed function- Parameters:
before- the function to apply before this function is applied- Returns:
- a composed function that first applies the
beforefunction and then applies this function - Throws:
NullPointerException- if before is null- See Also:
-
compose
default <V> ThrowingFunction<V,R, compose? extends Throwable> (ThrowingFunction<? super V, ? extends T, ? extends Throwable> before) Returns a composed function that first applies thebeforefunction 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 thebeforefunction, and to the composed function- Parameters:
before- the function to apply before this function is applied- Returns:
- a composed function that first applies the
beforefunction and then applies this function - Throws:
NullPointerException- if before is null- See Also:
-
andThen
default <V> ThrowingFunction<T,V, andThen? extends Throwable> (Function<? super R, ? extends V> after) Returns a composed function that first applies this function to its input, and then applies theafterfunction 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 theafterfunction, 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
afterfunction - Throws:
NullPointerException- if after is null- See Also:
-
andThen
default <V> ThrowingFunction<T,V, andThen? extends Throwable> (ThrowingFunction<? super R, ? extends V, ? extends Throwable> after) Returns a composed function that first applies this function to its input, and then applies theafterfunction 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 theafterfunction, 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
afterfunction - Throws:
NullPointerException- if after is null- See Also:
-
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
-