Chapter 18. Configuring jeus-web-dd.xml

This chapter explains the contents of jeus-web-dd.xml, a web module deployment descriptor.

XML schema file: JEUS_HOME/lib/schemas/jeus/jeus-web-dd.xsd

18.1. Introduction

XML references are configured in the following format.

XML Schema/XML Tree: Summarizes all the tags of XML configuration file. Each node is defined in the following format.
1. Tag reference enables quick search for tags. Each tag is attached with index numbers ( ex: (11) ). Tags are explained with this number in tag reference.
2. The XML tag name defined in the XML schema is expressed in the format of <tag name>.
3. Tags are set with cardinality defined in XML schema.
  
  “?” is for 0 or 1 element, “+” is for 1 or more elements, “*” is for 0 or more elements, (no symbol) is for exactly one element
4. Several tags have "P" character, meaning that they are the tags related to performance. These tags are used to tune the setting.
Element Reference: Explains XML tags in the tree.
1. Dynamic: Allowed to change the configuration dynamically.
2. Non-Dynamic: Not allowed to change the configuration dynamically. This is expressed only for the special case to comment out.
3. Description: A short description for tags.
4. Value Description: The value and type.
5. Value Type: Data type of the value. (ex: String)
6. Value Type Description: Description for the data type of the value.
7. Default Value: The value to be used by default when the XML is not used.
8. Defined Value: The default value.
9. Example: The XML tag example.
10. Performance Recommendation: The value recommended to improve performance.
11. Child Elements:The tags contained in its own tag element.

18.2. XML Schema/XML Tree

(1) <jeus-web-dd>
- (2) <context-path> ?
- (3) <pipeline> ?
  - (4) <valve> *
    (5) <class-name>
    (6) <property> *
    (7) <key>
    (8) <value>
- (9) <enable-jsp> ?
- (10) <jsp-engine> ?
- (20) <auto-reload> ?
  - (21) <enable-reload> ?
  - (22) <use-jvm-hotswap> ?
  - (23) <check-on-demand> ?
  - (24) <reload-timeout> ?
- (25) <properties> ?
  - (26) <property> *
    (27) <key>
    (28) <value>
- (29) <webinf-first> ?
  - (30) <enabled>
  - (31) <excluded-package> *
- (32) <role-mapping> ?
  - (33) <role-permission> *
    (34) <role>
    (35) <principal> *
    (36) <actions> ?
    (37) <classname> ?
    (38) <excluded> ?
    
    (39) <unchecked> ?
- (40) <upgrade> ?
  - (41) <upgrade-executor> ?
    (42) <min> ?
    (43) <max> ?
    (44) <keep-alive-time> ?
    (45) <queue-size> ?
- (46) <websocket> ?
- (61) <session-config> ?
  - (62) <timeout> ?
  - (63) <max-session-count> ?
  - (64) <reload-persistent> ?
  - (65) <tracking-mode> ?
    (66) <cookie> ?
    (67) <url> ?
    (68) <ssl> ?
  - (69) <session-cookie> ?
    (70) <cookie-name> ?
    (71) <url-cookie-name> ?
    (72) <version> ?
    (73) <domain> ?
    (74) <path> ?
    (75) <max-age> ?
    (76) <secure> ?
    (77) <http-only> ?
    (78) <same-site> ?
    (79) <comment> ?
    (80) <partitioned> ?
- (81) <encoding> ?
  - (82) <request-encoding> ?
    (83) <default>
    (84) <client-override>
    (85) <forced>
    (86) <url-mapping> *
    (87) <servlet-path>
    (88) <encoding>
  - (89) <response-encoding> ?
    (90) <default>
    (91) <forced>
- (92) <content-encodings> ?
  - (93) <compression-min-size> ?
  - (94) <content-encoding> +
    (95) <mime-type>
    (96) <compression>
- (97) <accept-encodings> ?
  - (98) <accept-encoding>
    (99) <compression>
    (100) <quality> ?
- (101) <cookie-policy> ?
  - (102) <write-value-on-header-policy> ?
    (103) <apply-url-encoding-rule> ?
    (104) <charset-encoding> ?
- (105) <user-log> ?
  - (106) <level> ?
  - (107) <use-parent-handlers> ?
  - (108) <filter-class> ?
  - (109) <formatter-pattern> ?
  - (110) <handler> ?
    (111) <file-handler> *
    (112) <name>
    (113) <level> ?
    (114) <encoding> ?
    (115) <filter-class> ?
    (116) <file-name> ?
    (117) <permission> ?
    (118) <chown> ?
    (119) <enable-rotation> ?
    (120) <rotation-count> ?
    (121) <rotation-dir> ?
    (122) <valid-day>
    (123) <valid-hour>
    (124) <valid-size>
    (125) <buffer-size> ? P
    (126) <append> ?
    
    (127) <smtp-handler> * P
    (128) <name>
    (129) <level> ?
    (130) <encoding> ?
    (131) <filter-class> ?
    (132) <smtp-host-address>
    (133) <sender-id>
    (134) <sender-password>
    (135) <from-address>
    (136) <to-address>
    (137) <property> *
    (138) <key>
    (139) <value>
    
    (140) <cc-address> ?
    (141) <bcc-address> ?
    (142) <send-for-all-messages> ?
    
    (143) <socket-handler> * P
    (144) <name>
    (145) <level> ?
    (146) <encoding> ?
    (147) <filter-class> ?
    (148) <address>
    (149) <port>
    
    (150) <user-handler> *
    (151) <name>
    (152) <level> ?
    (153) <encoding> ?
    (154) <filter-class> ?
    (155) <handler-class>
    (156) <handler-property> ?
    (157) <property> *
    (158) <key>
    (159) <value>
    
    (160) <formatter-pattern> ?
    (161) <formatter-property> ?
    (162) <property> *
    (163) <key>
    (164) <value>
- (165) <allow-indexing> ?
  - (166) <directory> *
- (167) <deny-download> ?
  - (168) <file> *
  - (169) <directory> *
  - (170) <extension> *
- (171) <aliasing> ?
  - (172) <alias> *
    (173) <alias-name>
    (174) <real-path>
- (175) <file-caching> ?
  - (176) <max-idle-time> ?
  - (177) <max-cache-memory> ?
  - (178) <directory> *
- (179) <added-classpath> ?
  - (180) <class-path> *
- (181) <thread-pool> ?
  - (182) <base> ?
    (183) <name>
    (184) <min>
    (185) <max>
    (186) <max-idle-time> ?
    (187) <max-queue> ?
    (188) <thread-state-notify> ?
    (189) <max-thread-active-time> ?
    (190) <interrupt-thread> ?
    (191) <active-timeout-notification> ?
    (192) <notify-threshold-ratio> ?
    (193) <notify-subject> ?
    (194) <restart-threshold-ratio> ?
    (195) <restart-subject> ?
  - (196) <service-group> *
    (197) <name>
    (198) <uri>
    (199) <min>
    (200) <max>
    (201) <max-idle-time> ?
    (202) <max-queue> ?
    (203) <thread-state-notify> ?
    (204) <max-thread-active-time> ?
    (205) <interrupt-thread> ?
    (206) <active-timeout-notification> ?
    (207) <notify-threshold-ratio> ?
    (208) <notify-subject> ?
    (209) <restart-threshold-ratio> ?
    (210) <restart-subject> ?
- (211) <env> *
  - (212) <name>
  - (213) <value>
  - (214) <type> ?
- (215) <ejb-ref> ?
  - (216) <jndi-info> *
    (217) <ref-name>
    (218) <export-name> ?
- (219) <res-ref> ?
  - (220) <jndi-info> *
    (221) <ref-name>
    (222) <export-name> ?
- (223) <res-env-ref> ?
  - (224) <jndi-info> *
    (225) <ref-name>
    (226) <export-name> ?
- (227) <message-destination-ref> ?
  - (228) <jndi-info> *
    (229) <ref-name>
    (230) <export-name> ?
- (231) <service-ref> ?
  - (232) <service-client> *
    (233) <service-ref-name>
    (234) <port-info> *
    (235) <service-endpoint-interface> ?
    (236) <wsdl-port> ?
    (237) <stub-property> *
    (238) <name>
    (239) <value>
    
    (240) <call-property> *
    (241) <name>
    (242) <value>
    
    (243) <security> ?
    (244) <request-sender> ?
    (245) <action-list>
    (246) <password-callback-class> ?
    (247) <user> ?
    (248) <timeStamp> ?
    (249) <timeToLive> ?
    (250) <aberration> ?
    (251) <requireSignature> ?
    (252) <precision> ?
    
    (253) <userNameToken> ?
    (254) <password> ?
    (255) <passwordType> ?
    (256) <userTokenElements> ?
    
    (257) <signature-infos> ?
    (258) <signature-info> *
    (259) <signatureParts> ?
    (260) <signatureAlgorithm> ?
    (261) <messageDigestAlogrithm> ?
    (262) <canonicalization> ?
    (263) <keyIdentifier>
    (264) <keystore> ?
    (265) <key-type>
    (266) <keystore-password>
    (267) <keystore-filename>
    
    (268) <encryption-infos> ?
    (269) <encryption-info> *
    (270) <encryptionParts> ?
    (271) <keyTransportAlogrithm> ?
    (272) <encryptionAlgorithm> ?
    (273) <encryptionUser> ?
    (274) <keyIdentifier>
    (275) <keystore> ?
    (276) <key-type>
    (277) <keystore-password>
    (278) <keystore-filename>
    
    (279) <embeddedKey> ?
    (280) <embeddedKeyCallbackClass>
    (281) <key-name>
    
    (282) <response-receiver> ?
    (283) <action-list>
    (284) <observeActionOrder> ?
    (285) <password-callback-class> ?
    (286) <timeStamp> ?
    (287) <timeToLive> ?
    (288) <aberration> ?
    (289) <requireSignature> ?
    (290) <precision> ?
    
    (291) <decryption> ?
    (292) <keystore>
    (293) <key-type>
    (294) <keystore-password>
    (295) <keystore-filename>
    
    (296) <signature-verification> ?
    (297) <keystore>
    (298) <key-type>
    (299) <keystore-password>
    (300) <keystore-filename>
    
    (301) <service-impl-class> ?
    (302) <wsdl-override> ?
    (303) <require-dynamic-proxy> ?
    (304) <service-qname> ?
    (305) <call-property> *
    (306) <name>
    (307) <value>
- (308) <keep-generated> ?
- (309) <fast-deploy> ?
- (310) <servlet> *
  - (311) <servlet-name>
  - (312) <run-as-identity> ?
    (313) <principal-name>
- (314) <jsp-resource> ?
  - (315) <provider-class> ?
- (316) <target-session-cluster> ?
- (317) <use-jeus-login-manager> ?
- (318) <attach-stacktrace-on-error> ?
- (319) <keep-alive-error-response-codes> ?
- (320) <library-ref> *
- (329) <java-security-permission> ?
  - (330) <security-permission-spec>
  - (331) <description> ?
- (332) <async-config> ?
  - (333) <async-timeout-millis> ?
  - (334) <background-thread-pool> ?
    (335) <name> ?
    (336) <min> ?
    (337) <max> ?
    (338) <keep-alive-time> ?
    (339) <queue-size> ?
    (340) <stuck-thread-handling> ?
    (341) <max-stuck-thread-time> ?
    (342) <action-on-stuck-thread> ?
    (343) <stuck-thread-check-period> ?
    (344) <user-warning-class> ?
  - (345) <dispatch-thread-pool> ?
    (346) <name> ?
    (347) <min> ?
    (348) <max> ?
    (349) <keep-alive-time> ?
    (350) <queue-size> ?
    (351) <stuck-thread-handling> ?
    (352) <max-stuck-thread-time> ?
    (353) <action-on-stuck-thread> ?
    (354) <stuck-thread-check-period> ?
    (355) <user-warning-class> ?
- (356) <web-security> ?
  - (357) <redirect-strategy-ref> ?
- (358) <batch-thread-pool> ?
- (368) <osgi> ?

18.3. Element Reference

(1) `<jeus-web-dd>`
Description	This file is the JEUS application (servlet application) Deployment Descriptor. It contains information about context deployment and registration under <context>.
Value Type	contextType
Child Elements	(3) `context-path` (4) `pipeline` (10) `enable-jsp` (11) `jsp-engine` (21) `auto-reload` (26) `properties` (30) `webinf-first` (33) `role-mapping` (41) `upgrade` (47) `websocket` (62) `session-config` (82) `encoding` (93) `content-encodings` (98) `accept-encodings` (102) `cookie-policy` (106) `user-log` (166) `allow-indexing` (168) `deny-download` (172) `aliasing` (176) `file-caching` (180) `added-classpath` (182) `thread-pool` (212) `env` (216) `ejb-ref` (220) `res-ref` (224) `res-env-ref` (228) `message-destination-ref` (232) `service-ref` (309) `keep-generated` (310) `fast-deploy` (311) `servlet` (315) `jsp-resource` (317) `target-session-cluster` (318) `use-jeus-login-manager` (319) `attach-stacktrace-on-error` (320) `keep-alive-error-response-codes` (321) `library-ref` (330) `java-security-permission` (333) `async-config` (357) `web-security` (359) `batch-thread-pool` (369) `osgi`

(2) `< jeus-web-dd > <context-path>`
Description	Context Root. If "/examples" is the context path to the web application "webapp", the URL "http://www.foo.com/examples/index.html" sends the index.html file from "webapp" to the client.
Value Type	valuableToken
Value Description	The value must begin with "/", and the path must be unique in the virtual host.

(3) `< jeus-web-dd > <pipeline>`
Description	Context-level valve configuration. This will be applied after the server pipeline is applied. For more information, see "Valves and Filters" in JEUS Web Engine Guide.
Value Type	pipelineType
Child Elements	(5) `valve`

(4) `< jeus-web-dd >< pipeline > <valve>`
Description	Configure valves at the server, virtual host or context level.
Value Type	valveType
Child Elements	(6) `class-name` (7) `property`

(5) `< jeus-web-dd >< pipeline >< valve > <class-name>`
Description	Valve class name for the server, virtual host or context-level configuration.
Value Type	token
Value Description	Class that inherits from ValveBase of JEUS

(6) `< jeus-web-dd >< pipeline >< valve > <property>`
Description	Valve property.
Value Type	propertyType
Value Description	Key-value pair as described in the guide
Child Elements	(8) `key` (9) `value`

(7) `< jeus-web-dd >< pipeline >< valve >< property > <key>`
Description	Key of a property.
Value Type	valuableToken

(8) `< jeus-web-dd >< pipeline >< valve >< property > <value>`
Description	Value of a property.
Value Type	valuableToken

(9) `< jeus-web-dd > <enable-jsp>`
Description	Option to use the JSP engine. If set to false, JSP files are unsupported and handled as general resources. This means that JSP source files must not be included in a web application.
Value Type	boolean
Default Value	true

