Package org.apache.catalina.core

Class DefaultInstanceManager

java.lang.Object

org.apache.catalina.core.DefaultInstanceManager

All Implemented Interfaces:

InstanceManager

public class DefaultInstanceManager
extends java.lang.Object
implements InstanceManager

Default implementation of InstanceManager that handles annotation-based dependency injection for EJB, JPA, and web service references.

Field Summary

Fields

Modifier and Type	Field	Description
protected java.lang.ClassLoader	classLoader	The class loader for loading application classes.
protected java.lang.ClassLoader	containerClassLoader	The class loader for loading container classes.
protected boolean	ignoreAnnotations	Whether to ignore annotations during injection.
protected boolean	privileged	Whether to perform privileged operations.
protected static StringManager	sm	The string manager for this package.

Constructor Summary

Constructors

Constructor	Description
DefaultInstanceManager(javax.naming.Context context, java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> injectionMap, Context catalinaContext, java.lang.ClassLoader containerClassLoader)	Create a new DefaultInstanceManager.

Method Summary

Modifier and Type	Method	Description
void	backgroundProcess()	Called by the component using the InstanceManager periodically to perform any regular maintenance that might be required.
void	destroyInstance(java.lang.Object instance)	Destroy the given instance, performing pre-destroy callbacks.
protected int	getAnnotationCacheSize()	Makes cache size available to unit tests.
protected java.lang.Class<?>	loadClass(java.lang.String className, java.lang.ClassLoader classLoader)	Load a class using the appropriate class loader.
protected java.lang.Class<?>	loadClassMaybePrivileged(java.lang.String className, java.lang.ClassLoader classLoader)	Load a class, performing a privileged check if necessary.
protected static void	lookupFieldResource(javax.naming.Context context, java.lang.Object instance, java.lang.reflect.Field field, java.lang.String name, java.lang.Class<?> clazz)	Inject resources in specified field.
protected static void	lookupMethodResource(javax.naming.Context context, java.lang.Object instance, java.lang.reflect.Method method, java.lang.String name, java.lang.Class<?> clazz)	Inject resources in specified method.
java.lang.Object	newInstance(java.lang.Class<?> clazz)	Create a new instance of the given class.
void	newInstance(java.lang.Object o)	Perform dependency injection on the given object.
java.lang.Object	newInstance(java.lang.String className)	Create a new instance of the class with the given name.
java.lang.Object	newInstance(java.lang.String className, java.lang.ClassLoader classLoader)	Create a new instance of the class with the given name using the specified class loader.
protected void	populateAnnotationsCache(java.lang.Class<?> clazz, java.util.Map<java.lang.String,java.lang.String> injections)	Make sure that the annotations cache has been populated for the provided class.
protected void	postConstruct(java.lang.Object instance, java.lang.Class<?> clazz)	Call postConstruct method on the specified instance recursively from the deepest superclass to actual class.
protected void	preDestroy(java.lang.Object instance, java.lang.Class<?> clazz)	Call preDestroy method on the specified instance recursively from the deepest superclass to actual class.
protected void	processAnnotations(java.lang.Object instance, java.util.Map<java.lang.String,java.lang.String> injections)	Inject resources in specified instance.

Methods inherited from class java.lang.Object

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

Field Detail

sm

protected static final StringManager sm

The string manager for this package.

classLoader

protected final java.lang.ClassLoader classLoader

The class loader for loading application classes.

containerClassLoader

protected final java.lang.ClassLoader containerClassLoader

The class loader for loading container classes.

privileged

protected final boolean privileged

Whether to perform privileged operations.

ignoreAnnotations

protected final boolean ignoreAnnotations

Whether to ignore annotations during injection.

Constructor Detail

DefaultInstanceManager

public DefaultInstanceManager(javax.naming.Context context,
                              java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> injectionMap,
                              Context catalinaContext,
                              java.lang.ClassLoader containerClassLoader)

Create a new DefaultInstanceManager.

Parameters:

context - The context associated with this instance manager

injectionMap - The injection map for JNDI resource lookups

catalinaContext - The Catalina context for configuration

containerClassLoader - The container class loader

Method Detail

newInstance

public java.lang.Object newInstance(java.lang.Class<?> clazz)
                             throws java.lang.IllegalAccessException,
                                    java.lang.reflect.InvocationTargetException,
                                    javax.naming.NamingException,
                                    java.lang.InstantiationException,
                                    java.lang.IllegalArgumentException,
                                    java.lang.NoSuchMethodException,
                                    java.lang.SecurityException

Description copied from interface: InstanceManager

Create a new instance of the given class.

Specified by:

