Editing orion-web.xml

For a WAR file deployed to Oracle Application Server Containers for J2EE (OC4J), JDeveloper automatically generates two deployment descriptors which are used to define the web application deployment descriptors:

web.xml

Represents the standard J2EE WAR deployment descriptor defined by Sun Microsystems. The Web Container in OC4J provides full support for Servlets 2.3 and Java Server Pages (JSP) 1.2. For more information, refer to the Sun Microsystems Java Servlet Specification, Version 2.3 which you can download from:
http://www.javasoft.com/products/servlet/

orion-web.xml

Represents the OC4J platform-specific deployment descriptors for web applications and contains the deploy time information for a WAR deployed to Oracle Application Server. If you have implementation-specific information, you can supplement the web.xml with the orion-web.xml file. After each deployment in JDeveloper, this deployment file is altered to reflect any newly added deployment descriptor information.

The orion-web.xml file contains the following settings:

• additional servlet filtering and "servlet chaining"
• buffering
• character sets
• directory browsing
• document root
• locales
• classpath
• MIME mappings
• virtual directories
• access mask (to limit access to the servlet)
• clustering
• request and session tracking
• JNDI mappings
• security role mappings
• EJB mappings
• resource expiration settings
• class loading

The orion-web.dtd is contained in oc4j.jar. After you decompress this JAR, all DTDs for the OC4J server files are located in the WEB-INF directory.

Note: After you create your web application with JDeveloper, both web.xml and orion-web.xml are automatically generated for you. They appear in the Navigator below your project.

To customize the web deployment descriptor (orion-web.xml) for OC4J deployment:

1. If you want to edit any of the standard J2EE deployment descriptors, select web.xml in the Navigator below the specified project and choose Settings.
2. Modify any of the settings on this panel and click OK when you are finished.
3. If you want to edit any of the OC4J platform-specific deployment descriptors, select orion-web.xml in the Navigator below the specified project and choose Settings.
4. Modify any of the settings on this panel and click OK when you are finished.
5. When your web application is deployed to a remote OC4J, both of these deployment descriptors are included in your <web_app>.ear file.
   Note: For a local deployment to the embedded OC4J server, these deployment descriptors and the resulting classes are reside in the embedded OC4J location.
6. Click Help on any deployment descriptor page for more information.

For more information about developing web applications in OC4J, see the "Oracle Application Server Containers for J2EE Servlet Developer’s Guide," which is provided with your Oracle Application Server documentation library.

Related topics