제22장 jeus-application-dd.xml 설정
이전   다음

제22장 jeus-application-dd.xml 설정

내용 목차

22.1. 소개
22.2. XML Schema/XML 트리
22.3. Element Reference
22.4. jeus-application-dd.xml 파일 예제

여기에서 EAR의 DD인 jeus-application-dd.xml에서 사용되는 설정을 찾을 수 있다.

22.1. 소개

레퍼런스는 다음 형식으로 구성되어 있다.

  1. XML Schema/XML 트리: XML 설정 파일의 모든 태그 리스트를 정리했다. 각 노드의 형식은 다음과 같다.

    1. 태그 레퍼런스로 빨리 찾아보기 위해서 각 태그마다 인덱스 번호( 예: (11) )를 붙여 놓았다. 태그 레퍼런스에서는 이 번호 순서로 설명한다.

    2. XML Schema에서 정의한 XML 태그명을 <tag name> 형식으로 표시한다.

    3. XML Schema에서 정의한 Cardinality를 표시한다. “?” = 0개나 1개의 element, “+” = 1개 이상의 element, “*” = 0개 이상의 element, (기호가 없음) = 정확히 1개의 element

    4. 몇몇 태그에는 “P” 문자를 붙여 놓았는데, 해당 태그는 성능에 관계되는 태그라는 것을 뜻한다. 이 태그는 설정을 튜닝할 때 사용된다.

  2. Element Reference: 트리에 있는 각 XML 태그를 설명한다.

    1. Dynamic: 동적 설정 반영 가능

    2. Non-Dynamic: 동적 설정 반영 불가능, Dynamic이 설정되지 않은 항목들이 보통 이에 해당 하나 특별히 설명이 있는 경우 이 항목이 표시된다.

    3. Description: 태그에 대한 간단한 설명.

    4. Value Description: 입력하는 값과 타입.

    5. Value Type: 값의 데이터 타입. (예: String)

    6. Value Type Description: 값의 데이터 타입에 대한 설명

    7. Default Value: 해당 XML을 사용하지 않았을 때 기본적으로 사용되는 값.

    8. Defined Value: 이미 정해져 있는 값.

    9. Example: 해당 XML 태그에 대한 예.

    10. Performance Recommendation: 성능 향상을 위해서 추천하는 값.

    11. Child Elements: 자신의 태그 안에 사용하는 태그.

22.2. XML Schema/XML 트리

22.3. Element Reference

(1) <application>
Description 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 애플리케이션의 모든 모듈에 적용할 Principal Role 매핑을 설정한다.
Value Type rolePermissionType
Child Elements

(4) role

(5) principal

(6) actions

(7) classname

(8) excluded

(9) unchecked

(3) < application >< role-permission > <role>
Description Principal들에게 부여할 Role 이름을 지정한다.
Value Type token

(4) < application >< role-permission > <principal>
Description Role에 해당하는 User Principal을 지정한다.
Value Type token
Value Description Security의 accounts.xml에서 지정되어 있는 Principal 이름을 입력한다.

(5) < application >< role-permission > <actions>
Description Role Permission 객체에 대한 액션을 정의한다. 기본으로 사용되는 Role Permission은 정해진 액션이 없다.
Value Type token

(6) < application >< role-permission > <classname>
Description 사용할 Role Permission Class Name을 지정한다. 지정하지 않으면 JEUS에서 기본적으로 제공하는 클래스가 사용된다.
Value Type token

(7) < application >< role-permission > <excluded>
Description Role을 사용하지 못하도록 설정한다.
Value Type emptyType

(8) < application >< role-permission > <unchecked>
Description 아무런 체크 없이 Role을 사용 가능하도록 설정한다.
Value Type emptyType

(9) < application > <java-security-permission>
Description JEUS가 J2SE Security를 사용할 때 해당 애플리케이션에게 허용할 J2SE Permission을 지정할 수 있다.
Value Type securityPermissionType
Child Elements

(11) security-permission-spec

