org.sellcom.core.util.function

Interface ThrowingToLongBiFunction<T,U>

All Superinterfaces:

ToLongBiFunction<T,U>

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 ThrowingToLongBiFunction<T,U>
extends ToLongBiFunction<T,U>

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

Since:

1.0

Method Summary

Modifier and Type	Method and Description
default long	applyAsLong(T former, U latter) Applies this function to the given arguments.
long	applyAsLongThrowing(T former, U latter) Applies this function to the given arguments.
default ToLongBiFunction<T,U>	fallbackTo(ToLongBiFunction<T,U> fallback) Returns a ToLongBiFunction applying the given function to the arguments if this function throws an exception.
default ToLongBiFunction<T,U>	fallbackTo(ToLongBiFunction<T,U> fallback, Consumer<Exception> exceptionConsumer) Returns a ToLongBiFunction applying the given function to the arguments if this function throws an exception.
default ToLongBiFunction<T,U>	orReturn(long value) Returns a ToLongBiFunction returning the given value if this function throws an exception.
default ToLongBiFunction<T,U>	orReturn(long value, Consumer<Exception> exceptionConsumer) Returns a ToLongBiFunction returning the given value if this function throws an exception.
default ThrowingToLongBiFunction<T,U>	orThrow(Class<? extends RuntimeException> exceptionClass) Returns a ThrowingToLongBiFunction throwing an exception of the given type if this function throws an exception.
default ThrowingToLongBiFunction<T,U>	orThrow(Class<? extends RuntimeException> exceptionClass, String message) Returns a ThrowingToLongBiFunction throwing an exception of the given type if this function throws an exception.
default ThrowingToLongBiFunction<T,U>	orTryWith(ThrowingToLongBiFunction<? super T,? super U> other) Returns a ThrowingToLongBiFunction applying the given function to the argument if this function throws an exception.
default ThrowingToLongBiFunction<T,U>	orTryWith(ThrowingToLongBiFunction<? super T,? super U> other, Consumer<Exception> exceptionConsumer) Returns a ThrowingToLongBiFunction applying the given function to the argument if this function throws an exception.

Method Detail

applyAsLong

default long applyAsLong(T former,
                         U latter)

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

Specified by:

applyAsLong in interface ToLongBiFunction<T,U>

Since:

1.0

applyAsLongThrowing

long applyAsLongThrowing(T former,
                         U latter)
                  throws Exception

Applies this function to the given arguments.

Throws:

Exception

Since:

1.0

fallbackTo

default ToLongBiFunction<T,U> fallbackTo(ToLongBiFunction<T,U> fallback)

Returns a ToLongBiFunction applying the given function to the arguments if this function throws an exception.

Throws:

IllegalArgumentException - if fallback is null

Since:

1.0

fallbackTo

default ToLongBiFunction<T,U> fallbackTo(ToLongBiFunction<T,U> fallback,
                                         Consumer<Exception> exceptionConsumer)

Returns a ToLongBiFunction applying the given function to the arguments if this function throws an exception.

Throws:

IllegalArgumentException - if fallback is null

Since:

1.0

orReturn

default ToLongBiFunction<T,U> orReturn(long value)

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

Since:

1.0

orReturn

default ToLongBiFunction<T,U> orReturn(long value,
                                       Consumer<Exception> exceptionConsumer)

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

Since:

1.0

orThrow

default ThrowingToLongBiFunction<T,U> orThrow(Class<? extends RuntimeException> exceptionClass)

Returns a ThrowingToLongBiFunction 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:

IllegalArgumentException - if exceptionClass is null

Since:

1.0

orThrow

default ThrowingToLongBiFunction<T,U> orThrow(Class<? extends RuntimeException> exceptionClass,
                                              String message)

Returns a ThrowingToLongBiFunction 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:

IllegalArgumentException - if exceptionClass is null

Since:

1.0

orTryWith

default ThrowingToLongBiFunction<T,U> orTryWith(ThrowingToLongBiFunction<? super T,? super U> other)

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

Throws:

IllegalArgumentException - if other is null

Since:

1.0

orTryWith

default ThrowingToLongBiFunction<T,U> orTryWith(ThrowingToLongBiFunction<? super T,? super U> other,
                                                Consumer<Exception> exceptionConsumer)

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

Throws:

IllegalArgumentException - if other is null

Since:

1.0