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 - Exclude 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 StandardsDefault: 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 Authentication 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>