(12) description

(10) < application >< java-security-permission > <security-permission-spec>
Description Security Permission을 기술한다. 형식은 Java Policy 파일을 따른다.
Value Type token

(11) < application >< java-security-permission > <description>
Description Security Permission 설정에 대한 설명을 입력할 수 있다.
Value Type token

(12) < application > <library-ref>
Description 애플리케이션에서 사용할 Shared Library 정보를 설정한다.
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 Shared Library 이름을 설정한다.
Value Type token

(14) < application >< library-ref > <specification-version>
Description 사용할 Shared Library 스펙(specification) 버전을 설정한다.
Value Type library-ref-versionType
Child Elements

(16) value

(17) exact-match

(15) < application >< library-ref >< specification-version > <value>
Description 버전의 값을 설정한다.
Value Type string

(16) < application >< library-ref >< specification-version > <exact-match>
Description 정확히 매치되는 버전이 필요한지 여부를 설정한다.
Value Type boolean
Default Value false

(17) < application >< library-ref > <implementation-version>
Description 사용할 Shared Library 구현(implementation) 버전을 설정한다.
Value Type library-ref-versionType
Child Elements

(19) value

(20) exact-match

(18) < application >< library-ref >< implementation-version > <value>
Description 버전의 값을 설정한다.
Value Type string

(19) < application >< library-ref >< implementation-version > <exact-match>
Description 정확히 매치되는 버전이 필요한지 여부를 설정한다.
Value Type boolean
Default Value false

(20) < application >< library-ref > <failon-error>
Description 해당 Shared Library를 찾지 못할 경우 Deploy를 실패할지 여부를 설정한다. 기본값은 false이다.
Value Type boolean
Default Value false

(21) < application > <env>
Description 표준 DD에 정의된 Env Entry 값을 Override하기 위해 사용된다.
Value Type envType
Child Elements

(23) name

(24) value

(25) type

(22) < application >< env > <name>
Description 코드에서 사용하는 환경변수의 이름을 설정한다.
Value Type valuableToken

(23) < application >< env > <value>
Description 대응하는 Wrapper 클래스 생성자의 파라미터로서 사용되는 값을 설정한다.
Value Type valuableToken

(24) < application >< env > <type>
Description 환경변수의 Java 타입을 설정한다.
Value Type valuableToken
Value Description 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 코드에서 사용하는 EJB 참조를 실제 EJB JNDI 이름으로 바인드한다.
Value Type jndi-refType
Child Elements

(27) jndi-info

(26) < application >< ejb-ref > <jndi-info>
Description Environment Entry에 사용되는 Logical 이름을 실제 JNDI 이름으로 매핑한다. 예를 들면 "jdbc/myDataSource"로 사용된 Environment Entry 이름을 실제 JNDI 이름인 "DataSource1"으로 매핑한다.
Value Type jndi-infoType
Child Elements

(28) ref-name

(29) export-name

(27) < application >< ejb-ref >< jndi-info > <ref-name>
Description 소스코드에서 사용할 수 있는 참조 이름을 선언할 수 있다.
Value Type valuableToken
Value Description 실제 JNDI 이름에 바인드될 참조 이름이다. 이것은 해당하는 J2EE 표준 Descriptor 항목의 Ref Name에 대응된다.

(28) < application >< ejb-ref >< jndi-info > <export-name>
Description JEUS DD에 정의된 실제 JNDI 이름을 설정한다.
Value Type token

(29) < application > <res-ref>
Description 소스코드에서 사용할 수 있는 외부 자원(예: DB) 참조 이름을 선언할 수 있다.
Value Type jndi-refType
Child Elements

(31) jndi-info

(30) < application >< res-ref > <jndi-info>
Description Environment Entry에 사용되는 Logical 이름을 실제 JNDI 이름으로 매핑한다. 예를 들면 "jdbc/myDataSource"로 사용된 Environment Entry 이름을 실제 JNDI 이름인 "DataSource1"으로 매핑한다.
Value Type jndi-infoType
Child Elements

