org.slieb.throwables

Interface LongFunctionWithThrowable<R,E extends Throwable>

Type Parameters:

R - some generic flag

E - The extension

All Superinterfaces:

LongFunction<R>

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 LongFunctionWithThrowable<R,E extends Throwable>
extends LongFunction<R>

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

Method Summary

Modifier and Type	Method and Description
static <R,E extends Throwable> LongFunction<R>	aLongFunctionThatUnsafelyThrowsUnchecked(LongFunctionWithThrowable<R,E> longfunctionwiththrowable) Utility method to unwrap lambdas of type LongFunction and withUncheckedThrowable any Exception
default R	apply(long v1) Overridden method of LongFunctionWithThrowable that will call applyWithThrowable, but catching any exceptions.
R	applyWithThrowable(long v1) Functional method that will throw exceptions.
static <R,E extends Throwable> LongFunctionWithThrowable<R,E>	asLongFunctionWithThrowable(LongFunction<R> longfunction) Utility method to convert LongFunctionWithThrowable
static <R,E extends Throwable> LongFunctionWithThrowable<R,E>	castLongFunctionWithThrowable(LongFunctionWithThrowable<R,E> longfunctionwiththrowable) Utility method to mark lambdas of type LongFunctionWithThrowable
default LongFunctionWithThrowable<R,E>	onException(BiConsumer<Throwable,Object[]> consumer)
default LongFunctionWithThrowable<R,E>	onException(Consumer<Throwable> consumer)
default LongFunction<R>	thatReturnsOnCatch(R defaultReturnValue)
default LongFunction<Optional<R>>	thatReturnsOptional()
default LongFunction<R>	thatUnsafelyThrowsUnchecked()
default LongFunctionWithThrowable<R,E>	withLogging() Will log WARNING level exceptions on logger if they occur within the interface
default LongFunctionWithThrowable<R,E>	withLogging(org.slf4j.Logger logger) Will log WARNING level exceptions on logger if they occur within the interface
default LongFunctionWithThrowable<R,E>	withLogging(org.slf4j.Logger logger, String message)

Method Detail

castLongFunctionWithThrowable

static <R,E extends Throwable> LongFunctionWithThrowable<R,E> castLongFunctionWithThrowable(LongFunctionWithThrowable<R,E> longfunctionwiththrowable)

Utility method to mark lambdas of type LongFunctionWithThrowable

Type Parameters:

R - Generic that corresponds to the same generic on LongFunction

E - The type this interface is allowed to throw

Parameters:

longfunctionwiththrowable - The interface instance

Returns:

the cast interface

aLongFunctionThatUnsafelyThrowsUnchecked

static <R,E extends Throwable> LongFunction<R> aLongFunctionThatUnsafelyThrowsUnchecked(LongFunctionWithThrowable<R,E> longfunctionwiththrowable)
                                                                                 throws E extends Throwable

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

Type Parameters:

R - Generic that corresponds to the same generic on LongFunction

E - The type this interface is allowed to throw

Parameters:

longfunctionwiththrowable - The interface instance

Returns:

the cast interface

Throws:

E - the original Exception from longfunctionwiththrowable

E extends Throwable

asLongFunctionWithThrowable

static <R,E extends Throwable> LongFunctionWithThrowable<R,E> asLongFunctionWithThrowable(LongFunction<R> longfunction)

Utility method to convert LongFunctionWithThrowable

Type Parameters:

R - Generic that corresponds to the same generic on LongFunction

E - The type this interface is allowed to throw

Parameters:

longfunction - The interface instance

Returns:

the cast interface

apply

default R apply(long v1)

Overridden method of LongFunctionWithThrowable that will call applyWithThrowable, but catching any exceptions.

Specified by:

apply in interface LongFunction<R>

Parameters:

v1 - parameter to overridden method

Returns:

the value

applyWithThrowable

R applyWithThrowable(long v1)
              throws E extends Throwable

Functional method that will throw exceptions.

Parameters:

v1 - parameter to overridden method

Returns:

the value

Throws:

E - some exception

E extends Throwable

thatReturnsOptional

default LongFunction<Optional<R>> thatReturnsOptional()

Returns:

An interface that will wrap the result in an optional, and return an empty optional when an exception occurs.

thatReturnsOnCatch

default LongFunction<R> thatReturnsOnCatch(R defaultReturnValue)

Parameters:

defaultReturnValue - A value to return if any throwable is caught.

Returns:

An interface that returns a default value if any exception occurs.

thatUnsafelyThrowsUnchecked

default LongFunction<R> 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 LongFunctionWithThrowable<R,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 LongFunctionWithThrowable<R,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 LongFunctionWithThrowable<R,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 LongFunctionWithThrowable<R,E> onException(Consumer<Throwable> consumer)

Parameters:

consumer - An exception consumer.

Returns:

An interface that will log all exceptions to given logger

onException

default LongFunctionWithThrowable<R,E> onException(BiConsumer<Throwable,Object[]> consumer)

Parameters:

consumer - An exception consumer.

Returns:

An interface that will log all exceptions to given logger