Chapter 22. Configuring jeus-application-dd.xml
Prev   Next

Chapter 22. Configuring jeus-application-dd.xml

Table of Contents

22.1. Introduction
22.2. XML Schema/XML Tree
22.3. Element Reference
22.4. Example File

This chapter explains the contents of jeus-application-dd.xml, an EAR deployment descriptor.

22.1. Introduction

XML references are configured in the following format.

  1. 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.

  2. 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.

22.2. XML Schema/XML Tree

22.3. Element Reference

(1) <application>
Description Setting for jeus-application-dd.xml.
Value Type applicationType
Child Elements

(3) role-permission

(10) java-security-permission

(13) library-ref

(22) env

(26) ejb-ref

(30) res-ref

(34) res-env-ref

(38) message-destination-ref

(42) service-ref

(119) message-destination

(123) deploy-modules-concurrently

(124) classloading

(126) batch-thread-pool

(2) < application > <role-permission>
Description Setting for principal role mappings that apply to all application modules.
Value Type rolePermissionType
Child Elements

(4) role

(5) principal

(6) actions

(7) classname

(8) excluded

(9) unchecked

(3) < application >< role-permission > <role>
Description Name of the role to be assigned to the principals.
Value Type token

(4) < application >< 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.

(5) < application >< role-permission > <actions>
Description Action for the RolePermission object. The default value is no action for RolePermissions.
Value Type token

(6) < application >< 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

(7) < application >< role-permission > <excluded>
Description Indicates that the role will be disabled.
Value Type emptyType

(8) < application >< role-permission > <unchecked>
Description Indicates that the role will be available without any permission.
Value Type emptyType

(9) < application > <java-security-permission>
Description Use this to specify Java SE permissions for applications when Java SE security is enabled.
Value Type securityPermissionType
Child Elements

(11) security-permission-spec

(12) description

(10) < application >< java-security-permission > <security-permission-spec>
Description Security permission specifications in the format for the Java security policy.
Value Type token

(11) < application >< java-security-permission > <description>
Description Description of the security permission configuration.
Value Type token

(12) < application > <library-ref>
Description Information about a shared library that the application will use.
Value Type library-refType
Child Elements

(14) library-name

(15) specification-version

(18) implementation-version

(21) failon-error

(13) < application >< library-ref > <library-name>
Description Name of the shared library.
Value Type token

(14) < application >< library-ref > <specification-version>
Description Specification version of the shared library.
Value Type library-ref-versionType
Child Elements

(16) value

(17) exact-match

(15) < application >< library-ref >< specification-version > <value>
Description Value of the library version.
Value Type string

(16) < application >< library-ref >< specification-version > <exact-match>
Description Indicates whether the exact match of the version is required.
Value Type boolean
Default Value false

(17) < application >< library-ref > <implementation-version>
Description Implementation version of the shared library.
Value Type library-ref-versionType
Child Elements

(19) value

(20) exact-match

(18) < application >< library-ref >< implementation-version > <value>
Description Value of the library version.
Value Type string

(19) < application >< library-ref >< implementation-version > <exact-match>
Description Indicates whether the exact match of the version is required.
Value Type boolean
Default Value false

(20) < application >< 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

(21) < application > <env>
Description Overrides the env-entry properties defined in the standard DD.
Value Type envType
Child Elements

(23) name

(24) value

(25) type

(22) < application >< env > <name>
Description Name of an environment variable.
Value Type valuableToken

(23) < application >< env > <value>
Description Parameter value of the wrapper class generator that corresponds to the environment variable.
Value Type valuableToken

(24) < application >< 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.

(25) < application > <ejb-ref>
Description Binds an EJB reference to an actual EJB JNDI name.
Value Type jndi-refType
Child Elements

(27) jndi-info

(26) < application >< 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

(28) ref-name

(29) export-name

(27) < application >< 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.

(28) < application >< ejb-ref >< jndi-info > <export-name>
Description Actual JNDI name defined in the JEUS DD.
Value Type token

(29) < application > <res-ref>
Description Use this to declare reference name for an external resource such as a database.
Value Type jndi-refType
Child Elements

(31) jndi-info

(30) < application >< 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

(32) ref-name

(33) export-name

(31) < application >< 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.

(32) < application >< res-ref >< jndi-info > <export-name>
Description Actual JNDI name defined in the JEUS DD.
Value Type token

(33) < application > <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

(35) jndi-info

(34) < application >< 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

(36) ref-name

(37) export-name

(35) < application >< 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.

(36) < application >< res-env-ref >< jndi-info > <export-name>
Description Actual JNDI name defined in the JEUS DD.
Value Type token

(37) < application > <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

(39) jndi-info

(38) < application >< 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

(40) ref-name

(41) export-name

(39) < application >< 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.

