org.slieb.throwables

Interface RunnableWithThrowable<E extends Throwable>

Type Parameters:

E - The extension

All Superinterfaces:

Runnable

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 RunnableWithThrowable<E extends Throwable>
extends Runnable

Generated from Runnable Extends java.lang.Runnable to allow for a checked exception.

Method Summary

Modifier and Type	Method and Description
static <E extends Throwable> Runnable	aRunnableThatUnsafelyThrowsUnchecked(RunnableWithThrowable<E> runnablewiththrowable) Utility method to unwrap lambdas of type Runnable and withUncheckedThrowable any Exception
static <E extends Throwable> RunnableWithThrowable<E>	asRunnableWithThrowable(Runnable runnable) Utility method to convert RunnableWithThrowable
static <E extends Throwable> RunnableWithThrowable<E>	castRunnableWithThrowable(RunnableWithThrowable<E> runnablewiththrowable) Utility method to mark lambdas of type RunnableWithThrowable
default RunnableWithThrowable<E>	onException(Consumer<Throwable> consumer)
default void	run() Overridden method of RunnableWithThrowable that will call runWithThrowable, but catching any exceptions.
void	runWithThrowable() Functional method that will throw exceptions.
default Runnable	thatThrowsNothing()
default Runnable	thatUnsafelyThrowsUnchecked()
default RunnableWithThrowable<E>	withLogging() Will log WARNING level exceptions on logger if they occur within the interface
default RunnableWithThrowable<E>	withLogging(org.slf4j.Logger logger) Will log WARNING level exceptions on logger if they occur within the interface
default RunnableWithThrowable<E>	withLogging(org.slf4j.Logger logger, String message)

Method Detail

castRunnableWithThrowable

static <E extends Throwable> RunnableWithThrowable<E> castRunnableWithThrowable(RunnableWithThrowable<E> runnablewiththrowable)

Utility method to mark lambdas of type RunnableWithThrowable

Type Parameters:

E - The type this interface is allowed to throw

Parameters:

runnablewiththrowable - The interface instance

Returns:

the cast interface

aRunnableThatUnsafelyThrowsUnchecked

static <E extends Throwable> Runnable aRunnableThatUnsafelyThrowsUnchecked(RunnableWithThrowable<E> runnablewiththrowable)
                                                                    throws E extends Throwable

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

Type Parameters:

E - The type this interface is allowed to throw

Parameters:

runnablewiththrowable - The interface instance

Returns:

the cast interface

Throws:

E - the original Exception from runnablewiththrowable

E extends Throwable

asRunnableWithThrowable

static <E extends Throwable> RunnableWithThrowable<E> asRunnableWithThrowable(Runnable runnable)

Utility method to convert RunnableWithThrowable

Type Parameters:

E - The type this interface is allowed to throw

Parameters:

runnable - The interface instance

Returns:

the cast interface

run

default void run()

Overridden method of RunnableWithThrowable that will call runWithThrowable, but catching any exceptions.

Specified by:

run in interface Runnable

runWithThrowable

void runWithThrowable()
               throws E extends Throwable

Functional method that will throw exceptions.

Throws:

E - some exception

E extends Throwable

thatThrowsNothing

default Runnable thatThrowsNothing()

Returns:

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

thatUnsafelyThrowsUnchecked

default Runnable 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 RunnableWithThrowable<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 RunnableWithThrowable<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 RunnableWithThrowable<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 RunnableWithThrowable<E> onException(Consumer<Throwable> consumer)

Parameters:

consumer - An exception consumer.

Returns:

An interface that will log all exceptions to given logger