(32) ref-name

(33) export-name

(31) < application >< res-ref >< jndi-info > <ref-name>
Description 소스코드에서 사용할 수 있는 참조 이름을 선언할 수 있다.
Value Type valuableToken
Value Description 실제 JNDI 이름에 바인드될 참조 이름이다. 이것은 해당하는 J2EE 표준 Descriptor 항목의 Ref Name에 대응된다.

(32) < application >< res-ref >< jndi-info > <export-name>
Description JEUS DD에 정의된 실제 JNDI 이름을 설정한다.
Value Type token

(33) < application > <res-env-ref>
Description 코드에서 사용하는 외부 자원 참조를 실제 JNDI 이름으로 바인드한다. 표준 EJB DD의 <resource-env-ref>에 대응한다.
Value Type jndi-refType
Child Elements

(35) jndi-info

(34) < application >< res-env-ref > <jndi-info>
Description Environment Entry에 사용되는 Logical 이름을 실제 JNDI 이름으로 매핑한다. 예를 들면 "jdbc/myDataSource"로 사용된 Environment Entry 이름을 실제 JNDI 이름인 "DataSource1"으로 매핑한다.
Value Type jndi-infoType
Child Elements

(36) ref-name

(37) export-name

(35) < application >< res-env-ref >< jndi-info > <ref-name>
Description 소스코드에서 사용할 수 있는 참조 이름을 선언할 수 있다.
Value Type valuableToken
Value Description 실제 JNDI 이름에 바인드될 참조 이름이다. 이것은 해당하는 J2EE 표준 Descriptor 항목의 Ref Name에 대응된다.

(36) < application >< res-env-ref >< jndi-info > <export-name>
Description JEUS DD에 정의된 실제 JNDI 이름을 설정한다.
Value Type token

(37) < application > <message-destination-ref>
Description 코드에서 사용하는 외부 자원 참조를 실제 JNDI 이름으로 매핑한다. 표준 DD의 <message-destination-ref>에 대응된다.
Value Type jndi-refType
Child Elements

(39) jndi-info

(38) < application >< message-destination-ref > <jndi-info>
Description Environment Entry에 사용되는 Logical 이름을 실제 JNDI 이름으로 매핑한다. 예를 들면 "jdbc/myDataSource"로 사용된 Environment Entry 이름을 실제 JNDI 이름인 "DataSource1"으로 매핑한다.
Value Type jndi-infoType
Child Elements

(40) ref-name

(41) export-name

(39) < application >< message-destination-ref >< jndi-info > <ref-name>
Description 소스코드에서 사용할 수 있는 참조 이름을 선언할 수 있다.
Value Type valuableToken
Value Description 실제 JNDI 이름에 바인드될 참조 이름이다. 이것은 해당하는 J2EE 표준 Descriptor 항목의 Ref Name에 대응된다.

(40) < application >< message-destination-ref >< jndi-info > <export-name>
Description JEUS DD에 정의된 실제 JNDI 이름을 설정한다.
Value Type token

(41) < application > <service-ref>
Description JEUS 웹 서비스 클라이언트 설정 문서의 최상위 항목이다.
Value Type jeus-webservices-client-ddType
Child Elements

(43) service-client

(42) < application >< service-ref > <service-client>
Description 배치되는 웹 서비스 클라이언트를 위한 설정들을 표시한다.
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 WSDL 파일에서 관련된 웹 서비스 Endpoint 이름이다. 표준 배치 서술자 web.xml 혹은 ejb-jar.xml의 <service-ref-name>에 해당하는 설정이다.
Value Type token

(44) < application >< service-ref >< service-client > <port-info>
Description 배치되는 웹 서비스 클라이언트가 호출하는 웹 서비스 포트 정보를 설정한다.
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 WSDL 포트의 Service Endpoint 인터페이스를 나타내는 클래스를 표시한다. <service-ref> 설정에서 <port-component-ref>의 <service-endpoint-interface>에 해당하는 설정이다.
Value Type token

