Creating orion-web.xml

The orion-web-jar.xml deployment descriptor file contains 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 J2EE standard deployment descriptor, web.xml with orion-web.xml. After each deployment in JDeveloper, this deployment file is altered to reflect any newly added deployment descriptor information.

JDeveloper also automatically generates a web.xml and orion-web-jar.xml file when you create a deployment profile for web applications (WAR) and deploy it to Oracle Application Server. However, if you want to control the contents of the orion-web-jar.xml, you can manually create your own orion-web-jar.xml to include in the deployment profile.

The orion-web.xml file supports the following additional configuration 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.

To manually create an orion-web.xml file:

1. In the Navigator, select the project to which you want to add an orion-web.xml file.
2. Choose File | New to open the New Gallery dialog.
3. In the Categories tree, click Web Tier.
4. In the Items list, double-click OC4J Web Deployment Descriptor (orion-web.xml).
5. The newly created file opens in the Code Editor. Edit this file to add the configuration settings as appropriate.
6. (Optional) If you ever want to edit this deployment descriptor, right-click the orion-web.xml node in the Navigator below the specified project. See Editing orion-web.xml.

See also: "Oracle Application Server Containers for J2EE Servlet Developer’s Guide" for more information about creating this file.