(10) `< jeus-web-dd > <jsp-engine>`
Description	Applies to all JSP pages of web applications.
Value Type	jsp-engineType
Child Elements	(12) `check-included-jspfile` (13) `keep-generated` (14) `use-in-memory-compilation` (15) `graceful-jsp-reloading` (16) `graceful-jsp-reloading-period` (17) `jsp-work-dir` (18) `java-compiler` (19) `compile-output-dir` (20) `compile-option`

(11) `< jeus-web-dd >< jsp-engine > <check-included-jspfile>`
Description	Recompiles a JSP file after checking whether its included JSP files and tag files are updated.
Value Type	boolean
Value Description	Boolean. The default value is true.
Default Value	true

(12) `< jeus-web-dd >< jsp-engine > <keep-generated>`
Description	Indicates whether to keep Java files after compilation. Keeping source files is useful for debugging.
Value Type	boolean
Value Description	Boolean. The default value is true.
Default Value	true

(13) `< jeus-web-dd >< jsp-engine > <use-in-memory-compilation>`
Description	Recompiles JSP files that are running by creating .java and .class files in memory. However, .class files are written to the file system by using background threads so that they are not recompiled when the server restarts. When <keep-generated> is set to true, .java files are written in the system using background threads.
Value Type	boolean
Value Description	boolean
Default Value	true

(14) `< jeus-web-dd >< jsp-engine > <graceful-jsp-reloading>`
Description	Indicates whether to regularly check for any update in a JSP file and create a JSP page instance if there is any.
Value Type	boolean
Value Description	Boolean
Default Value	false

(15) `< jeus-web-dd >< jsp-engine > <graceful-jsp-reloading-period>`
Description	Time period after which Graceful Jsp Reloading is performed.
Value Type	long
Value Description	Milliseconds
Default Value	30000

(16) `< jeus-web-dd >< jsp-engine > <jsp-work-dir>`
Description	Directory for JSP class files.
Value Type	token
Value Description	Absolute path to JSP class files.

(17) `< jeus-web-dd >< jsp-engine > <java-compiler>`
Description	Java compiler with which to compile JSP Java source into servlet classes. The default compiler is the Java Compiler API included in JVM. However, Java compilation occasionally uses a lot of memory, which may cause memory issues in a real service environment. Therefore, it is recommended to compile a separate process by selecting javac or perform compilation through AppCompiler in advance.
Value Type	token
Default Value	java6

(18) `< jeus-web-dd >< jsp-engine > <compile-output-dir>`
Description	Directory for JSP class files other than JSP Work Dir. If this element is not configured, the files are stored in JSP Work Dir. This option is not used in general.
Value Type	token
Value Description	Absolute path to JSP class files.

(19) `< jeus-web-dd >< jsp-engine > <compile-option>`
Description	Servlet compiler. This option is not used in general.
Value Type	token
Value Description	Compile options (Refer to Java Compiler Setting Items).

(20) `< jeus-web-dd > <auto-reload>`
Description	Option to automatically reload servlet classes and custom tag classes if classes are changed. If this is activated, additional resources are required to reload and to monitor if classes have been changed. Therefore, it is recommended to enable this option only in a development environment.
Value Type	auto-reloadType
Child Elements	(22) `enable-reload` (23) `use-jvm-hotswap` (24) `check-on-demand` (25) `reload-timeout`

(21) `< jeus-web-dd >< auto-reload > <enable-reload>`
Description	Option to use servlet auto-reloading.
Value Type	boolean
Value Description	Boolean type. The value enables or disables servlet auto-reloading.
Default Value	false

(22) `< jeus-web-dd >< auto-reload > <use-jvm-hotswap>`
Description	Option to use the hot swap function provided by the JVM. If this is set to true, class files will be loaded using Java Instrumentation. If loading fails, all contexts will be reloaded in the standard way.
Value Type	boolean
Default Value	false

(23) `< jeus-web-dd >< auto-reload > <check-on-demand>`
Description	Option to check if servlet class reloading is performed when a request is received.
Value Type	boolean
Value Description	Boolean type. The value enables or disables this option.
Default Value	false

(24) `< jeus-web-dd >< auto-reload > <reload-timeout>`
Description	Timeout value for servlet auto-reloading.
Value Type	long
Default Value	30000

(25) `< jeus-web-dd > <properties>`
Description	Context properties.
Value Type	propertiesType
Child Elements	(27) `property`

(26)


                <
                jeus-web-dd
                ><
                properties
                >
                <property>

Value Type propertyType

Child Elements

(28) key

(29) value

(27) `< jeus-web-dd >< properties >< property > <key>`
Description	Key of a property.
Value Type	valuableToken

(28) `< jeus-web-dd >< properties >< property > <value>`
Description	Value of a property.
Value Type	valuableToken

(29) `< jeus-web-dd > <webinf-first>`
Description	Option to scan the specified class path first in the web application when loading a class. If set to true, ClassCastException may occur due to a duplicate class. You can specify exception packages and classes with <excluded-pacakge>.
Value Type	webinfFirstType
Child Elements	(31) `enabled` (32) `excluded-package`

(30) `< jeus-web-dd >< webinf-first > <enabled>`
Description	Option to enable webinf-first.
Value Type	boolean
Default Value	false

(31) `< jeus-web-dd >< webinf-first > <excluded-package>`
Description	A conflict may occur if a class to be loaded exists in both the location set in a web application and another location. This option sets a specific package and class so that a class in a class path specified in a web application is not searched first. If the method arguments and return types of the class changes, it may not be deployed or executed normally. In such case, the library in the class path set in a web application must be manually modified.
Value Type	string

(32) `< jeus-web-dd > <role-mapping>`
Description	Maps actual system user names to J2EE Role names that are used in <security-role> in the context's web.xml file. The web.xml file exists in "\WEB-INF\" in the context's Document Base directory.
Value Type	role-mappingType
Child Elements	(34) `role-permission`

(33) `< jeus-web-dd >< role-mapping > <role-permission>`
Description	Role and actions that are given to the principal.
Value Type	rolePermissionType
Child Elements	(35) `role` (36) `principal` (37) `actions` (38) `classname` (39) `excluded` (40) `unchecked`

(34) `< jeus-web-dd >< role-mapping >< role-permission > <role>`
Description	Name of the role to be assigned to the principals.
Value Type	token

(35) `< jeus-web-dd >< role-mapping >< role-permission > <principal>`
Description	User principal for the role.
Value Type	token
Value Description	Name of the principal specified in accounts.xml in the security directory.

(36) `< jeus-web-dd >< role-mapping >< role-permission > <actions>`
Description	Action for the RolePermission object. The default value is no action for RolePermissions.
Value Type	token

(37) `< jeus-web-dd >< role-mapping >< role-permission > <classname>`
Description	Role permission class name. If a class name is not specified, the default class name will be used.
Value Type	token

(38) `< jeus-web-dd >< role-mapping >< role-permission > <excluded>`
Description	Indicates that the role will be disabled.
Value Type	emptyType

(39) `< jeus-web-dd >< role-mapping >< role-permission > <unchecked>`
Description	Indicates that the role will be available without any permission.
Value Type	emptyType

(40) `< jeus-web-dd > <upgrade>`
Description	Setting for an upgrade request made by a web application.
Value Type	upgradeType
Child Elements	(42) `upgrade-executor`

(41) `< jeus-web-dd >< upgrade > <upgrade-executor>`
Description	Thread pool setting used within a container to process upgrade inbound messages. Typically used in the following cases: Processing NIO servlets through the HTTP upgrade handler, handling websocket endpoints, and managing the SendHandler during asynchronous websocket sending.
Value Type	upgradeExecutorType
Child Elements	(43) `min` (44) `max` (45) `keep-alive-time` (46) `queue-size`

(42) `< jeus-web-dd >< upgrade >< upgrade-executor > <min>`
Description	Minimum number of threads to be managed in a thread pool.
Value Type	nonNegativeIntType
Default Value	0

(43) `< jeus-web-dd >< upgrade >< upgrade-executor > <max>`
Description	Maximum number of threads to be managed in a thread pool.
Value Type	nonNegativeIntType
Default Value	30

(44) `< jeus-web-dd >< upgrade >< upgrade-executor > <keep-alive-time>`
Description	Time period during which idle threads exceeding the minimum value remain unused before being automatically removed from the thread pool. If set to 0, thread removal is disabled.
Value Type	nonNegativeLongType
Value Description	Milliseconds
Default Value	60000

(45) `< jeus-web-dd >< upgrade >< upgrade-executor > <queue-size>`
Description	Size of the queue to store tasks processed by the thread pool.
Value Type	nonNegativeIntType
Default Value	4096

(46) `< jeus-web-dd > <websocket>`
Description	Option to use and configure the WebSocket container in a web application. If you do not want to use this option, set it to <websocket/>.
Value Type	webSocketType
Child Elements	(48) `max-incoming-binary-message-buffer-size` (49) `max-incoming-text-message-buffer-size` (50) `max-session-idle-timeout-in-millis` (51) `monitoring-period-in-millis` (52) `blocking-send-timeout-in-millis` (53) `async-send-timeout-in-millis` (54) `websocket-executor` (59) `distributed-userProperties`

(47) `< jeus-web-dd >< websocket > <max-incoming-binary-message-buffer-size>`
Description	Maximum buffer size for a binary message from the client. This value is returned by the jakarta.websocket.WebSocketContainer.getDefaultMaxBinaryMessageBufferSize() method. If the message size is larger than the max size, the WebSocket session is closed, generating the 1009 error. If the message size is 0, the messasge is discarded.
Value Type	nonNegativeIntType
Default Value	8192

(48) `< jeus-web-dd >< websocket > <max-incoming-text-message-buffer-size>`
Description	Maximum buffer size for a text message from the client. This value is returned by the jakarta.websocket.WebSocketContainer.getDefaultMaxTextMessageBufferSize() method. If the message size is larger than the max size, the WebSocket session is closed, generating the 1009 error. If the message size is 0, the messasge is discarded.
Value Type	nonNegativeIntType
Default Value	8192

(49) `< jeus-web-dd >< websocket > <max-session-idle-timeout-in-millis>`
Description	Amount of time to wait before closing an idle WebSocket session. The default value is 30 mimutes just as the time out value for an HTTP session. This value is returned by the jakarta.websocket.WebSocketContainer.getDefaultMaxSessionIdleTimeout() method. Any value between 0 and 1,000 is regarded as 1,000.
Value Type	nonNegativeLongType
Value Description	Milliseconds
Default Value	1800000

(50) `< jeus-web-dd >< websocket > <monitoring-period-in-millis>`
Description	Interval at which to check the WebSocket session timeout. The default value is 5 minutes. Any value smaller than 1,000 is regarded as 1,000.
Value Type	positiveLongType
Value Description	Milliseconds
Default Value	300000

(51) `< jeus-web-dd >< websocket > <blocking-send-timeout-in-millis>`
Description	Amount of time to wait for the response when using Synchronous Send. If a timeout occurs, it will be handled as an IOException error. The default value is 10 seconds.
Value Type	nonNegativeLongType
Value Description	Milliseconds
Default Value	10000

(52) `< jeus-web-dd >< websocket > <async-send-timeout-in-millis>`
Description	Amount of time to wait before terminating pending messages on a server when using Asynchronous Send. This value is returned by the jakarta.websocket.WebSocketContainer.getDefaultAsyncSendTimeout() method.
Value Type	nonNegativeLongType
Value Description	Milliseconds

(53) `< jeus-web-dd >< websocket > <websocket-executor>`
Description	Settings for the thread pool that is used internally by the WebSocket Container. This is used to process SendHandler during asynchronous sending.
Value Type	webSocketExecutorType
Child Elements	(55) `min` (56) `max` (57) `keep-alive-time` (58) `queue-size`

(54) `< jeus-web-dd >< websocket >< websocket-executor > <min>`
Description	Minimum number of threads to be managed by a thread pool.
Value Type	nonNegativeIntType
Default Value	0

(55) `< jeus-web-dd >< websocket >< websocket-executor > <max>`
Description	Maximum number of threads to be managed by a thread pool.
Value Type	nonNegativeIntType
Default Value	30

(56) `< jeus-web-dd >< websocket >< websocket-executor > <keep-alive-time>`
Description	Time period during which idle threads exceeding the minimum value remain unused before being automatically removed from the thread pool. If set to 0, thread removal is disabled.
Value Type	nonNegativeLongType
Value Description	Milliseconds
Default Value	60000

(57) `< jeus-web-dd >< websocket >< websocket-executor > <queue-size>`
Description	Size of the queue to store tasks processed by the thread pool.
Value Type	nonNegativeIntType
Default Value	4096

(58) `< jeus-web-dd >< websocket > <distributed-userProperties>`
Description	Settings related to WebSocket UserProperties Failover that is provided according to the definitions in the jakarta.websocket.Session.getUserProperties() method.
Value Type	distributedWebSocketUserPropertiesType
Child Elements	(60) `enabled` (61) `use-write-through-policy`

(59) `< jeus-web-dd >< websocket >< distributed-userProperties > <enabled>`
Description	Option to use WebSocket Session Failover. By default, this is not used because it requires integration with HTTP sessions.
Value Type	boolean
Default Value	false

(60) `< jeus-web-dd >< websocket >< distributed-userProperties > <use-write-through-policy>`
Description	Option to wait for the synchronization to the backup server to complete when executing put/remove on UserProperties of a WebSocket session. By default, synchronization is performed as a background job instead of waiting for it to complete.
Value Type	boolean
Default Value	false

(61) `< jeus-web-dd > <session-config>`
Description	Sessions to be used in a context.
Value Type	session-configType
Child Elements	(63) `timeout` (64) `max-session-count` (65) `reload-persistent` (66) `tracking-mode` (70) `session-cookie`

(62) `< jeus-web-dd >< session-config > <timeout>`
Description	Expiration period of sessions created by the server. Sessions that have not been accessed for the specified duration are no longer used and are deleted. This has a lower priority than Session Timeout in web.xml, which is configured by the servlet and allows individual configuration. If this option is set to -1, sessions will not be deleted. This is the expiration period of sessions. The unit is in minutes. The default value is 30.
Value Type	int
Default Value	30

(63) `< jeus-web-dd >< session-config > <max-session-count>`
Description	Maximum number of sessions to maintain in memory. If the number of sessions exceeds the maximum number of sessions, an error will occur. Maximum number of sessions to maintain in memory. If not specified, sessions can be created infinitely. The default value is -1 (no limit).
Value Type	int
Default Value	-1

(64) `< jeus-web-dd >< session-config > <reload-persistent>`
Description	Indicates whether to keep attribute objects of sessions when the context is reloaded. If this option is set to true, session attributes will persist regardless of reloading the context. If this option is set to false, all attributes will be deleted when the context is reloaded. If this is true, performance will be lower because sessions will persist. Note that reloading is different from redeployment. The value type is Boolean. The default value is false.
Value Type	boolean
Default Value	false