(46) < application >< service-ref >< service-client >< port-info > <wsdl-port>
Description <port-info>와 연결된 WSDL 포트 정의를 표시한다.
Value Type QName

(47) < application >< service-ref >< service-client >< port-info > <stub-property>
Description 특정 포트에서 사용하는 javax.xml.rpc.Stub 객체에 설정하는 프로퍼티들을 표시한다.
Value Type nameValueType
Child Elements

(49) name

(50) value

(48) < application >< service-ref >< service-client >< port-info >< stub-property > <name>
Description javax.xml.rpc.Stub 또는 javax.xml.rpc.Call에 프로퍼티를 설정하기 위한 Key 이름을 설정한다.
Value Type string

(49) < application >< service-ref >< service-client >< port-info >< stub-property > <value>
Description javax.xml.rpc.Stub 또는 javax.xml.rpc.Call에 프로퍼티를 설정하기 위한 Key에 해당하는 값(value)을 설정한다.
Value Type string

(50) < application >< service-ref >< service-client >< port-info > <call-property>
Description 특정 포트에서 사용하는 javax.xml.rpc.Call 객체에 설정하는 프로퍼티들을 표시한다.
Value Type nameValueType
Child Elements

(52) name

(53) value

(51) < application >< service-ref >< service-client >< port-info >< call-property > <name>
Description javax.xml.rpc.Stub 또는 javax.xml.rpc.Call에 프로퍼티를 설정하기 위한 Key 이름을 설정한다.
Value Type string

(52) < application >< service-ref >< service-client >< port-info >< call-property > <value>
Description javax.xml.rpc.Stub 또는 javax.xml.rpc.Call에 프로퍼티를 설정하기 위한 Key에 해당하는 값(value)을 설정한다.
Value Type string

(53) < application >< service-ref >< service-client >< port-info > <security>
Description 웹 서비스의 보안(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 웹 서비스를 호출하는 메시지에 보안을 적용하기 위한 설정이다.
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으로 나열한다. Timestamp, Encrypt, Signature, UsernameToken이 들어갈 수 있다. 각각의 항목은 공백으로 분리한다.
Value Type string

(56) < application >< service-ref >< service-client >< port-info >< security >< request-sender > <password-callback-class>
Description 패스워드를 설정하는 Callback 클래스의 전체 패키지 이름이다.
Value Type string

(57) < application >< service-ref >< service-client >< port-info >< security >< request-sender > <user>
Description UsernameToken에 들어갈 이름과 서명에 들어갈 Key의 별칭을 설정한다.
Value Type string

(58) < application >< service-ref >< service-client >< port-info >< security >< request-sender > <timeStamp>
Description TimeStamp에 적용할 ttl(timeToLive) aberration(오차), 서명 여부를 설정한다.
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 보내게 될 메시지의 유효기간을 초 단위로 설정한다.
Value Type positiveInteger

(60) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< timeStamp > <aberration>
Description 표준시와의 차이를 설정한다. 기본값은 0초이다.
Value Type integer

(61) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< timeStamp > <requireSignature>
Description Timestamp에 서명을 할지 여부를 설정한다. 기본값은 true이다.
Value Type boolean

(62) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< timeStamp > <precision>
Description 시스템 환경(네트워크, 처리지연 등)을 고려한 여유시간을 설정한다.
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를 설정한다. Password를 암호화해서 저장할 때에는 {algorithm}ciphertext와 같은 형식으로 입력한다. ex) {DES}FQrLbQ/D8O1lDVS71L28rw==
Value Type string

(65) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< userNameToken > <passwordType>
Description UsernameToken에 사용될 Password의 타입을 설정한다. PasswordDigest 혹은 PasswordText를 사용할 수 있다.
Value Type passwordTypeType
Defined Value

PasswordDigest

PasswordText

