제21장 jeus-client-dd.xml 설정

내용 목차

21.1. 소개
21.2. XML Schema/XML 트리
21.3. Element Reference
21.4. jeus-client-dd.xml 파일 예제

여기에서 클라이언트 모듈의 DD인 jeus-client-dd.xml에서 사용되는 설정을 찾을 수 있다.

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

  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: 자신의 태그 안에 사용하는 태그.

(1) <jeus-client-dd>
Description 단일 JEUS 클라이언트 모듈의 최상위 항목으로, 각각의 jeus-client-dd.xml 파일에는 이 설정 항목이 반드시 존재한다.
Value Type jeus-client-ddType
Child Elements

(3) module-info

(7) system-logging

(68) security-info

(72) java-security-permission

(75) scheduler

(103) env

(107) ejb-ref

(111) res-ref

(115) res-env-ref

(119) message-destination-ref

(123) service-ref

(2) < jeus-client-dd > <module-info>
Description 클라이언트 애플리케이션에 대한 정보를 설정한다.
Value Type client-module-infoType
Child Elements

(4) module-name

(5) app-main-class

(6) app-argument

(3) < jeus-client-dd >< module-info > <module-name>
Description 클라이언트 애플리케이션에 지정되는 모듈 이름을 설정한다. @Deprecated. 이 속성은 Java EE 6부터 Application Client Standard Deployment Descriptor(application-client.xml)에서 지원하므로, 해당 설정을 이용하도록 한다.
Value Type token

(4) < jeus-client-dd >< module-info > <app-main-class>
Description 클라이언트 애플리케이션의 메인 클래스의 Fully Qualified Class Name을 설정한다.
Value Type token

(5) < jeus-client-dd >< module-info > <app-argument>
Description 클라이언트 애플리케이션이 실행될 때 사용되는 애플리케이션 Argument를 지정한다.
Value Type token

(6) < jeus-client-dd > <system-logging>
Description 클라이언트 애플리케이션 컨테이너가 사용하는 Logger를 설정한다.
Value Type system-loggingType
Child Elements

(8) name

(9) level

(10) use-parent-handlers

(11) filter-class

(12) formatter-pattern

(13) handler

(7) < jeus-client-dd >< system-logging > <name>
Description Logger에 대해 설정을 적용할 때 해당 Logger Name을 지정한다. Logger의 이름을 알고 싶을 때는 Logger 페이지를 별도로 참고한다.
Value Type valuableToken

(8) < jeus-client-dd >< system-logging > <level>
Description Logger의 레벨을 설정한다. 각 레벨의 의미는 Java SE Logging API의 "Level Class Documentation"을 참고한다.
Value Type loggingLevelType
Default Value INFO
Defined Value

OFF

SEVERE

WARNING

INFO

CONFIG

FINE

FINER

FINEST

ALL

(9) < jeus-client-dd >< system-logging > <use-parent-handlers>
Description 상위 Logger의 핸들러를 이 Logger에서도 사용할지를 결정한다. 기본값은 true로 상위 Logger의 핸들러를 사용해서 로그 메시지를 출력한다. 단, "jeus" Logger의 경우는 Root Logger이기 때문에 false로 설정한다. 웹 액세스 로그의 경우, 웹 엔진 액세스 로거에서는 이 설정은 의미가 없다. 가상 호스트 별 액세스 로거에서는 이 설정을 false로 하면 웹 엔진 전체의 액세스 로그에 가상 호스트 별 액세스 로그를 남기지 않는다.
Value Type boolean
Default Value true

(10) < jeus-client-dd >< system-logging > <filter-class>
Description Logger에 지정할 필터 클래스의 Fully Qualified Class Name을 설정한다. 필터 클래스에 구현한 내용을 바탕으로 로그 메시지들이 필터링되어 출력된다.
Value Type valuableToken

(11) < jeus-client-dd >< system-logging > <formatter-pattern>
Description 이 Logger의 핸들러가 출력하는 로그의 출력 패턴을 설정한다. 희망하는 로그의 출력 패턴을 지정하면 jeus.util.logging.PatternFormatter에서 해당 패턴을 바탕으로 로그 메시지를 Formatting하여 출력한다. 단, 입력 패턴에는 %를 형식 문자 입력 외에는 사용할 수 없다. 지원하는 형식 문자는 총 9가지(%d, %l, %J, %T, %c, %M, %N, %a, %m)이며 각 형식 문자의 의미는 "JEUS Server 안내서"의 "8.3. Logging 설정"을 참고한다.
Value Type valuableToken
Default Value [%d{yyyy.MM.dd HH:mm:ss}][%l] [%J-%T] [%M-%N] %m

(12) < jeus-client-dd >< system-logging > <handler>
Description Logger에서 사용할 핸들러를 설정한다.
Value Type handlerType
Child Elements

(14) file-handler

(30) smtp-handler

(46) socket-handler

(53) user-handler

(13) < jeus-client-dd >< system-logging >< handler > <file-handler>
Description Logger를 파일로 출력하고자 할 경우에 사용하는 핸들러이다.
Value Type file-handlerType
Child Elements

(15) name

(16) level

(17) encoding

(18) filter-class

(19) file-name

(20) permission

