Package org.sellcom.core.util.function

Interface ThrowingConsumer<T>

All Superinterfaces:

java.util.function.Consumer<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 ThrowingConsumer<T>
extends java.util.function.Consumer<T>

Represents an operation that accepts a single argument and returns no result, possibly throwing an exception.

Since:

1.0

Method Summary

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

Methods inherited from interface java.util.function.Consumer

andThen

Method Detail

accept

default void accept(T argument)

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

Specified by:

accept in interface java.util.function.Consumer<T>

Since:

1.0

acceptThrowing

void acceptThrowing(T argument)
             throws java.lang.Exception

Performs this operation on the given argument.

Throws:

java.lang.Exception

Since:

1.0

fallbackTo

default java.util.function.Consumer<T> fallbackTo(java.util.function.Consumer<T> fallback)

Returns a Consumer performing the given operation on the argument if this operation throws an exception.

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

fallbackTo

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

Returns a Consumer performing the given operation on the argument if this operation throws an exception.

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

orThrow

default ThrowingConsumer<T> orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass)

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

java.lang.IllegalArgumentException - if exceptionClass is null

Since:

1.0

orThrow

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

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

java.lang.IllegalArgumentException - if exceptionClass is null

Since:

1.0

orTryWith

default ThrowingConsumer<T> orTryWith(ThrowingConsumer<? super T> other)

Returns a ThrowingConsumer performing the given operation on the argument if this operation throws an exception.

Throws:

java.lang.IllegalArgumentException - if other is null

Since:

1.0

orTryWith

default ThrowingConsumer<T> orTryWith(ThrowingConsumer<? super T> other,
                                      java.util.function.Consumer<java.lang.Exception> exceptionConsumer)

Returns a ThrowingConsumer performing the given operation on the argument if this operation throws an exception.

Throws:

java.lang.IllegalArgumentException - if other is null

Since:

1.0