(66) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< userNameToken > <userTokenElements>
Description UsernameToken에 추가될 항목(Element)의 리스트이다. 각 항목은 공백으로 분리된다. nonce 혹은 created가 사용될 수 있다. passwordType이 PasswordDigest일 경우에 사용이 가능하다.
Value Type string

(67) < application >< service-ref >< service-client >< port-info >< security >< request-sender > <signature-infos>
Description 메시지에 서명을 하기 위한 설정이다.
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 메시지의 서명을 위한 설정이다. 복수 설정이 가능하다.
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 메시지의 특정 부분을 서명하고자 할 때 설정한다. "{}{http://schemas.xmlsoap.org/soap/envelope/}Body; Token"과 같은 방식으로 열거할 수 있다. 기본적으로 설정하지 않았을 경우에는 SOAP 바디 전체를 서명하게 된다.
Value Type string

(70) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos >< signature-info > <signatureAlgorithm>
Description 서명에 사용될 알고리듬을 명시한다. SHA1withRSA,SHA1WithDSA,HMACSHA1 중의 하나를 사용한다.
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 MessageDigest에 사용될 알고리듬을 명시한다. 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 방법을 명시한다. Exclusive XML Canonicalization omit comments, Exclusive XML Canonicalization with comments, Inclusive XML Canonicalization omit comments, Inclusive XML Canonicalization with comments 중의 하나를 사용한다.
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 서명에 사용될 Key의 정보를 표현하는 방식이다. IssuerSerial, DirectReference, SKIKeyIdentifier, X509KeyIdentifier 중의 하나를 사용한다.
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 메시지의 서명을 위한 개인 Key를 저장하고 있는 Keystore의 설정이다.
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 Keystore에 저장되는 Key의 타입을 설정한다(JKS 혹은 pkcs12).
Value Type string