(21) chown

(22) enable-rotation

(23) rotation-count

(24) rotation-dir

(25) valid-day

(26) valid-hour

(27) valid-size

(28) buffer-size

(29) append

(14) < jeus-client-dd >< system-logging >< handler >< file-handler > <name>
Description 핸들러의 이름을 설정한다. 핸들러 이름은 하나의 Logger 내에서 유일해야 하며, 설정된 이름은 관리 도구(WebAdmin 등의 툴) 등에서 핸들러를 지칭할 때 사용한다.
Value Type valuableToken

(15) < jeus-client-dd >< system-logging >< handler >< file-handler > <level>
Description 핸들러의 레벨을 설정한다. Logger를 통과한 메시지의 레벨이 해당 핸들러 레벨에 포함될 경우에만 핸들러에 의해 출력된다.
Value Type loggingLevelType
Default Value FINEST
Defined Value

OFF

SEVERE

WARNING

INFO

CONFIG

FINE

FINER

FINEST

ALL

(16) < jeus-client-dd >< system-logging >< handler >< file-handler > <encoding>
Description 핸들러가 메시지를 남길 때 사용할 Encoding을 설정한다.
Value Type valuableToken

(17) < jeus-client-dd >< system-logging >< handler >< file-handler > <filter-class>
Description 핸들러에 지정할 필터 클래스의 Fully Qualified Class Name을 설정한다. 필터 클래스에 구현한 내용을 바탕으로 로그 메시지들이 필터링되어서 출력된다.
Value Type valuableToken

(18) < jeus-client-dd >< system-logging >< handler >< file-handler > <file-name>
Description 핸들러가 사용할 파일 이름을 설정한다. 만약, User가 이 설정을 하지 않으면 각 Logger의 Default File Name이 사용된다. 각각의 Default File Name은 "JEUS Server 안내서"를 참고한다.
Value Type token

(19) < jeus-client-dd >< system-logging >< handler >< file-handler > <permission>
Description Log 파일의 접근 권한 설정을 한다. 9자리의 r,w,x,-로 이루어진 log permission을 주도록 한다. (주의: Unix 계열의 OS에서만 유효한 옵션)
Value Type string

(20) < jeus-client-dd >< system-logging >< handler >< file-handler > <chown>
Description Log 파일의 소유자, 소유그룹 설정을 한다. ,(comma)로 구분하는 소유자와 소유그룹을 순서대로 주도록 한다.
Value Type string

(21) < jeus-client-dd >< system-logging >< handler >< file-handler > <enable-rotation>
Description 핸들러가 사용하는 파일이 Log File Rotation 기능을 사용할지 여부를 설정한다. 별도로 설정하지 않으면 true로 설정되고, 파일에 Logging할 때 Rotation 기능을 사용한다.
Value Type boolean
Value Description Boolean 타입으로, 기본값은 true이다.
Default Value true

(22) < jeus-client-dd >< system-logging >< handler >< file-handler > <rotation-count>
Description 핸들러가 사용하는 파일이 Log File Rotation 기능을 사용할 때 백업할 파일의 개수를 설정한다. 만약, 설정하지 않고 File Size로 Rotation할 경우에는 99999개 까지 쌓이고, 날짜나 시간으로 Rotation할 경우에는 Rotation된 파일은 계속 쌓인다.
Value Type off-intType

(23) < jeus-client-dd >< system-logging >< handler >< file-handler > <rotation-dir>
Description 핸들러가 사용하는 파일이 Log File Rotation 기능을 사용할 때 Rotation된 파일이 저장될 위치를 설정한다. 설정하지 않으면 현재 Logging을 하고 있는 파일의 디렉터리에 저장된다.
Value Type string

(24) < jeus-client-dd >< system-logging >< handler >< file-handler > <valid-day>
Description 핸들러가 사용하는 파일을 설정한 기간 동안만 사용하고 계속 갱신할 경우에 사용한다. 이 설정은 날짜 단위로 파일을 바꿀 때 사용한다. 이 경우 핸들러가 사용하는 파일 이름 뒤에 파일이 사용된 날짜가 자동으로 붙게 된다.
Value Type off-intType
Value Description 날짜를 나타내는 값으로 정수이다. Valid Day, Valid Hour, Valid Size를 설정하지 않은 경우 Valid Day를 1로 설정한 것과 동일하게 동작한다.
Default Value 1

(25) < jeus-client-dd >< system-logging >< handler >< file-handler > <valid-hour>
Description 핸들러가 사용하는 파일을 Valid Hour에 지정된 기간 동안만 사용하고 계속 갱신할 경우에 사용한다. 이 설정은 시간 단위로 파일을 바꿀 때 사용한다. 이 경우 핸들러가 사용하는 파일 이름 뒤에 파일이 사용된 날짜와 시간이 자동으로 붙게 된다.
Value Type off-intType
Value Description 시간을 나타내는 값으로 정수이다.

(26) < jeus-client-dd >< system-logging >< handler >< file-handler > <valid-size>
Description 핸들러가 사용하는 파일이 Valid Size에 지정한 크기보다 작을 때까지만 사용하고 계속 갱신할 경우에 사용한다. 이 설정은 사이즈 단위로 파일을 바꿀 때 사용한다. 이 경우 핸들러가 사용하는 파일 이름 뒤에 순차적으로 Index가 붙게 된다.
Value Type off-intType
Value Description 사이즈를 나타내며 단위는 kb이다.