newInstance in interface InstanceManager

Parameters:

clazz - The class to instantiate

Returns:

the new instance

Throws:

java.lang.IllegalAccessException - if the class or its nullary constructor is not accessible

java.lang.reflect.InvocationTargetException - if the nullary constructor throws an exception

javax.naming.NamingException - if a naming exception is encountered

java.lang.InstantiationException - if this Class represents an abstract class, an interface, an array class, a primitive type, or void

java.lang.IllegalArgumentException - if this method is invoked with illegal arguments

java.lang.NoSuchMethodException - if the nullary method cannot be found

java.lang.SecurityException - if a security manager, s, is present

newInstance

public java.lang.Object newInstance(java.lang.String className)
                             throws java.lang.IllegalAccessException,
                                    java.lang.reflect.InvocationTargetException,
                                    javax.naming.NamingException,
                                    java.lang.InstantiationException,
                                    java.lang.ClassNotFoundException,
                                    java.lang.IllegalArgumentException,
                                    java.lang.NoSuchMethodException,
                                    java.lang.SecurityException

Description copied from interface: InstanceManager

Create a new instance of the class with the given name.

Specified by:

newInstance in interface InstanceManager

Parameters:

className - The name of the class to instantiate

Returns:

the new instance

Throws:

java.lang.IllegalAccessException - if the class or its nullary constructor is not accessible

java.lang.reflect.InvocationTargetException - if the nullary constructor throws an exception

javax.naming.NamingException - if a naming exception is encountered

java.lang.InstantiationException - if this Class represents an abstract class, an interface, an array class, a primitive type, or void

java.lang.ClassNotFoundException - if the class cannot be found

java.lang.IllegalArgumentException - if this method is invoked with illegal arguments

java.lang.NoSuchMethodException - if the nullary method cannot be found

java.lang.SecurityException - if a security manager, s, is present

newInstance

public java.lang.Object newInstance(java.lang.String className,
                                    java.lang.ClassLoader classLoader)
                             throws java.lang.IllegalAccessException,
                                    javax.naming.NamingException,
                                    java.lang.reflect.InvocationTargetException,
                                    java.lang.InstantiationException,
                                    java.lang.ClassNotFoundException,
                                    java.lang.IllegalArgumentException,
                                    java.lang.NoSuchMethodException,
                                    java.lang.SecurityException

Description copied from interface: InstanceManager

Create a new instance of the class with the given name using the specified class loader.

Specified by:

newInstance in interface InstanceManager

Parameters:

className - The fully qualified class name

classLoader - The class loader to use for loading the class

Returns:

the new instance

Throws:

java.lang.IllegalAccessException - if the class or its nullary constructor is not accessible

javax.naming.NamingException - if a naming exception is encountered

java.lang.reflect.InvocationTargetException - if the nullary constructor throws an exception

java.lang.InstantiationException - if this Class represents an abstract class, an interface, an array class, a primitive type, or void

java.lang.ClassNotFoundException - if the class cannot be found

java.lang.IllegalArgumentException - if this method is invoked with illegal arguments

java.lang.NoSuchMethodException - if the nullary method cannot be found

java.lang.SecurityException - if a security manager, s, is present

newInstance

public void newInstance(java.lang.Object o)
                 throws java.lang.IllegalAccessException,
                        java.lang.reflect.InvocationTargetException,
                        javax.naming.NamingException

Description copied from interface: InstanceManager

Perform dependency injection on the given object.

Specified by:

newInstance in interface InstanceManager

Parameters:

o - The object to inject dependencies into

Throws:

java.lang.IllegalAccessException - if the class or its nullary constructor is not accessible

java.lang.reflect.InvocationTargetException - if the nullary constructor throws an exception

javax.naming.NamingException - if a naming exception is encountered

destroyInstance

public void destroyInstance(java.lang.Object instance)
                     throws java.lang.IllegalAccessException,
                            java.lang.reflect.InvocationTargetException

Description copied from interface: InstanceManager

Destroy the given instance, performing pre-destroy callbacks.

Specified by:

destroyInstance in interface InstanceManager

Parameters:

instance - The object to destroy

Throws:

java.lang.IllegalAccessException - if the class or its nullary constructor is not accessible

java.lang.reflect.InvocationTargetException - if the nullary constructor throws an exception

postConstruct

protected void postConstruct(java.lang.Object instance,
                             java.lang.Class<?> clazz)
                      throws java.lang.IllegalAccessException,
                             java.lang.reflect.InvocationTargetException

Call postConstruct method on the specified instance recursively from the deepest superclass to actual class.

Parameters:

instance - object to call postconstruct methods on