(76) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos >< signature-info >< keystore > <keystore-password>
Description Keystore에 접근하기 위한 Password를 설정한다. Password를 암호화해서 저장할 때에는 {algorithm}ciphertext와 같은 형식으로 입력한다. ex) {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 Keystore의 파일 이름을 설정한다. 파일 이름만 입력할 경우, 클래스 경로에서 찾게 되므로 파일 이름이나 절대 경로를 포함하는 파일 이름을 입력한다.
Value Type string

(78) < application >< service-ref >< service-client >< port-info >< security >< request-sender > <encryption-infos>
Description 메시지를 암호화하기 위한 설정이다.
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 메시지를 암호화하기 위한 설정이다.
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 특정 부분을 암호화하기 위한 설정이다. "{mode}{ns}{localname};{mode}{ns}{localname};…" 과 같은 형식이다. 기본 모드의 값은 "content"이다.
Value Type string

(81) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <keyTransportAlogrithm>
Description MessageDigest에 사용될 알고리듬을 명시한다. RSA1.5 중의 하나를 사용한다.
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 암호화에 사용하는 알고리듬이다. AES_128, AES_256, TRIPLE_DES, AES_192를 지원한다.
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 암호화에 사용되는 Key의 별칭이다.
Value Type string

(84) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <keyIdentifier>
Description 암호화에 사용될 Key의 정보를 표현하는 방식이다. IssuerSerial, DirectReference, SKIKeyIdentifier, X509KeyIdentifier EmbeddedKeyName 중의 하나를 사용한다.
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 암호화에 사용될 Key의 저장소에 대해 설정한다.
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 Keystore에 저장되는 Key의 타입을 설정한다(JKS 혹은 pkcs12).
Value Type string

(87) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info >< keystore > <keystore-password>
Description Keystore에 접근하기 위한 Password를 설정한다. Password를 암호화해서 저장할 때에는 {algorithm}ciphertext와 같은 형식으로 입력한다. ex) {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 Keystore의 파일 이름을 설정한다. 파일 이름만 입력할 경우, 클래스 경로에서 찾게 되므로 파일 이름이나 절대 경로를 포함하는 파일 이름을 입력한다.
Value Type string

(89) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <embeddedKey>
Description 웹 서비스와 웹 서비스 클라이언트가 공유하고 있는 Key를 설정한다. keyIdentifier가 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 SessionKey를 사용하려면 Key의 Byte 정보를 가지고 있는 Callback 클래스를 설정한다.
Value Type string

(91) < application >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info >< embeddedKey > <key-name>
Description SessionKey의 이름을 설정한다.
Value Type string

(92) < application >< service-ref >< service-client >< port-info >< security > <response-receiver>
Description 웹 서비스 응답 메시지가 보안 적용이 되어있을 경우, 처리하기 위한 설정이다.
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 받게 되는 메시지가 어떤 보안이 적용되어 있어야 하는지 설정한다. Timestamp, Encrypt, Signature, UsernameToken이 들어갈 수 있다. 각각의 항목은 공백으로 분리한다.
Value Type string

(94) < application >< service-ref >< service-client >< port-info >< security >< response-receiver > <observeActionOrder>
Description Sender가 사용한 Action List의 순서와 Receiver의 Action List의 순서가 동일해야 하는지 여부를 설정한다.
Value Type boolean
Default Value true

(95) < application >< service-ref >< service-client >< port-info >< security >< response-receiver > <password-callback-class>
Description Password Callback 클래스의 이름을 전체 패키지 이름으로 입력한다.
Value Type string

(96) < application >< service-ref >< service-client >< port-info >< security >< response-receiver > <timeStamp>
Description TimeStamp에 적용할 ttl(timeToLive) aberration(오차)를 설정한다.
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 보내게 될 메시지의 유효기간을 초 단위로 설정한다.
Value Type positiveInteger

(98) < application >< service-ref >< service-client >< port-info >< security >< response-receiver >< timeStamp > <aberration>
Description 표준시와의 차이를 설정한다. 기본값은 0초이다.
Value Type integer

(99) < application >< service-ref >< service-client >< port-info >< security >< response-receiver >< timeStamp > <requireSignature>
Description Timestamp에 서명을 할지 여부를 설정한다. 기본값은 true이다.
Value Type boolean

(100) < application >< service-ref >< service-client >< port-info >< security >< response-receiver >< timeStamp > <precision>
Description 시스템 환경(네트워크, 처리지연 등)을 고려한 여유시간을 설정한다.
Value Type positiveInteger

(101) < application >< service-ref >< service-client >< port-info >< security >< response-receiver > <decryption>
Description 받는 메시지의 암호화된 부분을 해독하기 위한 설정이다.
Value Type decryptionType
Child Elements

(103) keystore

(102) < application >< service-ref >< service-client >< port-info >< security >< response-receiver >< decryption > <keystore>
Description 메시지의 암호를 해독하기 위한 Keystore의 설정이다.
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 Keystore에 저장되는 Key의 타입을 설정한다(JKS 혹은 pkcs12).
Value Type string

(104) < application >< service-ref >< service-client >< port-info >< security >< response-receiver >< decryption >< keystore > <keystore-password>
Description Keystore에 접근하기 위한 Password를 설정한다. Password를 암호화해서 저장할 때에는 {algorithm}ciphertext와 같은 형식으로 입력한다. ex) {DES}FQrLbQ/D8O1lDVS71L28rw==
Value Type string

(105) < application >< service-ref >< service-client >< port-info >< security >< response-receiver >< decryption >< keystore > <keystore-filename>
Description Keystore의 파일 이름을 설정한다. 파일 이름만 입력할 경우, 클래스 경로에서 찾게 되므로 파일 이름이나 절대 경로를 포함하는 파일 이름을 입력한다.
Value Type string

(106) < application >< service-ref >< service-client >< port-info >< security >< response-receiver > <signature-verification>
Description 받는 메시지의 서명을 검증하기 위한 설정이다.
Value Type signature-verificationType
Child Elements

(108) keystore