(27) < jeus-client-dd >< system-logging >< handler >< file-handler > <buffer-size>
Description 핸들러가 파일에 출력할 때 사용하는 Buffer의 크기를 지정한다.
Value Type nonNegativeIntType
Value Description Byte 단위이고 기본값은 1024이다.
Default Value 1024

(28) < jeus-client-dd >< system-logging >< handler >< file-handler > <append>
Description 핸들러가 사용하는 파일이 이미 존재하는 경우 파일 뒤에 덧붙여 사용할지를 결정한다. false로 설정되어 있다면 Enable Rotation이 true로 설정된 경우에는 Boot Time에 Rotation을 하고 Enable Rotation이 false로 설정된 경우에는 기존의 파일에 덮어쓴다.
Value Type boolean
Value Description Boolean 타입이고, 기본값은 true이다.
Default Value true

(29) < jeus-client-dd >< system-logging >< handler > <smtp-handler>
Description Logger를 e-mail로 보내고자 할 경우에 사용하는 핸들러이다.
Value Type smtp-handlerType
Child Elements

(31) name

(32) level

(33) encoding

(34) filter-class

(35) smtp-host-address

(36) sender-id

(37) sender-password

(38) from-address

(39) to-address

(40) property

(43) cc-address

(44) bcc-address

(45) send-for-all-messages

(30) < jeus-client-dd >< system-logging >< handler >< smtp-handler > <name>
Description 핸들러의 이름을 설정한다. 핸들러 이름은 하나의 Logger 내에서 유일해야 하며, 설정된 이름은 관리 도구(WebAdmin 등의 툴) 등에서 핸들러를 지칭할 때 사용한다.
Value Type valuableToken

(31) < jeus-client-dd >< system-logging >< handler >< smtp-handler > <level>
Description 핸들러의 레벨을 설정한다. Logger를 통과한 메시지의 레벨이 해당 핸들러 레벨에 포함될 경우에만 핸들러에 의해 출력된다.
Value Type loggingLevelType
Default Value FINEST
Defined Value

OFF

SEVERE

WARNING

INFO

CONFIG

FINE

FINER

FINEST

ALL

(32) < jeus-client-dd >< system-logging >< handler >< smtp-handler > <encoding>
Description 핸들러가 메시지를 남길 때 사용할 Encoding을 설정한다.
Value Type valuableToken

(33) < jeus-client-dd >< system-logging >< handler >< smtp-handler > <filter-class>
Description 핸들러에 지정할 필터 클래스의 Fully Qualified Class Name을 설정한다. 필터 클래스에 구현한 내용을 바탕으로 로그 메시지들이 필터링되어서 출력된다.
Value Type valuableToken

(34) < jeus-client-dd >< system-logging >< handler >< smtp-handler > <smtp-host-address>
Description e-mail을 보낼 SMTP 서버의 주소를 지정한다.
Value Type valuableToken

(35) < jeus-client-dd >< system-logging >< handler >< smtp-handler > <sender-id>
Description e-mail을 보낼 sender의 id를 지정한다.
Value Type valuableToken

(36) < jeus-client-dd >< system-logging >< handler >< smtp-handler > <sender-password>
Description e-mail을 보낼 sender의 password를 지정한다. 암호화해서 저장할 때에는 '{암호화할 알고리듬}암호화된 password'와 같은 형식으로 입력한다.
Value Type valuableToken

(37) < jeus-client-dd >< system-logging >< handler >< smtp-handler > <from-address>
Description e-mail을 보내는 사람의 주소를 지정한다.
Value Type valuableToken

(38) < jeus-client-dd >< system-logging >< handler >< smtp-handler > <to-address>
Description e-mail을 받는 사람의 주소를 지정한다.
Value Type valuableToken

(39) < jeus-client-dd >< system-logging >< handler >< smtp-handler > <property>
Description 이용하는 mail서버에 특정한 smtp 프로퍼티를 지정한다. schema에 명시된 property와 겹치는 경우에는 schema의 값을 따른다.
Value Type propertyType
Child Elements

(41) key

(42) value

(40) < jeus-client-dd >< system-logging >< handler >< smtp-handler >< property > <key>
Description 프로퍼티의 Key 값이다.
Value Type valuableToken

(41) < jeus-client-dd >< system-logging >< handler >< smtp-handler >< property > <value>
Description 프로퍼티의 Value 값이다.
Value Type valuableToken

(42) < jeus-client-dd >< system-logging >< handler >< smtp-handler > <cc-address>
Description e-mail을 참조로 받는 사람의 주소를 지정한다.
Value Type valuableToken

(43) < jeus-client-dd >< system-logging >< handler >< smtp-handler > <bcc-address>
Description e-mail을 숨은 참조로 받는 사람의 주소를 지정한다.
Value Type valuableToken