(65) `< jeus-web-dd >< session-config > <tracking-mode>`
Description	Indicates the session tracking methods for session delivery. You can choose from "Cookie", "Url", and "Ssl", and multiple choices are possible. "Ssl" cannot be selected with others. The default value is "Cookie". Note that if you forcibly disable "Cookie", sessions might not persist.
Value Type	session-tracking-modeType
Child Elements	(67) `cookie` (68) `url` (69) `ssl`

(66) `< jeus-web-dd >< session-config >< tracking-mode > <cookie>`
Description	Indicates whether to deliver sessions with cookies. The value type is Boolean. The default value is true.
Value Type	boolean
Default Value	true

(67) `< jeus-web-dd >< session-config >< tracking-mode > <url>`
Description	Enables URL rewriting to track sessions. This is not generally used, and the default value is false. This option can generate security problems because the sessions are exposed in the URL. The value type is Boolean.
Value Type	boolean
Default Value	false

(68) `< jeus-web-dd >< session-config >< tracking-mode > <ssl>`
Description	Option to enable SSL for session tracking. The value type is Boolean. The default value is false.
Value Type	boolean
Default Value	false

(69) `< jeus-web-dd >< session-config > <session-cookie>`
Description	Detailed configuration of session cookies when cookies are used to deliver sessions.
Value Type	session-cookie-configType
Child Elements	(71) `cookie-name` (72) `url-cookie-name` (73) `version` (74) `domain` (75) `path` (76) `max-age` (77) `secure` (78) `http-only` (79) `same-site` (80) `comment` (81) `partitioned`

(70) `< jeus-web-dd >< session-config >< session-cookie > <cookie-name>`
Description	Name of a cookie that is used to deliver a session. The default value is JSESSIONID, but other values can be specified. The value type is string. This functions as the key value for session cookies.
Value Type	valuableToken
Default Value	JSESSIONID

(71) `< jeus-web-dd >< session-config >< session-cookie > <url-cookie-name>`
Description	Name of a cookie for delivering the session using URL rewriting. The default value is jsessionid, and other values can be specified to deliver session cookies. The value type is string. This functions as the key value for session cookies.
Value Type	valuableToken
Default Value	jsessionid

(72) `< jeus-web-dd >< session-config >< session-cookie > <version>`
Description	Cookie ID version. The possible values are 0 and 1. The default is 0.
Value Type	int
Default Value	0

(73) `< jeus-web-dd >< session-config >< session-cookie > <domain>`
Description	Domain name that the session cookie applies to. The cookie is used for requests to the specified domain. If .foo.com is specified, the session cookie works for requests from both first.foo.com and second.foo.com. A single correctly formatted domain name. It must start with ".". The host name should not be specified (Refer to the RFC-2109 specification).
Value Type	valuableToken

(74) `< jeus-web-dd >< session-config >< session-cookie > <path>`
Description	Path that the session cookie applies to. The session cookie is used for requests to the path. The cookies are sent with requests to the specified URL if the domain is correctly formatted (Refer to <domain> configuration). For example, if the path is "/examples" and the domain is ".foo.com", and the client request is "www.foo.com/examples", the client cookie is sent with the request. A single correctly formatted URL path should be specified.
Value Type	valuableToken

(75) `< jeus-web-dd >< session-config >< session-cookie > <max-age>`
Description	Expiration of the session ID cookie. Session cookies are valid for the specified amount of time. After the specified amount of time, the session cookies become invalid and will no longer be used. The unit is in seconds, and the default value is -1.
Value Type	int
Default Value	-1

(76) `< jeus-web-dd >< session-config >< session-cookie > <secure>`
Description	Secure attribute of the session ID cookies. If this is set to true, session ID cookies will only be sent to secure HTTPS connections. The value type is Boolean. This determines whether the cookie is sent via HTTPS. The default value is false.
Value Type	boolean
Default Value	false

(77) `< jeus-web-dd >< session-config >< session-cookie > <http-only>`
Description	Security method that prevents session ID cookies from being used by scripts instead of by HTTP. The value type is Boolean. This determines whether to use the HttpOnly option for cookies. The default value is true.
Value Type	boolean
Default Value	true

(78) `< jeus-web-dd >< session-config >< session-cookie > <same-site>`
Description	Protection method against attacks that make unintended requests by using the session ID cookie (cross-site request forgery).
Value Type	same-siteType
Value Description	Set either to Lax or Strict if the cookie uses the SameSite option.
Default Value	Disable
Defined Value	None Strict Lax Disable

(79) `< jeus-web-dd >< session-config >< session-cookie > <comment>`
Description	Description of the cookie. This provides the information about the cookie. This option is not supported by cookies of type 0 (Netscape version).
Value Type	valuableToken

(80) `< jeus-web-dd >< session-config >< session-cookie > <partitioned>`
Description	Uses Cookies Having Independent Partitioned State (CHIPS), which allows cookies to be maintained in partitioned storage by using a separate cookie jar for each root site page. Only applicable for secure cookies.
Value Type	boolean
Default Value	false

(81)


                <
                jeus-web-dd
                >
                <encoding>

Value Type webAppEncodingType

Child Elements

(83) request-encoding

(90) response-encoding

(82) `< jeus-web-dd >< encoding > <request-encoding>`
Description	Encoding to apply to an HTTP request. The encoding converts a byte array (query strings, application/x-www-form-urlencoded type content, etc.) that was readfrom a socket to a string object by parsing the byte array.
Value Type	webAppRequestEncodingType
Child Elements	(84) `default` (85) `client-override` (86) `forced` (87) `url-mapping`

(83) `< jeus-web-dd >< encoding >< request-encoding > <default>`
Description	Default value to use when no explicit encoding is specified.
Value Type	valuableToken
Value Description	Standard character encoding value (e.g. UTF-8)

(84) `< jeus-web-dd >< encoding >< request-encoding > <client-override>`
Description	Overrides the charset attribute for the Content-Type header in an HTTP client when no explicit encoding is specified. In JEUS 7 Fix#1, JEUS 6 and earlier versions, this setting serves the same purpose as <forced>.
Value Type	valuableToken

(85) `< jeus-web-dd >< encoding >< request-encoding > <forced>`
Description	Forcefully applies the specified value even when an encoding is already specified. It takes precedence over any other behaviors within the application.
Value Type	valuableToken
Value Description	Standard character encoding value (e.g. UTF-8)

(86) `< jeus-web-dd >< encoding >< request-encoding > <url-mapping>`
Description	Encoding of a request URL. If either <forced> or <client-override> is not configured, this setting will be ignored. If this setting is not configured for a servlet-path, the default configuration will be used. If there is no default value, ISO-8859-1 will be used.
Value Type	requestURLMappingEncodingType
Child Elements	(88) `servlet-path` (89) `encoding`

(87) `< jeus-web-dd >< encoding >< request-encoding >< url-mapping > <servlet-path>`
Description	Servlet path. The value format follows the mapping defined in the servlet specifications.
Value Type	string

(88) `< jeus-web-dd >< encoding >< request-encoding >< url-mapping > <encoding>`
Description	Encoding that applies to the specified servlet path. The specified encoding is used in request parameters.
Value Type	valuableToken

(89) `< jeus-web-dd >< encoding > <response-encoding>`
Description	Setting for "XXX" of "Content-type:text/html; charset=XXX" in the HTTP response header. This is also configured for a JSP page encoding. In a container, this setting is used to convert the string object that was created by a servlet into a byte array, in order to save it in the buffer.
Value Type	encodingSubType
Child Elements	(91) `default` (92) `forced`

(90) `< jeus-web-dd >< encoding >< response-encoding > <default>`
Description	Default encoding.
Value Type	valuableToken
Value Description	Standard character encoding (e.g. UTF-8)

(91) `< jeus-web-dd >< encoding >< response-encoding > <forced>`
Description	Encoding that overrides the default encoding. This has priority over any other operation.
Value Type	valuableToken
Value Description	Standard character encoding (e.g. UTF-8)

(92)


                <
                jeus-web-dd
                >
                <content-encodings>

Value Type contentEncodingsType

Child Elements

(94) compression-min-size

(95) content-encoding

(93) `< jeus-web-dd >< content-encodings > <compression-min-size>`
Description	Minimum size of the response body to be compressed. When the response uses "Transfer-Encoding: chunked", the total body size cannot be determined. As a result, this feature is not applied, and compression is performed or skipped based solely on the content-type and accept-encoding headers of the request. For responses with "Content-Length", compression is skipped if the body size is smaller than the specified compression-min-size. Compression is also disabled if the response size is explicitly set using HttpServletResponse.setContentLength() or HttpServletResponse.setContentLengthLong().
Value Type	nonNegativeIntType

(94) `< jeus-web-dd >< content-encodings > <content-encoding>`
Description	Specifies the MIME type and corresponding compression algorithm. If the same MIME type is defined multiple times, the last specified content-encoding is applied. For cases both "text/" and "text/html" are defined separately, responses with the content type text/plain are compressed based on the configuration for "text/"; and responses with the content type text/html follow the configuration for "text/html". MIME types set to identify are excluded from compression.
Value Type	contentEncodingType
Child Elements	(96) `mime-type` (97) `compression`

(95) `< jeus-web-dd >< content-encodings >< content-encoding > <mime-type>`
Description	MIME type for compression. If the MIME type of the response content matches this setting, the specified encoding for compression will be applied. To include multiple subtypes, use ''. For example, setting "text/" will apply compression to all text-based MIME types.
Value Type	valuableToken

(96) `< jeus-web-dd >< content-encodings >< content-encoding > <compression>`
Description	Compression algorithm for the response body. Currently supported are gzip, deflate, and identity. The algorithm is selected through negotiation, prioritizing the content encoding specified in the request's Accept-Encoding header. If the Accept-Encoding header does not include any of the specified algorithms, or if identity has the highest priority, compression will not be performed.
Value Type	valuableToken

(97) `< jeus-web-dd > <accept-encodings>`
Value Type	acceptEncodingsType
Child Elements	(99) `accept-encoding`

(98) `< jeus-web-dd >< accept-encodings > <accept-encoding>`
Description	Adds the Accept-Encoding header to the response. According to RFC7694, the client compresses the request body based on the compression configurations specified in the response's Accept-Encoding header. The client's implementation determines whether request body compression is applied, so compression may not always occur. Since the safety of the compressed request body cannot be guaranteed without decompression, the Accept-Encoding header is added only when the client is deemed "safe." This determination is based on the <server-access-control> web connection setting being set to true. Up to three compressions can be configured.
Value Type	acceptEncodingType
Child Elements	(100) `compression` (101) `quality`

(99) `< jeus-web-dd >< accept-encodings >< accept-encoding > <compression>`
Description	Compression types to be included in the Accept-Encoding header. Currently, only three types are supported: gzip, deflate, and identity. Other types will be ignored.
Value Type	valuableToken

(100) `< jeus-web-dd >< accept-encodings >< accept-encoding > <quality>`
Description	Compression priority. As specified, a decimal value between 0.0 and 1.0 can be entered, with up to three decimal places. Values outside this range will be ignored. If no priority is specified, the highest priority will be assigned by default, according to the specification.
Value Type	double

(101) `< jeus-web-dd > <cookie-policy>`
Value Type	httpCookiePolicyType
Child Elements	(103) `write-value-on-header-policy`

(102) `< jeus-web-dd >< cookie-policy > <write-value-on-header-policy>`
Description	Indicates whether to apply the URL encoding rule when reading or using the cookies in an HTTP header.
Value Type	write-value-on-header-policyType
Child Elements	(104) `apply-url-encoding-rule` (105) `charset-encoding`

(103) `< jeus-web-dd >< cookie-policy >< write-value-on-header-policy > <apply-url-encoding-rule>`
Description	Indicates whether the URL encoding rule will be applied.
Value Type	boolean

(104) `< jeus-web-dd >< cookie-policy >< write-value-on-header-policy > <charset-encoding>`
Description	Character encoding used when responding to and decoding cookies regardless of whether the URL encoding rule has been configured. If character encoding is not configured, the request and response encoding are used by default.
Value Type	valuableToken

(105) `< jeus-web-dd > <user-log>`
Description	User logs that are created by web applications by the servlet context's log method.
Value Type	web-common-logType
Child Elements	(107) `level` (108) `use-parent-handlers` (109) `filter-class` (110) `formatter-pattern` (111) `handler`

(106) `< jeus-web-dd >< user-log > <level>`
Description	Logging level. For the description of each logging level, refer to "Level Class Documentation" for Java SE Logging API.
Value Type	loggingLevelType
Default Value	INFO
Defined Value	OFF SEVERE WARNING INFO CONFIG FINE FINER FINEST ALL

(107) `< jeus-web-dd >< user-log > <use-parent-handlers>`
Description	Option to indicate whether a logger should use its parent handlers. The default is true. However, for the JEUS logger, which is a root logger, this option must be set to false. This option does not apply to web engine access loggers. If this option is set to false for virtual host's access loggers, access logs for the entire web engine will not contain those by each virtual host.
Value Type	boolean
Default Value	true

(108) `< jeus-web-dd >< user-log > <filter-class>`
Description	Fully qualified name of the filter class to be assigned to a logger. The filter class filters out log messages.
Value Type	valuableToken

(109) `< jeus-web-dd >< user-log > <formatter-pattern>`
Description	Formatting pattern for logs printed by the logger handler. jeus.util.logging.PatternFormatter uses a specified pattern to format log messages. When specifying a formatting pattern, % cannot be used other than as a formatter character. The following 9 formatters are supported: %d, %l, %J, %T, %c, %M, %N, %a, and %m. Refer to "8.3. Logging Configuration" in "JEUS Server Guide" for more information about each formatter.
Value Type	valuableToken
Default Value	[%d{yyyy.MM.dd HH:mm:ss}][%l] [%J-%T] [%M-%N] %m

(110) `< jeus-web-dd >< user-log > <handler>`
Description	Handler for a logger.
Value Type	handlerType
Child Elements	(112) `file-handler` (128) `smtp-handler` (144) `socket-handler` (151) `user-handler`

(111) `< jeus-web-dd >< user-log >< handler > <file-handler>`
Description	Handler that sends logging results to a file.
Value Type	file-handlerType
Child Elements	(113) `name` (114) `level` (115) `encoding` (116) `filter-class` (117) `file-name` (118) `permission` (119) `chown` (120) `enable-rotation` (121) `rotation-count` (122) `rotation-dir` (123) `valid-day` (124) `valid-hour` (125) `valid-size` (126) `buffer-size` (127) `append`

(112) `< jeus-web-dd >< user-log >< handler >< file-handler > <name>`
Description	Name of the handler. The name must be unique for a logger. The name is used to identify the handler when using an administrator tool, such as WebAdmin.
Value Type	valuableToken