clazz - (super) class to examine for postConstruct annotation.

Throws:

java.lang.IllegalAccessException - if postConstruct method is inaccessible.

java.lang.reflect.InvocationTargetException - if call fails

preDestroy

protected void preDestroy(java.lang.Object instance,
                          java.lang.Class<?> clazz)
                   throws java.lang.IllegalAccessException,
                          java.lang.reflect.InvocationTargetException

Call preDestroy method on the specified instance recursively from the deepest superclass to actual class.

Parameters:

instance - object to call preDestroy methods on

clazz - (super) class to examine for preDestroy annotation.

Throws:

java.lang.IllegalAccessException - if preDestroy method is inaccessible.

java.lang.reflect.InvocationTargetException - if call fails

backgroundProcess

public void backgroundProcess()

Description copied from interface: InstanceManager

Called by the component using the InstanceManager periodically to perform any regular maintenance that might be required. By default, this method is a NO-OP.

Specified by:

backgroundProcess in interface InstanceManager

populateAnnotationsCache

protected void populateAnnotationsCache(java.lang.Class<?> clazz,
                                        java.util.Map<java.lang.String,java.lang.String> injections)
                                 throws java.lang.IllegalAccessException,
                                        java.lang.reflect.InvocationTargetException,
                                        javax.naming.NamingException

Make sure that the annotations cache has been populated for the provided class.

Parameters:

clazz - clazz to populate annotations for

injections - map of injections for this class from xml deployment descriptor

Throws:

java.lang.IllegalAccessException - if injection target is inaccessible

javax.naming.NamingException - if value cannot be looked up in jndi

java.lang.reflect.InvocationTargetException - if injection fails

processAnnotations

protected void processAnnotations(java.lang.Object instance,
                                  java.util.Map<java.lang.String,java.lang.String> injections)
                           throws java.lang.IllegalAccessException,
                                  java.lang.reflect.InvocationTargetException,
                                  javax.naming.NamingException

Inject resources in specified instance.

Parameters:

instance - instance to inject into

injections - map of injections for this class from xml deployment descriptor

Throws:

java.lang.IllegalAccessException - if injection target is inaccessible

javax.naming.NamingException - if value cannot be looked up in jndi

java.lang.reflect.InvocationTargetException - if injection fails

getAnnotationCacheSize

protected int getAnnotationCacheSize()

Makes cache size available to unit tests.

Returns:

the cache size

loadClassMaybePrivileged

protected java.lang.Class<?> loadClassMaybePrivileged(java.lang.String className,
                                                      java.lang.ClassLoader classLoader)
                                               throws java.lang.ClassNotFoundException

Load a class, performing a privileged check if necessary.

Parameters:

className - The name of the class to load

classLoader - The class loader to use

Returns:

the loaded class

Throws:

java.lang.ClassNotFoundException - if the class cannot be found

loadClass

protected java.lang.Class<?> loadClass(java.lang.String className,
                                       java.lang.ClassLoader classLoader)
                                throws java.lang.ClassNotFoundException

Load a class using the appropriate class loader.

Parameters:

className - The name of the class to load

classLoader - The class loader to use

Returns:

the loaded class

Throws:

java.lang.ClassNotFoundException - if the class cannot be found

lookupFieldResource

protected static void lookupFieldResource(javax.naming.Context context,
                                          java.lang.Object instance,
                                          java.lang.reflect.Field field,
                                          java.lang.String name,
                                          java.lang.Class<?> clazz)
                                   throws javax.naming.NamingException,
                                          java.lang.IllegalAccessException

Inject resources in specified field.

Parameters:

context - jndi context to extract value from

instance - object to inject into

field - field target for injection

name - jndi name value is bound under

clazz - class annotation is defined in

Throws:

java.lang.IllegalAccessException - if field is inaccessible

javax.naming.NamingException - if value is not accessible in naming context

lookupMethodResource

protected static void lookupMethodResource(javax.naming.Context context,
                                           java.lang.Object instance,
                                           java.lang.reflect.Method method,
                                           java.lang.String name,
                                           java.lang.Class<?> clazz)
                                    throws javax.naming.NamingException,
                                           java.lang.IllegalAccessException,
                                           java.lang.reflect.InvocationTargetException

Inject resources in specified method.

Parameters:

context - jndi context to extract value from

instance - object to inject into

method - field target for injection

name - jndi name value is bound under

clazz - class annotation is defined in

Throws:

java.lang.IllegalAccessException - if method is inaccessible

javax.naming.NamingException - if value is not accessible in naming context

java.lang.reflect.InvocationTargetException - if setter call fails