(44) < jeus-client-dd >< system-logging >< handler >< smtp-handler > <send-for-all-messages>
Description 핸들러로 들어왔을 때 이를 e-mail로 보낼 대상으로 여길지를 설정한다. false로 설정되어 있으면 Logger의 특별한 send() 메소드로 호출된 메시지들만 e-mail로 전송된다. 즉, 처음부터 e-mail로 보낼 의도로 지정된 메시지들만 e-mail로 전송된다.
Value Type boolean
Default Value false

(45) < jeus-client-dd >< system-logging >< handler > <socket-handler>
Description Logger를 지정된 소켓으로 보내고자 할 경우에 사용하는 핸들러이다.
Value Type socket-handlerType
Child Elements

(47) name

(48) level

(49) encoding

(50) filter-class

(51) address

(52) port

(46) < jeus-client-dd >< system-logging >< handler >< socket-handler > <name>
Description 핸들러의 이름을 설정한다. 핸들러 이름은 하나의 Logger 내에서 유일해야 하며, 설정된 이름은 관리 도구(WebAdmin 등의 툴) 등에서 핸들러를 지칭할 때 사용한다.
Value Type valuableToken

(47) < jeus-client-dd >< system-logging >< handler >< socket-handler > <level>
Description 핸들러의 레벨을 설정한다. Logger를 통과한 메시지의 레벨이 해당 핸들러 레벨에 포함될 경우에만 핸들러에 의해 출력된다.
Value Type loggingLevelType
Default Value FINEST
Defined Value

OFF

SEVERE

WARNING

INFO

CONFIG

FINE

FINER

FINEST

ALL

(48) < jeus-client-dd >< system-logging >< handler >< socket-handler > <encoding>
Description 핸들러가 메시지를 남길 때 사용할 Encoding을 설정한다.
Value Type valuableToken

(49) < jeus-client-dd >< system-logging >< handler >< socket-handler > <filter-class>
Description 핸들러에 지정할 필터 클래스의 Fully Qualified Class Name을 설정한다. 필터 클래스에 구현한 내용을 바탕으로 로그 메시지들이 필터링되어서 출력된다.
Value Type valuableToken

(50) < jeus-client-dd >< system-logging >< handler >< socket-handler > <address>
Description 핸들러가 생성될 때 메시지들을 보낼 곳의 IP 주소를 설정한다.
Value Type valuableToken

(51) < jeus-client-dd >< system-logging >< handler >< socket-handler > <port>
Description 핸들러가 생성될 때 메시지들을 보낼 곳의 포트 번호를 설정한다.
Value Type nonNegativeIntType

(52) < jeus-client-dd >< system-logging >< handler > <user-handler>
Description User가 Java SE Logging API에 따라 생성한 핸들러를 사용할 경우의 설정이다.
Value Type user-handlerType
Child Elements

(54) name

(55) level

(56) encoding

(57) filter-class

(58) handler-class

(59) handler-property

(63) formatter-pattern

(64) formatter-property

(53) < jeus-client-dd >< system-logging >< handler >< user-handler > <name>
Description 핸들러의 이름을 설정한다. 핸들러 이름은 하나의 Logger 내에서 유일해야 하며, 설정된 이름은 관리 도구(WebAdmin 등의 툴) 등에서 핸들러를 지칭할 때 사용한다.
Value Type valuableToken

(54) < jeus-client-dd >< system-logging >< handler >< user-handler > <level>
Description 핸들러의 레벨을 설정한다. Logger를 통과한 메시지의 레벨이 해당 핸들러 레벨에 포함될 경우에만 핸들러에 의해 출력된다.
Value Type loggingLevelType
Default Value FINEST
Defined Value

OFF

SEVERE

WARNING

INFO

CONFIG

FINE

FINER

FINEST

ALL

(55) < jeus-client-dd >< system-logging >< handler >< user-handler > <encoding>
Description 핸들러가 메시지를 남길 때 사용할 Encoding을 설정한다.
Value Type valuableToken

(56) < jeus-client-dd >< system-logging >< handler >< user-handler > <filter-class>
Description 핸들러에 지정할 필터 클래스의 Fully Qualified Class Name을 설정한다. 필터 클래스에 구현한 내용을 바탕으로 로그 메시지들이 필터링되어서 출력된다.
Value Type valuableToken

(57) < jeus-client-dd >< system-logging >< handler >< user-handler > <handler-class>
Description User가 생성한 핸들러의 Fully Qualified Class Name을 설정한다.이 클래스는 java.util.logging.Handler를 상속받고 jeus.util.logging.JeusHandler를 구현해야 한다.
Value Type valuableToken

(58) < jeus-client-dd >< system-logging >< handler >< user-handler > <handler-property>
Description 핸들러가 생성될 때 넘겨줄 프로퍼티를 설정한다. 이 프로퍼티들은 Key Value로 Map 객체에 저장되어 JeusHandler.setProperty() 메소드를 통해 핸들러로 전달된다.
Value Type handlerPropertySetType
Child Elements

(60) property

(59) < jeus-client-dd >< system-logging >< handler >< user-handler >< handler-property > <property>
Description 핸들러 등에게 전달할 프로퍼티들을 설정한다.
Value Type propertyType
Child Elements

(61) key

(62) value