(40) < application >< message-destination-ref >< jndi-info > <export-name>
Description Actual JNDI name defined in the JEUS DD.
Value Type token

(41) < application > <service-ref>
Description Root element of a JEUS Web service client configuration documentation.
Value Type jeus-webservices-client-ddType
Child Elements

(43) service-client

(42) < application >< service-ref > <service-client>
Description Settings for web service clients that will be deployed.
Value Type serviceClientType
Child Elements

(44) service-ref-name

(45) port-info

(112) service-impl-class

(113) wsdl-override

(114) require-dynamic-proxy

(115) service-qname

(116) call-property

(43) < application >< 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

(44) < application >< service-ref >< service-client > <port-info>
Description Web service port information that is used by deployed web service clients.
Value Type portInfoType
Child Elements

(46) service-endpoint-interface

(47) wsdl-port

(48) stub-property

(51) call-property

(54) security

(45) < application >< 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

(46) < application >< service-ref >< service-client >< port-info > <wsdl-port>
Description WSDL port information for <port-info>.
Value Type QName

(47) < application >< 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

(49) name

(50) value

(48) < application >< 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

(49) < application >< 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

(50) < application >< 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

(52) name

(53) value

(51) < application >< 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

(52) < application >< 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

(53) < application >< service-ref >< service-client >< port-info > <security>
Description Web service clients for Web service security (WS-Security).
Value Type webservice-securityType
Child Elements

(55) request-sender

(93) response-receiver

(54) < application >< 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

(56) action-list

(57) password-callback-class

(58) user

(59) timeStamp

(64) userNameToken

(68) signature-infos

(79) encryption-infos

(55) < application >< 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

(56) < application >< 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

(57) < application >< 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

(58) < application >< service-ref >< service-client >< port-info >< security >< request-sender > <timeStamp>
Description TTL (time-to-live) aberration for timestamps.
Value Type timeStampType
Child Elements

(60) timeToLive

(61) aberration

(62) requireSignature

(63) precision

(59) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< timeStamp > <timeToLive>
Description Expiry time of sent messages in seconds.
Value Type positiveInteger

(60) < application >< 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

(61) < application >< 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

(62) < application >< 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

(63) < application >< service-ref >< service-client >< port-info >< security >< request-sender > <userNameToken>
Description UsernameToken.
Value Type userNameTokenSenderType
Child Elements

(65) password

(66) passwordType

(67) userTokenElements

(64) < application >< 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

(65) < application >< 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

(66) < application >< 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

(67) < application >< service-ref >< service-client >< port-info >< security >< request-sender > <signature-infos>
Description Setting for signing messages.
Value Type signature-infosType
Child Elements

(69) signature-info

(68) < application >< 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

(70) signatureParts

(71) signatureAlgorithm

(72) messageDigestAlogrithm

(73) canonicalization

(74) keyIdentifier

(75) keystore

(69) < application >< 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

(70) < application >< 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

(71) < application >< 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

(72) < application >< 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

(73) < application >< 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

(74) < application >< 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

(76) key-type

(77) keystore-password

(78) keystore-filename

(75) < application >< 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

(76) < application >< 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

(77) < application >< 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

(78) < application >< service-ref >< service-client >< port-info >< security >< request-sender > <encryption-infos>
Description Setting for encrypting messages.
Value Type encryption-infosType
Child Elements

(80) encryption-info

(79) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos > <encryption-info>
Description Setting for encrypting messages.
Value Type encryption-infoType
Child Elements

(81) encryptionParts

(82) keyTransportAlogrithm

(83) encryptionAlgorithm

(84) encryptionUser

(85) keyIdentifier

(86) keystore

(90) embeddedKey

(80) < application >< 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

(81) < application >< 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

(82) < application >< 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

(83) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <encryptionUser>
Description Alias for the encryption key.
Value Type string

(84) < application >< 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

(85) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <keystore>
Description Keystore for encryption keys.
Value Type keystoreType
Child Elements

(87) key-type

(88) keystore-password

(89) keystore-filename

(86) < application >< 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

(87) < application >< 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

(88) < application >< 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

(89) < application >< 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

(91) embeddedKeyCallbackClass

(92) key-name

(90) < application >< 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

(91) < application >< 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

(92) < application >< 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

(94) action-list

(95) observeActionOrder

(96) password-callback-class

(97) timeStamp

(102) decryption

(107) signature-verification

(93) < application >< 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

(94) < application >< 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

(95) < application >< 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

(96) < application >< service-ref >< service-client >< port-info >< security >< response-receiver > <timeStamp>
Description TTL (time-to-live) aberration for timestamps.
Value Type timeStampType
Child Elements

(98) timeToLive

(99) aberration

(100) requireSignature

(101) precision

(97) < application >< service-ref >< service-client >< port-info >< security >< response-receiver >< timeStamp > <timeToLive>
Description Expiry time of sent messages in seconds.
Value Type positiveInteger

