Package org.springframework.scheduling.concurrent

Class DefaultManagedAwareThreadFactory

java.lang.Object

org.springframework.util.CustomizableThreadCreator

org.springframework.scheduling.concurrent.CustomizableThreadFactory

org.springframework.scheduling.concurrent.DefaultManagedAwareThreadFactory

All Implemented Interfaces:

Serializable, ThreadFactory, InitializingBean

public class DefaultManagedAwareThreadFactory
extends CustomizableThreadFactory
implements InitializingBean

JNDI-based variant of CustomizableThreadFactory, performing a default lookup for JSR-236's "java:comp/DefaultManagedThreadFactory" in a Jakarta EE environment, falling back to the local CustomizableThreadFactory setup if not found.

This is a convenient way to use managed threads when running in a Jakarta EE environment, simply using regular local threads otherwise - without conditional setup (i.e. without profiles).

Note: This class is not strictly JSR-236 based; it can work with any regular ThreadFactory that can be found in JNDI. Therefore, the default JNDI name "java:comp/DefaultManagedThreadFactory" can be customized through the "jndiName" bean property.

Since:

4.0

Author:

Juergen Hoeller

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected final Log	logger

Constructor Summary

Constructors

Constructor	Description
DefaultManagedAwareThreadFactory()

Method Summary

Modifier and Type	Method	Description
void	afterPropertiesSet()	Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.
Thread	newThread(Runnable runnable)
void	setJndiEnvironment(Properties jndiEnvironment)	Set the JNDI environment to use for JNDI lookups.
void	setJndiName(String jndiName)	Specify a JNDI name of the ThreadFactory to delegate to, replacing the default JNDI name "java:comp/DefaultManagedThreadFactory".
void	setJndiTemplate(JndiTemplate jndiTemplate)	Set the JNDI template to use for JNDI lookups.
void	setResourceRef(boolean resourceRef)	Set whether the lookup occurs in a Jakarta EE container, i.e.

Methods inherited from class org.springframework.util.CustomizableThreadCreator

createThread, getDefaultThreadNamePrefix, getThreadGroup, getThreadNamePrefix, getThreadPriority, isDaemon, nextThreadName, setDaemon, setThreadGroup, setThreadGroupName, setThreadNamePrefix, setThreadPriority

Methods inherited from class java.lang.Object

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

Field Details

logger

protected final Log logger

Constructor Details

DefaultManagedAwareThreadFactory

public DefaultManagedAwareThreadFactory()

Method Details

setJndiTemplate

public void setJndiTemplate(JndiTemplate jndiTemplate)

Set the JNDI template to use for JNDI lookups.

See Also:

• JndiAccessor.setJndiTemplate(org.springframework.jndi.JndiTemplate)

setJndiEnvironment

public void setJndiEnvironment(Properties jndiEnvironment)

Set the JNDI environment to use for JNDI lookups.

See Also:

• JndiAccessor.setJndiEnvironment(java.util.Properties)

setResourceRef

public void setResourceRef(boolean resourceRef)

Set whether the lookup occurs in a Jakarta EE container, i.e. if the prefix "java:comp/env/" needs to be added if the JNDI name doesn't already contain it. PersistenceAnnotationBeanPostProcessor's default is "true".

See Also:

• JndiLocatorSupport.setResourceRef(boolean)

setJndiName

public void setJndiName(String jndiName)

Specify a JNDI name of the ThreadFactory to delegate to, replacing the default JNDI name "java:comp/DefaultManagedThreadFactory".

This can either be a fully qualified JNDI name, or the JNDI name relative to the current environment naming context if "resourceRef" is set to "true".

See Also:

• setResourceRef(boolean)

afterPropertiesSet

public void afterPropertiesSet()
                        throws NamingException

Description copied from interface: InitializingBean

Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.

This method allows the bean instance to perform validation of its overall configuration and final initialization when all bean properties have been set.

Specified by:

afterPropertiesSet in interface InitializingBean

Throws:

NamingException

newThread

public Thread newThread(Runnable runnable)

Specified by:

newThread in interface ThreadFactory

Overrides:

newThread in class CustomizableThreadFactory