(60) < jeus-client-dd >< system-logging >< handler >< user-handler >< handler-property >< property > <key>
Description 프로퍼티의 Key 값이다.
Value Type valuableToken

(61) < jeus-client-dd >< system-logging >< handler >< user-handler >< handler-property >< property > <value>
Description 프로퍼티의 Value 값이다.
Value Type valuableToken

(62) < jeus-client-dd >< system-logging >< handler >< user-handler > <formatter-pattern>
Description 이 Logger의 핸들러가 출력하는 로그의 출력 패턴을 설정한다. 희망하는 로그의 출력 패턴을 지정하면 jeus.util.logging.PatternFormatter에서 해당 패턴을 바탕으로 로그 메시지를 Formatting하여 출력한다.
Value Type valuableToken
Default Value [%d{yyyy.MM.dd HH:mm:ss}][%l] [%J-%T] [%M-%N] %m

(63) < jeus-client-dd >< system-logging >< handler >< user-handler > <formatter-property>
Description 핸들러가 생성될 때 함께 생성된 Formatter에게 넘겨줄 프로퍼티를 설정한다. 이 프로퍼티들은 Key Value로 Map 객체에 저장되어 JeusFormatter.setProperty() 메소드를 통해 Formatter로 전달된다.
Value Type handlerPropertySetType
Child Elements

(65) property

(64) < jeus-client-dd >< system-logging >< handler >< user-handler >< formatter-property > <property>
Description 핸들러 등에게 전달할 프로퍼티들을 설정한다.
Value Type propertyType
Child Elements

(66) key

(67) value

(65) < jeus-client-dd >< system-logging >< handler >< user-handler >< formatter-property >< property > <key>
Description 프로퍼티의 Key 값이다.
Value Type valuableToken

(66) < jeus-client-dd >< system-logging >< handler >< user-handler >< formatter-property >< property > <value>
Description 프로퍼티의 Value 값이다.
Value Type valuableToken

(67) < jeus-client-dd > <security-info>
Description 클라이언트 애플리케이션이 실행될 때 Security 인증을 위한 여러 가지 정보를 설정한다.
Value Type security-infoType
Child Elements

(69) provider-node-name

(70) user

(71) passwd

(68) < jeus-client-dd >< security-info > <provider-node-name>
Description 클라이언트 애플리케이션이 실행될 때 Security 인증을 수행할 서버를 지정한다.
Value Type token

(69) < jeus-client-dd >< security-info > <user>
Description 클라이언트 애플리케이션이 실행될 때 사용하는 Security Context의 Username을 지정한다.
Value Type token

(70) < jeus-client-dd >< security-info > <passwd>
Description 클라이언트 애플리케이션이 실행될 때 사용하는 Security Context의 Password를 지정한다. Password를 암호화해서 저장할 때에는 {algorithm}ciphertext와 같은 형식으로 입력한다. ex) {DES}FQrLbQ/D8O1lDVS71L28rw==
Value Type token

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

(73) security-permission-spec

(74) description

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

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

(74) < jeus-client-dd > <scheduler>
Description 클라이언트 컨테이너에서 사용할 Scheduler의 설정이다.
Value Type schedulerType
Child Elements

(76) enabled

(77) pooling

(90) job-list

(75) < jeus-client-dd >< scheduler > <enabled>
Description Scheduler 서비스의 구동 여부를 지정한다.
Value Type boolean
Default Value false

(76) < jeus-client-dd >< scheduler > <pooling>
Description Scheduler에서 멀티 스레드로 Job을 실행할 때 사용하는 Thread Pool을 설정한다.
Value Type thread-poolingType
Child Elements

(78) shared

(80) dedicated

(77) < jeus-client-dd >< scheduler >< pooling > <shared>
Description 서버 전반적으로 공유할 Thread Pool을 사용한다.
Value Type shared-poolType
Child Elements

(79) reserved-thread-num

(78) < jeus-client-dd >< scheduler >< pooling >< shared > <reserved-thread-num>
Description 서버 전반적으로 공유할 Thread Pool을 사용하는 경우 다른 서비스가 스레드를 모두 점유하면 스레드 할당을 받지 못할 수 있다. 따라서 특별히 이 서비스를 위한 스레드를 미리 할당하고 싶을 경우에 설정한다. 설정값은 다른 서비스 들과 합산했을 때 System Thread Pool의 최댓값을 넘지 않도록 해야 한다.
Value Type nonNegativeIntType
Default Value 0

(79) < jeus-client-dd >< scheduler >< pooling > <dedicated>
Description 서비스별 전용 Thread Pool을 사용한다.
Value Type dedicated-poolType
Child Elements

(81) min

(82) max

(83) keep-alive-time

(84) queue-size

(85) stuck-thread-handling

(80) < jeus-client-dd >< scheduler >< pooling >< dedicated > <min>
Description Thread Pool에서 관리하는 스레드 수의 최솟값이다.
Value Type nonNegativeIntType
Default Value 0

(81) < jeus-client-dd >< scheduler >< pooling >< dedicated > <max>
Description Thread Pool에서 관리하는 스레드 수의 최댓값이다.
Value Type nonNegativeIntType
Default Value 10

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

