org.sellcom.core.util.function

Interface ThrowingBiConsumer<T,U>

All Superinterfaces:

BiConsumer<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 ThrowingBiConsumer<T,U>
extends BiConsumer<T,U>

Represents an operation that accepts two arguments and returns no result, possibly throwing an exception.

Since:

1.0

Method Summary

Modifier and Type	Method and Description
default void	accept(T former, U latter) Performs this operation on the given arguments.
void	acceptThrowing(T former, U latter) Performs this operation on the given arguments.
default BiConsumer<T,U>	fallbackTo(BiConsumer<T,U> fallback) Returns a BiConsumer performing the given operation on the arguments if this operation throws an exception.
default BiConsumer<T,U>	fallbackTo(BiConsumer<T,U> fallback, Consumer<Exception> exceptionConsumer) Returns a BiConsumer performing the given operation on the arguments if this operation throws an exception.
default ThrowingBiConsumer<T,U>	orThrow(Class<? extends RuntimeException> exceptionClass) Returns a ThrowingBiConsumer throwing an exception of the given type if this operation throws an exception.
default ThrowingBiConsumer<T,U>	orThrow(Class<? extends RuntimeException> exceptionClass, String message) Returns a ThrowingBiConsumer throwing an exception of the given type if this operation throws an exception.
default ThrowingBiConsumer<T,U>	orTryWith(ThrowingBiConsumer<? super T,? super U> other) Returns a ThrowingBiConsumer performing the given operation on the arguments if this operation throws an exception.
default ThrowingBiConsumer<T,U>	orTryWith(ThrowingBiConsumer<? super T,? super U> other, Consumer<Exception> exceptionConsumer) Returns a ThrowingBiConsumer performing the given operation on the arguments if this operation throws an exception.

Methods inherited from interface java.util.function.BiConsumer

andThen

Method Detail

accept

default void accept(T former,
                    U latter)

Performs this operation on the given arguments. Wraps any thrown checked exceptions with UncheckedException.

Specified by:

accept in interface BiConsumer<T,U>

Since:

1.0

acceptThrowing

void acceptThrowing(T former,
                    U latter)
             throws Exception

Performs this operation on the given arguments.

Throws:

Exception

Since:

1.0

fallbackTo

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

Returns a BiConsumer performing the given operation on the arguments if this operation throws an exception.

Throws:

IllegalArgumentException - if fallback is null

Since:

1.0

fallbackTo

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

Returns a BiConsumer performing the given operation on the arguments if this operation throws an exception.

Throws:

IllegalArgumentException - if fallback is null

Since:

1.0

orThrow

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

Returns a ThrowingBiConsumer throwing an exception of the given type if this operation throws an exception. The original exception thrown by this operation 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 ThrowingBiConsumer<T,U> orThrow(Class<? extends RuntimeException> exceptionClass,
                                        String message)

Returns a ThrowingBiConsumer throwing an exception of the given type if this operation throws an exception. The original exception thrown by this operation 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 ThrowingBiConsumer<T,U> orTryWith(ThrowingBiConsumer<? super T,? super U> other)

Returns a ThrowingBiConsumer performing the given operation on the arguments if this operation throws an exception.

Throws:

IllegalArgumentException - if other is null

Since:

1.0

orTryWith

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

Returns a ThrowingBiConsumer performing the given operation on the arguments if this operation throws an exception.

Throws:

IllegalArgumentException - if other is null

Since:

1.0