org.wildfly.clustering.service.concurrent

Interface ServiceExecutor

All Known Implementing Classes:

StampedLockServiceExecutor

public interface ServiceExecutor

Allows safe invocation of tasks that require resources not available after close(Runnable) to block a service from stopping.

Author:

Paul Ferraro

Method Summary

Modifier and Type	Method and Description
void	close(Runnable closeTask) Closes the service, executing the specified task, first waiting for any concurrent executions to complete.
<E extends Exception> void	execute(org.wildfly.common.function.ExceptionRunnable<E> executeTask) Executes the specified task, but only if the service was not already closed.
<R,E extends Exception> Optional<R>	execute(org.wildfly.common.function.ExceptionSupplier<R,E> executeTask) Executes the specified task, but only if the service was not already closed.
void	execute(Runnable executeTask) Executes the specified task, but only if the service was not already closed.
<R> Optional<R>	execute(Supplier<R> executeTask) Executes the specified task, but only if the service was not already closed.

Method Detail

execute

void execute(Runnable executeTask)

Executes the specified task, but only if the service was not already closed. If service is already closed, the task is not run.

Parameters:

executeTask - a task to execute

execute

<E extends Exception> void execute(org.wildfly.common.function.ExceptionRunnable<E> executeTask)
                            throws E extends Exception

Executes the specified task, but only if the service was not already closed. If service is already closed, the task is not run.

Parameters:

executeTask - a task to execute

Throws:

E - if the task execution failed

E extends Exception

execute

<R> Optional<R> execute(Supplier<R> executeTask)

Executes the specified task, but only if the service was not already closed. If service is already closed, the task is not run. If executed, the specified task must return a non-null value, to be distinguishable from a non-execution.

Parameters:

executeTask - a task to execute

Returns:

an optional value that is present only if the specified task was run.

execute

<R,E extends Exception> Optional<R> execute(org.wildfly.common.function.ExceptionSupplier<R,E> executeTask)
                                     throws E extends Exception

Executes the specified task, but only if the service was not already closed. If service is already closed, the task is not run. If executed, the specified task must return a non-null value, to be distinguishable from a non-execution.

Parameters:

executeTask - a task to execute

Returns:

an optional value that is present only if the specified task was run.

Throws:

E - if the task execution failed

E extends Exception

close

void close(Runnable closeTask)

Closes the service, executing the specified task, first waiting for any concurrent executions to complete. The specified task will only execute once, irrespective on subsequent close(Runnable) invocations.

Parameters:

closeTask - a task which closes the service