(83) < jeus-client-dd >< scheduler >< pooling >< dedicated > <queue-size>
Description Thread Pool이 처리하는 업무 개체를 저장하는 Queue의 크기를 지정한다.
Value Type nonNegativeIntType
Default Value 4096

(84) < jeus-client-dd >< scheduler >< pooling >< dedicated > <stuck-thread-handling>
Description 스레드가 특정 업무 때문에 일정 시간 이상 계속 점유된 상태일 경우, 해당 스레드에 대해서 특정 액션을 취하기 위한 설정이다.
Value Type stuck-thread-handlingType
Child Elements

(86) max-stuck-thread-time

(87) action-on-stuck-thread

(88) stuck-thread-check-period

(89) user-warning-class

(85) < jeus-client-dd >< scheduler >< pooling >< dedicated >< stuck-thread-handling > <max-stuck-thread-time>
Description 스레드를 Stuck Thread로 판단하는 기준이 되는 값을 설정한다. 설정된 시간 이상 계속 점유된 상태이면 해당 스레드를 Stuck Thread로 간주한다.
Value Type nonNegativeLongType
Value Description 밀리세컨드 단위로 설정한다.
Default Value 3600000

(86) < jeus-client-dd >< scheduler >< pooling >< dedicated >< 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

(87) < jeus-client-dd >< scheduler >< pooling >< dedicated >< stuck-thread-handling > <stuck-thread-check-period>
Description Stuck Thread 의 상태를 체크하는 주기를 설정한다.
Value Type nonNegativeLongType
Value Description 밀리세컨드 단위로 설정한다.
Default Value 300000

(88) < jeus-client-dd >< scheduler >< pooling >< dedicated >< 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

(89) < jeus-client-dd >< scheduler > <job-list>
Description Scheduler에 등록할 Job List을 지정한다.
Value Type job-listType
Child Elements

(91) job

(90) < jeus-client-dd >< scheduler >< job-list > <job>
Description Scheduler에 등록할 하나의 Job을 지정한다.
Value Type jobType
Child Elements

(92) name

(93) class-name

(94) interval

(99) description

(100) begin-time

(101) end-time

(102) count

(91) < jeus-client-dd >< scheduler >< job-list >< job > <name>
Description Job의 이름을 지정한다(ID에 대한 Validation작업이 필요).
Value Type valuableToken

(92) < jeus-client-dd >< scheduler >< job-list >< job > <class-name>
Description Job을 수행하는 클래스의 Fully Qualified Name을 설정한다.
Value Type valuableToken

(93) < jeus-client-dd >< scheduler >< job-list >< job > <interval>
Description Job이 수행되는 주기를 지정한다.
Value Type intervalType
Child Elements

(95) millisecond

(96) minutely

(97) hourly

(98) daily

(94) < jeus-client-dd >< scheduler >< job-list >< job >< interval > <millisecond>
Description 주기를 밀리세컨드 단위로 지정한다.
Value Type long

(95) < jeus-client-dd >< scheduler >< job-list >< job >< interval > <minutely>
Description 주기를 분 단위로 지정한다.
Value Type nonNegativeIntType

(96) < jeus-client-dd >< scheduler >< job-list >< job >< interval > <hourly>
Description 주기를 시간 단위로 지정한다.
Value Type nonNegativeIntType

(97) < jeus-client-dd >< scheduler >< job-list >< job >< interval > <daily>
Description 주기를 날짜 단위로 지정한다.
Value Type nonNegativeIntType

(98) < jeus-client-dd >< scheduler >< job-list >< job > <description>
Description Job의 설명을 입력할 수 있다.
Value Type valuableToken

(99) < jeus-client-dd >< scheduler >< job-list >< job > <begin-time>
Description Job의 시작시간을 지정한다. 설정되지 않으면 Job은 바로 시작된다. 입력 양식은 xs:dateTime type에 따른다.
Value Type dateTime

(100) < jeus-client-dd >< scheduler >< job-list >< job > <end-time>
Description Job의 종료시간을 지정한다. 설정되지 않으면 Job은 종료되지 않는다. 입력 양식은 xs:dateTime type에 따른다.
Value Type dateTime

(101) < jeus-client-dd >< scheduler >< job-list >< job > <count>
Description Job의 수행 횟수를 지정한다.
Value Type long
Default Value -1

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

(104) name

(105) value

(106) type

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

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

(105) < jeus-client-dd >< 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의 자바 타입 중 하나를 선택해야 한다.

(106) < jeus-client-dd > <ejb-ref>
Description 코드에서 사용하는 EJB 참조를 실제 EJB JNDI 이름으로 바인드한다.
Value Type jndi-refType
Child Elements

(108) jndi-info

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

(109) ref-name

(110) export-name

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

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

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

(112) jndi-info

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

(113) ref-name

(114) export-name

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

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

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

(116) jndi-info

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

(117) ref-name

(118) export-name

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

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

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

(120) jndi-info

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

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

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

(124) service-client

(123) < jeus-client-dd >< service-ref > <service-client>
Description 배치되는 웹 서비스 클라이언트를 위한 설정들을 표시한다.
Value Type serviceClientType
Child Elements

(125) service-ref-name

(126) port-info

(193) service-impl-class

(194) wsdl-override

(195) require-dynamic-proxy

