Package org.wildfly.clustering.ee.concurrent

Interface ServiceExecutor

All Superinterfaces:
Executor
public interface ServiceExecutor extends Executor
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
    Description
    void
    close(Runnable closeTask)
    Closes the service, executing the specified task, first waiting for any concurrent executions to complete.
    <R> Optional<R>
    execute(Supplier<R> executeTask)
    Executes the specified task, but only if the service was not already closed.
    <E extends Exception>
    void
    execute(org.wildfly.common.function.ExceptionRunnable<E> runner)
    Executes the specified runner.
    <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.

    Methods inherited from interface java.util.concurrent.Executor

    execute

  • Method Details

    • execute

      <E extends Exception> void execute(org.wildfly.common.function.ExceptionRunnable<E> runner) throws E
      Executes the specified runner.
      Type Parameters:
      E - the exception type
      Parameters:
      runner - a runnable task
      Throws:
      E - if execution fails

    • 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
      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

    • 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