org.glassfish.enterprise.concurrent

Class AbstractManagedExecutorService

java.lang.Object

java.util.concurrent.AbstractExecutorService

org.glassfish.enterprise.concurrent.AbstractManagedExecutorService

All Implemented Interfaces:

Executor, ExecutorService, javax.enterprise.concurrent.ManagedExecutorService

Direct Known Subclasses:

ManagedExecutorServiceImpl, ManagedScheduledExecutorServiceImpl

public abstract class AbstractManagedExecutorService
extends AbstractExecutorService
implements javax.enterprise.concurrent.ManagedExecutorService

Abstract base class for ManagedExecutorService and ManagedScheduledExecutorService implementation classes. Lifecycle operations are available for use by the application server. Application components should be handed instances that extends from AbstractManagedExecutorServiceAdapter instead, which have their lifecycle operations disabled. Instances of subclasses of this class could be used by the Java EE product provider to control the life cycle.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractManagedExecutorService.RejectPolicy

Field Summary

Fields

Modifier and Type	Field and Description
protected ContextServiceImpl	contextService
protected ContextSetupProvider	contextSetupProvider
protected boolean	contextualCallback
protected boolean	longRunningTasks
protected ManagedThreadFactoryImpl	managedThreadFactory
protected String	name
protected AbstractManagedExecutorService.RejectPolicy	rejectPolicy

Constructor Summary

Constructors

Constructor and Description
AbstractManagedExecutorService(String name, ManagedThreadFactoryImpl managedThreadFactory, long hungTaskThreshold, boolean longRunningTasks, ContextServiceImpl contextService, ContextSetupProvider contextCallback, AbstractManagedExecutorService.RejectPolicy rejectPolicy)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	awaitTermination(long timeout, TimeUnit unit)
protected <T> T	doInvokeAny(Collection<? extends Callable<T>> tasks, boolean timed, long nanos)
abstract void	execute(Runnable command)
protected void	executeManagedFutureTask(ManagedFutureTask<?> task) Executes a ManagedFutureTask created by getNewTaskFor()
abstract long	getCompletedTaskCount() Returns the approximate total number of tasks that have completed execution.
javax.enterprise.concurrent.ContextService	getContextService()
ContextSetupProvider	getContextSetupProvider()
abstract javax.enterprise.concurrent.ManagedExecutorService	getExecutorForTaskListener() Returns the ManagedExecutorService instance that is used for passing as the executor argument of ManagedTaskListener calls
Collection<AbstractManagedThread>	getHungThreads()
ManagedThreadFactoryImpl	getManagedThreadFactory()
String	getName()
protected abstract <V> ManagedFutureTask<V>	getNewTaskFor(Callable<V> callable) newTaskFor from super class java.util.concurrent.AbstractExecutorService is protected access.
protected abstract <V> ManagedFutureTask<V>	getNewTaskFor(Runnable r, V result) newTaskFor from super class java.util.concurrent.AbstractExecutorService is protected access.
String	getObjectName()
AbstractManagedExecutorService.RejectPolicy	getRejectPolicy()
abstract long	getTaskCount() Returns the approximate total number of tasks that have ever been scheduled for execution.
protected abstract ExecutorService	getThreadPoolExecutor()
Collection<AbstractManagedThread>	getThreads() Return an array of threads in this Managed[Scheduled]ExecutorService
<T> List<Future<T>>	invokeAll(Collection<? extends Callable<T>> tasks)
<T> List<Future<T>>	invokeAll(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit)
<T> T	invokeAny(Collection<? extends Callable<T>> tasks)
<T> T	invokeAny(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit)
boolean	isContextualCallback()
boolean	isEventProvider()
boolean	isLongRunningTasks()
boolean	isShutdown()
boolean	isStateManageable()
boolean	isStatisticsProvider()
boolean	isTerminated()
protected <T> RunnableFuture<T>	newTaskFor(Callable<T> callable)
protected <T> RunnableFuture<T>	newTaskFor(Runnable r, T result)
void	shutdown()
List<Runnable>	shutdownNow()
<T> Future<T>	submit(Callable<T> task)
Future<?>	submit(Runnable task)
<T> Future<T>	submit(Runnable task, T result)

Methods inherited from class java.lang.Object

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

Field Detail

name

protected final String name

contextSetupProvider

protected final ContextSetupProvider contextSetupProvider

contextService

protected final ContextServiceImpl contextService

managedThreadFactory

protected final ManagedThreadFactoryImpl managedThreadFactory

rejectPolicy

protected AbstractManagedExecutorService.RejectPolicy rejectPolicy

contextualCallback

protected final boolean contextualCallback

longRunningTasks

protected boolean longRunningTasks

Constructor Detail

AbstractManagedExecutorService

public AbstractManagedExecutorService(String name,
                              ManagedThreadFactoryImpl managedThreadFactory,
                              long hungTaskThreshold,
                              boolean longRunningTasks,
                              ContextServiceImpl contextService,
                              ContextSetupProvider contextCallback,
                              AbstractManagedExecutorService.RejectPolicy rejectPolicy)