(196) service-qname

(197) call-property

(124) < jeus-client-dd >< service-ref >< service-client > <service-ref-name>
Description WSDL 파일에서 관련된 웹 서비스 Endpoint 이름이다. 표준 배치 서술자 web.xml 혹은 ejb-jar.xml의 <service-ref-name>에 해당하는 설정이다.
Value Type token

(125) < jeus-client-dd >< service-ref >< service-client > <port-info>
Description 배치되는 웹 서비스 클라이언트가 호출하는 웹 서비스 포트 정보를 설정한다.
Value Type portInfoType
Child Elements

(127) service-endpoint-interface

(128) wsdl-port

(129) stub-property

(132) call-property

(135) security

(126) < jeus-client-dd >< service-ref >< service-client >< port-info > <service-endpoint-interface>
Description WSDL 포트의 Service Endpoint 인터페이스를 나타내는 클래스를 표시한다. <service-ref> 설정에서 <port-component-ref>의 <service-endpoint-interface>에 해당하는 설정이다.
Value Type token

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

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

(130) name

(131) value

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

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

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

(133) name

(134) value

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

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

(134) < jeus-client-dd >< service-ref >< service-client >< port-info > <security>
Description 웹 서비스의 보안(WS-Security)을 위한 웹 서비스 클라이언트를 설정한다.
Value Type webservice-securityType
Child Elements

(136) request-sender

(174) response-receiver

(135) < jeus-client-dd >< service-ref >< service-client >< port-info >< security > <request-sender>
Description 웹 서비스를 호출하는 메시지에 보안을 적용하기 위한 설정이다.
Value Type security-senderType
Child Elements

(137) action-list

(138) password-callback-class

(139) user

(140) timeStamp

(145) userNameToken

(149) signature-infos

(160) encryption-infos

(136) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender > <action-list>
Description 어떤 보안을 적용할 것인지를 String으로 나열한다. Timestamp, Encrypt, Signature, UsernameToken이 들어갈 수 있다. 각각의 항목은 공백으로 분리한다.
Value Type string

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

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

(139) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender > <timeStamp>
Description TimeStamp에 적용할 ttl(timeToLive) aberration(오차), 서명 여부를 설정한다.
Value Type timeStampType
Child Elements

(141) timeToLive

(142) aberration

(143) requireSignature

(144) precision

(140) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< timeStamp > <timeToLive>
Description 보내게 될 메시지의 유효기간을 초 단위로 설정한다.
Value Type positiveInteger

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

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

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

(144) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender > <userNameToken>
Description UsernameToken을 설정한다.
Value Type userNameTokenSenderType
Child Elements

(146) password

(147) passwordType

(148) userTokenElements

(145) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< userNameToken > <password>
Description 사용할 Password를 설정한다. Password를 암호화해서 저장할 때에는 {algorithm}ciphertext와 같은 형식으로 입력한다. ex) {DES}FQrLbQ/D8O1lDVS71L28rw==
Value Type string

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

PasswordDigest

PasswordText

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

(148) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender > <signature-infos>
Description 메시지에 서명을 하기 위한 설정이다.
Value Type signature-infosType
Child Elements

(150) signature-info

(149) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos > <signature-info>
Description 메시지의 서명을 위한 설정이다. 복수 설정이 가능하다.
Value Type signature-infoType
Child Elements

(151) signatureParts

(152) signatureAlgorithm

(153) messageDigestAlogrithm

(154) canonicalization

(155) keyIdentifier

(156) keystore

(150) < jeus-client-dd >< 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

(151) < jeus-client-dd >< 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

(152) < jeus-client-dd >< 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

(153) < jeus-client-dd >< 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

(154) < jeus-client-dd >< 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

(155) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos >< signature-info > <keystore>
Description 메시지의 서명을 위한 개인 Key를 저장하고 있는 Keystore의 설정이다.
Value Type keystoreType
Child Elements

(157) key-type

(158) keystore-password

(159) keystore-filename

(156) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< signature-infos >< signature-info >< keystore > <key-type>
Description Keystore에 저장되는 Key의 타입을 설정한다(JKS 혹은 pkcs12).
Value Type string

(157) < jeus-client-dd >< 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

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

(159) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender > <encryption-infos>
Description 메시지를 암호화하기 위한 설정이다.
Value Type encryption-infosType
Child Elements

(161) encryption-info

(160) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos > <encryption-info>
Description 메시지를 암호화하기 위한 설정이다.
Value Type encryption-infoType
Child Elements

(162) encryptionParts

(163) keyTransportAlogrithm

(164) encryptionAlgorithm

(165) encryptionUser

(166) keyIdentifier

(167) keystore

(171) embeddedKey

(161) < jeus-client-dd >< 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

(162) < jeus-client-dd >< 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

(163) < jeus-client-dd >< 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

(164) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <encryptionUser>
Description 암호화에 사용되는 Key의 별칭이다.
Value Type string

(165) < jeus-client-dd >< 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

(166) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <keystore>
Description 암호화에 사용될 Key의 저장소에 대해 설정한다.
Value Type keystoreType
Child Elements

(168) key-type

(169) keystore-password

(170) keystore-filename

