Module io.jenetics.base

Package io.jenetics.internal.util

Interface Lifecycle.ExtendedCloseable<E extends Exception>

Type Parameters:

E - the exception thrown by the close() method

All Superinterfaces:

AutoCloseable

All Known Implementing Classes:

Lifecycle.Resources, Lifecycle.Value

Enclosing class:

Lifecycle

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 static interface Lifecycle.ExtendedCloseable<E extends Exception>
extends AutoCloseable

Extends the AutoCloseable with methods for wrapping the thrown exception into unchecked exceptions or ignoring them.

Method Summary

Modifier and Type	Method	Description
void	close()
static <E extends Exception> Lifecycle.ExtendedCloseable<E>	of(Lifecycle.ThrowingRunnable<? extends E> release)	Wraps a given release method and returns an Lifecycle.ExtendedCloseable.
static <E extends Exception> Lifecycle.ExtendedCloseable<E>	of(Lifecycle.ThrowingRunnable<? extends E>... releases)	Create a new ExtendedCloseable object with the given initial release methods>.
static <E extends Exception> Lifecycle.ExtendedCloseable<E>	of(Collection<? extends Lifecycle.ThrowingRunnable<? extends E>> releases)	Create a new ExtendedCloseable object with the given initial release methods>.
default void	silentClose()	Calls the close() method and ignores every thrown exception.
default void	silentClose(Throwable previousError)	Calls the close() method and ignores every thrown exception.
default void	uncheckedClose(Function<? super E,? extends RuntimeException> mapper)	Calls the close() method and wraps thrown Exception into an RuntimeException, mapped by the given mapper.

Method Details

close

void close()
    throws E

Specified by:

close in interface AutoCloseable

Throws:

E extends Exception

uncheckedClose

default void uncheckedClose(Function<? super E,? extends RuntimeException> mapper)

Calls the close() method and wraps thrown Exception into an RuntimeException, mapped by the given mapper.

Throws:

RuntimeException - if the close() method throws an Exception

silentClose

default void silentClose()

Calls the close() method and ignores every thrown exception.

silentClose

default void silentClose(Throwable previousError)

Calls the close() method and ignores every thrown exception. If the given previousError is non-null, the thrown exception is appended to the list of suppressed exceptions.

Parameters:

previousError - the error, which triggers the close of the given closeables

of

static <E extends Exception>
Lifecycle.ExtendedCloseable<E> of(Lifecycle.ThrowingRunnable<? extends E> release)

Wraps a given release method and returns an Lifecycle.ExtendedCloseable.

Parameters:

release - the release method to wrap

Returns:

a new extended closeable with the given underlying release method

Throws:

NullPointerException - if the given release method is null

of

static <E extends Exception>
Lifecycle.ExtendedCloseable<E> of(Collection<? extends Lifecycle.ThrowingRunnable<? extends E>> releases)

Create a new ExtendedCloseable object with the given initial release methods>. The given list of objects are closed in reversed order.

Parameters:

releases - the initial release methods

Returns:

a new closeable object which collects the given releases

Throws:

NullPointerException - if one of the releases is null

See Also:

• of(ThrowingRunnable...)

of

@SafeVarargs
static <E extends Exception>
Lifecycle.ExtendedCloseable<E> of(Lifecycle.ThrowingRunnable<? extends E>... releases)

Create a new ExtendedCloseable object with the given initial release methods>. The given list of objects are closed in reversed order.

Parameters:

releases - the release methods

Returns:

a new closeable object which collects the given releases

Throws:

NullPointerException - if one of the releases is null

See Also:

• of(Collection)