(113) `< jeus-web-dd >< user-log >< handler >< file-handler > <level>`
Description	Level of the handler. Log records whose logging level does not meet or exceed that of the handler will be ignored.
Value Type	loggingLevelType
Default Value	FINEST
Defined Value	OFF SEVERE WARNING INFO CONFIG FINE FINER FINEST ALL

(114) `< jeus-web-dd >< user-log >< handler >< file-handler > <encoding>`
Description	Encoding that the handler uses to record log messages.
Value Type	valuableToken

(115) `< jeus-web-dd >< user-log >< handler >< file-handler > <filter-class>`
Description	Fully qualified name of the filter class to be assigned to the handler. Log messages are filtered and displayed based on the filter class. The filter class filters out log messages.
Value Type	valuableToken

(116) `< jeus-web-dd >< user-log >< handler >< file-handler > <file-name>`
Description	Name of the file to be used by the handler. If not configured, it is set to the default value. For information about the default file names, refer to "JEUS Server Guide."
Value Type	token

(117) `< jeus-web-dd >< user-log >< handler >< file-handler > <permission>`
Description	Access permission to the log file. Set to 9 characters that consist of r, w, x, and -. (Note: available only for the Unix family operating systems.)
Value Type	string

(118) `< jeus-web-dd >< user-log >< handler >< file-handler > <chown>`
Description	Owner of a log file to set the owner group of the file. Specify comma(,)-separated owner-group pairs, in order.
Value Type	string

(119) `< jeus-web-dd >< user-log >< handler >< file-handler > <enable-rotation>`
Description	Indicates whether the file will use log file rotation. If not specified, it is set to true by default, and rotation is used when logging to the file.
Value Type	boolean
Value Description	Boolean. The default value is true.
Default Value	true

(120) `< jeus-web-dd >< user-log >< handler >< file-handler > <rotation-count>`
Description	Number of backup files to retain when log file rotation is enabled. If this option is not set while files are rotated by their size, files are archived up to 99999 files. If the files are archived by date or time, they will accumulate without limit.
Value Type	off-intType

(121) `< jeus-web-dd >< user-log >< handler >< file-handler > <rotation-dir>`
Description	Directory where files will be archived when log file rotation is enabled. If the directory is not specified, the log files are stored in the directory for the current log file.
Value Type	string

(122) `< jeus-web-dd >< user-log >< handler >< file-handler > <valid-day>`
Description	Number of days before renewing the file used by the handler. Use this option to renew the file after the specified number of days. Dates are automatically appended to the file names.
Value Type	off-intType
Value Description	Integer. When any of valid-day, valid-hour, or valid-size is not specified, the file will be updated based on the default value.
Default Value	1

(123) `< jeus-web-dd >< user-log >< handler >< file-handler > <valid-hour>`
Description	Number of hours before renewing the file used by the handler. Use this option to renew the file after the specified number of hours. Dates and hours are automatically appended to the file names.
Value Type	off-intType
Value Description	Integer

(124) `< jeus-web-dd >< user-log >< handler >< file-handler > <valid-size>`
Description	Maximum size of the file used by the handler. Use this option to renew a file when its maximum size is exceeded. Indexes are sequentially appended to the file names.
Value Type	off-intType
Value Description	Kilobytes

(125) `< jeus-web-dd >< user-log >< handler >< file-handler > <buffer-size>`
Description	Size of the buffer used when the handler sends output messages to a file.
Value Type	nonNegativeIntType
Value Description	Bytes. The default value is 1,024.
Default Value	1024

(126) `< jeus-web-dd >< user-log >< handler >< file-handler > <append>`
Description	Indicates whether to append lines to the original file used by the handler. If this option is set to false and Enable Rotation is true, log files will be rotated at boot. If Enable Rotation is set to false, a new file will replace the existing file.
Value Type	boolean
Value Description	Boolean. The default value is true.
Default Value	true

(127) `< jeus-web-dd >< user-log >< handler > <smtp-handler>`
Description	Handler that sends logging results to an email address.
Value Type	smtp-handlerType
Child Elements	(129) `name` (130) `level` (131) `encoding` (132) `filter-class` (133) `smtp-host-address` (134) `sender-id` (135) `sender-password` (136) `from-address` (137) `to-address` (138) `property` (141) `cc-address` (142) `bcc-address` (143) `send-for-all-messages`

(128) `< jeus-web-dd >< user-log >< handler >< smtp-handler > <name>`
Description	Name of the handler. The name must be unique for a logger. The name is used to identify the handler when using an administrator tool, such as WebAdmin.
Value Type	valuableToken

(129) `< jeus-web-dd >< user-log >< handler >< smtp-handler > <level>`
Description	Level of the handler. Log records whose logging level does not meet or exceed that of the handler will be ignored.
Value Type	loggingLevelType
Default Value	FINEST
Defined Value	OFF SEVERE WARNING INFO CONFIG FINE FINER FINEST ALL

(130) `< jeus-web-dd >< user-log >< handler >< smtp-handler > <encoding>`
Description	Encoding that the handler uses to record log messages.
Value Type	valuableToken

(131) `< jeus-web-dd >< user-log >< handler >< smtp-handler > <filter-class>`
Description	Fully qualified name of the filter class to be assigned to the handler. Log messages are filtered and displayed based on the filter class. The filter class filters out log messages.
Value Type	valuableToken

(132) `< jeus-web-dd >< user-log >< handler >< smtp-handler > <smtp-host-address>`
Description	Host address of the SMTP server through which an email will be sent.
Value Type	valuableToken

(133) `< jeus-web-dd >< user-log >< handler >< smtp-handler > <sender-id>`
Description	ID of the email sender.
Value Type	valuableToken

(134) `< jeus-web-dd >< user-log >< handler >< smtp-handler > <sender-password>`
Description	Password of the email sender. To encrypt the password, type the password in the format of {algorithm}cipher text.
Value Type	valuableToken

(135) `< jeus-web-dd >< user-log >< handler >< smtp-handler > <from-address>`
Description	Email address of the sender.
Value Type	valuableToken

(136) `< jeus-web-dd >< user-log >< handler >< smtp-handler > <to-address>`
Description	Email address of the recipient.
Value Type	valuableToken

(137) `< jeus-web-dd >< user-log >< handler >< smtp-handler > <property>`
Description	SMTP property to be used for the mail server. If the property is configured in the schema, that value overrides the one configured in this option.
Value Type	propertyType
Child Elements	(139) `key` (140) `value`

(138) `< jeus-web-dd >< user-log >< handler >< smtp-handler >< property > <key>`
Description	Key of a property.
Value Type	valuableToken

(139) `< jeus-web-dd >< user-log >< handler >< smtp-handler >< property > <value>`
Description	Value of a property.
Value Type	valuableToken

(140) `< jeus-web-dd >< user-log >< handler >< smtp-handler > <cc-address>`
Description	Email address of the carbon copy (CC) recipient.
Value Type	valuableToken

(141) `< jeus-web-dd >< user-log >< handler >< smtp-handler > <bcc-address>`
Description	Email address of the blind carbon copy (BCC) recipient.
Value Type	valuableToken

(142) `< jeus-web-dd >< user-log >< handler >< smtp-handler > <send-for-all-messages>`
Description	Indicates whether to send all log messages to an email address. If this option is set to false, only the messages written through the logger's send() method will be sent. That is, only the messages that were intended to be sent to an email address will be sent.
Value Type	boolean
Default Value	false

(143) `< jeus-web-dd >< user-log >< handler > <socket-handler>`
Description	Handler that sends logging results to a specified socket.
Value Type	socket-handlerType
Child Elements	(145) `name` (146) `level` (147) `encoding` (148) `filter-class` (149) `address` (150) `port`

(144) `< jeus-web-dd >< user-log >< handler >< socket-handler > <name>`
Description	Name of the handler. The name must be unique for a logger. The name is used to identify the handler when using an administrator tool, such as WebAdmin.
Value Type	valuableToken

(145) `< jeus-web-dd >< user-log >< handler >< socket-handler > <level>`
Description	Level of the handler. Log records whose logging level does not meet or exceed that of the handler will be ignored.
Value Type	loggingLevelType
Default Value	FINEST
Defined Value	OFF SEVERE WARNING INFO CONFIG FINE FINER FINEST ALL

(146) `< jeus-web-dd >< user-log >< handler >< socket-handler > <encoding>`
Description	Encoding that the handler uses to record log messages.
Value Type	valuableToken

(147) `< jeus-web-dd >< user-log >< handler >< socket-handler > <filter-class>`
Description	Fully qualified name of the filter class to be assigned to the handler. Log messages are filtered and displayed based on the filter class. The filter class filters out log messages.
Value Type	valuableToken

(148) `< jeus-web-dd >< user-log >< handler >< socket-handler > <address>`
Description	IP address that a new handler will send messages to.
Value Type	valuableToken

(149) `< jeus-web-dd >< user-log >< handler >< socket-handler > <port>`
Description	Number of the port that a new handler will send messages to.
Value Type	nonNegativeIntType

(150) `< jeus-web-dd >< user-log >< handler > <user-handler>`
Description	Handler that has been created by the user using the Java SE Logging API.
Value Type	user-handlerType
Child Elements	(152) `name` (153) `level` (154) `encoding` (155) `filter-class` (156) `handler-class` (157) `handler-property` (161) `formatter-pattern` (162) `formatter-property`

(151) `< jeus-web-dd >< user-log >< handler >< user-handler > <name>`
Description	Name of the handler. The name must be unique for a logger. The name is used to identify the handler when using an administrator tool, such as WebAdmin.
Value Type	valuableToken

(152) `< jeus-web-dd >< user-log >< handler >< user-handler > <level>`
Description	Level of the handler. Log records whose logging level does not meet or exceed that of the handler will be ignored.
Value Type	loggingLevelType
Default Value	FINEST
Defined Value	OFF SEVERE WARNING INFO CONFIG FINE FINER FINEST ALL

(153) `< jeus-web-dd >< user-log >< handler >< user-handler > <encoding>`
Description	Encoding that the handler uses to record log messages.
Value Type	valuableToken

(154) `< jeus-web-dd >< user-log >< handler >< user-handler > <filter-class>`
Description	Fully qualified name of the filter class to be assigned to the handler. Log messages are filtered and displayed based on the filter class. The filter class filters out log messages.
Value Type	valuableToken

(155) `< jeus-web-dd >< user-log >< handler >< user-handler > <handler-class>`
Description	Fully qualified class name of the user-created handler. The class must inherit 'java.util.logging.Handler' and implement 'jeus.util.logging.JeusHandler'.
Value Type	valuableToken

(156) `< jeus-web-dd >< user-log >< handler >< user-handler > <handler-property>`
Description	Properties that the handler will have. These properties are stored in a map object as key-value pairs and sent to the handler through the JeusHandler.setProperty() method.
Value Type	handlerPropertySetType
Child Elements	(158) `property`

(157) `< jeus-web-dd >< user-log >< handler >< user-handler >< handler-property > <property>`
Description	Properties for the handler.
Value Type	propertyType
Child Elements	(159) `key` (160) `value`

(158) `< jeus-web-dd >< user-log >< handler >< user-handler >< handler-property >< property > <key>`
Description	Key of a property.
Value Type	valuableToken

(159) `< jeus-web-dd >< user-log >< handler >< user-handler >< handler-property >< property > <value>`
Description	Value of a property.
Value Type	valuableToken

(160) `< jeus-web-dd >< user-log >< handler >< user-handler > <formatter-pattern>`
Description	Formatting pattern for logs printed by the logger handler. jeus.util.logging.PatternFormatter uses a specified pattern to format log messages.
Value Type	valuableToken
Default Value	[%d{yyyy.MM.dd HH:mm:ss}][%l] [%J-%T] [%M-%N] %m

(161) `< jeus-web-dd >< user-log >< handler >< user-handler > <formatter-property>`
Description	Properties for the formatter that the handler will use. These properties are stored in a map object as key-value pairs and sent to the formatter through the JeusFormatter.setProperty() method.
Value Type	handlerPropertySetType
Child Elements	(163) `property`

(162) `< jeus-web-dd >< user-log >< handler >< user-handler >< formatter-property > <property>`
Description	Properties for the handler.
Value Type	propertyType
Child Elements	(164) `key` (165) `value`

(163) `< jeus-web-dd >< user-log >< handler >< user-handler >< formatter-property >< property > <key>`
Description	Key of a property.
Value Type	valuableToken

(164) `< jeus-web-dd >< user-log >< handler >< user-handler >< formatter-property >< property > <value>`
Description	Value of a property.
Value Type	valuableToken

(165) `< jeus-web-dd > <allow-indexing>`
Description	Displays the URLs in a path as a directory list when a client sends a request. The directory list is displayed when a directory is requested, which is called indexing. Indexing is provided if the following three conditions are satisfied: 1. The request does not include a file name or resource name in the URL path. 2. A default welcome file is not specified in the Descriptor file for web.xml for the web application. 3. The requested directory allows indexing (the directory displays all sub items).
Value Type	allow-indexingType
Child Elements	(167) `directory`

(166) `< jeus-web-dd >< allow-indexing > <directory>`
Description	URL path that allows directory indexing.
Value Type	token
Value Description	URL path must start and end with "/".

(167) `< jeus-web-dd > <deny-download>`
Description	Files that are not allowed to be downloaded. For example, if the file secret.dat is located in the path /customers/data in the domain www.foo.com, and the client requests "URL www.foo.com/customers/data/secret.dat", the secret.dat file will be downloaded. To prevent a file from being downloaded, specify it in this option and it will not be downloaded. An HTTP 404 error will be sent as a response to a download attempt.
Value Type	deny-downloadType
Child Elements	(169) `file` (170) `directory` (171) `extension`

(168) `< jeus-web-dd >< deny-download > <file>`
Description	File that is not allowed to be downloaded. This configuration uses exact matching. The file location must be described exactly as it exists in the context. It must start with "/".
Value Type	token
Value Description	URL context path, including the file name.

(169) `< jeus-web-dd >< deny-download > <directory>`
Description	Prevents all files in the specified directory from being downloaded. This configuration uses exact matching. The directory location must be described exactly as it exists in the context.
Value Type	token
Value Description	Starts and ends with "/". The directory must be relative to the context URL.

(170) `< jeus-web-dd >< deny-download > <extension>`
Description	Prevents files with the specified extension from being downloaded.
Value Type	token
Value Description	File extension that is not allowed to be downloaded.

(171) `< jeus-web-dd > <aliasing>`
Description	Maps a part of the URL path of a request to an external application path.
Value Type	aliasingType
Child Elements	(173) `alias`

(172) `< jeus-web-dd >< aliasing > <alias>`
Description	Provides additional path mapping for resources that the requested URL points to. For example, if the URL "http://www.foo.com/examples/images/hello.gif" is requested and the file "hello.gif" is located under the directory "/home/images/web", set "alias-name" to "/images/" and "alias-path" to "/home/images/web".
Value Type	aliasType
Child Elements	(174) `alias-name` (175) `real-path`

