com.sun.enterprise.web
Class TomcatDeploymentConfig

java.lang.Object
  com.sun.enterprise.web.TomcatDeploymentConfig

public class TomcatDeploymentConfig
extends java.lang.Object

This class decorates all com.sun.enterprise.deployment.* objects in order to make them usuable by the Catalina container. This avoid having duplicate memory representation of the web.xml (as well as parsing the web.xml twice)

Author:

Jean-Francois Arcand

Constructor Summary

TomcatDeploymentConfig()

Method Summary

protected static void	configureApplicationListener(WebModule webModule, WebBundleDescriptor wmd) Configure context initialization parameter that is configured in the server configuration file, rather than the application deployment descriptor.
protected static void	configureContextEjb(WebModule webModule, EjbReferenceDescriptor ejbDescriptor) Configures EJB resource reference for a web application, as represented in a <ejb-local-ref>element in the deployment descriptor.
protected static void	configureContextEnvironment(WebModule webModule, WebBundleDescriptor wmd) Configure application environment entry, as represented by an <env-entry> element in the deployment descriptor.
protected static void	configureContextLocalEjb(WebModule webModule, EjbReferenceDescriptor ejbDescriptor) Configures EJB resource reference for a web application, as represented in a <ejb-ref> in the deployment descriptor.
protected static void	configureContextParam(WebModule webModule, WebBundleDescriptor wmd) Configure context parameter defined in the deployment descriptor.
protected static void	configureContextResource(WebModule webModule, WebBundleDescriptor wmd) Configure a resource reference for a web application, as represented in a <resource-ref> element in the deployment descriptor.
protected static void	configureEjbReference(WebModule webModule, WebBundleDescriptor wmd) Configures EJB resource reference for a web application, as represented in a <ejb-ref> and <ejb-local-ref>element in the deployment descriptor.
protected static void	configureErrorPage(WebModule webModule, WebBundleDescriptor wmd) Configure error page element for a web application, as represented by a <error-page> element in the deployment descriptor.
protected static void	configureFilterDef(WebModule webModule, WebBundleDescriptor wmd) Configure filter definition for a web application, as represented by a <filter> element in the deployment descriptor.
protected static void	configureFilterMap(WebModule webModule, WebBundleDescriptor wmd) Configure filter mapping for a web application, as represented by a <filter-mapping> element in the deployment descriptor.
protected static void	configureJspConfig(WebModule webModule, WebBundleDescriptor wmd) Configure jsp-config element contained in the deployment descriptor
protected static void	configureLoginConfig(WebModule webModule, WebBundleDescriptor wmd) Configure a login configuration element for a web application, as represented by a <login-config> element in the deployment descriptor.
protected static void	configureMessageDestination(WebModule webModule, WebBundleDescriptor wmd) Configure of a message destination for a web application, as represented in a <message-destination> element in the deployment descriptor.
protected static void	configureMessageDestinationRef(WebModule webModule, WebBundleDescriptor wmd) Representation of a message destination reference for a web application, as represented by a <message-destination-ref> element in the deployment descriptor.
protected static void	configureMimeMapping(WebModule webModule, WebBundleDescriptor wmd) Configure mime-mapping defined in the deployment descriptor.
protected static void	configureResourceRef(WebModule webModule, WebBundleDescriptor wmd) Configure resource-reference defined in the deployment descriptor.
protected static void	configureSecurityConstraint(WebModule webModule, WebBundleDescriptor wmd) Configure security constraint element for a web application, as represented by a <security-constraint> element in the deployment descriptor.
protected static void	configureSecurityRoles(WebModule webModule, WebBundleDescriptor wmd) Validate the usage of security role names in the web application deployment descriptor.
protected static void	configureStandardContext(WebModule webModule, WebBundleDescriptor wmd) Configure the WebModule instance by creating StandardWrapper using the information contained in the deployment descriptor (Welcome Files, JSP, Servlets etc.)
static void	configureWebModule(WebModule webModule, WebBundleDescriptor webModuleDescriptor) Configure a WebModule by applying web.xml information contained in WebBundleDescriptor.

Methods inherited from class java.lang.Object

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

Constructor Detail

TomcatDeploymentConfig

public TomcatDeploymentConfig()

Method Detail

configureWebModule

public static void configureWebModule(WebModule webModule,
                                      WebBundleDescriptor webModuleDescriptor)
                               throws LifecycleException

Configure a WebModule by applying web.xml information contained in WebBundleDescriptor. This astatic void calling Tomcat 5 internal deployment mechanism by re-using the DOL objects.

