Package dev.getelements.elements.rt.util

Interface FinallyAction

All Superinterfaces:

AutoCloseable, 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 FinallyAction
extends Runnable, AutoCloseable

A FunctionalInterface which performs a series of actions when it is closed. Ideally to be used in a finally block or in a try-with-resources to chain additional destruction steps.

Field Summary

Fields

Modifier and Type	Field	Description
static final org.slf4j.Logger	logger	The default Logger used by FinallyAction instances.

Method Summary

Modifier and Type	Method	Description
static FinallyAction	begin()	Begins the finally action.
static FinallyAction	begin(org.slf4j.Logger logger)	Begins the finally action.
default void	close()
default org.slf4j.Logger	getLogger()	Gets a Logger used to log exceptions thrown while processing the FinallyAction.
default FinallyAction	then(Runnable next)	Chains this FinallyAction to the next FinallyAction.
default FinallyAction	thenClose(AutoCloseable closeable)
static FinallyAction	with(FinallyAction first)	Convenience method to start a chain of FinallyAction instances.

Methods inherited from interface java.lang.Runnable

run

Field Details

logger

static final org.slf4j.Logger logger

The default Logger used by FinallyAction instances.

Method Details

begin

static FinallyAction begin()

Begins the finally action.

Returns:

begin

static FinallyAction begin(org.slf4j.Logger logger)

Begins the finally action.

Returns:

getLogger

default org.slf4j.Logger getLogger()

Gets a Logger used to log exceptions thrown while processing the FinallyAction. The default returns logger.

Returns:

the Logger

then

default FinallyAction then(Runnable next)

Chains this FinallyAction to the next FinallyAction.

Parameters:

next -

Returns:

thenClose

default FinallyAction thenClose(AutoCloseable closeable)

close

default void close()

Specified by:

close in interface AutoCloseable

with

static FinallyAction with(FinallyAction first)

Convenience method to start a chain of FinallyAction instances.

Parameters:

first - the next in the chain

Returns:

a new FinallyAction