(173) `< jeus-web-dd >< aliasing >< alias > <alias-name>`
Description	Information about the URL path.
Value Type	token
Value Description	The directory name must start and end with "/".

(174) `< jeus-web-dd >< aliasing >< alias > <real-path>`
Description	Actual directory that is mapped to the URL path.
Value Type	token
Value Description	The directory path must end with the OS file delimiter (directory absolute path).

(175) `< jeus-web-dd > <file-caching>`
Description	Configures the cache for static resources including image files and HTML files. It is recommended that this function is not used. Use WebtoB cache instead.
Value Type	file-cachingType
Child Elements	(177) `max-idle-time` (178) `max-cache-memory` (179) `directory`

(176) `< jeus-web-dd >< file-caching > <max-idle-time>`
Description	Deletes static resources from the cache that have not been used for the specified amount of time.
Value Type	int
Value Description	Milliseconds
Default Value	-1

(177) `< jeus-web-dd >< file-caching > <max-cache-memory>`
Description	Maximum amount of memory for storing static resources.
Value Type	int
Value Description	Megabytes
Default Value	-1

(178) `< jeus-web-dd >< file-caching > <directory>`
Description	Directory in which to cache static contents. You can specify multiple cache directories.
Value Type	token
Value Description	Path to the URL directory where contents will be cached.

(179) `< jeus-web-dd > <added-classpath>`
Description	List of libraries that are referenced when a servlet program is compiled or executed. Directories can be used. Classes and packages in the directory "\WEB-INF\classes" and JAR files in "\WEB-INF\lib are included by default. The directory "\WEB-INF\" is located under the Document Base directory of the context.
Value Type	added-classpathType
Child Elements	(181) `class-path`

