Package org.sellcom.core.util.function

Interface ThrowingLongSupplier

All Superinterfaces:

java.util.function.LongSupplier

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 ThrowingLongSupplier
extends java.util.function.LongSupplier

Represents a supplier of long-valued results, possibly throwing an exception.

Since:

1.0

Method Summary

Modifier and Type	Method	Description
default java.util.function.LongSupplier	fallbackTo(java.util.function.LongSupplier fallback)	Returns a LongSupplier returning from the given supplier if this supplier throws an exception.
default java.util.function.LongSupplier	fallbackTo(java.util.function.LongSupplier fallback, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a LongSupplier returning from the given supplier if this supplier throws an exception.
default long	getAsLong()	Returns a result.
long	getAsLongThrowing()	Returns a result.
default java.util.function.LongSupplier	orReturn(long value)	Returns a LongSupplier returning the given value if this supplier throws an exception.
default java.util.function.LongSupplier	orReturn(long value, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a LongSupplier returning the given value if this supplier throws an exception.
default ThrowingLongSupplier	orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass)	Returns a ThrowingLongSupplier throwing an exception of the given type if this supplier throws an exception.
default ThrowingLongSupplier	orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass, java.lang.String message)	Returns a ThrowingLongSupplier throwing an exception of the given type if this supplier throws an exception.
default ThrowingLongSupplier	orTryWith(ThrowingLongSupplier other)	Returns a ThrowingLongSupplier returning from the given supplier if this supplier throws an exception.
default ThrowingLongSupplier	orTryWith(ThrowingLongSupplier other, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a ThrowingLongSupplier returning from the given supplier if this supplier throws an exception.

Method Detail

fallbackTo

default java.util.function.LongSupplier fallbackTo(java.util.function.LongSupplier fallback)

Returns a LongSupplier returning from the given supplier if this supplier throws an exception.

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

fallbackTo

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

Returns a LongSupplier returning from the given supplier if this supplier throws an exception.

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

getAsLong

default long getAsLong()

Returns a result. Wraps any thrown checked exceptions with UncheckedException.

Specified by:

getAsLong in interface java.util.function.LongSupplier

Since:

1.0

getAsLongThrowing

long getAsLongThrowing()
                throws java.lang.Exception

Returns a result.

Throws:

java.lang.Exception

Since:

1.0

orReturn

default java.util.function.LongSupplier orReturn(long value)

Returns a LongSupplier returning the given value if this supplier throws an exception.

Since:

1.0

orReturn

default java.util.function.LongSupplier orReturn(long value,
                                                 java.util.function.Consumer<java.lang.Exception> exceptionConsumer)

Returns a LongSupplier returning the given value if this supplier throws an exception.

Since:

1.0

orThrow

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

Returns a ThrowingLongSupplier throwing an exception of the given type if this supplier throws an exception. The original exception thrown by this supplier 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 ThrowingLongSupplier orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass,
                                     java.lang.String message)

Returns a ThrowingLongSupplier throwing an exception of the given type if this supplier throws an exception. The original exception thrown by this supplier 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 ThrowingLongSupplier orTryWith(ThrowingLongSupplier other)

Returns a ThrowingLongSupplier returning from the given supplier if this supplier throws an exception.

Throws:

java.lang.IllegalArgumentException - if other is null

Since:

1.0

orTryWith

default ThrowingLongSupplier orTryWith(ThrowingLongSupplier other,
                                       java.util.function.Consumer<java.lang.Exception> exceptionConsumer)

Returns a ThrowingLongSupplier returning from the given supplier if this supplier throws an exception.

Throws:

java.lang.IllegalArgumentException - if other is null

Since:

1.0