net.algart.contexts

Class DefaultArrayContext

java.lang.Object

net.algart.arrays.AbstractArrayContext

net.algart.contexts.DefaultArrayContext

All Implemented Interfaces:

ArrayContext

public class DefaultArrayContext
extends AbstractArrayContext
implements ArrayContext

A simple implementation of ArrayContext interface, based on the memory, thread pool, interruption and progress contexts defined in this package.

Since:

JDK 1.5

Version:

1.2

Author:

Daniel Alievsky

Nested Class Summary

Nested classes/interfaces inherited from interface net.algart.arrays.ArrayContext

ArrayContext.Event

Field Summary

Fields inherited from interface net.algart.arrays.ArrayContext

DEFAULT, DEFAULT_SINGLE_THREAD

Constructor Summary

Constructors

Constructor and Description
DefaultArrayContext(Context context) Creates new instance of this class, based on the passed context.
DefaultArrayContext(Context context, ThreadPoolFactory threadPoolFactory) Creates new instance of this class, based on the passed context, which returns the specified threadPoolFactory by getThreadPoolFactory() method.

Method Summary

Modifier and Type	Method and Description
void	checkInterruption() Calls context.as(InterruptionContext.class).checkInterruption(), where context is the argument of the construcor.
MemoryModel	getMemoryModel() Returns the result of context.as(ArrayMemoryContext.class).getMemoryModel() call, where context is the argument of the construcor.
ThreadPoolFactory	getThreadPoolFactory() Returns the result of context.as(ArrayThreadPoolContext.class).getThreadPoolFactory() call, where context is the argument of the construcor, or threadPoolFactory constructor argument, if this instance was created with the corresponding variant of the constructor.
java.lang.String	toString()
void	updateProgress(ArrayContext.Event event) Calls context.as(ProgressUpdater.class).updateProgress(part, part==1.0), where context is the argument of the construcor and part=event.readyPart().

Methods inherited from class net.algart.arrays.AbstractArrayContext

checkInterruptionAndUpdateProgress, currentThreadIndex, customData, customDataVersion, multithreadedVersion, noProgressVersion, numberOfThreads, part, part, singleThreadVersion

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.algart.arrays.ArrayContext

checkInterruptionAndUpdateProgress, currentThreadIndex, customData, customDataVersion, multithreadedVersion, noProgressVersion, numberOfThreads, part, part, singleThreadVersion

Constructor Detail

DefaultArrayContext

public DefaultArrayContext(Context context)

Creates new instance of this class, based on the passed context. The passed context must allow to get the following specific contexts: ArrayMemoryContext, ArrayThreadPoolContext, InterruptionContext and ProgressUpdater.

Parameters:

context - the context that will be used by methods of this class.

Throws:

java.lang.NullPointerException - if the argument is null.

UnsupportedContextException - if this context cannot serve at least one from the requested 4 specified contexts.

DefaultArrayContext

public DefaultArrayContext(Context context,
                           ThreadPoolFactory threadPoolFactory)

Creates new instance of this class, based on the passed context, which returns the specified threadPoolFactory by getThreadPoolFactory() method. The passed context must allow to get the following specific contexts: ArrayMemoryContext, InterruptionContext and ProgressUpdater. This constructor can be used, for example, if you need to clarify the desired number of parallel threads (usually set it to 1) by DefaultThreadPoolFactory.getDefaultThreadPoolFactory(int) method.

Parameters:

context - the context that will be used by methods of this class.

threadPoolFactory - the thread pool factory that will be used by this object.

Throws:

java.lang.NullPointerException - if the context or threadPoolFactory argument is null.

UnsupportedContextException - if this context cannot serve at least one from the requested 3 specified contexts.

Method Detail

getMemoryModel

public MemoryModel getMemoryModel()

Returns the result of context.as(ArrayMemoryContext.class).getMemoryModel() call, where context is the argument of the construcor.

Specified by:

getMemoryModel in interface ArrayContext

Specified by:

getMemoryModel in class AbstractArrayContext

Returns:

the desired thread pool factory.

getThreadPoolFactory

public ThreadPoolFactory getThreadPoolFactory()

Returns the result of context.as(ArrayThreadPoolContext.class).getThreadPoolFactory() call, where context is the argument of the construcor, or threadPoolFactory constructor argument, if this instance was created with the corresponding variant of the constructor.

Specified by:

getThreadPoolFactory in interface ArrayContext

Specified by:

getThreadPoolFactory in class AbstractArrayContext

Returns:

the desired thread pool factory.

checkInterruption

public void checkInterruption()
                       throws java.lang.RuntimeException

Calls context.as(InterruptionContext.class).checkInterruption(), where context is the argument of the construcor.

Specified by:

checkInterruption in interface ArrayContext

Specified by:

checkInterruption in class AbstractArrayContext

Throws:

java.lang.RuntimeException - if the application has requested to interrupt the currently executing module; in this implementation, it will be always InterruptionException instance.

updateProgress

public void updateProgress(ArrayContext.Event event)

Calls context.as(ProgressUpdater.class).updateProgress(part, part==1.0), where context is the argument of the construcor and part=event.readyPart().

Specified by:

updateProgress in interface ArrayContext

Specified by:

updateProgress in class AbstractArrayContext

Parameters:

event - information about the execution progress.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object