org.jboss.web
Interface AbstractWebContainer.WebDescriptorParser

Enclosing class:

AbstractWebContainer

public static interface AbstractWebContainer.WebDescriptorParser

Method Summary

void	parseWebAppDescriptors(java.lang.ClassLoader loader, org.w3c.dom.Element webApp, org.w3c.dom.Element jbossWeb) This method is called as part of subclass performDeploy() method implementations to parse the web-app.xml and jboss-web.xml deployment descriptors from a war deployment.

Method Detail

parseWebAppDescriptors

public void parseWebAppDescriptors(java.lang.ClassLoader loader,
                                   org.w3c.dom.Element webApp,
                                   org.w3c.dom.Element jbossWeb)
                            throws java.lang.Exception

This method is called as part of subclass performDeploy() method implementations to parse the web-app.xml and jboss-web.xml deployment descriptors from a war deployment. The method creates the ENC(java:comp/env) env-entry, resource-ref, & ejb-ref element values. The creation of the env-entry values does not require a jboss-web.xml descriptor. The creation of the resource-ref and ejb-ref elements does require a jboss-web.xml descriptor for the JNDI name of the deployed resources/EJBs. Because the ENC context is private to the web application, the web application class loader is used to identify the ENC. The class loader is used because each war typically requires a unique class loader to isolate the web application classes/resources. This means that the ClassLoader passed to this method must be the thread context ClassLoader seen by the server/jsp pages during init/destroy/service/etc. method invocations if these methods interace with the JNDI ENC context.

Parameters:

loader, - the ClassLoader for the web application. May not be null.

webApp, - the root element of thw web-app.xml descriptor. May not be null.

jbossWeb, - the root element of thw jboss-web.xml descriptor. May be null to indicate that no jboss-web.xml descriptor exists.