de.larssh.utils.function

Interface ThrowingConsumer<T>

Type Parameters:

T - the type of the input to the operation

All Superinterfaces:

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 Consumer<T>

Represents an operation that accepts a single input argument and returns no result. Unlike most other functional interfaces, ThrowingConsumer is expected to operate via side-effects.

ThrowingConsumers can throw any kind of Exception. When used as Consumer exceptions are hidden from compiler.

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

Method Summary

Modifier and Type	Method and Description
default void	accept(T value) Performs this operation on the given argument, allow throwing any kind of Exception.
void	acceptThrowing(T value) Performs this operation on the given argument, allow throwing any kind of Exception.
static <T> Consumer<T>	throwing(ThrowingConsumer<T> consumer) Short-hand method to cast any ThrowingConsumer as Consumer.

Methods inherited from interface java.util.function.Consumer

andThen

Method Detail

throwing

static <T> Consumer<T> throwing(ThrowingConsumer<T> consumer)

Short-hand method to cast any ThrowingConsumer as Consumer.

Type Parameters:

T - the type of the input to the operation

Parameters:

consumer - throwing consumer

Returns:

hidden throwing consumer

accept

default void accept(@Nullable
                    T value)

Performs this operation on the given argument, allow throwing any kind of Exception.

As this hides exceptions from the compiler, the calling method should either:

• have a throws statement for the hidden exceptions
• handle hidden exceptions using catch
• or at least document the hidden exceptions in JavaDoc using @throws.

Specified by:

accept in interface Consumer<T>

Parameters:

value - the input argument

Throws:

SneakyException - hidden exceptions

acceptThrowing

void acceptThrowing(@Nullable
                    T value)
             throws Exception

Performs this operation on the given argument, allow throwing any kind of Exception.

Parameters:

value - the input argument

Throws:

Exception - any kind of exception