Web.xml
The web deployment descriptor editor lets you specify deployment information for modules created in the Web development environment. The information appears in the web.xml file. The web.xml file for a web project provides information necessary for deploying a Web application module. It is used in building a WAR/EAR file from a project.
The online and web Services JEE applications for the product are controlled by this configuration file which holds the behavioral configuration for the applications. Refer to http://jcp.org/en/jsr/detail?id=109 for more details of the XML format.
The following sections outline the specific settings for the product.
Filter Mappings - JEE Filters
Note: Filters should not be altered unless instructed by Oracle Support. Refer to the web.xml file for the relevant settings.
The following filters apply to the product:
Filter
Usage
Browser Cache Filter
Browser Client side caching settings - Used with maxAge - Max Age for pages.
CSS Stylesheet Direction Filter
CSS Filter
Doctype Replace Filter
JDOC Filter
FlushAll Redirect Filter
Cache management utility Filter
GZip Compression Filter
HTTP 1.1 compression filter
Header Security Filter
OWASP processing of HTTP headers using SAMEORIGIN
HTML Comment stripping Filter
Removal of comments from HTTP transmission
Image Browser Cache Filter
Browser Client side caching settings for image files - Used with maxAgeI - Max Age for Images.
Image RTL Filter
Right to Left support Filter
Javascript Comment stripping Filter
Removal of comments from javascript transmission
Minification Filter
Optimization code
Privacy Page Redirect Filter
Privacy page redirect to /cm/privacy.html
Request Context Filter
Generic context Filter
Rest Security Filter
REST security support
Security Filter
Generic security filter to delegate security to JEE container
Timezone Database ContentType Filter
Time zone support
disableCompression - Disable Compression
Parameter
disableCompression
Description
Enables or disables compression between the Web Application Server and Business Application Server (true or false).
Ordinality
Mandatory
Valid Values
[true|false]
Source
Derived from WEB_ISDEVELOPMENT - Development Environment parameter from ENVIRON.INI. It is highly recommended to set to false for all environment exception is development environments using Oracle Utilities SDK.
Applicability
Web Application Server
Example:
<context-param>
<param-name>disableCompression</param-name>
<param-value>false</param-value>
</context-param>
excludePath - Eclude Path for Top Replace Filter
Parameter
excludePath
Description
Excludes all the files under a specified directory or specified files from the OUAF's top replace filter i.e., the top replace filter is not applied to the files under the directory or the specified files defined against the exclude path param.
Ordinality
Optional
Valid Values
Directory path or Files in a directory
Source
From custom user exit file(web.xml.topReplace_config.include) for web.xml
Applicability
Web Application Server
Example:
<filter>
<filter-name>Top Replace Filter</filter-
name>
<filter- class>com.splwg.base.web.utility.TopReplaceFilter</ filter-class>
<init-param>
<param-name>excludePath</param-name>
<param-value>/cm/subCM, /cm/sample.txt, /cm/CMServlet</param-value>
</init-param>
</filter>
maxAgeI - Max Age for Images
Parameter
maxAge
Description
Set the duration (in seconds) to store images, in the Client Cache, from the product on the client browser.
Ordinality
Mandatory
Valid Values
In accordance with JEE Standards
Default: 28850
Source
Derived from WEB_MAXAGEI - Image Cache parameter from ENVIRON.INI. It is highly recommended to set to the default unless otherwise recommended.
Applicability
Web Application Server
Example:
<filter>
<filter-name>Image Browser Cache Filter</filter-name>
<filter-class>com.splwg.base.web.services.BrowserCacheFilter</filter-class>
<init-param>
<param-name>maxAge</param-name>
<param-value>28850</param-value>
</init-param>
</filter>
maxAge - Max Age for pages
Parameter
maxAge
Description
Set the duration (in seconds) to store page structures from the product, in the Client Cache, on the client browser.
Ordinality
Mandatory
Valid Values
in accordance with JEE Standards. Default: 28850
Source
Derived from WEB_MAXAGE - Text Cache parameter from ENVIRON.INI. It is highly recommended to set to the default unless otherwise recommended.
Applicability
Web Application Server
Example:
<filter>
<filter-name>Browser Cache Filter</filter-name>
<filter-class>com.splwg.base.web.services.BrowserCacheFilter</filter-class>
<init-param>
<param-name>maxAge</param-name>
<param-value>28850</param-value>
</init-param>
</filter>
auth-method - Authorization Method
Parameter
auth-method
Description
Sets the JEE authentication method for the product.
Ordinality
Mandatory
Valid Values
[BASIC|CLIENT-CERT|FORM]
Source
Derived from WEB_WLAUTHMETHOD - Authentication Method parameter from ENVIRON.INI. Depending on the value this may lead to further settings being implemented.
BASIC - Enables the operating system to provide the logon dialog.
CLIENT-CERT - Enables an external solution such as a SSO solution, Kerberos or any security implementing client certificates to provide credentials.
DIGEST - Use digest authentication.
Note: Not supported for an external LDAP provider or custom provider within Oracle WebLogic. Digest Authenitcation is only supported if SIP is installed with Oracle WebLogic.
FORM - This instructs the product to implement the following additional settings:
WEB_FORM_LOGIN_PAGE - Default Form Login Page needs to be set to indicate the form to use for online authentication.
Applicability
Web Application Server
Example:
<login-config>
<auth-method>FORM</auth-method>
<form-login-config>
<form-login-page>/loginPage.jsp</form-login-page>
<form-error-page>/formLoginError.jsp</form-error-page>
</form-login-config>
</login-config>
fieldValuesAge - Server Cache Lifetime
Parameter
fieldValuesAge
Description
Set the duration (in seconds) to hold data in the Server Cache.
Ordinality
Mandatory
Valid Values
1 - 2147483647 Default: 3600
Source
Defaulted from template. Changes to the value require a Implementing Custom Templates.
Applicability
Web Application Server, Business Application Server.
Example:
<env-entry>
<description>How long to cache drop down values in seconds</description>
<env-entry-name>fieldValuesAge</env-entry-name>
<env-entry-type>java.lang.Integer</env-entry-type>
<env-entry-value>3600</env-entry-value>
</env-entry>
disableUIPageCompression - Disable UI Compression
Parameter
disableUIPageCompression
Description
Enables or disables compression between the browser and Web Application Server (true or false).
Ordinality
Mandatory
Valid Values
[true|false]
Source
Derived from WEB_ISDEVELOPMENT - Development Environment parameter from ENVIRON.INI. It is highly recommended to set to false for all environment exception is development environments using Oracle Utilities SDK.
Applicability
Web Application Server
Example:
<env-entry>
<description>Disable UIPage compression</description>
<env-entry-name>disableUIPageCompression</env-entry-name>
<env-entry-type>java.lang.Boolean</env-entry-type>
<env-entry-value>false</env-entry-value>
</env-entry>