org.jboss.as.threads

Interface HandoffExecutorResolver

All Known Implementing Classes:

HandoffExecutorResolver.AbstractThreadFactoryResolver, HandoffExecutorResolver.SimpleResolver

public interface HandoffExecutorResolver

Resolves the service name of the executor service a thread pool service should use if it cannot itself accept a task. Optionally provides an executor service for the thread pool to use in case the thread pool does not have a specifically configured handoff executor. The absence of a specifically configured thread pool would be typical.

Author:

Brian Stansberry (c) 2011 Red Hat Inc.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	HandoffExecutorResolver.AbstractThreadFactoryResolver Base class for ThreadFactoryResolver implementations that handles the case of a null threadFactoryName by installing a ThreadFactoryService whose service name is the service name of the thread pool with thread-factory appended.
static class	HandoffExecutorResolver.SimpleResolver Extends HandoffExecutorResolver.AbstractThreadFactoryResolver to deal with named thread factories by appending their simple name to a provided base name.

Field Summary

Fields

Modifier and Type	Field and Description
static HandoffExecutorResolver	STANDARD_RESOLVER Standard implementation of ThreadFactoryResolver -- a HandoffExecutorResolver.SimpleResolver with a base service name of ThreadsServices.EXECUTOR.

Method Summary

Modifier and Type	Method and Description
void	releaseHandoffExecutor(String handoffExecutorName, String threadPoolName, org.jboss.msc.service.ServiceName threadPoolServiceName, OperationContext context) Releases the handoff executor, doing any necessary cleanup, such as removing a default executor that was installed by resolveHandoffExecutor(String, String, ServiceName, ServiceTarget, List, ServiceListener[]).
org.jboss.msc.service.ServiceName	resolveHandoffExecutor(String handoffExecutorName, String threadPoolName, org.jboss.msc.service.ServiceName threadPoolServiceName, org.jboss.msc.service.ServiceTarget serviceTarget, List<org.jboss.msc.service.ServiceController<?>> newControllers, org.jboss.msc.service.ServiceListener<? super ThreadFactory>... newServiceListeners) Resolves the service name of the handoff executor a thread pool service should use, optionally providing a default executor in case the thread pool does not have a specifically configured handoff executor.

Field Detail

STANDARD_RESOLVER

static final HandoffExecutorResolver STANDARD_RESOLVER

Standard implementation of ThreadFactoryResolver -- a HandoffExecutorResolver.SimpleResolver with a base service name of ThreadsServices.EXECUTOR.

Method Detail

resolveHandoffExecutor

org.jboss.msc.service.ServiceName resolveHandoffExecutor(String handoffExecutorName,
                                                         String threadPoolName,
                                                         org.jboss.msc.service.ServiceName threadPoolServiceName,
                                                         org.jboss.msc.service.ServiceTarget serviceTarget,
                                                         List<org.jboss.msc.service.ServiceController<?>> newControllers,
                                                         org.jboss.msc.service.ServiceListener<? super ThreadFactory>... newServiceListeners)

Resolves the service name of the handoff executor a thread pool service should use, optionally providing a default executor in case the thread pool does not have a specifically configured handoff executor.

Parameters:

handoffExecutorName - the simple name of the handoff executor. Typically a reference value from the thread pool resource's configuration. Can be null in which case a default handoff executor may be returned.

threadPoolName - the name of the thread pool

threadPoolServiceName - the full name of the Service that provides the thread pool

serviceTarget - service target that is installing the thread pool service; can be used to install a ThreadFactoryService

newControllers - a list of ServiceControllers that the serviceTarget is installing. If the implementation adds a new service controller, it should add it to this list. May be null

newServiceListeners - ServiceListeners that should be added to any newly created service. May be null

Returns:

the ServiceName of the executor service the thread pool should use. May be null

releaseHandoffExecutor

void releaseHandoffExecutor(String handoffExecutorName,
                            String threadPoolName,
                            org.jboss.msc.service.ServiceName threadPoolServiceName,
                            OperationContext context)

Releases the handoff executor, doing any necessary cleanup, such as removing a default executor that was installed by resolveHandoffExecutor(String, String, ServiceName, ServiceTarget, List, ServiceListener[]).

Parameters:

handoffExecutorName - the simple name of the thread factory. Typically a reference value from the thread pool resource's configuration. Can be null in which case a default thread factory should be released.

threadPoolName - the name of the thread pool

threadPoolServiceName - the full name of the Service that provides the thread pool

context - the context of the current operation; can be used to perform any necessary service removals