de.aristaflow.adept2.util.threading.executor

Class AbstractObjectRunnable<O1,O2,R>

java.lang.Object

de.aristaflow.adept2.util.threading.executor.AbstractObjectRunnable<O1,O2,R>

Type Parameters:

O1 - The type of objects for which runnables are registered.

O2 - The type of objects with which runnables are managed and executed within an object-specific executor service.

R - The runtime data for managed objects. This allows for arbitrary data for each managed object.

All Implemented Interfaces:

ObjectRunnable<O1,O2>, java.lang.Runnable

Direct Known Subclasses:

ObjectOneWorkRunnable, PipelineRunnable

public abstract class AbstractObjectRunnable<O1,O2,R>
extends java.lang.Object
implements ObjectRunnable<O1,O2>

An abstract implementation for an ObjectRunnable including some lifecycle management like being active and termination.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.logging.Logger	logger The logger for various purpose, e. g. logging exceptions which are not propagated to outside the runnable.
protected java.util.Map<O2,Pair<ObjectRunnable<O1,O2>,R>>	objects The data structures containing all objects and the corresponding work.
protected java.util.concurrent.atomic.AtomicInteger	terminate The amount of termination requests.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractObjectRunnable(O1 registeredObject, O2 indexObject, java.util.Map<O2,Pair<ObjectRunnable<O1,O2>,R>> objects, java.util.concurrent.atomic.AtomicInteger terminate, java.util.logging.Logger logger) Creates a new runnable for the designated object.

Method Summary

Modifier and Type	Method and Description
void	awaitTermination() Awaits the termination of this runnable.
O2	getIndexObject() Gets the object with which this runnable is managed and executed within an object-specific executor service.
O1	getRegisteredObject() Gets the object with which this runnable has been registered at an object-specific executor service.
void	run()
protected abstract boolean	runForObject() Runs this runnable actually.

Methods inherited from class java.lang.Object

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

Field Detail

objects

protected final java.util.Map<O2,Pair<ObjectRunnable<O1,O2>,R>> objects

The data structures containing all objects and the corresponding work.

terminate

protected final java.util.concurrent.atomic.AtomicInteger terminate

The amount of termination requests. If this is > 1, the runnable has to terminate.
Access has to be synchronised via objects.

logger

protected final java.util.logging.Logger logger

The logger for various purpose, e. g. logging exceptions which are not propagated to outside the runnable.

Constructor Detail

AbstractObjectRunnable

protected AbstractObjectRunnable(O1 registeredObject,
                                 O2 indexObject,
                                 java.util.Map<O2,Pair<ObjectRunnable<O1,O2>,R>> objects,
                                 java.util.concurrent.atomic.AtomicInteger terminate,
                                 java.util.logging.Logger logger)

Creates a new runnable for the designated object.

Parameters:

registeredObject - The object for which this runnable has been registered.

indexObject - The object with which this runnable is managed and executed within the corresponding object-specific executor service.

objects - The data structures containing all objects and the corresponding work.

terminate - The amount of termination requests.

logger - The logger for various purpose, e. g. logging exceptions which are not propagated to outside the runnable.

Method Detail

getRegisteredObject

public O1 getRegisteredObject()

Description copied from interface: ObjectRunnable

Gets the object with which this runnable has been registered at an object-specific executor service.

Specified by:

getRegisteredObject in interface ObjectRunnable<O1,O2>

Returns:

The object with which this runnable has been registered at an object-specific executor service.

getIndexObject

public O2 getIndexObject()

Description copied from interface: ObjectRunnable

Gets the object with which this runnable is managed and executed within an object-specific executor service.

Specified by:

getIndexObject in interface ObjectRunnable<O1,O2>

Returns:

The object with which this runnable is managed and executed within an object-specific executor service.

run

public void run()

Specified by:

run in interface java.lang.Runnable

runForObject

protected abstract boolean runForObject()

Runs this runnable actually. Activation and termination signalling are already handled, implementations only need to react to termination requests.

Returns:

Whether the work for the object has been terminated. Otherwise there is work left and the termination is not signalled. With a termination request, return true, only return false if you want to continue to work without interruption, e.g. to change the executing thread.

awaitTermination

public void awaitTermination()
                      throws java.lang.InterruptedException

Description copied from interface: ObjectRunnable

Awaits the termination of this runnable. Either the thread has been interrupted, its termination has been requested or the runnable has simply finished.

Specified by:

awaitTermination in interface ObjectRunnable<O1,O2>

Throws:

java.lang.InterruptedException - If the waiting thread is interrupted while waiting for this runnable to terminate, an InterruptedException will be thrown.