Sun Java System Application Server Platform Edition 9 Administration Reference

W

web-container

Configures the web container.

Superelements

config

Subelements

The following table describes subelements for the web-container element.

Table 1–155 web-container Subelements

Element 

Required 

Description 

session-config

zero or one 

Specifies session configuration information for the web container. 

property

zero or more 

Specifies a property or a variable. 

Properties

The following table describes properties for the web-container element.

Table 1–156 web-container Properties

Property 

Default 

Description 

dispatcher-max-depth

20

Prevents recursive include or forward statements from creating an infinite loop by setting a maximum nested dispatch level. If this level is exceeded, the following message is written to the server log:

Exceeded maximum depth for nested request dispatches

web-module

Specifies a deployed web module.

Superelements

applications

Subelements

The following table describes subelements for the web-module element.

Table 1–157 web-module Subelements

Element 

Required 

Description 

description

zero or one 

Contains a text description of this element. 

web-service-endpoint

zero or more 

Configures a web service endpoint. 

property

zero or more 

Specifies a property or a variable. 

Attributes

The following table describes attributes for the web-module element.

Table 1–158 web-module Attributes

Attribute 

Default 

Description 

name

none 

The name of the web module. 

context-root

none 

The context root at which the web module is deployed. The context root can be the empty string or just /. The context root can start with the / character, but doesn’t have to.

location

none 

A fully qualified or relative path to the directory to which the contents of the .war file have been extracted. If relative, it is relative to the following directory:

domain-dir/applications/j2ee-modules/

object-type

user

(optional) Defines the type of the resource. Allowed values are: 

  • system-all - A system resource for all server instances and the domain application server.

  • system-admin - A system resource only for the domain application server.

  • system-instance - A system resource for all server instances only.

  • user - A user resource.

enabled

true

(optional) Determines whether the web module is enabled. 

libraries

none 

(optional) Specifies an absolute or relative path to libraries specific to this module or application. A relative path is relative to domain-dir/lib/applibs. If the path is absolute, the path must be accessible to the domain administration server (DAS), which means it must be under domain-dir. To include more than one path, use a system-specific separator, such as a colon for Solaris or a semicolon for Windows. The libraries are made available to the application in the order in which they are specified.

directory-deployed

false

(optional) Specifies whether the application has been deployed to a directory. 

web-service-endpoint

Configures a web service endpoint, which can be a JAX-RPC/JAXWS 2.0 or JSR-109 web service.

Superelements

ejb-module, j2ee-application, web-module

Subelements

The following table describes subelements for the web-service-endpoint element.

Table 1–159 web-service-endpoint Subelements

Element 

Required 

Description 

registry-location

zero or more 

Specifies the registry where web service endpoint artifacts are published.  

transformation-rule

zero or more 

Configures an eXtensible Stylesheet Language Transformation (XSLT) rule.

Attributes

The following table describes attributes for the web-service-endpoint element.

Table 1–160 web-service-endpoint Attributes

Attribute 

Default 

Description 

name

none 

The fully qualified name of the web service. For a web service endpoint within an application, the format is as follows: 

module-name#endpoint-name

For example: 

jaxrpc-simple.war#HelloIF

For a web service endpoint that is a stand-alone module, the name is just the endpoint-name.

monitoring

OFF

(optional) Specifies the monitoring level for this web service. For information about monitoring levels, see module-monitoring-levels.

max-history-size

25

(optional) Specifies the maximum number of monitoring records stored for this endpoint. 

jbi-enabled

true

(optional) Determines whether the visibility of this endpoint as a Java Business Integration service is enabled or disabled.