(180) `< jeus-web-dd >< added-classpath > <class-path>`
Description	Path to user-defined classes. This path is created when a servlet is compiled and executed.
Value Type	token
Value Description	Directory or a JAR file can be specified. When a directory is specified, the value should start with the directory delimiter. ("\" for Windows, "/" for UNIX).

(181) `< jeus-web-dd > <thread-pool>`
Description	Thread pool to handle requests for the current context.
Value Type	context-thread-poolType
Child Elements	(183) `base` (197) `service-group`

(182) `< jeus-web-dd >< thread-pool > <base>`
Description	Base thread pool to handle requests that are not mapped to the URI of any service group.
Value Type	base-thread-poolType
Child Elements	(184) `name` (185) `min` (186) `max` (187) `max-idle-time` (188) `max-queue` (189) `thread-state-notify`

(183) `< jeus-web-dd >< thread-pool >< base > <name>`
Description	Unique name as the identifier of the base thread pool.
Value Type	valuableToken
Default Value	Base

(184) `< jeus-web-dd >< thread-pool >< base > <min>`
Description	Minimum number of worker threads to be maintained in the pool.
Value Type	positiveIntType
Value Description	Thread count

(185) `< jeus-web-dd >< thread-pool >< base > <max>`
Description	Maximum number of worker threads to be maintained in the pool.
Value Type	positiveIntType
Value Description	Thread count

(186) `< jeus-web-dd >< thread-pool >< base > <max-idle-time>`
Description	Maximum amount of time during which worker threads remain idle before being removed from the pool. This value applies to excess threads that are generated over the <min> value.
Value Type	long
Value Description	Milliseconds
Default Value	300000

(187) `< jeus-web-dd >< thread-pool >< base > <max-queue>`
Description	Maximum number of requests to be queued. This setting is not used in the Tmax and WebtoB connectors. The queue size for the WebtoB connector is configured with the MaxQCount value in the WebtoB configuration file.
Value Type	int
Default Value	-1

(188) `< jeus-web-dd >< thread-pool >< base > <thread-state-notify>`
Description	Worker threads to be blocked, with the number of threads to be notified when blocked.
Value Type	context-thread-state-notifyType
Child Elements	(190) `max-thread-active-time` (191) `interrupt-thread` (192) `active-timeout-notification` (193) `notify-threshold-ratio` (194) `notify-subject` (195) `restart-threshold-ratio` (196) `restart-subject`

(189) `< jeus-web-dd >< thread-pool >< base >< thread-state-notify > <max-thread-active-time>`
Description	Duration threshold for a thread to be considered as blocked. For the check cycle, use <monitoring><check-thread-pool>. Basically, threads in a blocked state are discarded and new threads are created to fill the thread pool. However, for those thread pools in webtob-connector and tmax-connector, simply the blocked state is indicated without any actions taken.
Value Type	long
Value Description	Milliseconds. If the value is smaller than or equal to 0, it is ignored.
Default Value	0

(190) `< jeus-web-dd >< thread-pool >< base >< thread-state-notify > <interrupt-thread>`
Description	Option to interrupt when threads are blocked. Note that this only gives a hint for the thread to cancel the current operation without any direct action. If the thread itself does not check for interrupt, this option has no effect.
Value Type	boolean
Default Value	false

(191) `< jeus-web-dd >< thread-pool >< base >< thread-state-notify > <active-timeout-notification>`
Description	Option to send an email to notify of blocked threads.
Value Type	boolean
Default Value	false

(192) `< jeus-web-dd >< thread-pool >< base >< thread-state-notify > <notify-threshold-ratio>`
Description	Ratio of blocked threads to the maximum threshold of the thread pool. If the number of blocked threads exceeds the specified value, an email notification will be sent.
Value Type	double
Value Description	If the value is smaller than or equal to 0, it will be ignored.
Default Value	0.0

(193) `< jeus-web-dd >< thread-pool >< base >< thread-state-notify > <notify-subject>`
Description	Title of the email notification to be sent by the notify-threshold-ratio setting.
Value Type	token
Value Description	Must be concise and clear for the receiver (admin) to recognize the message immediately.

(194) `< jeus-web-dd >< thread-pool >< base >< thread-state-notify > <restart-threshold-ratio>`
Description	Ratio of the blocked threads to recommend restarting of the web engine. Set the value to a decimal point that is smaller than 1. When the number of blocked threads exceeds this threshold, a message that recommends restarting of the server will be printed.
Value Type	double
Value Description	Ratio of blocked threads to the total number of worker threads. If the value is smaller than or equal to 0, it will be ignored.
Default Value	0.0

(195) `< jeus-web-dd >< thread-pool >< base >< thread-state-notify > <restart-subject>`
Description	Title of the email notification to be sent by the restart-threshold-ratio setting.
Value Type	token
Value Description	Must be concise and clear for the receiver (admin) to recognize the message immediately.

(196) `< jeus-web-dd >< thread-pool > <service-group>`
Description	Thread pool to handle services that are mapped to the URI.
Value Type	service-group-thread-poolType
Child Elements	(198) `name` (199) `uri` (200) `min` (201) `max` (202) `max-idle-time` (203) `max-queue` (204) `thread-state-notify`

(197) `< jeus-web-dd >< thread-pool >< service-group > <name>`
Description	Unique name as the identifier of the thread pool for the service group.
Value Type	valuableToken

(198) `< jeus-web-dd >< thread-pool >< service-group > <uri>`
Description	URIs to be handled in the thread pool for the service group. Multiple URIs are separated by commas(','). Each URI starts with a dash ('/'). All requests that are mapped to URIs after the context-path will be processed by the thread pool for the service group.
Value Type	valuableToken
Value Description	Service name

(199) `< jeus-web-dd >< thread-pool >< service-group > <min>`
Description	Minimum number of worker threads to be maintained in the pool.
Value Type	positiveIntType
Value Description	Thread count

(200) `< jeus-web-dd >< thread-pool >< service-group > <max>`
Description	Maximum number of worker threads to be maintained in the pool.
Value Type	positiveIntType
Value Description	Thread count

(201) `< jeus-web-dd >< thread-pool >< service-group > <max-idle-time>`
Description	Maximum amount of time during which worker threads remain idle before being removed from the pool. This value applies to excess threads that are generated over the <min> value.
Value Type	long
Value Description	Milliseconds
Default Value	300000

(202) `< jeus-web-dd >< thread-pool >< service-group > <max-queue>`
Description	Maximum number of requests to be queued. This setting is not used in the Tmax and WebtoB connectors. The queue size for the WebtoB connector is configured with the MaxQCount value in the WebtoB configuration file.
Value Type	int
Default Value	-1

(203) `< jeus-web-dd >< thread-pool >< service-group > <thread-state-notify>`
Description	Worker threads to be blocked, with the number of threads to be notified when blocked.
Value Type	context-thread-state-notifyType
Child Elements	(205) `max-thread-active-time` (206) `interrupt-thread` (207) `active-timeout-notification` (208) `notify-threshold-ratio` (209) `notify-subject` (210) `restart-threshold-ratio` (211) `restart-subject`

(204) `< jeus-web-dd >< thread-pool >< service-group >< thread-state-notify > <max-thread-active-time>`
Description	Duration threshold for a thread to be considered as blocked. For the check cycle, use <monitoring><check-thread-pool>. Basically, threads in a blocked state are discarded and new threads are created to fill the thread pool. However, for those thread pools in webtob-connector and tmax-connector, simply the blocked state is indicated without any actions taken.
Value Type	long
Value Description	Milliseconds. If the value is smaller than or equal to 0, it is ignored.
Default Value	0

(205) `< jeus-web-dd >< thread-pool >< service-group >< thread-state-notify > <interrupt-thread>`
Description	Option to interrupt when threads are blocked. Note that this only gives a hint for the thread to cancel the current operation without any direct action. If the thread itself does not check for interrupt, this option has no effect.
Value Type	boolean
Default Value	false

(206) `< jeus-web-dd >< thread-pool >< service-group >< thread-state-notify > <active-timeout-notification>`
Description	Option to send an email to notify of blocked threads.
Value Type	boolean
Default Value	false

(207) `< jeus-web-dd >< thread-pool >< service-group >< thread-state-notify > <notify-threshold-ratio>`
Description	Ratio of blocked threads to the maximum threshold of the thread pool. If the number of blocked threads exceeds the specified value, an email notification will be sent.
Value Type	double
Value Description	If the value is smaller than or equal to 0, it will be ignored.
Default Value	0.0

(208) `< jeus-web-dd >< thread-pool >< service-group >< thread-state-notify > <notify-subject>`
Description	Title of the email notification to be sent by the notify-threshold-ratio setting.
Value Type	token
Value Description	Must be concise and clear for the receiver (admin) to recognize the message immediately.

(209) `< jeus-web-dd >< thread-pool >< service-group >< thread-state-notify > <restart-threshold-ratio>`
Description	Ratio of the blocked threads to recommend restarting of the web engine. Set the value to a decimal point that is smaller than 1. When the number of blocked threads exceeds this threshold, a message that recommends restarting of the server will be printed.
Value Type	double
Value Description	Ratio of blocked threads to the total number of worker threads. If the value is smaller than or equal to 0, it will be ignored.
Default Value	0.0

(210) `< jeus-web-dd >< thread-pool >< service-group >< thread-state-notify > <restart-subject>`
Description	Title of the email notification to be sent by the restart-threshold-ratio setting.
Value Type	token
Value Description	Must be concise and clear for the receiver (admin) to recognize the message immediately.

(211) `< jeus-web-dd > <env>`
Description	Overrides the env-entry properties defined in the standard DD.
Value Type	envType
Child Elements	(213) `name` (214) `value` (215) `type`

(212) `< jeus-web-dd >< env > <name>`
Description	Name of an environment variable.
Value Type	valuableToken

(213) `< jeus-web-dd >< env > <value>`
Description	Parameter value of the wrapper class generator that corresponds to the environment variable.
Value Type	valuableToken

(214) `< jeus-web-dd >< env > <type>`
Description	Java data type of the environment variable.
Value Type	valuableToken
Value Description	Choose one from java.lang.Boolean, java.lang.String, java.lang.Integer, java.lang.Double, java.lang.Byte, java.lang.Short, java.lang.Long, java.lang.Float, java.lang.Character.

(215) `< jeus-web-dd > <ejb-ref>`
Description	Binds an EJB reference to an actual EJB JNDI name.
Value Type	jndi-refType
Child Elements	(217) `jndi-info`

(216) `< jeus-web-dd >< ejb-ref > <jndi-info>`
Description	Maps the logical name of an environment entry to an actual JNDI name. For example, an environment entry named "jdbc/myDataSource" is mapped to "DataSource1", which is an actual JNDI name.
Value Type	jndi-infoType
Child Elements	(218) `ref-name` (219) `export-name`

(217) `< jeus-web-dd >< ejb-ref >< jndi-info > <ref-name>`
Description	Name of a reference.
Value Type	valuableToken
Value Description	The reference name will be bound to an actual JNDI name. The reference name corresponds to that of the J2EE standard descriptor.

(218) `< jeus-web-dd >< ejb-ref >< jndi-info > <export-name>`
Description	Actual JNDI name defined in the JEUS DD.
Value Type	token

(219) `< jeus-web-dd > <res-ref>`
Description	Use this to declare reference name for an external resource such as a database.
Value Type	jndi-refType
Child Elements	(221) `jndi-info`

(220) `< jeus-web-dd >< res-ref > <jndi-info>`
Description	Maps the logical name of an environment entry to an actual JNDI name. For example, an environment entry named "jdbc/myDataSource" is mapped to "DataSource1", which is an actual JNDI name.
Value Type	jndi-infoType
Child Elements	(222) `ref-name` (223) `export-name`

(221) `< jeus-web-dd >< res-ref >< jndi-info > <ref-name>`
Description	Name of a reference.
Value Type	valuableToken
Value Description	The reference name will be bound to an actual JNDI name. The reference name corresponds to that of the J2EE standard descriptor.

(222) `< jeus-web-dd >< res-ref >< jndi-info > <export-name>`
Description	Actual JNDI name defined in the JEUS DD.
Value Type	token

(223) `< jeus-web-dd > <res-env-ref>`
Description	Binds a reference to an external resource with an actual JNDI name. This element corresponds to <resource-env-ref> of the standard EJB DD.
Value Type	jndi-refType
Child Elements	(225) `jndi-info`

(224) `< jeus-web-dd >< res-env-ref > <jndi-info>`
Description	Maps the logical name of an environment entry to an actual JNDI name. For example, an environment entry named "jdbc/myDataSource" is mapped to "DataSource1", which is an actual JNDI name.
Value Type	jndi-infoType
Child Elements	(226) `ref-name` (227) `export-name`

(225) `< jeus-web-dd >< res-env-ref >< jndi-info > <ref-name>`
Description	Name of a reference.
Value Type	valuableToken
Value Description	The reference name will be bound to an actual JNDI name. The reference name corresponds to that of the J2EE standard descriptor.

(226) `< jeus-web-dd >< res-env-ref >< jndi-info > <export-name>`
Description	Actual JNDI name defined in the JEUS DD.
Value Type	token

(227) `< jeus-web-dd > <message-destination-ref>`
Description	Reference name for an external resource to be mapped to an actual JNDI name. This element corresponds to <message-destination-ref> of the standard DD.
Value Type	jndi-refType
Child Elements	(229) `jndi-info`

(228) `< jeus-web-dd >< message-destination-ref > <jndi-info>`
Description	Maps the logical name of an environment entry to an actual JNDI name. For example, an environment entry named "jdbc/myDataSource" is mapped to "DataSource1", which is an actual JNDI name.
Value Type	jndi-infoType
Child Elements	(230) `ref-name` (231) `export-name`

(229) `< jeus-web-dd >< message-destination-ref >< jndi-info > <ref-name>`
Description	Name of a reference.
Value Type	valuableToken
Value Description	The reference name will be bound to an actual JNDI name. The reference name corresponds to that of the J2EE standard descriptor.

(230) `< jeus-web-dd >< message-destination-ref >< jndi-info > <export-name>`
Description	Actual JNDI name defined in the JEUS DD.
Value Type	token

(231) `< jeus-web-dd > <service-ref>`
Description	Root element of a JEUS Web service client configuration documentation.
Value Type	jeus-webservices-client-ddType
Child Elements	(233) `service-client`

(232) `< jeus-web-dd >< service-ref > <service-client>`
Description	Settings for web service clients that will be deployed.
Value Type	serviceClientType
Child Elements	(234) `service-ref-name` (235) `port-info` (302) `service-impl-class` (303) `wsdl-override` (304) `require-dynamic-proxy` (305) `service-qname` (306) `call-property`

(233) `< jeus-web-dd >< service-ref >< service-client > <service-ref-name>`
Description	Name of a relevant web service endpoint in the WSDL file. This corresponds to the deployment descriptor file web.xml or <service-ref-name> in ejb-jar.xml.
Value Type	token

(234) `< jeus-web-dd >< service-ref >< service-client > <port-info>`
Description	Web service port information that is used by deployed web service clients.
Value Type	portInfoType
Child Elements	(236) `service-endpoint-interface` (237) `wsdl-port` (238) `stub-property` (241) `call-property` (244) `security`

(235) `< jeus-web-dd >< service-ref >< service-client >< port-info > <service-endpoint-interface>`
Description	Class that implements the ServiceEndpoint interface for the WSDL port. This corresponds to <service-endpoint-interface> of <port-component-ref> in <service-ref>.
Value Type	token

(236) `< jeus-web-dd >< service-ref >< service-client >< port-info > <wsdl-port>`
Description	WSDL port information for <port-info>.
Value Type	QName

(237) `< jeus-web-dd >< service-ref >< service-client >< port-info > <stub-property>`
Description	Properties that apply to the javax.xml.rpc.Stub object that is used in a certain port.
Value Type	nameValueType
Child Elements	(239) `name` (240) `value`

(238) `< jeus-web-dd >< service-ref >< service-client >< port-info >< stub-property > <name>`
Description	Key name that is used to configure properties for javax.xml.rpc.Stub or javax.xml.rpc.Call.
Value Type	string

(239) `< jeus-web-dd >< service-ref >< service-client >< port-info >< stub-property > <value>`
Description	Key value that is used to configure properties for javax.xml.rpc.Stub or javax.xml.rpc.Call.
Value Type	string

(240) `< jeus-web-dd >< service-ref >< service-client >< port-info > <call-property>`
Description	Properties that apply to the javax.xml.rpc.Call object that is used in a certain port.
Value Type	nameValueType
Child Elements	(242) `name` (243) `value`

(241) `< jeus-web-dd >< service-ref >< service-client >< port-info >< call-property > <name>`
Description	Key name that is used to configure properties for javax.xml.rpc.Stub or javax.xml.rpc.Call.
Value Type	string

(242) `< jeus-web-dd >< service-ref >< service-client >< port-info >< call-property > <value>`
Description	Key value that is used to configure properties for javax.xml.rpc.Stub or javax.xml.rpc.Call.
Value Type	string

(243) `< jeus-web-dd >< service-ref >< service-client >< port-info > <security>`
Description	Web service clients for Web service security (WS-Security).
Value Type	webservice-securityType
Child Elements	(245) `request-sender` (283) `response-receiver`

(244) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security > <request-sender>`
Description	Setting to secure a message that calls a Web service.
Value Type	security-senderType
Child Elements	(246) `action-list` (247) `password-callback-class` (248) `user` (249) `timeStamp` (254) `userNameToken` (258) `signature-infos` (269) `encryption-infos`

(245) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender > <action-list>`
Description	String value that indicates security settings. Timestamp, Encrypt, Signature, and UsernameToken can be used. Separate each element with a space.
Value Type	string

(246) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender > <password-callback-class>`
Description	Full package name of the callback class that sets passwords.
Value Type	string

(247) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender > <user>`
Description	User name, which is used for UsernameToken and as an alias for the signing key.
Value Type	string

(248) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender > <timeStamp>`
Description	TTL (time-to-live) aberration for timestamps.
Value Type	timeStampType
Child Elements	(250) `timeToLive` (251) `aberration` (252) `requireSignature` (253) `precision`

(249) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< timeStamp > <timeToLive>`
Description	Expiry time of sent messages in seconds.
Value Type	positiveInteger

(250) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< timeStamp > <aberration>`
Description	Difference from UTC in seconds. The default value is 0 seconds.
Value Type	integer

(251) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< timeStamp > <requireSignature>`
Description	Indicates whether to sign the timestamp. The default value is true.
Value Type	boolean

(252) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< timeStamp > <precision>`
Description	Extra time that is allowed for network and processing delays.
Value Type	positiveInteger

(253) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender > <userNameToken>`
Description	UsernameToken.
Value Type	userNameTokenSenderType
Child Elements	(255) `password` (256) `passwordType` (257) `userTokenElements`

(254) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< userNameToken > <password>`
Description	Password. To store it in an encrypted form, use the format {algorithm}ciphertext. For example, {DES}FQrLbQ/D8O1lDVS71L28rw==
Value Type	string

(255) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< userNameToken > <passwordType>`
Description	Password type for UsernameToken. PasswordDigest or PasswordText can be used.
Value Type	passwordTypeType
Defined Value	PasswordDigest PasswordText

(256) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< userNameToken > <userTokenElements>`
Description	UList of elements that is added to UsernameToken. Separate each element with a blank space. nonce or created can be used. Use this option if passwordType is PasswordDigest.
Value Type	string

(257) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender > <signature-infos>`
Description	Setting for signing messages.
Value Type	signature-infosType
Child Elements	(259) `signature-info`

(258) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos > <signature-info>`
Description	Setting for signing messages. Multiple configurations are possible.
Value Type	signature-infoType
Child Elements	(260) `signatureParts` (261) `signatureAlgorithm` (262) `messageDigestAlogrithm` (263) `canonicalization` (264) `keyIdentifier` (265) `keystore`

(259) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos >< signature-info > <signatureParts>`
Description	Setting for signing specific parts of messages. The value can take the format "{}{http://schemas.xmlsoap.org/soap/envelope/}Body; Token". The entire SOAP body is signed by default.
Value Type	string

(260) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos >< signature-info > <signatureAlgorithm>`
Description	Signing algorithm. SHA1withRSA, SHA1WithDSA, and HMACSHA1 can be used.
Value Type	signatureAlgorithmType
Defined Value	http://www.w3.org/2000/09/xmldsig#dsa-sha1 http://www.w3.org/2000/09/xmldsig#rsa-sha1 http://www.w3.org/2000/09/xmldsig#hmac-sha1

(261) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos >< signature-info > <messageDigestAlogrithm>`
Description	Algorithm for message digests. Uses SHA1.
Value Type	messageDigestAlgorithmType
Defined Value	http://www.w3.org/2000/09/xmldsig#sha1

(262) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos >< signature-info > <canonicalization>`
Description	Canonicalization type. Exclusive XML Canonicalization omit comments, Exclusive XML Canonicalization with comments, Inclusive XML Canonicalization omit comments, and Inclusive XML Canonicalization with comments can be used.
Value Type	canonicalizationType
Defined Value	http://www.w3.org/2001/10/xml-exc-c14n# http://www.w3.org/2001/10/xml-exc-c14n#WithComments http://www.w3.org/TR/2001/REC-xml-c14n-20010315 http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments

(263) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos >< signature-info > <keyIdentifier>`
Description	Information expression type of the signature key. IssuerSerial, DirectReference, SKIKeyIdentifier, and X509KeyIdentifier can be used.
Value Type	sigKeyIdentifierType
Defined Value	IssuerSerial DirectReference SKIKeyIdentifier X509KeyIdentifier

(264) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos >< signature-info > <keystore>`
Description	Keystore for private keys that are used to sign messages.
Value Type	keystoreType
Child Elements	(266) `key-type` (267) `keystore-password` (268) `keystore-filename`

(265) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos >< signature-info >< keystore > <key-type>`
Description	Key type of key that is stored in the keystore. JKS or pkcs12 can be used.
Value Type	string

(266) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos >< signature-info >< keystore > <keystore-password>`
Description	Password to access the keystore. To store the password in an encrypted form, use the format {algorithm}ciphertext. For example, {DES}FQrLbQ/D8O1lDVS71L28rw==
Value Type	string

(267) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos >< signature-info >< keystore > <keystore-filename>`
Description	File name of the keystore. If the file exists in the same directory as the class, enter the file name. If the file exists in a different directory, enter the file name with its absolute path. <!-- 원본 메시지 "파일 이름만 입력할 경우, 클래스 경로에서 찾게 되므로 --> <!-- 파일 이름이나 절대 경로를 포함하는 파일 이름을 입력한다." 가 모호하여 연구소에 문의. 임시로 절대 경로를 포함하는 값을 지칭한다는 내용으로 번역. -->
Value Type	string

(268) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender > <encryption-infos>`
Description	Setting for encrypting messages.
Value Type	encryption-infosType
Child Elements	(270) `encryption-info`

(269) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos > <encryption-info>`
Description	Setting for encrypting messages.
Value Type	encryption-infoType
Child Elements	(271) `encryptionParts` (272) `keyTransportAlogrithm` (273) `encryptionAlgorithm` (274) `encryptionUser` (275) `keyIdentifier` (276) `keystore` (280) `embeddedKey`

(270) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <encryptionParts>`
Description	Setting for encrypting a specific part of a message. The format is "{mode}{ns}{localname};{mode}{ns}{localname};…". The default mode value is "content".
Value Type	string

(271) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <keyTransportAlogrithm>`
Description	Algorithm for message digests. Use one of the RSA 1.5 algorithms.
Value Type	keyTransportAlogrithmType
Defined Value	http://www.w3.org/2001/04/xmlenc#rsa-1

(272) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <encryptionAlgorithm>`
Description	Encryption algorithm. AES_128, AES_256, TRIPLE_DES, and AES_192 can be used.
Value Type	encryptionAlgorithmType
Defined Value	http://www.w3.org/2001/04/xmlenc#tripledes-cbc http://www.w3.org/2001/04/xmlenc#aes128-cbc http://www.w3.org/2001/04/xmlenc#aes192-cbc http://www.w3.org/2001/04/xmlenc#aes256-cbc http://www.tmaxsoft.com/xml/algorithms/xmlenc#seed-cbc

(273) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <encryptionUser>`
Description	Alias for the encryption key.
Value Type	string

(274) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <keyIdentifier>`
Description	Information expression type of the encryption key. IssuerSerial, DirectReference, SKIKeyIdentifier, X509KeyIdentifier, and EmbeddedKeyName can be used.
Value Type	encKeyIdentifierType
Defined Value	IssuerSerial DirectReference SKIKeyIdentifier X509KeyIdentifier EmbeddedKeyName

(275) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <keystore>`
Description	Keystore for encryption keys.
Value Type	keystoreType
Child Elements	(277) `key-type` (278) `keystore-password` (279) `keystore-filename`

(276) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info >< keystore > <key-type>`
Description	Key type of key that is stored in the keystore. JKS or pkcs12 can be used.
Value Type	string

(277) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info >< keystore > <keystore-password>`
Description	Password to access the keystore. To store the password in an encrypted form, use the format {algorithm}ciphertext. For example, {DES}FQrLbQ/D8O1lDVS71L28rw==
Value Type	string

(278) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info >< keystore > <keystore-filename>`
Description	File name of the keystore. If the file exists in the same directory as the class, enter the file name. If the file exists in a different directory, enter the file name with its absolute path. <!-- 원본 메시지 "파일 이름만 입력할 경우, 클래스 경로에서 찾게 되므로 --> <!-- 파일 이름이나 절대 경로를 포함하는 파일 이름을 입력한다." 가 모호하여 연구소에 문의. 임시로 절대 경로를 포함하는 값을 지칭한다는 내용으로 번역. -->
Value Type	string

(279) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <embeddedKey>`
Description	Key that is shared between the web service and its clients. This can be set when keyIdentifier is set to EmbeddedKeyName.
Value Type	embeddedKeyType
Child Elements	(281) `embeddedKeyCallbackClass` (282) `key-name`

(280) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info >< embeddedKey > <embeddedKeyCallbackClass>`
Description	Callback class that has the session key's byte information used to access the key.
Value Type	string

(281) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info >< embeddedKey > <key-name>`
Description	Name of the session key.
Value Type	string

(282) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security > <response-receiver>`
Description	Setting to specify a response to a secured message from a Web service.
Value Type	security-receiverType
Child Elements	(284) `action-list` (285) `observeActionOrder` (286) `password-callback-class` (287) `timeStamp` (292) `decryption` (297) `signature-verification`

(283) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver > <action-list>`
Description	Security settings for received messages. Timestamp, Encrypt, Signature, and UsernameToken can be used. Separate each item with a space.
Value Type	string

(284) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver > <observeActionOrder>`
Description	Indicates whether the Action List order of the sender and the Action List order of the receiver should match.
Value Type	boolean
Default Value	true

(285) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver > <password-callback-class>`
Description	Password callback class name. Type the entire package name.
Value Type	string

(286) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver > <timeStamp>`
Description	TTL (time-to-live) aberration for timestamps.
Value Type	timeStampType
Child Elements	(288) `timeToLive` (289) `aberration` (290) `requireSignature` (291) `precision`

(287) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< timeStamp > <timeToLive>`
Description	Expiry time of sent messages in seconds.
Value Type	positiveInteger

(288) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< timeStamp > <aberration>`
Description	Difference from UTC in seconds. The default value is 0 seconds.
Value Type	integer

(289) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< timeStamp > <requireSignature>`
Description	Indicates whether to sign the timestamp. The default value is true.
Value Type	boolean

(290) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< timeStamp > <precision>`
Description	Extra time that is allowed for network and processing delays.
Value Type	positiveInteger

(291) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver > <decryption>`
Description	Setting for decrypting encrypted received messages.
Value Type	decryptionType
Child Elements	(293) `keystore`

(292) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< decryption > <keystore>`
Description	Keystore for decrypting messages.
Value Type	keystoreType
Child Elements	(294) `key-type` (295) `keystore-password` (296) `keystore-filename`

(293) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< decryption >< keystore > <key-type>`
Description	Key type of key that is stored in the keystore. JKS or pkcs12 can be used.
Value Type	string

(294) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< decryption >< keystore > <keystore-password>`
Description	Password to access the keystore. To store the password in an encrypted form, use the format {algorithm}ciphertext. For example, {DES}FQrLbQ/D8O1lDVS71L28rw==
Value Type	string

(295) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< decryption >< keystore > <keystore-filename>`
Description	File name of the keystore. If the file exists in the same directory as the class, enter the file name. If the file exists in a different directory, enter the file name with its absolute path. <!-- 원본 메시지 "파일 이름만 입력할 경우, 클래스 경로에서 찾게 되므로 --> <!-- 파일 이름이나 절대 경로를 포함하는 파일 이름을 입력한다." 가 모호하여 연구소에 문의. 임시로 절대 경로를 포함하는 값을 지칭한다는 내용으로 번역. -->
Value Type	string

(296) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver > <signature-verification>`
Description	Setting for verifying received message signatures.
Value Type	signature-verificationType
Child Elements	(298) `keystore`

(297) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< signature-verification > <keystore>`
Description	Keystore for verifying signatures.
Value Type	keystoreType
Child Elements	(299) `key-type` (300) `keystore-password` (301) `keystore-filename`

(298) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< signature-verification >< keystore > <key-type>`
Description	Key type of key that is stored in the keystore. JKS or pkcs12 can be used.
Value Type	string

(299) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< signature-verification >< keystore > <keystore-password>`
Description	Password to access the keystore. To store the password in an encrypted form, use the format {algorithm}ciphertext. For example, {DES}FQrLbQ/D8O1lDVS71L28rw==
Value Type	string

(300) `< jeus-web-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< signature-verification >< keystore > <keystore-filename>`
Description	File name of the keystore. If the file exists in the same directory as the class, enter the file name. If the file exists in a different directory, enter the file name with its absolute path. <!-- 원본 메시지 "파일 이름만 입력할 경우, 클래스 경로에서 찾게 되므로 --> <!-- 파일 이름이나 절대 경로를 포함하는 파일 이름을 입력한다." 가 모호하여 연구소에 문의. 임시로 절대 경로를 포함하는 값을 지칭한다는 내용으로 번역. -->
Value Type	string

(301) `< jeus-web-dd >< service-ref >< service-client > <service-impl-class>`
Description	Service implementation class for web service clients. This is created automatically for deployment, so web service deployment descriptors do not need to create the class.
Value Type	token

(302) `< jeus-web-dd >< service-ref >< service-client > <wsdl-override>`
Description	WSDL file location to replace <wsdl-file> in <service-ref>. The specified location should be a valid URL.
Value Type	string

(303) `< jeus-web-dd >< service-ref >< service-client > <require-dynamic-proxy>`
Description	Indicates to enable Dynamic Proxy for ServiceReferenceFactory when Port Component Link is used.
Value Type	boolean

(304) `< jeus-web-dd >< service-ref >< service-client > <service-qname>`
Description	Service definitions of the WSDL file.
Value Type	QName

(305) `< jeus-web-dd >< service-ref >< service-client > <call-property>`
Description	Properties that apply to all javax.xml.rpc.Call objects used in WSDL services.
Value Type	nameValueType
Child Elements	(307) `name` (308) `value`

(306) `< jeus-web-dd >< service-ref >< service-client >< call-property > <name>`
Description	Key name that is used to configure properties for javax.xml.rpc.Stub or javax.xml.rpc.Call.
Value Type	string

(307) `< jeus-web-dd >< service-ref >< service-client >< call-property > <value>`
Description	Key value that is used to configure properties for javax.xml.rpc.Stub or javax.xml.rpc.Call.
Value Type	string

(308) `< jeus-web-dd > <keep-generated>`
Description	Option to keep Java source and SMAP files that have been generated by web applications.
Value Type	boolean

(309) `< jeus-web-dd > <fast-deploy>`
Description	If the component is a web service or includes web service clients, this indicates whether to use the class files that were installed with the web component or to recompile them.
Value Type	boolean

(310) `< jeus-web-dd > <servlet>`
Description	Information provided from JEUS for servlets of web applications.
Value Type	servletType
Child Elements	(312) `servlet-name` (313) `run-as-identity`

(311) `< jeus-web-dd >< servlet > <servlet-name>`
Description	<servlet-name> in web.xml.
Value Type	token

(312) `< jeus-web-dd >< servlet > <run-as-identity>`
Description	Maps the role name specified at <run-as-specified-identity> in web.xml to the actual user name (principal).
Value Type	run-as-identityType
Child Elements	(314) `principal-name`

(313) `< jeus-web-dd >< servlet >< run-as-identity > <principal-name>`
Description	Name of the principal for the role of <run-as-specified-identity> in ejb-jar.xml or web.xml.
Value Type	token
Value Description	Principal name specified in the security section of subjects.xml.

(314) `< jeus-web-dd > <jsp-resource>`
Description	Provider class that is used to send JSP resources located in the repository to the JSP engine. This option is no longer supported by JEUS 7 or later.
Value Type	jsp-resourceType
Child Elements	(316) `provider-class`

(315) `< jeus-web-dd >< jsp-resource > <provider-class>`
Description	Class that implements the JspResourceProvider interface to provide JSP resources as an InputStream.
Value Type	string

(316) `< jeus-web-dd > <target-session-cluster>`
Description	Cluster to which to create a context.
Value Type	token

(317) `< jeus-web-dd > <use-jeus-login-manager>`
Description	Option to prevent multiple logins to JEUS.
Value Type	boolean
Default Value	false

(318) `< jeus-web-dd > <attach-stacktrace-on-error>`
Description	Option to attach a stack trace to error pages that are sent from JEUS.
Value Type	boolean
Value Description	Boolean type. The value activates or inactivates attaching the stack trace.
Default Value	false

(319) `< jeus-web-dd > <keep-alive-error-response-codes>`
Description	Response error codes that are sent through the Connection: keep-alive header. This applies when web applications directly send error responses. This does not apply when the engine determines that the connection has been terminated. For example, if a servlet executes response.sendError(503), an error code is returned. But if the engine sends a 503 error because an exception occurred in the servlet, no error code is returned. This configuration does not take effect when HTTP client is HTTP 1.0 or earlier or when Connection: close is explicitly sent with a request. For AJP13, this function is performed by the Apache web server; therefore, this option does not take effect.
Value Type	token
Value Description	Character string. To specify multiple items, separate them with a comma (,) as in "404,503".
Default Value	404

(320) `< jeus-web-dd > <library-ref>`
Description	Information about a shared library that the application will use.
Value Type	library-refType
Child Elements	(322) `library-name` (323) `specification-version` (326) `implementation-version` (329) `failon-error`

(321) `< jeus-web-dd >< library-ref > <library-name>`
Description	Name of the shared library.
Value Type	token

(322) `< jeus-web-dd >< library-ref > <specification-version>`
Description	Specification version of the shared library.
Value Type	library-ref-versionType
Child Elements	(324) `value` (325) `exact-match`

(323) `< jeus-web-dd >< library-ref >< specification-version > <value>`
Description	Value of the library version.
Value Type	string

(324) `< jeus-web-dd >< library-ref >< specification-version > <exact-match>`
Description	Indicates whether the exact match of the version is required.
Value Type	boolean
Default Value	false

(325) `< jeus-web-dd >< library-ref > <implementation-version>`
Description	Implementation version of the shared library.
Value Type	library-ref-versionType
Child Elements	(327) `value` (328) `exact-match`

(326) `< jeus-web-dd >< library-ref >< implementation-version > <value>`
Description	Value of the library version.
Value Type	string

(327) `< jeus-web-dd >< library-ref >< implementation-version > <exact-match>`
Description	Indicates whether the exact match of the version is required.
Value Type	boolean
Default Value	false

(328) `< jeus-web-dd >< library-ref > <failon-error>`
Description	Indicates whether deployment will fail if a shared library is not found. The default value is false.
Value Type	boolean
Default Value	false

(329) `< jeus-web-dd > <java-security-permission>`
Description	J2SE permissions that are allowed for applications when JEUS uses J2SE Security.
Value Type	securityPermissionType
Child Elements	(331) `security-permission-spec` (332) `description`

(330) `< jeus-web-dd >< java-security-permission > <security-permission-spec>`
Description	Security permission specifications in the format for the Java security policy.
Value Type	token

(331) `< jeus-web-dd >< java-security-permission > <description>`
Description	Description of the security permission configuration.
Value Type	token

(332) `< jeus-web-dd > <async-config>`
Description	Configuration for servlet 3.0 asynchronous processing.
Value Type	async-configType
Child Elements	(334) `async-timeout-millis` (335) `background-thread-pool` (346) `dispatch-thread-pool`

(333) `< jeus-web-dd >< async-config > <async-timeout-millis>`
Description	Timeout value for web containers to process asynchronous tasks. The timeout can be configured by calling a timeout API. If an application has not set a timeout using AsyncContext#setTimeout, the value configured for AsyncContext#getTimeout will be returned. The default value is 30 seconds.
Value Type	long
Default Value	30000

(334) `< jeus-web-dd >< async-config > <background-thread-pool>`
Description	Thread pool that is used to call AsyncContext#start.
Value Type	async-thread-poolType
Child Elements	(336) `name` (337) `min` (338) `max` (339) `keep-alive-time` (340) `queue-size` (341) `stuck-thread-handling`

(335) `< jeus-web-dd >< async-config >< background-thread-pool > <name>`
Description	Thread pool name.
Value Type	token

(336) `< jeus-web-dd >< async-config >< background-thread-pool > <min>`
Description	Minimum number of threads in a thread pool.
Value Type	nonNegativeIntType
Default Value	0

(337) `< jeus-web-dd >< async-config >< background-thread-pool > <max>`
Description	Maximum number of threads in a thread pool.
Value Type	nonNegativeIntType
Default Value	10

(338) `< jeus-web-dd >< async-config >< background-thread-pool > <keep-alive-time>`
Description	Keep-alive time for inactive threads. If a thread pool contains more than the maximum number of threads, inactive threads will be automatically removed from the thread pool after the specified period of time. If this option is set to 0, threads will not be removed.
Value Type	nonNegativeLongType
Value Description	Milliseconds
Default Value	60000

(339) `< jeus-web-dd >< async-config >< background-thread-pool > <queue-size>`
Description	Size of the queue which stores the application objects processed by a thread pool.
Value Type	nonNegativeIntType
Default Value	4096

(340) `< jeus-web-dd >< async-config >< background-thread-pool > <stuck-thread-handling>`
Description	Option to configure a how to handle a thread when it is occupied by a specific task for longer than specified.
Value Type	stuck-thread-handlingType
Child Elements	(342) `max-stuck-thread-time` (343) `action-on-stuck-thread` (344) `stuck-thread-check-period` (345) `user-warning-class`

(341) `< jeus-web-dd >< async-config >< background-thread-pool >< stuck-thread-handling > <max-stuck-thread-time>`
Description	Length of time before a thread is identified as stuck.
Value Type	nonNegativeLongType
Value Description	Milliseconds
Default Value	3600000

(342) `< jeus-web-dd >< async-config >< background-thread-pool >< stuck-thread-handling > <action-on-stuck-thread>`
Description	Action to take when stuck threads are detected.
Value Type	action-on-stuck-threadType
Default Value	None
Defined Value	None Interrupt IgnoreAndReplace Warning

(343) `< jeus-web-dd >< async-config >< background-thread-pool >< stuck-thread-handling > <stuck-thread-check-period>`
Description	Time period during which the status of a stuck thread is checked.
Value Type	nonNegativeLongType
Value Description	Milliseconds
Default Value	300000

(344) `< jeus-web-dd >< async-config >< background-thread-pool >< stuck-thread-handling > <user-warning-class>`
Description	If action-on-stuck-thread is set to Warning, the default value for this option is thread dump. However, you can write a class to execute an action you want by configuring this option. The class must implement the jeus.util.pool.Warning interface in jclient.jar. Write the class and then locate it in SERVER_HOME/lib/application of a target server.
Value Type	string
Value Description	Use a fully Qualifed Class name. Example: test.stuck.UserWarning

(345) `< jeus-web-dd >< async-config > <dispatch-thread-pool>`
Description	Thread pool that is used to call AsyncContext#dispatch.
Value Type	async-thread-poolType
Child Elements	(347) `name` (348) `min` (349) `max` (350) `keep-alive-time` (351) `queue-size` (352) `stuck-thread-handling`

(346) `< jeus-web-dd >< async-config >< dispatch-thread-pool > <name>`
Description	Thread pool name.
Value Type	token

(347) `< jeus-web-dd >< async-config >< dispatch-thread-pool > <min>`
Description	Minimum number of threads in a thread pool.
Value Type	nonNegativeIntType
Default Value	0

(348) `< jeus-web-dd >< async-config >< dispatch-thread-pool > <max>`
Description	Maximum number of threads in a thread pool.
Value Type	nonNegativeIntType
Default Value	10

(349) `< jeus-web-dd >< async-config >< dispatch-thread-pool > <keep-alive-time>`
Description	Keep-alive time for inactive threads. If a thread pool contains more than the maximum number of threads, inactive threads will be automatically removed from the thread pool after the specified period of time. If this option is set to 0, threads will not be removed.
Value Type	nonNegativeLongType
Value Description	Milliseconds
Default Value	60000

(350) `< jeus-web-dd >< async-config >< dispatch-thread-pool > <queue-size>`
Description	Size of the queue which stores the application objects processed by a thread pool.
Value Type	nonNegativeIntType
Default Value	4096

(351) `< jeus-web-dd >< async-config >< dispatch-thread-pool > <stuck-thread-handling>`
Description	Option to configure a how to handle a thread when it is occupied by a specific task for longer than specified.
Value Type	stuck-thread-handlingType
Child Elements	(353) `max-stuck-thread-time` (354) `action-on-stuck-thread` (355) `stuck-thread-check-period` (356) `user-warning-class`

(352) `< jeus-web-dd >< async-config >< dispatch-thread-pool >< stuck-thread-handling > <max-stuck-thread-time>`
Description	Length of time before a thread is identified as stuck.
Value Type	nonNegativeLongType
Value Description	Milliseconds
Default Value	3600000

(353) `< jeus-web-dd >< async-config >< dispatch-thread-pool >< stuck-thread-handling > <action-on-stuck-thread>`
Description	Action to take when stuck threads are detected.
Value Type	action-on-stuck-threadType
Default Value	None
Defined Value	None Interrupt IgnoreAndReplace Warning

(354) `< jeus-web-dd >< async-config >< dispatch-thread-pool >< stuck-thread-handling > <stuck-thread-check-period>`
Description	Time period during which the status of a stuck thread is checked.
Value Type	nonNegativeLongType
Value Description	Milliseconds
Default Value	300000

(355) `< jeus-web-dd >< async-config >< dispatch-thread-pool >< stuck-thread-handling > <user-warning-class>`
Description	If action-on-stuck-thread is set to Warning, the default value for this option is thread dump. However, you can write a class to execute an action you want by configuring this option. The class must implement the jeus.util.pool.Warning interface in jclient.jar. Write the class and then locate it in SERVER_HOME/lib/application of a target server.
Value Type	string
Value Description	Use a fully Qualifed Class name. Example: test.stuck.UserWarning

(356) `< jeus-web-dd > <web-security>`
Description	Setting for web application security.
Value Type	webSecurityType
Child Elements	(358) `redirect-strategy-ref`

(357) `< jeus-web-dd >< web-security > <redirect-strategy-ref>`
Description	Strategy class that is used to handle jakarta.servlet.http.HttpServletResponse.sendRedirect(String). The class should implement the jeus.servlet.security.RedirectStrategy interface. Set to jeus.servlet.security.RejectCrlfRedirectStrategy to block CRLF injection. Set to jeus.servlet.security.RemoveCrlfRedirectStrategy to replace CR or LF with an empty string.
Value Type	valuableToken

(358) `< jeus-web-dd > <batch-thread-pool>`
Description	Provides an environment where JBatch (JSR-352) applications are run. If this option is not specified, a container will be given the minimum thread pool size for running a JBatch service.
Value Type	dedicated-poolType
Child Elements	(360) `min` (361) `max` (362) `keep-alive-time` (363) `queue-size` (364) `stuck-thread-handling`

(359) `< jeus-web-dd >< batch-thread-pool > <min>`
Description	Minimum number of threads in a thread pool.
Value Type	nonNegativeIntType
Default Value	0

(360) `< jeus-web-dd >< batch-thread-pool > <max>`
Description	Maximum number of threads in a thread pool.
Value Type	nonNegativeIntType
Default Value	10

(361) `< jeus-web-dd >< batch-thread-pool > <keep-alive-time>`
Description	Keep-alive time for inactive threads. If a thread pool contains more than the maximum number of threads, inactive threads will be automatically removed from the thread pool after the specified period of time. If this option is set to 0, threads will not be removed.
Value Type	nonNegativeLongType
Value Description	Milliseconds
Default Value	60000

(362) `< jeus-web-dd >< batch-thread-pool > <queue-size>`
Description	Size of the queue which stores the application objects processed by a thread pool.
Value Type	nonNegativeIntType
Default Value	4096

(363) `< jeus-web-dd >< batch-thread-pool > <stuck-thread-handling>`
Description	Option to configure a how to handle a thread when it is occupied by a specific task for longer than specified.
Value Type	stuck-thread-handlingType
Child Elements	(365) `max-stuck-thread-time` (366) `action-on-stuck-thread` (367) `stuck-thread-check-period` (368) `user-warning-class`

(364) `< jeus-web-dd >< batch-thread-pool >< stuck-thread-handling > <max-stuck-thread-time>`
Description	Length of time before a thread is identified as stuck.
Value Type	nonNegativeLongType
Value Description	Milliseconds
Default Value	3600000

(365) `< jeus-web-dd >< batch-thread-pool >< stuck-thread-handling > <action-on-stuck-thread>`
Description	Action to take when stuck threads are detected.
Value Type	action-on-stuck-threadType
Default Value	None
Defined Value	None Interrupt IgnoreAndReplace Warning

(366) `< jeus-web-dd >< batch-thread-pool >< stuck-thread-handling > <stuck-thread-check-period>`
Description	Time period during which the status of a stuck thread is checked.
Value Type	nonNegativeLongType
Value Description	Milliseconds
Default Value	300000

(367) `< jeus-web-dd >< batch-thread-pool >< stuck-thread-handling > <user-warning-class>`
Description	If action-on-stuck-thread is set to Warning, the default value for this option is thread dump. However, you can write a class to execute an action you want by configuring this option. The class must implement the jeus.util.pool.Warning interface in jclient.jar. Write the class and then locate it in SERVER_HOME/lib/application of a target server.
Value Type	string
Value Description	Use a fully Qualifed Class name. Example: test.stuck.UserWarning

(368) `< jeus-web-dd > <osgi>`
Description	OSGi features setting.
Value Type	osgiType
Child Elements	(370) `framework-name` (371) `install-initial-bundles` (372) `initial-bundles-directory-location` (373) `default-start-level` (374) `fail-on-error` (375) `class-loading-delegation`

(369) `< jeus-web-dd >< osgi > <framework-name>`
Description	Name of an OSGi framework to use in a web application. The OSGi framework with the specified name must exist in the domain configuration, targeting the same server where the web application is running.
Value Type	string

(370) `< jeus-web-dd >< osgi > <install-initial-bundles>`
Description	Option to install bundles in the initial bundles directory.
Value Type	boolean

(371) `< jeus-web-dd >< osgi > <initial-bundles-directory-location>`
Description	Location of the initial bundles directory.
Value Type	string

(372) `< jeus-web-dd >< osgi > <default-start-level>`
Description	Default start level for bundles in the initial bundles directory.
Value Type	int
Default Value	30

(373) `< jeus-web-dd >< osgi > <fail-on-error>`
Description	Indicates whether to treat failed installation of initial bundles as an error.
Value Type	boolean
Default Value	true

(374) `< jeus-web-dd >< osgi > <class-loading-delegation>`
Description	Defines necessary configurations for referencing classes within the OSGi Framework used by the web application.
Value Type	class-loading-delegationType
Child Elements	(376) `application-bundle`

(375) `< jeus-web-dd >< osgi >< class-loading-delegation > <application-bundle>`
Description	Unique name and version of the bundle to reference.
Value Type	application-bundleType
Child Elements	(377) `bundle-symbolic-name` (378) `version`

(376) `< jeus-web-dd >< osgi >< class-loading-delegation >< application-bundle > <bundle-symbolic-name>`
Description	Unique name of the bundle to specify.
Value Type	string

(377) `< jeus-web-dd >< osgi >< class-loading-delegation >< application-bundle > <version>`
Description	Version of the bundle to specify.
Value Type	string

18.4. Example File

[Example 18.1] Example File

<?xml version="1.0"?>
<jeus-web-dd xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <!-- the URL path of the context.  -->
    <context-path>/examples</context-path>

    <!-- handling messages defined by ServletContext.log() method -->
    <user-log>
        <level>INFO</level>

        <use-parent-handlers>false</use-parent-handlers>

        <handler>
            <file-handler>
                <name>userHandler</name>
                <file-name>/home/jeus/logs/MyContextLog.log</file-name>
                <valid-day>7</valid-day>
                <buffer-size>1024</buffer-size>
                <append>true</append>
            </file-handler>
        </handler>
    </user-log>

    <!-- determine the usage of JSP engine. -->
    <enable-jsp>true</enable-jsp>

    <!-- determine whether to reload Servlets classes and custom tag classes 
         automtically if the classes are changed -->
    <auto-reload>
        <!-- determine whether to activate or inactivate Servlet auto-reload -->
        <enable-reload>true</enable-reload>

        <!-- determine whether to activate or inactivate class loading using JVM hotswap -->
        <use-jvm-hotswap>true</use-jvm-hotswap>

        <!-- set for inspecting for reloading Servlet class when each request reached -->
        <check-on-demand>true</check-on-demand>

        <!-- set for timeout for reloading Servlet class -->
        <reload-timeout>31000</reload-timeout>
    </auto-reload>

    <!-- maximum number of Servlet instances to create if the single threaded model is used -->
    <max-instance-pool-size>20</max-instance-pool-size>

    <!-- additional classes to add to the class path when Servlets are compiled or executed -->
    <added-classpath>
        <class-path>/home/jeus/mylib/subdir/</class-path>
    </added-classpath>

    <!-- if no "default welcome file" is specified, the contents of the underlying directory 
         of an URL path will be sent back to the client -->
    <allow-indexing>
        <directory>/images/</directory>
    </allow-indexing>

    <!-- specify any files that should not be downloadable -->
    <deny-download>
        <file>/data/secret.dat</file>
        <extension>dat</extension>
        <directory>/data/</directory>
    </deny-download>

    <!-- create symbolic links from requested URL paths to actual file system -->
    <aliasing>
        <alias>
            <alias-name>/images/</alias-name>
            <real-path>/home/web/images/</real-path>
        </alias>
    </aliasing>

    <!-- configure the caching of static resources such as images and HTML files -->
    <file-caching>
        <max-idle-time>1800000</max-idle-time>
        <max-cache-memory>10</max-cache-memory>
        <directory>/images/</directory>
    </file-caching>

    <!-- map any J2EE role names to actual system user names -->
    <role-mapping>
        <role-permission>
            <role>administrator</role>
            <principal>peter</principal>
        </role-permission>
    </role-mapping>

    <!-- map EJB reference in web.xml to JNDI name used in actual system -->
    <ejb-ref>
        <jndi-info>
            <ref-name>ejb/account</ref-name>
            <export-name>AccountEJB</export-name>
        </jndi-info>
    </ejb-ref>

    <!-- map resource reference in web.xml to JNDI name -->
    <res-ref>
        <jndi-info>
            <ref-name>jdbc/EmployeeAppDB</ref-name>
            <export-name>EmployeeDB</export-name>
        </jndi-info>
    </res-ref>

    <!-- map resource environment reference in web.xml to JNDI name -->
    <res-env-ref>
        <jndi-info>
            <ref-name>jms/StockQueue</ref-name>
            <export-name>StockQueue</export-name>
        </jndi-info>
    </res-env-ref>

    <!-- JSP-related settings for this context -->
    <jsp-engine>
        <!-- set the absolute-path directory that servlet sources and class files -->
        <jsp-work-dir>/home/jeus/MyJSPWorkdir/</jsp-work-dir>

        <!-- set the java compiler to compile the generated java file -->
        <java-compiler>javac</java-compiler>

        <!-- set the generated class file location to absolute-path, not in jsp-work-dir-->
        <compile-output-dir>/home/jeus/MyJSPWorkdir/</compile-output-dir>

        <!-- compiler option to compile the generated java file from jsp -->
        <compile-option>-g:none -verbose</compile-option>

        <!-- set the charset encoding when the generaged servlet source from jsp complie -->
        <compile-encoding>8859_1</compile-encoding>

        <!-- whether check the included jsp files changed in compile or not -->
        <check-included-jspfile>true</check-included-jspfile>

        <!-- whether save the generaged java source file or not -->
        <keep-generated>true</keep-generated>

        <!-- whether graceful jsp reloading for shared jsp source repository -->
        <graceful-jsp-reloading>true</graceful-jsp-reloading>

        <!-- set the period of graceful jsp reloading checking -->
        <graceful-jsp-reloading-period>15000</graceful-jsp-reloading-period>
    </jsp-engine>

    <!-- determine whether to leave java source files of Tie and Web Service Client Stub -->
    <keep-generated>true</keep-generated>

    <!-- determine whether to use class files installed with web component  -->
    <fast-deploy>true</fast-deploy>

    <!-- indicate servlet information in current context in JEUS -->
    <servlet>
        <!-- servlet name defined in web.xml -->
        <servlet-name>test</servlet-name>

        <!-- map the run-as-specified-identity in web.xml to real user-name(principal) -->
        <run-as-identity>jeus</run-as-identity>
    </servlet>

    <!-- configure whether to find it below web-inf directory when loading class. -->
    <webinf-first>
        <enabled>true</enabled>
    </webinf-first>

    <!-- set provider-class to provide JSP resource to JspEngine -->
    <jsp-resource>
        <!-- JspResourceProvider Implementation class to provide JSP resource as inputstream -->
        <provider-class>com.tmax.jspprovider</provider-class>
    </jsp-resource>

    <!-- configure context-wide property -->
    <properties>
        <property>
            <key>myKey</key>
            <value>myValue</value>
        </property>
    </properties>

    <!-- session-related settings for this context -->
    <session-config>
        <shared>false</shared>
        <timeout>30</timeout>
        <reload-persistent>false</reload-persistent>
        <tracking-mode>
            <cookie>true</cookie>
        </tracking-mode>
        <session-cookie>
            <cookie-name>JSESSIONID</cookie-name>
            <version>0</version>
            <domain>.tmax.co.kr</domain>
            <path>/</path>
            <max-age>-1</max-age>
            <secure>false</secure>
            <http-only>true</http-only>
            <comment>example for cookie</comment>
        </session-cookie>
    </session-config>

    <!-- configure request, response encoding -->
    <encoding>
        <request-encoding>
            <default>UTF-8</default>
            <forced>UTF-8</forced>
        </request-encoding>

        <response-encoding>
            <default>UTF-8</default>
            <forced>UTF-8</forced>
        </response-encoding>
    </encoding>

    <!-- determine whether detailed error descriptions should be sent to the browser -->
    <attach-stacktrace-on-error>false</attach-stacktrace-on-error>

    <!-- specify shared library for this context -->
    <library-ref>
        <library-name>myLibrary</library-name>
        <specification-version>
		    <value>2.0</value>
		</specification-version>
        <implementation-version>
		    <value>2.0</value>
		</implementation-version>
    </library-ref>

    <!-- config for servlet 3.0 Asynchronous Servlet-->
    <anync-config>
        <!-- set async processing timeout -->
        <async-timeout-millis>30000</async-timeout-millis>
        <!-- set the thread pool used when AsyncContext#start called -->

        <background-thread-pool>
            <!-- set the threadpool name -->
            <name>back</name>
        </background-thread-pool>

        <!-- set the thread pool used when AsyncContext#dispatch called -->
        <dispatched-thread-pool>
            <!-- set the threadpool name -->
            <name>dispatch</name>
        </dispatched-thread-pool>
    </anync-config>

    <!-- set the J2SE permission on current application when JEUS uses J2SE security -->
    <java-security-permission>
        <!-- description of security permission -->
        <description>example permission</description>

        <!-- describe security permission -->
        <security-permission-spec>grant { permission
        java.lang.RuntimePermission "foo"; } </security-permission-spec>
    </java-security-permission>

    <!-- setting for JBatch (JSR-352) threadpool resource -->
    <batch-thread-pool>
        <min>10</min>
        <max>20</max>
        <keep-alive-time>20</keep-alive-time>
        <queue-size>4096</queue-size>
    </batch-thread-pool>

    <!-- setting for websocket -->
    <websocket>
        <distributed-userProperties>
            <enabled>true</enabled>
            <use-write-through-policy>false</use-write-through-policy>
        </distributed-userProperties>
    </websocket>
</jeus-web-dd>

Prev		Next
Chapter 17. Configuring cert-user-map.xml	Home	Chapter 19. Configuring jeus-ejb-dd.xml