(107) < application >< service-ref >< service-client >< port-info >< security >< response-receiver >< signature-verification > <keystore>
Description 서명을 검증하기 위한 Keystore 설정이다.
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 Keystore에 저장되는 Key의 타입을 설정한다(JKS 혹은 pkcs12).
Value Type string

(109) < application >< service-ref >< service-client >< port-info >< security >< response-receiver >< signature-verification >< keystore > <keystore-password>
Description Keystore에 접근하기 위한 Password를 설정한다. Password를 암호화해서 저장할 때에는 {algorithm}ciphertext와 같은 형식으로 입력한다. ex) {DES}FQrLbQ/D8O1lDVS71L28rw==
Value Type string

(110) < application >< service-ref >< service-client >< port-info >< security >< response-receiver >< signature-verification >< keystore > <keystore-filename>
Description Keystore의 파일 이름을 설정한다. 파일 이름만 입력할 경우, 클래스 경로에서 찾게 되므로 파일 이름이나 절대 경로를 포함하는 파일 이름을 입력한다.
Value Type string

(111) < application >< service-ref >< service-client > <service-impl-class>
Description 웹 서비스 클라이언트를 위한 서비스 구현체를 설정한다. 배치의 경우에 자동 생성되므로 웹 서비스 배치자가 설정할 필요가 없다.
Value Type token

(112) < application >< service-ref >< service-client > <wsdl-override>
Description <service-ref>의 <wsdl-file>을 대체하기 위한 WSDL 파일의 위치를 표시한다. 표시된 위치는 유효한 URL이어야 한다.
Value Type string

(113) < application >< service-ref >< service-client > <require-dynamic-proxy>
Description Port Component Link를 사용할 때 ServiceReferenceFactory에서 Dynamic Proxy를 사용하도록 지시한다.
Value Type boolean

(114) < application >< service-ref >< service-client > <service-qname>
Description WSDL의 WSDL 서비스 정의를 표시한다.
Value Type QName

(115) < application >< service-ref >< service-client > <call-property>
Description WSDL 서비스에서 사용하는 모든 javax.xml.rpc.Call 객체에 설정하는 프로퍼티들을 표시한다.
Value Type nameValueType
Child Elements

(117) name

(118) value

(116) < application >< service-ref >< service-client >< call-property > <name>
Description javax.xml.rpc.Stub 또는 javax.xml.rpc.Call에 프로퍼티를 설정하기 위한 Key 이름을 설정한다.
Value Type string

(117) < application >< service-ref >< service-client >< call-property > <value>
Description javax.xml.rpc.Stub 또는 javax.xml.rpc.Call에 프로퍼티를 설정하기 위한 Key에 해당하는 값(value)을 설정한다.
Value Type string

(118) < application > <message-destination>
Description application.xml의 <message-destination>에 선언된 Message Destination과 JNDI에 등록된 실제 Destination객체를 매핑한다.
Value Type jndi-refType
Child Elements

(120) jndi-info

(119) < application >< message-destination > <jndi-info>
Description Environment Entry에 사용되는 Logical 이름을 실제 JNDI 이름으로 매핑한다. 예를 들면 "jdbc/myDataSource"로 사용된 Environment Entry 이름을 실제 JNDI 이름인 "DataSource1"으로 매핑한다.
Value Type jndi-infoType
Child Elements

(121) ref-name

(122) export-name

(120) < application >< message-destination >< jndi-info > <ref-name>
Description 소스코드에서 사용할 수 있는 참조 이름을 선언할 수 있다.
Value Type valuableToken
Value Description 실제 JNDI 이름에 바인드될 참조 이름이다. 이것은 해당하는 J2EE 표준 Descriptor 항목의 Ref Name에 대응된다.

(121) < application >< message-destination >< jndi-info > <export-name>
Description JEUS DD에 정의된 실제 JNDI 이름을 설정한다.
Value Type token

(122) < application > <deploy-modules-concurrently>
Description EAR에 속한 module들에 대해서 concurrent deploy를 수행할지의 여부를 결정한다. 다만 application.xml의 initialize-in-order가 true인 경우에는 이 설정값과 관계 없이 EAR에 속한 module들을 순서대로 deploy한다. 즉 이 설정은 initialize-in-order가 false인 경우에만 유효하다.
Value Type boolean
Default Value false

