org.slieb.throwables

Interface ConsumerWithThrowable<T,E extends Throwable>

Type Parameters:

T - some generic flag

E - The extension

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 ConsumerWithThrowable<T,E extends Throwable>
extends Consumer<T>

Generated from Consumer Extends java.util.function.Consumer to allow for a checked exception.

Method Summary

Modifier and Type	Method and Description
default void	accept(T v1) Overridden method of ConsumerWithThrowable that will call acceptWithThrowable, but catching any exceptions.
void	acceptWithThrowable(T v1) Functional method that will throw exceptions.
static <T,E extends Throwable> Consumer<T>	aConsumerThatUnsafelyThrowsUnchecked(ConsumerWithThrowable<T,E> consumerwiththrowable) Utility method to unwrap lambdas of type Consumer and withUncheckedThrowable any Exception
static <T,E extends Throwable> ConsumerWithThrowable<T,E>	asConsumerWithThrowable(Consumer<T> consumer) Utility method to convert ConsumerWithThrowable
static <T,E extends Throwable> ConsumerWithThrowable<T,E>	castConsumerWithThrowable(ConsumerWithThrowable<T,E> consumerwiththrowable) Utility method to mark lambdas of type ConsumerWithThrowable
default ConsumerWithThrowable<T,E>	onException(BiConsumer<Throwable,Object[]> consumer)
default ConsumerWithThrowable<T,E>	onException(Consumer<Throwable> consumer)
default Consumer<T>	thatThrowsNothing()
default Consumer<T>	thatUnsafelyThrowsUnchecked()
default ConsumerWithThrowable<T,E>	withLogging() Will log WARNING level exceptions on logger if they occur within the interface
default ConsumerWithThrowable<T,E>	withLogging(org.slf4j.Logger logger) Will log WARNING level exceptions on logger if they occur within the interface
default ConsumerWithThrowable<T,E>	withLogging(org.slf4j.Logger logger, String message)

Methods inherited from interface java.util.function.Consumer

andThen

Method Detail

castConsumerWithThrowable

static <T,E extends Throwable> ConsumerWithThrowable<T,E> castConsumerWithThrowable(ConsumerWithThrowable<T,E> consumerwiththrowable)

Utility method to mark lambdas of type ConsumerWithThrowable

Type Parameters:

T - Generic that corresponds to the same generic on Consumer

E - The type this interface is allowed to throw

Parameters:

consumerwiththrowable - The interface instance

Returns:

the cast interface

aConsumerThatUnsafelyThrowsUnchecked

static <T,E extends Throwable> Consumer<T> aConsumerThatUnsafelyThrowsUnchecked(ConsumerWithThrowable<T,E> consumerwiththrowable)
                                                                         throws E extends Throwable

Utility method to unwrap lambdas of type Consumer and withUncheckedThrowable any Exception

Type Parameters:

T - Generic that corresponds to the same generic on Consumer

E - The type this interface is allowed to throw

Parameters:

consumerwiththrowable - The interface instance

Returns:

the cast interface

Throws:

E - the original Exception from consumerwiththrowable

E extends Throwable

asConsumerWithThrowable

static <T,E extends Throwable> ConsumerWithThrowable<T,E> asConsumerWithThrowable(Consumer<T> consumer)

Utility method to convert ConsumerWithThrowable

Type Parameters:

T - Generic that corresponds to the same generic on Consumer

E - The type this interface is allowed to throw

Parameters:

consumer - The interface instance

Returns:

the cast interface

accept

default void accept(T v1)

Overridden method of ConsumerWithThrowable that will call acceptWithThrowable, but catching any exceptions.

Specified by:

accept in interface Consumer<T>

Parameters:

v1 - parameter to overridden method

acceptWithThrowable

void acceptWithThrowable(T v1)
                  throws E extends Throwable

Functional method that will throw exceptions.

Parameters:

v1 - parameter to overridden method

Throws:

E - some exception

E extends Throwable

thatThrowsNothing

default Consumer<T> thatThrowsNothing()

Returns:

An interface that completely ignores exceptions. Consider using this method withLogging() as well.

thatUnsafelyThrowsUnchecked

default Consumer<T> thatUnsafelyThrowsUnchecked()
                                         throws E extends Throwable

Returns:

An interface that is only returned if no exception has been thrown.

Throws:

E - if an exception E has been thrown, it is rethrown by this method

E extends Throwable

withLogging

default ConsumerWithThrowable<T,E> withLogging(org.slf4j.Logger logger,
                                               String message)

Parameters:

logger - The logger to log exceptions on

message - A message to use for logging exceptions

Returns:

An interface that will log all exceptions to given logger

withLogging

default ConsumerWithThrowable<T,E> withLogging(org.slf4j.Logger logger)

Will log WARNING level exceptions on logger if they occur within the interface

Parameters:

logger - The logger instance to log exceptions on

Returns:

An interface that will log exceptions on given logger

withLogging

default ConsumerWithThrowable<T,E> withLogging()

Will log WARNING level exceptions on logger if they occur within the interface

Returns:

An interface that will log exceptions on global logger

onException

default ConsumerWithThrowable<T,E> onException(Consumer<Throwable> consumer)

Parameters:

consumer - An exception consumer.

Returns:

An interface that will log all exceptions to given logger

onException

default ConsumerWithThrowable<T,E> onException(BiConsumer<Throwable,Object[]> consumer)

Parameters:

consumer - An exception consumer.

Returns:

An interface that will log all exceptions to given logger