org.jgroups.blocks.executor

Class ExecutionService

java.lang.Object

java.util.concurrent.AbstractExecutorService

org.jgroups.blocks.executor.ExecutionService

All Implemented Interfaces:

Executor, ExecutorService

public class ExecutionService
extends AbstractExecutorService

This is a jgroups implementation of an ExecutorService, where the consumers are running on any number of nodes. The nodes should run ExecutionRunner to start picking up requests.

Every future object returned will be a NotifyingFuture which allows for not having to query the future and have a callback instead. This can then be used as a workflow to submit other tasks sequentially or also to query the future for the value at that time.

Every callable or runnable submitted must be either Serializable or Streamable. Also the value returned from a callable must Serializable or Streamable. Unfortunately if the value returned is not serializable then a NotSerializableException will be thrown as the cause.

Since:

2.12.0

Author:

wburns

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ExecutionService.DistributedFuture<V> This is basically a copy of the FutureTask in java.util.concurrent but added serializable to it.
protected static class	ExecutionService.RunnableAdapter<T> This is copied from Executors class which contains RunnableAdapter.

Field Summary

Fields

Modifier and Type	Field and Description
protected Executing	_execProt
protected AtomicBoolean	_shutdown
protected Condition	_unfinishedCondition
protected Set<Future<?>>	_unfinishedFutures
protected Lock	_unfinishedLock
protected JChannel	ch

Constructor Summary

Constructors

Constructor and Description
ExecutionService()
ExecutionService(JChannel ch)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	awaitTermination(long timeout, TimeUnit unit)
void	execute(Runnable command)
<T> T	invokeAny(Collection<? extends Callable<T>> tasks)
<T> T	invokeAny(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit)
boolean	isShutdown()
boolean	isTerminated()
protected <T> RunnableFuture<T>	newTaskFor(Callable<T> callable)
protected <T> RunnableFuture<T>	newTaskFor(Runnable runnable, T value)
void	setChannel(JChannel ch)
void	shutdown()
List<Runnable>	shutdownNow()
<T> NotifyingFuture<T>	submit(Callable<T> task)
<T> NotifyingFuture<T>	submit(Runnable task, T result)

Methods inherited from class java.util.concurrent.AbstractExecutorService

invokeAll, invokeAll, submit

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ch

protected JChannel ch

_execProt

protected Executing _execProt

_unfinishedLock

protected Lock _unfinishedLock

_unfinishedCondition

protected Condition _unfinishedCondition

_unfinishedFutures

protected Set<Future<?>> _unfinishedFutures

_shutdown

protected AtomicBoolean _shutdown

Constructor Detail

ExecutionService

public ExecutionService()

ExecutionService

public ExecutionService(JChannel ch)

Method Detail

setChannel

public void setChannel(JChannel ch)

submit

public <T> NotifyingFuture<T> submit(Runnable task,
                            T result)

Specified by:

submit in interface ExecutorService

Overrides:

submit in class AbstractExecutorService

submit

public <T> NotifyingFuture<T> submit(Callable<T> task)

Specified by:

submit in interface ExecutorService

Overrides:

submit in class AbstractExecutorService

shutdown

public void shutdown()

shutdownNow

public List<Runnable> shutdownNow()

isShutdown

public boolean isShutdown()

isTerminated

public boolean isTerminated()

awaitTermination

public boolean awaitTermination(long timeout,
                       TimeUnit unit)
                         throws InterruptedException

Throws:

InterruptedException

invokeAny

public <T> T invokeAny(Collection<? extends Callable<T>> tasks)
            throws InterruptedException,
                   ExecutionException

Specified by:

invokeAny in interface ExecutorService

Overrides:

invokeAny in class AbstractExecutorService

Throws:

InterruptedException

ExecutionException

invokeAny

public <T> T invokeAny(Collection<? extends Callable<T>> tasks,
              long timeout,
              TimeUnit unit)
            throws InterruptedException,
                   ExecutionException,
                   TimeoutException

Specified by:

invokeAny in interface ExecutorService

Overrides:

invokeAny in class AbstractExecutorService

Throws:

InterruptedException

ExecutionException

TimeoutException

execute

public void execute(Runnable command)

newTaskFor

protected <T> RunnableFuture<T> newTaskFor(Runnable runnable,
                               T value)

Overrides:

newTaskFor in class AbstractExecutorService

newTaskFor

protected <T> RunnableFuture<T> newTaskFor(Callable<T> callable)

Overrides:

newTaskFor in class AbstractExecutorService