(123) < application > <classloading>
Description 애플리케이션 수행 시 필요한 클래스 로딩에 관한 설정을 한다.
Value Type classloadType
Child Elements

(125) local-lib-first

(124) < application >< classloading > <local-lib-first>
Description 클래스를 로딩할 때 애플리케이션에 지정된 클래스 패스 내에서 먼저 찾을 것인지 여부를 설정한다. true로 설정할 경우 중복된 클래스로 인한 ClassCastException을 주의해야 한다.
Value Type boolean
Default Value false

(125) < application > <batch-thread-pool>
Description JBatch(JSR-352) 애플리케이션이 작동하기 위한 환경을 제공한다. 값이 설정되지 않을 경우, 컨테이너 내부적으로 JBatch 서비스를 실행가능한 최소한의 스레드풀 사이즈를 가진다.
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 Thread Pool에서 관리하는 스레드 수의 최솟값이다.
Value Type nonNegativeIntType
Default Value 0

(127) < application >< batch-thread-pool > <max>
Description Thread Pool에서 관리하는 스레드 수의 최댓값이다.
Value Type nonNegativeIntType
Default Value 10

(128) < application >< batch-thread-pool > <keep-alive-time>
Description Min 이하의 스레드에 대해서 설정된 시간 동안 사용되지 않는다면 자동적으로 Thread Pool에서 제거된다. 0이면 제거하지 않는다.
Value Type nonNegativeLongType
Value Description 밀리세컨드 단위로 설정한다.
Default Value 60000

(129) < application >< batch-thread-pool > <queue-size>
Description Thread Pool이 처리하는 업무 개체를 저장하는 Queue의 크기를 지정한다.
Value Type nonNegativeIntType
Default Value 4096

(130) < application >< batch-thread-pool > <stuck-thread-handling>
Description 스레드가 특정 업무 때문에 일정 시간 이상 계속 점유된 상태일 경우, 해당 스레드에 대해서 특정 액션을 취하기 위한 설정이다.
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 스레드를 Stuck Thread로 판단하는 기준이 되는 값을 설정한다. 설정된 시간 이상 계속 점유된 상태이면 해당 스레드를 Stuck Thread로 간주한다.
Value Type nonNegativeLongType
Value Description 밀리세컨드 단위로 설정한다.
Default Value 3600000

(132) < application >< batch-thread-pool >< stuck-thread-handling > <action-on-stuck-thread>
Description Stuck Thread로 판단된 경우 그 쓰레드에 대해 특정 액션을 취하기 위한 설정이다.
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 Stuck Thread 의 상태를 체크하는 주기를 설정한다.
Value Type nonNegativeLongType
Value Description 밀리세컨드 단위로 설정한다.
Default Value 300000

(134) < application >< batch-thread-pool >< stuck-thread-handling > <user-warning-class>
Description action-on-stuck-thread를 Warning으로 설정된 경우에 default는 thread dump를 찍어주도록 되어있으나, 사용자가 원하는 작업을 할 수 있도록 직접 클래스를 작성하고 싶을 때 이 설정을 사용한다. 해당 클래스는 jeus.util.pool.Warning를 반드시 implement 해야 하며, jeus.util.pool.Warning interface는 jclient.jar에서 찾을 수 있다. 클래스를 작성한 후에 사용하고 싶은 대상 서버의 SERVER_HOME/lib/application에 위치시킨다.
Value Type string
Value Description fullyQualifedClass 이름을 사용한다. ex) test.stuck.UserWarning

22.4. jeus-application-dd.xml 파일 예제

[예 22.1] jeus-application-dd.xml 파일 예제

<?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>

이전   다음
제21장 jeus-client-dd.xml 설정 처음으로 제23장 jeus-webservices-dd.xml 설정