Package org.jgroups.blocks.executor

Class ExecutionService

java.lang.Object

java.util.concurrent.AbstractExecutorService

org.jgroups.blocks.executor.ExecutionService

All Implemented Interfaces:

AutoCloseable, 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, Externalizable, or Streamable. Also the value returned from a callable must Serializable, Externalizable, 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	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 final class	ExecutionService.RunnableAdapter<T>	This is copied from class which contains RunnableAdapter.

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor	Description
ExecutionService()
ExecutionService(JChannel ch)

Method Summary

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

Methods inherited from class java.util.concurrent.AbstractExecutorService

invokeAll, invokeAll, invokeAny, invokeAny, submit

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.concurrent.ExecutorService

close

Field Details

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 Details

ExecutionService

public ExecutionService()

ExecutionService

public ExecutionService(JChannel ch)

Method Details

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

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