Package conseq4j.summon

Class ConseqServiceFactory

java.lang.Object

conseq4j.summon.ConseqServiceFactory

All Implemented Interfaces:

SequentialExecutorServiceFactory, Terminable

@ThreadSafe
public final class ConseqServiceFactory
extends Object
implements SequentialExecutorServiceFactory

A factory to produce sequential executors of type ExecutorService with an upper-bound global execution concurrency. Providing task execution concurrency, as well as sequencing, via the ExecutorService API.

Author:

Qingtian Wang

Method Summary

Modifier and Type	Method	Description
ExecutorService	getExecutorService(Object sequenceKey)
boolean	isTerminated()	Nonblocking
static ConseqServiceFactory	newInstance()
static ConseqServiceFactory	newInstance(int concurrency)
void	shutdown()	Nonblocking, initiates an orderly shutdown of all managed thread resources.

Methods inherited from class java.lang.Object

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

Method Detail

newInstance

public static ConseqServiceFactory newInstance()

Returns:

ExecutorService factory with default concurrency

newInstance

public static ConseqServiceFactory newInstance(int concurrency)

Parameters:

concurrency - max number of tasks possible to be executed in parallel

Returns:

ExecutorService factory with given concurrency

getExecutorService

public ExecutorService getExecutorService(Object sequenceKey)

Specified by:

getExecutorService in interface SequentialExecutorServiceFactory

Parameters:

sequenceKey - an Object instance whose hash code is used to summon the corresponding executor.

Returns:

a single-thread executor that does not support any shutdown action.

shutdown

public void shutdown()

Description copied from interface: Terminable

Nonblocking, initiates an orderly shutdown of all managed thread resources. Previously submitted tasks are executed, but no new tasks will be accepted. Invocation has no additional effect if already shut down.

Specified by:

shutdown in interface Terminable

isTerminated

public boolean isTerminated()

Description copied from interface: Terminable

Nonblocking

Specified by:

isTerminated in interface Terminable

Returns:

true if all tasks of all managed executors have completed following shut down. Note that isTerminated is never true unless shutdown was called first.