(98) < application >< 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

(99) < application >< 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

(100) < application >< 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

(101) < application >< service-ref >< service-client >< port-info >< security >< response-receiver > <decryption>
Description Setting for decrypting encrypted received messages.
Value Type decryptionType
Child Elements

(103) keystore

(102) < application >< service-ref >< service-client >< port-info >< security >< response-receiver >< decryption > <keystore>
Description Keystore for decrypting messages.
Value Type keystoreType
Child Elements

(104) key-type

(105) keystore-password

(106) keystore-filename

(103) < application >< 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

(104) < application >< 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

(105) < application >< 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

(106) < application >< service-ref >< service-client >< port-info >< security >< response-receiver > <signature-verification>
Description Setting for verifying received message signatures.
Value Type signature-verificationType
Child Elements

(108) keystore

(107) < application >< service-ref >< service-client >< port-info >< security >< response-receiver >< signature-verification > <keystore>
Description Keystore for verifying signatures.
Value Type keystoreType
Child Elements

(109) key-type

(110) keystore-password

(111) keystore-filename

(108) < application >< 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

(109) < application >< 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

(110) < application >< 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

(111) < application >< 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

(112) < application >< 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

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

(114) < application >< service-ref >< service-client > <service-qname>
Description Service definitions of the WSDL file.
Value Type QName

(115) < application >< 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

(117) name

(118) value

(116) < application >< 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

(117) < application >< 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

(118) < application > <message-destination>
Description Maps the message destinations defined in <message-destination> in application.xml to the actual destination objects that are registered in JNDI.
Value Type jndi-refType
Child Elements

(120) jndi-info

(119) < application >< message-destination > <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

(121) ref-name

(122) export-name

(120) < application >< message-destination >< 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.

(121) < application >< message-destination >< jndi-info > <export-name>
Description Actual JNDI name defined in the JEUS DD.
Value Type token

(122) < application > <deploy-modules-concurrently>
Description Option to concurrently deploy modules in the EAR file. This setting is valid only when initialize-in-order is set to false in application.xml. If initialize-in-order is set to true, the modules are deployed in order regardless of this setting. That is, this setting is valid only when initialize-in-order is set to false.
Value Type boolean
Default Value false

(123) < application > <classloading>
Description Setting for loading a class required to execute an application.
Value Type classloadType
Child Elements

(125) local-lib-first

(124) < application >< classloading > <local-lib-first>
Description Option to load a class first that exists in the class path specified in an application. If this option is set to true, ClassCastException may occur due to duplicated classes.
Value Type boolean
Default Value false

(125) < application > <batch-thread-pool>
Description Provides an environment for executing JBatch (JSR-352) applications. If this option is not configured, a container has the minimum thread pool size for executing a JBatch service.
Value Type dedicated-poolType
Child Elements

(127) min

(128) max

(129) keep-alive-time

(130) queue-size

(131) stuck-thread-handling

(126) < application >< batch-thread-pool > <min>
Description Minimum number of threads in a thread pool.
Value Type nonNegativeIntType
Default Value 0

(127) < application >< batch-thread-pool > <max>
Description Maximum number of threads in a thread pool.
Value Type nonNegativeIntType
Default Value 10

(128) < application >< 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

(129) < application >< 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

(130) < application >< 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

(132) max-stuck-thread-time

(133) action-on-stuck-thread

(134) stuck-thread-check-period

(135) user-warning-class

(131) < application >< 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

(132) < application >< 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

(133) < application >< 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

(134) < application >< 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

22.4. Example File

[Example 22.1] Example File

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<application xmlns="http://www.tmaxsoft.com/xml/ns/jeus">

    <!-- principal - role mappings -->
    <role-permission>
        <principal>appUser</principal>
        <role>appRole</role>
    </role-permission>

    <!-- reference - JNDI export name mappings -->
    <env>
        <type>java.lang.Integer</type>
        <name>minAmount</name>
        <value>100</value>
    </env>
    <ejb-ref>
        <jndi-info>
            <ref-name>ejb/AccountEJB</ref-name>
            <export-name>ACCEJB</export-name>
        </jndi-info>
    </ejb-ref>
    <res-ref>
        <jndi-info>
            <ref-name>jdbc/AccountDB</ref-name>
            <export-name>ACCOUNTDB</export-name>
        </jndi-info>
    </res-ref>
    <res-env-ref>
        <jndi-info>
            <ref-name>jms/StockQueue</ref-name>
            <export-name>STOCKQUEUE</export-name>
        </jndi-info>
    </res-env-ref>

    <!-- 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>
</application>

Prev   Next
Chapter 21. Configuring jeus-client-dd.xml Home Chapter 23. Configuring jeus-webservices-dd.xml