Throws:

LifecycleException

configureEjbReference

protected static void configureEjbReference(WebModule webModule,
                                            WebBundleDescriptor wmd)

Configures EJB resource reference for a web application, as represented in a <ejb-ref> and <ejb-local-ref>element in the deployment descriptor.

configureContextLocalEjb

protected static void configureContextLocalEjb(WebModule webModule,
                                               EjbReferenceDescriptor ejbDescriptor)

Configures EJB resource reference for a web application, as represented in a <ejb-ref> in the deployment descriptor.

configureContextEjb

protected static void configureContextEjb(WebModule webModule,
                                          EjbReferenceDescriptor ejbDescriptor)

Configures EJB resource reference for a web application, as represented in a <ejb-local-ref>element in the deployment descriptor.

configureContextEnvironment

protected static void configureContextEnvironment(WebModule webModule,
                                                  WebBundleDescriptor wmd)

Configure application environment entry, as represented by an <env-entry> element in the deployment descriptor.

configureErrorPage

protected static void configureErrorPage(WebModule webModule,
                                         WebBundleDescriptor wmd)

Configure error page element for a web application, as represented by a <error-page> element in the deployment descriptor.

configureFilterDef

protected static void configureFilterDef(WebModule webModule,
                                         WebBundleDescriptor wmd)

Configure filter definition for a web application, as represented by a <filter> element in the deployment descriptor.

configureFilterMap

protected static void configureFilterMap(WebModule webModule,
                                         WebBundleDescriptor wmd)

Configure filter mapping for a web application, as represented by a <filter-mapping> element in the deployment descriptor. Each filter mapping must contain a filter name plus either a URL pattern or a servlet name.

configureApplicationListener

protected static void configureApplicationListener(WebModule webModule,
                                                   WebBundleDescriptor wmd)

Configure context initialization parameter that is configured in the server configuration file, rather than the application deployment descriptor. This is convenient for establishing default values (which may be configured to allow application overrides or not) without having to modify the application deployment descriptor itself.

configureJspConfig

protected static void configureJspConfig(WebModule webModule,
                                         WebBundleDescriptor wmd)

Configure jsp-config element contained in the deployment descriptor

configureLoginConfig

protected static void configureLoginConfig(WebModule webModule,
                                           WebBundleDescriptor wmd)

Configure a login configuration element for a web application, as represented by a <login-config> element in the deployment descriptor.

configureMimeMapping

protected static void configureMimeMapping(WebModule webModule,
                                           WebBundleDescriptor wmd)

Configure mime-mapping defined in the deployment descriptor.

configureResourceRef

protected static void configureResourceRef(WebModule webModule,
                                           WebBundleDescriptor wmd)

Configure resource-reference defined in the deployment descriptor.

configureContextParam

protected static void configureContextParam(WebModule webModule,
                                            WebBundleDescriptor wmd)

Configure context parameter defined in the deployment descriptor.

configureMessageDestination

protected static void configureMessageDestination(WebModule webModule,
                                                  WebBundleDescriptor wmd)

Configure of a message destination for a web application, as represented in a <message-destination> element in the deployment descriptor.

configureMessageDestinationRef

protected static void configureMessageDestinationRef(WebModule webModule,
                                                     WebBundleDescriptor wmd)

Representation of a message destination reference for a web application, as represented by a <message-destination-ref> element in the deployment descriptor.

configureContextResource

protected static void configureContextResource(WebModule webModule,
                                               WebBundleDescriptor wmd)

Configure a resource reference for a web application, as represented in a <resource-ref> element in the deployment descriptor.

configureStandardContext

protected static void configureStandardContext(WebModule webModule,
                                               WebBundleDescriptor wmd)

Configure the WebModule instance by creating StandardWrapper using the information contained in the deployment descriptor (Welcome Files, JSP, Servlets etc.)

configureSecurityConstraint

protected static void configureSecurityConstraint(WebModule webModule,
                                                  WebBundleDescriptor wmd)

Configure security constraint element for a web application, as represented by a <security-constraint> element in the deployment descriptor. Configure a web resource collection for a web application's security constraint, as represented by a <web-resource-collection> element in the deployment descriptor.

configureSecurityRoles

protected static void configureSecurityRoles(WebModule webModule,
                                             WebBundleDescriptor wmd)

Validate the usage of security role names in the web application deployment descriptor. If any problems are found, issue warning messages (for backwards compatibility) and add the missing roles. (To make these problems fatal instead, simply set the ok instance variable to false as well).