org.jboss.as.threads

Interface ThreadFactoryResolver

All Known Implementing Classes:

ThreadFactoryResolver.AbstractThreadFactoryResolver, ThreadFactoryResolver.SimpleResolver

public interface ThreadFactoryResolver

Resolves the service name of the thread factory a thread pool service should use. Provides a default thread factory for a thread pool in case the thread pool does not have a specifically configured thread factory. 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	ThreadFactoryResolver.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	ThreadFactoryResolver.SimpleResolver Extends ThreadFactoryResolver.AbstractThreadFactoryResolver to deal with named thread factories by appending their simple name to a provided base name.

Method Summary

Modifier and Type	Method and Description
void	releaseThreadFactory(String threadFactoryName, String threadPoolName, org.jboss.msc.service.ServiceName threadPoolServiceName, OperationContext context) Releases the thread factory, doing any necessary cleanup, such as removing a default thread factory that was installed by resolveThreadFactory(String, String, ServiceName, ServiceTarget, List, ServiceListener[]).
org.jboss.msc.service.ServiceName	resolveThreadFactory(String threadFactoryName, 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 thread factory a thread pool service should use, providing a default thread factory in case the thread pool does not have a specifically configured thread factory.

Method Detail

resolveThreadFactory

org.jboss.msc.service.ServiceName resolveThreadFactory(String threadFactoryName,
                                                       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 thread factory a thread pool service should use, providing a default thread factory in case the thread pool does not have a specifically configured thread factory.

Parameters:

threadFactoryName - 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 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 ThreadFactoryService the thread pool should use. Cannot be null

releaseThreadFactory

void releaseThreadFactory(String threadFactoryName,
                          String threadPoolName,
                          org.jboss.msc.service.ServiceName threadPoolServiceName,
                          OperationContext context)

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

Parameters:

threadFactoryName - 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