Method Detail

doInvokeAny

protected <T> T doInvokeAny(Collection<? extends Callable<T>> tasks,
                boolean timed,
                long nanos)
                 throws InterruptedException,
                        ExecutionException,
                        TimeoutException

Throws:

InterruptedException

ExecutionException

TimeoutException

getContextSetupProvider

public ContextSetupProvider getContextSetupProvider()

getContextService

public javax.enterprise.concurrent.ContextService getContextService()

isContextualCallback

public boolean isContextualCallback()

getHungThreads

public Collection<AbstractManagedThread> getHungThreads()

getManagedThreadFactory

public ManagedThreadFactoryImpl getManagedThreadFactory()

getName

public String getName()

isLongRunningTasks

public boolean isLongRunningTasks()

getRejectPolicy

public AbstractManagedExecutorService.RejectPolicy getRejectPolicy()

getObjectName

public String getObjectName()

getThreads

public Collection<AbstractManagedThread> getThreads()

Return an array of threads in this Managed[Scheduled]ExecutorService

Returns:

an array of threads in this Managed[Scheduled]ExecutorService. It returns null if there is no thread.

invokeAll

public <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks)
                          throws InterruptedException

Specified by:

invokeAll in interface ExecutorService

Overrides:

invokeAll in class AbstractExecutorService

Throws:

InterruptedException

invokeAll

public <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks,
                            long timeout,
                            TimeUnit unit)
                          throws InterruptedException

Specified by:

invokeAll in interface ExecutorService

Overrides:

invokeAll in class AbstractExecutorService

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

isEventProvider

public boolean isEventProvider()

isStateManageable

public boolean isStateManageable()

isStatisticsProvider

public boolean isStatisticsProvider()

submit

public Future<?> submit(Runnable task)

Specified by:

submit in interface ExecutorService

Overrides:

submit in class AbstractExecutorService

Throws:

RejectedExecutionException

NullPointerException

submit

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

Specified by:

submit in interface ExecutorService

Overrides:

submit in class AbstractExecutorService

Throws:

RejectedExecutionException

NullPointerException

submit

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

Specified by:

submit in interface ExecutorService

Overrides:

submit in class AbstractExecutorService

Throws:

RejectedExecutionException

NullPointerException

getThreadPoolExecutor

protected abstract ExecutorService getThreadPoolExecutor()

execute

public abstract void execute(Runnable command)

Specified by:

execute in interface Executor

executeManagedFutureTask

protected void executeManagedFutureTask(ManagedFutureTask<?> task)

Executes a ManagedFutureTask created by getNewTaskFor()

Parameters:

task - The ManagedFutureTask to be run

awaitTermination

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

Specified by:

awaitTermination in interface ExecutorService

Throws:

InterruptedException

isShutdown

public boolean isShutdown()

Specified by:

isShutdown in interface ExecutorService

isTerminated

public boolean isTerminated()

Specified by:

isTerminated in interface ExecutorService

shutdown

public void shutdown()

Specified by:

shutdown in interface ExecutorService

shutdownNow

public List<Runnable> shutdownNow()

Specified by:

shutdownNow in interface ExecutorService

getNewTaskFor

protected abstract <V> ManagedFutureTask<V> getNewTaskFor(Runnable r,
                                     V result)

newTaskFor from super class java.util.concurrent.AbstractExecutorService is protected access. This method allows newTaskFor to be called by other methods in this package that is not a subclass of AbstractExecutorService, and to return Object of type ManagedFutureTask, which extends from the return type of newTaskFor of FutureRunnable.

getNewTaskFor

protected abstract <V> ManagedFutureTask<V> getNewTaskFor(Callable<V> callable)

newTaskFor from super class java.util.concurrent.AbstractExecutorService is protected access. This method allows newTaskFor to be called by other methods in this package that is not a subclass of AbstractExecutorService, and to return Object of type ManagedFutureTask, which extends from the return type of newTaskFor of FutureRunnable.

newTaskFor

protected <T> RunnableFuture<T> newTaskFor(Runnable r,
                               T result)

Overrides:

newTaskFor in class AbstractExecutorService

newTaskFor

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

Overrides:

newTaskFor in class AbstractExecutorService

getExecutorForTaskListener

public abstract javax.enterprise.concurrent.ManagedExecutorService getExecutorForTaskListener()

Returns the ManagedExecutorService instance that is used for passing as the executor argument of ManagedTaskListener calls

Returns:

the ManagedExecutorService instance that is used for passing as the executor argument of ManagedTaskListener calls

getTaskCount

public abstract long getTaskCount()

Returns the approximate total number of tasks that have ever been scheduled for execution. Because the states of tasks and threads may change dynamically during computation, the returned value is only an approximation.

Returns:

the number of tasks

getCompletedTaskCount

public abstract long getCompletedTaskCount()

Returns the approximate total number of tasks that have completed execution. Because the states of tasks and threads may change dynamically during computation, the returned value is only an approximation, but one that does not ever decrease across successive calls.

Returns:

the number of tasks