Package de.xima.fc.interfaces

Interface IThrowingFunction<T,R>

Type Parameters:

T - the type of the input to the function

R - the type of the result of the function

All Superinterfaces:

Function<T,R>, ITypedThrowingFunction<T,R,Exception>

All Known Subinterfaces:

ISerializableThrowingFunction<T,R>, IThrowingUnaryOperator<T>

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 IThrowingFunction<T,R>
extends Function<T,R>, ITypedThrowingFunction<T,R,Exception>

A Function that may throw a checked exception.

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

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

Since:

8.0.1

Author:

XIMA MEDIA GmbH

Method Summary

Modifier and Type	Method	Description
default R	apply(T t)
static <T,R> IThrowingFunction<T,R>	of(IThrowingFunction<T,R> fn)	Returns the given supplier, for improved variable inference.
static <T,R> IThrowingFunction<T,R>	throwingFunction(IThrowingFunction<T,R> fn)	Returns the given function, for improved variable inference.
R	tryApply(T t)	Gets a result.

Methods inherited from interface java.util.function.Function

andThen, compose

Method Detail

tryApply

R tryApply(T t)
    throws Exception

Gets a result.

Specified by:

tryApply in interface ITypedThrowingFunction<T,R,Exception>

Parameters:

t - the function argument

Returns:

the function result

Throws:

Exception - When this operation fails.

apply

default R apply(T t)

Specified by:

apply in interface Function<T,R>

Specified by:

apply in interface ITypedThrowingFunction<T,R,Exception>

of

static <T,R> IThrowingFunction<T,R> of(IThrowingFunction<T,R> fn)

Returns the given supplier, for improved variable inference. Sometimes you need to create local variables and assign them to a new lambda. This does not work well with variable inference, as Java cannot infer the type of anonymous lambdas. This utility method lets you write slightly more readable code like this:

 final var fn = ISerializableThrowingFunction.of(t -> ...);
 

You can also use this helper method to create a function from a lambda expression that throws checked exceptions and use the result as a Function that rethrows checked exceptions as unchecked ones.

Type Parameters:

T - the type of the argument expected by the function

R - the type of the result of the function

Parameters:

fn - Function to return.

Returns:

The given supplier.

throwingFunction

static <T,R> IThrowingFunction<T,R> throwingFunction(IThrowingFunction<T,R> fn)

Returns the given function, for improved variable inference. Sometimes you need to create local variables and assign them to a new lambda. This does not work well with variable inference, as Java cannot infer the type of anonymous lambdas. This utility method lets you write slightly more readable code like this:

 final var fn = throwingFunction(t -> ...);
 

You can also use this helper method to create a function from a lambda expression that throws checked exceptions and use the result as a Function that rethrows checked exceptions as unchecked ones.

Type Parameters:

T - the type of the argument expected by the function

R - the type of the result of the function

Parameters:

fn - Function to return.

Returns:

The given supplier.