de.larssh.utils.function

Interface ThrowingSupplier<T>

Type Parameters:

T - the type of results supplied by this supplier

All Superinterfaces:

Supplier<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 ThrowingSupplier<T>
extends Supplier<T>

Represents a supplier of results. There is no requirement that a new or distinct result be returned each time the supplier is invoked.

ThrowingSuppliers can throw any kind of Exception. When used as Supplier exceptions are hidden from compiler.

This is a functional interface whose functional method is get().

Method Summary

Modifier and Type	Method and Description
default T	get() Gets a result, allow throwing any kind of Exception.
T	getThrowing() Gets a result, allow throwing any kind of Exception.
static <T> Supplier<T>	throwing(ThrowingSupplier<T> supplier) Short-hand method to cast any ThrowingSupplier as Supplier.

Method Detail

throwing

static <T> Supplier<T> throwing(ThrowingSupplier<T> supplier)

Short-hand method to cast any ThrowingSupplier as Supplier.

Type Parameters:

T - the type of results supplied by this supplier

Parameters:

supplier - throwing supplier

Returns:

hidden throwing supplier

get

@Nullable
default T get()

Gets a result, 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:

get in interface Supplier<T>

Returns:

a result

Throws:

SneakyException - hidden exceptions

getThrowing

@Nullable
T getThrowing()
                 throws Exception

Gets a result, allow throwing any kind of Exception.

Returns:

a result

Throws:

Exception - any kind of exception