Package org.sellcom.core.util.function

Interface ThrowingLongFunction<R>

All Superinterfaces:

java.util.function.LongFunction<R>

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 ThrowingLongFunction<R>
extends java.util.function.LongFunction<R>

Represents a function that accepts a long-valued argument and produces a result, possibly throwing an exception.

Since:

1.0

Method Summary

Modifier and Type	Method	Description
default R	apply(long argument)	Applies this function to the given argument.
R	applyThrowing(long argument)	Applies this function to the given argument.
default java.util.function.LongFunction<R>	fallbackTo(java.util.function.LongFunction<R> fallback)	Returns a LongFunction applying the given function to the argument if this function throws an exception.
default java.util.function.LongFunction<R>	fallbackTo(java.util.function.LongFunction<R> fallback, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a LongFunction applying the given function to the argument if this function throws an exception.
default java.util.function.LongFunction<R>	orReturn(R value)	Returns a LongFunction returning the given value if this function throws an exception.
default java.util.function.LongFunction<R>	orReturn(R value, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a LongFunction returning the given value if this function throws an exception.
default ThrowingLongFunction<R>	orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass)	Returns a ThrowingLongFunction throwing an exception of the given type if this function throws an exception.
default ThrowingLongFunction<R>	orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass, java.lang.String message)	Returns a ThrowingLongFunction throwing an exception of the given type if this function throws an exception.
default ThrowingLongFunction<R>	orTryWith(ThrowingLongFunction<? extends R> other)	Returns a ThrowingLongFunction applying the given function to the argument if this function throws an exception.
default ThrowingLongFunction<R>	orTryWith(ThrowingLongFunction<? extends R> other, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a ThrowingLongFunction applying the given function to the argument if this function throws an exception.

Method Detail

apply

default R apply(long argument)

Applies this function to the given argument. Wraps any thrown checked exceptions with UncheckedException.

Specified by:

apply in interface java.util.function.LongFunction<R>

Since:

1.0

applyThrowing

R applyThrowing(long argument)
         throws java.lang.Exception

Applies this function to the given argument.

Throws:

java.lang.Exception

Since:

1.0

fallbackTo

default java.util.function.LongFunction<R> fallbackTo(java.util.function.LongFunction<R> fallback)

Returns a LongFunction applying the given function to the argument if this function throws an exception.

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

fallbackTo

default java.util.function.LongFunction<R> fallbackTo(java.util.function.LongFunction<R> fallback,
                                                      java.util.function.Consumer<java.lang.Exception> exceptionConsumer)

Returns a LongFunction applying the given function to the argument if this function throws an exception.

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

orReturn

default java.util.function.LongFunction<R> orReturn(R value)

Returns a LongFunction returning the given value if this function throws an exception.

Since:

1.0

orReturn

default java.util.function.LongFunction<R> orReturn(R value,
                                                    java.util.function.Consumer<java.lang.Exception> exceptionConsumer)

Returns a LongFunction returning the given value if this function throws an exception.

Since:

1.0

orThrow

default ThrowingLongFunction<R> orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass)

Returns a ThrowingLongFunction throwing an exception of the given type if this function throws an exception. The original exception thrown by this function is the cause of the thrown exception.

The exception class must have a constructor accepting a single Throwable as an argument.

Throws:

java.lang.IllegalArgumentException - if exceptionClass is null

Since:

1.0

orThrow

default ThrowingLongFunction<R> orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass,
                                        java.lang.String message)

Returns a ThrowingLongFunction throwing an exception of the given type if this function throws an exception. The original exception thrown by this function is the cause of the thrown exception.

The exception class must have a constructor accepting String and Throwable as arguments.

Throws:

java.lang.IllegalArgumentException - if exceptionClass is null

Since:

1.0

orTryWith

default ThrowingLongFunction<R> orTryWith(ThrowingLongFunction<? extends R> other)

Returns a ThrowingLongFunction applying the given function to the argument if this function throws an exception.

Throws:

java.lang.IllegalArgumentException - if other is null

Since:

1.0

orTryWith

default ThrowingLongFunction<R> orTryWith(ThrowingLongFunction<? extends R> other,
                                          java.util.function.Consumer<java.lang.Exception> exceptionConsumer)

Returns a ThrowingLongFunction applying the given function to the argument if this function throws an exception.

Throws:

java.lang.IllegalArgumentException - if other is null

Since:

1.0