(167) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info >< keystore > <key-type>
Description Keystore에 저장되는 Key의 타입을 설정한다(JKS 혹은 pkcs12).
Value Type string

(168) < jeus-client-dd >< 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

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

(170) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info > <embeddedKey>
Description 웹 서비스와 웹 서비스 클라이언트가 공유하고 있는 Key를 설정한다. keyIdentifier가 EmbeddedKeyName으로 설정되어야 사용할 수 있다.
Value Type embeddedKeyType
Child Elements

(172) embeddedKeyCallbackClass

(173) key-name

(171) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< request-sender >< encryption-infos >< encryption-info >< embeddedKey > <embeddedKeyCallbackClass>
Description SessionKey를 사용하려면 Key의 Byte 정보를 가지고 있는 Callback 클래스를 설정한다.
Value Type string

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

(173) < jeus-client-dd >< service-ref >< service-client >< port-info >< security > <response-receiver>
Description 웹 서비스 응답 메시지가 보안 적용이 되어있을 경우, 처리하기 위한 설정이다.
Value Type security-receiverType
Child Elements

(175) action-list

(176) observeActionOrder

(177) password-callback-class

(178) timeStamp

(183) decryption

(188) signature-verification

(174) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< response-receiver > <action-list>
Description 받게 되는 메시지가 어떤 보안이 적용되어 있어야 하는지 설정한다. Timestamp, Encrypt, Signature, UsernameToken이 들어갈 수 있다. 각각의 항목은 공백으로 분리한다.
Value Type string

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

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

(177) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< response-receiver > <timeStamp>
Description TimeStamp에 적용할 ttl(timeToLive) aberration(오차)를 설정한다.
Value Type timeStampType
Child Elements

(179) timeToLive

(180) aberration

(181) requireSignature

(182) precision

(178) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< timeStamp > <timeToLive>
Description 보내게 될 메시지의 유효기간을 초 단위로 설정한다.
Value Type positiveInteger

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

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

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

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

(184) keystore

(183) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< decryption > <keystore>
Description 메시지의 암호를 해독하기 위한 Keystore의 설정이다.
Value Type keystoreType
Child Elements

(185) key-type

(186) keystore-password

(187) keystore-filename

(184) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< decryption >< keystore > <key-type>
Description Keystore에 저장되는 Key의 타입을 설정한다(JKS 혹은 pkcs12).
Value Type string

(185) < jeus-client-dd >< 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

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

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

(189) keystore

(188) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< signature-verification > <keystore>
Description 서명을 검증하기 위한 Keystore 설정이다.
Value Type keystoreType
Child Elements

(190) key-type

(191) keystore-password

(192) keystore-filename

(189) < jeus-client-dd >< service-ref >< service-client >< port-info >< security >< response-receiver >< signature-verification >< keystore > <key-type>
Description Keystore에 저장되는 Key의 타입을 설정한다(JKS 혹은 pkcs12).
Value Type string

(190) < jeus-client-dd >< 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

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

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

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

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

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

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

(198) name

(199) value

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

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

[예 21.1] jeus-client-dd.xml 파일 예제

<?xml version="1.0" encoding="UTF-8"?>
<!--
    Represents JEUS6 application client deployment descriptor.
-->
<jeus-client-dd xmlns="http://www.tmaxsoft.com/xml/ns/jeus">

    <!--
        Starting information for executing the application client.
    -->
    <module-info>
        <module-name>client_application1</module-name>
        <app-main-class>SalaryClient</app-main-class>
        <app-argument>125000</app-argument>
    </module-info>


    <!--
        System logging information.
    -->
    <system-logging>
        <level>FINE</level>
    </system-logging>


    <!--
        User information to authenticate the right of service(EJB, JMS, etc.).
    -->
    <security-info>
        <provider-node-name>jeus_node1</provider-node-name>
        <user>john</user>
        <password>MTExMTExMQ==</password>
    </security-info>


    <!-- JEUS Scheduler Service if required. -->
    <scheduler>
      <enabled>true</enabled>
    </scheduler>


    <!-- Environment variable for the applicaiton client. -->
    <env>
        <name>year</name>
        java.lang.Integer
        <value>2002</value>
    </env>


    <!-- JNDI reference for EJB.
        <ref-name> <ref-name> of application-client.xml
        <export-name> real-binded name to JNDI
    -->
    <ejb-ref>
        <jndi-info>
            <ref-name>count</ref-name>
            <export-name>count_bean</export-name>
        </jndi-info>
    </ejb-ref>


    <!-- JNDI reference for resource.
        <ref-name> <ref-name> of application-client.xml
        <export-name> real-binded name to JNDI
    -->
    <res-ref>
        <jndi-info>
            <ref-name>datasource</ref-name>
            <export-name>Oracle_DataSource</export-name>
        </jndi-info>
    </res-ref>


    <!-- JNDI reference for JMS Queue.
        <ref-name> <ref-name> of application-client.xml
        <export-name> real-binded name to JNDI
    -->
    <res-env-ref>
        <jndi-info>
            <ref-name>jms/SalaryInfo</ref-name>
            <export-name>jms/salary_info_queue1</export-name>
        </jndi-info>
    </res-env-ref>
</jeus-client-dd>