여기에서 Resource Adapter 모듈의 DD인
jeus-connector-dd.xml
에서 사용되는 설정을 찾을 수 있다.
XML Schema 파일:
JEUS_HOME/lib/schemas/jeus/jeus-connector-dd.xsd
레퍼런스는 다음 형식으로 구성되어 있다.
XML Schema/XML 트리: XML 설정 파일의 모든 태그 리스트를 정리했다. 각 노드의 형식은 다음과 같다.
태그 레퍼런스로 빨리 찾아보기 위해서 각 태그마다 인덱스 번호( 예: (11) )를 붙여 놓았다. 태그 레퍼런스에서는 이 번호 순서로 설명한다.
XML Schema에서 정의한 XML 태그명을 <tag name> 형식으로 표시한다.
XML Schema에서 정의한 Cardinality를 표시한다. “?” = 0개나 1개의 element, “+” = 1개 이상의 element, “*” = 0개 이상의 element, (기호가 없음) = 정확히 1개의 element
몇몇 태그에는 “P” 문자를 붙여 놓았는데, 해당 태그는 성능에 관계되는 태그라는 것을 뜻한다. 이 태그는 설정을 튜닝할 때 사용된다.
Element Reference: 트리에 있는 각 XML 태그를 설명한다.
Dynamic: 동적 설정 반영 가능
Non-Dynamic: 동적 설정 반영 불가능, Dynamic이 설정되지 않은 항목들이 보통 이에 해당 하나 특별히 설명이 있는 경우 이 항목이 표시된다.
Description: 태그에 대한 간단한 설명.
Value Description: 입력하는 값과 타입.
Value Type: 값의 데이터 타입. (예: String)
Value Type Description: 값의 데이터 타입에 대한 설명
Default Value: 해당 XML을 사용하지 않았을 때 기본적으로 사용되는 값.
Defined Value: 이미 정해져 있는 값.
Example: 해당 XML 태그에 대한 예.
Performance Recommendation: 성능 향상을 위해서 추천하는 값.
Child Elements: 자신의 태그 안에 사용하는 태그.
(2) <module-name> ?
(3) <use-workmanager> ?
(4) <worker-pool> ?
(5) <min> ?
(6) <max> ?
(7) <step> ?
(8) <keep-alive-time> ?
(9) <pooled-timeout> ?
(10) <queue-size> ?
(11) <pre-allocation> ?
(12) <submit-timeout> ?
(13) <release-timeout> ?
(14) <shutdown-timeout> ?
(15) <connection-pool> *
(17) <export-name>
(18) <log-file> ?
(19) <file-name>
(20) <buffer-size> ?
(21) <valid-day> ?
(22) <transaction-support> ?
(23) <user> ?
(24) <password> ?
(25) <use-wrapper> ?
(26) <dissociation-timeout> ?
(27) <invalidation-timeout> ?
(28) <validation-timeout> ?
(29) <skip-connection-matching> ?
(31) <pool-management> ?
(32) <min> ?
(33) <max> ?
(34) <step> ?
(35) <pooled-timeout> ?
(36) <period> ?
(37) <wait-connection> ?
(38) <wait-connection> ?
(39) <max-waiter-count> ?
(40) <max-wait-trial> ?
(41) <wait-timeout> ?
(42) <use-match-connection> ?
(44) <connection-validation> ?
(45) <enabled> ?
(46) <period> ?
(47) <non-validation-interval> ?
(48) <validation-retrial-count> ?
(50) <action-on-connection-leak> ?
(51) <connection-trace> ?
(52) <enabled> ?
(53) <get-connection-trace> ?
(54) <local-transaction-trace> ?
(55) <max-use-count> ?
(56) <pool-destroy-timeout> ?
(57) <disposable-connection> ?
(59) <max-disposable-count> ?
(60) <property> *
(64) <java-security-permission> ?
(66) <description> ?
(1)
<jeus-connector-dd>
| |
Description | 리소스 어댑터 모듈의 최상위 항목이다. jeus-connector-dd.xml 파일에는 이 태그가 반드시 존재한다. |
Value Type | jeus-connector-ddType |
Child Elements |
(3)
(4)
(5)
(16)
|
(2)
<
jeus-connector-dd
>
<module-name>
| |
Description | @Deprecated. 리소스 어댑터 모듈의 이름이다. JEUS 6 Fix#7부터는 더 이상 사용하지 않는다. |
Value Type | token |
(3)
<
jeus-connector-dd
>
<use-workmanager>
| |
Description | @Deprecated. Work Manager 사용 여부를 설정한다. true로 설정한 경우 리소스 어댑터가 시작되기 직전에 설정에 따라 초기화된다. |
Value Type | boolean |
Default Value | false |
(4)
<
jeus-connector-dd
>
<worker-pool>
| |
Description | Work Manager를 설정한다. |
Value Type | deprecated-worker-poolType |
Child Elements |
(6)
(7)
(8)
(9)
(10)
(11)
(12)
(13)
(14)
(15)
|
(5)
<
jeus-connector-dd
><
worker-pool
>
<min>
| |
Description | Work Manager가 관리하는 스레드 수의 최솟값을 설정한다. |
Value Type | nonNegativeIntType |
Default Value | 0 |
(6)
<
jeus-connector-dd
><
worker-pool
>
<max>
| |
Description | Work Manager가 관리하는 스레드 수의 최댓값을 설정한다. |
Value Type | nonNegativeIntType |
Default Value | 5 |
(7)
<
jeus-connector-dd
><
worker-pool
>
<step>
| |
Description | @Deprecated 이 값은 항상 1이다. |
Value Type | nonNegativeIntType |
Default Value | 1 |
(8)
<
jeus-connector-dd
><
worker-pool
>
<keep-alive-time>
| |
Description | 최솟값 이외의 스레드의 경우, 설정된 시간 동안 사용되지 않는다면 자동적으로 Thread Pool에서 제거된다. 밀리세컨드 단위로 설정한다. 0이면 제거하지 않으며 기본값은 1분이다. |
Value Type | nonNegativeLongType |
Default Value | 60000 |
(9)
<
jeus-connector-dd
><
worker-pool
>
<pooled-timeout>
| |
Description | @Deprecated. Keep Alive Time의 사용을 권장한다. |
Value Type | nonNegativeLongType |
Default Value | 60000 |
(10)
<
jeus-connector-dd
><
worker-pool
>
<queue-size>
| |
Description | Work Manager가 Work를 저장할 Queue의 크기를 지정한다. |
Value Type | nonNegativeIntType |
Default Value | 4096 |
(11)
<
jeus-connector-dd
><
worker-pool
>
<pre-allocation>
| |
Description | Work Manager가 초기화될 때 최솟값에 설정된 수의 스레드를 미리 생성해 놓는다. |
Value Type | boolean |
Default Value | true |
(12)
<
jeus-connector-dd
><
worker-pool
>
<submit-timeout>
| |
Description | @Deprecated |
Value Type | nonNegativeLongType |
Default Value | 0 |
(13)
<
jeus-connector-dd
><
worker-pool
>
<release-timeout>
| |
Description | @Deprecated |
Value Type | nonNegativeLongType |
Default Value | 0 |
(14)
<
jeus-connector-dd
><
worker-pool
>
<shutdown-timeout>
| |
Description | Work Manager가 종료될 때 바로 종료하지 않고 여기에 설정된 시간만큼 기다린다. 즉, Graceful Shutdown을 지원한다. 밀리세컨드 단위로 설정한다. -1 또는 0이면 기다리지 않는다. |
Value Type | long |
Default Value | -1 |
(15)
<
jeus-connector-dd
>
<connection-pool>
| |
Description | 아웃바운드 Connection Pool을 설정한다. |
Value Type | connection-poolType |
Child Elements |
(17)
(18)
(19)
(23)
(24)
(25)
(26)
(27)
(28)
(29)
(31)
(32)
(61)
|
(16)
<
jeus-connector-dd
><
connection-pool
>
<connectionfactory-interface>
| |
Description | ra.xml에 등록한 <connection-definition>의 <connectionfactory-interface>의 설정값을 나타낸다. 하나의 리소스 어댑터 모듈에는 <connection-definition> 설정을 여러 개 할 수 있고, 그에 맞춰서 Connection Pool을 생성해야 한다. 그래서 ra.xml에 <connection-definition>이 2개 이상 설정되어 있을 경우에는 이 값을 반드시 설정해야 한다. |
Value Type | token |
(17)
<
jeus-connector-dd
><
connection-pool
>
<export-name>
| |
Description | Connection Pool의 JNDI 이름이다. 임의로 지정할 수 있지만 Standalone 모듈인 경우에는 전체 노드에서 유일한 이름이어야 한다. |
Value Type | token |
(18)
<
jeus-connector-dd
><
connection-pool
>
<log-file>
| |
Description | @Deprecated. 리소스 어댑터의 ManagedConnectionFactory가 사용할 로그 파일을 지정한다. |
Value Type | log-fileType |
Child Elements |
(20)
(21)
(22)
|
(19)
<
jeus-connector-dd
><
connection-pool
><
log-file
>
<file-name>
| |
Description | Connection Pool이 사용할 로그 파일 이름을 설정한다. |
Value Type | token |
(20)
<
jeus-connector-dd
><
connection-pool
><
log-file
>
<buffer-size>
| |
Description | Connection Pool이 로그 파일에 출력할 때 사용하는 Buffer의 크기를 지정한다. |
Value Type | nonNegativeIntType |
Value Description | Byte 단위이다. |
Default Value | 512 |
(21)
<
jeus-connector-dd
><
connection-pool
><
log-file
>
<valid-day>
| |
Description | 날짜 단위로 로그 파일을 바꿀 때 사용한다. 1 이상의 값을 설정하면 로그 파일 이름 뒤에 파일이 사용된 날짜가 자동으로 붙게 된다. |
Value Type | off-intType |
Value Description | day |
(22)
<
jeus-connector-dd
><
connection-pool
>
<transaction-support>
| |
Description | Connection Pool이 지원하는 트랜잭션 타입을 설정한다. 여기에 설정된 값은 ra.xml에 설정된 값보다 우선된다. XATransactionOnly 값은 더 이상 사용하지 않으며 XATransaction으로 취급한다. |
Value Type | transaction-supportType |
Defined Value |
NoTransaction LocalTransaction XATransaction XATransactionOnly |
(23)
<
jeus-connector-dd
><
connection-pool
>
<user>
| |
Description | 기본 인증을 서버에 맡길 경우 이에 필요한 User의 이름을 설정한다. |
Value Type | token |
(24)
<
jeus-connector-dd
><
connection-pool
>
<password>
| |
Description | 기본 인증을 서버에 맡길 경우 이에 필요한 Password를 설정한다. Password를 암호화해서 저장할 때에는 '{algorithm}ciphertext'와 같은 형식으로 입력한다. |
Value Type | token |
(25)
<
jeus-connector-dd
><
connection-pool
>
<use-wrapper>
| |
Description | @Deprecated. |
Value Type | boolean |
Default Value | true |
(26)
<
jeus-connector-dd
><
connection-pool
>
<dissociation-timeout>
| |
Description | @Deprecated. Dissociation을 적용하는 시간값을 설정한다. 해당 리소스 어댑터에서 이 기능을 지원하지 않는 경우 무시된다. |
Value Type | nonNegativeLongType |
Default Value | 0 |
(27)
<
jeus-connector-dd
><
connection-pool
>
<invalidation-timeout>
| |
Description | @Deprecated. Invalidation을 적용할 시간값을 설정한다. 이 시간이 경과해도 Connection Pool로 돌아오지 않는 커넥션은 강제로 제거된다. |
Value Type | nonNegativeLongType |
Default Value | 0 |
(28)
<
jeus-connector-dd
><
connection-pool
>
<validation-timeout>
| |
Description | @Deprecated. 리소스 어댑터가 Connection Pool의 커넥션을 검증하는 시간 단위를 설정한다. 리소스 어댑터의 ManagedConnectionFactory가 ValidatingManagedConnectionFactory 인터페이스를 구현했으면 이 시간 단위로 Invalid 커넥션은 Connection Pool에서 제거된다. |
Value Type | nonNegativeLongType |
Default Value | 0 |
(29)
<
jeus-connector-dd
><
connection-pool
>
<skip-connection-matching>
| |
Description | @Deprecated. 커넥션 인증을 위한 Connection Matching 과정을 생략한다. |
Value Type | boolean |
Default Value | false |
(30)
<
jeus-connector-dd
><
connection-pool
>
<use-lazy-transaction-enlistment>
| |
Description | JCA 표준에서 언급하는 트랜잭션 최적화 기능 중 하나인 "Lazy Transaction Enlistment" 옵션 사용 여부를 설정한다. 이 옵션을 사용할 경우 예상하는 트랜잭션 시나리오와 달라질 수 있으므로 주의한다. |
Value Type | boolean |
Default Value | false |
(31)
<
jeus-connector-dd
><
connection-pool
>
<pool-management>
| |
Description | Connection Pool에 관련된 값을 설정한다. |
Value Type | pool-managementType |
Child Elements |
(33)
(34)
(35)
(36)
(37)
(38)
(43)
(44)
(51)
(52)
(56)
(57)
|
(32)
<
jeus-connector-dd
><
connection-pool
><
pool-management
>
<min>
| |
Description | Connection Pool에 의해 관리되는 커넥션 수의 최솟값을 설정한다.. |
Value Type | nonNegativeIntType |
Default Value | 2 |
(33)
<
jeus-connector-dd
><
connection-pool
><
pool-management
>
<max>
| |
Description | Connection Pool에 의해 관리되는 커넥션 수의 최댓값을 설정한다.. |
Value Type | nonNegativeIntType |
Default Value | 10 |
(34)
<
jeus-connector-dd
><
connection-pool
><
pool-management
>
<step>
| |
Description | 커넥션을 늘릴 필요가 있는 상황에서 한 번에 늘리는 단위 개수를 의미한다. |
Value Type | nonNegativeIntType |
Default Value | 1 |
(35)
<
jeus-connector-dd
><
connection-pool
><
pool-management
>
<pooled-timeout>
| |
Description | @Deprecated. <period>를 사용한다. |
Value Type | nonNegativeLongType |
Default Value | 600000 |
(36)
<
jeus-connector-dd
><
connection-pool
><
pool-management
>
<period>
| |
Description | 설정 주기마다 Connection Pool의 커넥션 수를 조정한다. 특히 Connection Pool에 최소 커넥션 수보다 많은 커넥션이 존재하는 경우에는 최솟값으로 줄여준다. 또한 최솟값보다 실제 커넥션 수가 적은 경우에는 최솟값으로 조정해준다. 그러나 애플리케이션이 커넥션 인증을 하는 경우에는 커넥션을 임의로 생성할 수 없기 때문에 최솟값으로 늘려주지 않는다. |
Value Type | nonNegativeLongType |
Value Description | 밀리세컨드 단위로 설정하고, 0 이면 제거하지 않는다. |
Default Value | 600000 |
(37)
<
jeus-connector-dd
><
connection-pool
><
pool-management
>
<wait-connection>
| |
Description | Pool에 유휴 커넥션이 없을 때 스레드들이 커넥션을 얻기 위해 기다릴지 여부를 결정한다. 이 설정을 하지 않을 경우 Pool에 이미 최댓값만큼 커넥션이 생성되었음에도 불구하고 Pool이 비어있으면 일회용 커넥션(disposable connection)을 생성해서 애플리케이션에 넘겨주게 된다. |
Value Type | wait-connectionType |
Child Elements |
(39)
(40)
(41)
(42)
|
(38)
<
jeus-connector-dd
><
connection-pool
><
pool-management
><
wait-connection
>
<wait-connection>
| |
Description | 커넥션을 얻기 위해 기다릴 것인지 여부를 설정한다. |
Value Type | boolean |
Default Value | false |
(39)
<
jeus-connector-dd
><
connection-pool
><
pool-management
><
wait-connection
>
<max-waiter-count>
| |
Description | @Deprecated. 커넥션을 얻기 위해 기다리는 클라이언트의 최대 수이다. 이보다 많을 경우 바로 실패한 것으로 간주된다. JEUS 6 Fix#7부터는 사용하지 않는 옵션이다. |
Value Type | nonNegativeIntType |
Default Value | 5 |
(40)
<
jeus-connector-dd
><
connection-pool
><
pool-management
><
wait-connection
>
<max-wait-trial>
| |
Description | @Deprecated 설정한 횟수만큼 Connection Matching을 실패했다면 커넥션을 얻는 데 실패한 것으로 간주한다. JEUS 6 Fix#7부터는 사용하지 않는 옵션이다. |
Value Type | nonNegativeIntType |
Default Value | 5 |
(41)
<
jeus-connector-dd
><
connection-pool
><
pool-management
><
wait-connection
>
<wait-timeout>
| |
Description | 설정한 시간 동안 기다려도 커넥션을 얻지 못했다면 커넥션을 얻는 데 실패한 것으로 간주한다. |
Value Type | nonNegativeLongType |
Default Value | 10000 |
(42)
<
jeus-connector-dd
><
connection-pool
><
pool-management
>
<use-match-connection>
| |
Description | Connectio Match를 사용할 것인지 결정한다. 자세한 내용은 JCA 표준을 참조한다. |
Value Type | boolean |
Default Value | false |
(43)
<
jeus-connector-dd
><
connection-pool
><
pool-management
>
<allow-disposable-connection-when-match-failed>
| |
Description | Connection Match가 실패했을 경우 일회용(disposable) 커넥션을 사용할 것인지를 설정한다. Connection Match를 하지 않는 경우에는 이 값을 사용하지 않는다. |
Value Type | boolean |
Default Value | false |
(44)
<
jeus-connector-dd
><
connection-pool
><
pool-management
>
<connection-validation>
| |
Description | 커넥션 유효성 검사에 관련된 설정을 한다. 리소스 어댑터가 제공하는 ManagedConnectionFactory가 jakarta.resource.spi.ValidatingManagedConnectionFactory를 구현했을 경우에만 사용 가능하다. |
Value Type | jcaConnectionValidationType |
Child Elements |
(46)
(47)
|
(45)
<
jeus-connector-dd
><
connection-pool
><
pool-management
><
connection-validation
>
<enabled>
| |
Description | Connection Validation(커넥션 유효성 검사)기능을 사용할지 여부를 결정한다. 리소스 어댑터가 jakarta.resource.spi.ValidatingManagedConnectionFactory를 구현했을 경우에만 사용 가능하다. |
Value Type | boolean |
Default Value | false |
(46)
<
jeus-connector-dd
><
connection-pool
><
pool-management
><
connection-validation
>
<period>
| |
Description | Connection Validation(커넥션 유효성 검사)의 주기를 설정한다. |
Value Type | nonNegativeLongType |
Default Value | 0 |
(47)
<
jeus-connector-dd
><
connection-pool
><
pool-management
><
connection-validation
>
<non-validation-interval>
| |
Description | Connection Validation(커넥션 유효성 검사)이 너무 잦아서 오버헤드가 발생하는 경우 설정한다. 커넥션 유효성 검사를 수행하기 직전의 시각과 가장 최근의 커넥션 유효성 검사 시각과의 차이가 설정한 시간 간격 이내면 커넥션 유효성 검사를 생략한다. 예를 들어 이 설정값이 5000ms인 경우 어떤 커넥션의 마지막 커넥션 유효성 검사 시각으로부터 아직 5초가 지나지 않았다면 그 커넥션에 대한 유효성 검사가 생략된 채 애플리케이션에 전달된다. 밀리세컨드 단위로 설정한다. |
Value Type | nonNegativeLongType |
Default Value | 0 |
(48)
<
jeus-connector-dd
><
connection-pool
><
pool-management
><
connection-validation
>
<validation-retrial-count>
| |
Description | Connection Validation(커넥션 유효성 검사)은 기본적으로 Destroy Policy On Valiation이 FAILED_CONNECTION_ONLY로 설정되어 있을 경우 한 번 수행된다. Destroy Policy On Validation이 ALL_CONNECTIONS로 설정되어 있을 경우에는 최초의 커넥션 유효성 검사에서 커넥션 이상이 확인되면 또 다른 커넥션에 대해서 한 번 더 커넥션 유효성 검사가 이루어져 총 두 번의 커넥션 유효성 검사가 수행될 수 있다. 이 설정값이 이러한 기본 커넥션 유효성 검사 수행 횟수에 더해져 최종 커넥션 유효성 검사 수행 횟수가 정해진다. |
Value Type | nonNegativeIntType |
Default Value | 0 |
(49)
<
jeus-connector-dd
><
connection-pool
><
pool-management
><
connection-validation
>
<destroy-policy-on-validation>
| |
Description | 커넥션이 유효하지 않은 것으로 확인되었을 때 Connection Pool에 있는 다른 커넥션들에 대한 처리 정책을 설정한다. FAILED_CONNECTION_ONLY로 설정하면 유효하지 않은 것으로 확인된 커넥션만 제거한다. ALL_CONNECTIONS로 설정하면 유효하지 않은 것으로 확인된 커넥션을 제거하고 Connection Pool에 있는 다른 커넥션의 유효성을 한 번 더 확인한다. 그조차 유효하지 않은 것으로 확인되면 Connection Pool의 모든 커넥션을 제거한다. |
Value Type | destroy-policy-on-check-queryType |
Default Value | FailedConnectionOnly |
Defined Value |
FailedConnectionOnly AllConnections |
(50)
<
jeus-connector-dd
><
connection-pool
><
pool-management
>
<action-on-connection-leak>
| |
Description | 컴포넌트(주로 Stateless Component - Servlet/JSP, Stateless Session Bean, MDB)에서 사용한 커넥션에 대한 Logging이나 반환 액션을 설정한다. |
Value Type | action-on-resource-leakType |
Defined Value |
NoAction Warning AutoClose |
(51)
<
jeus-connector-dd
><
connection-pool
><
pool-management
>
<connection-trace>
| |
Description | 커넥션을 모니터링하기 위한 옵션이다. 기본 기능은 어떤 애플리케이션이 커넥션을 사용하고 있는지 알 수 있도록 getConnection할 때의 Stack 정보를 표시한다. |
Value Type | jca-connection-traceType |
Child Elements |
(53)
(54)
|
(52)
<
jeus-connector-dd
><
connection-pool
><
pool-management
><
connection-trace
>
<enabled>
| |
Description | 커넥션 모니터링 기능 사용 여부를 설정한다. |
Value Type | boolean |
Default Value | false |
(53)
<
jeus-connector-dd
><
connection-pool
><
pool-management
><
connection-trace
>
<get-connection-trace>
| |
Description | 애플리케이션이 커넥션 요청(getConnection)을 할 때의 StackTrace를 저장한다. Connection Leak 발생 시 실제 어떤 App이 해당 커넥션을 사용했는지 확인할 수 있도록 StackTrace를 출력해준다. 이것은 서버 로그 또는 관리 도구(WebAdmin 등)을 통해서 확인할 수 있다. |
Value Type | boolean |
Default Value | true |
(54)
<
jeus-connector-dd
><
connection-pool
><
pool-management
><
connection-trace
>
<local-transaction-trace>
| |
Description | 애플리케이션이 리소스 어댑터와 로컬 트랜잭션 작업을 할 때의 정보를 추적할 것인지 선택하는 옵션이다. Get Connection Trace 설정과 함께 사용하면 로컬 트랜잭션을 제대로 Commit 또는 Rollback하지 않은 애플리케이션을 추적할 때 도움을 줄 수 있다. 이 옵션을 설정한 상태에서 jeus.connector.pool.transaction Logger의 레벨을 FINE으로 설정했을 경우, 서버 로그를 통해서 확인할 수 있다. |
Value Type | boolean |
Default Value | false |
(55)
<
jeus-connector-dd
><
connection-pool
><
pool-management
>
<max-use-count>
| |
Description | 물리적 커넥션을 몇 번 사용할지 결정하는 옵션이다. 이 횟수만큼 사용되고 나면 새로운 커넥션으로 교체된다. |
Value Type | nonNegativeIntType |
Default Value | 0 |
(56)
<
jeus-connector-dd
><
connection-pool
><
pool-management
>
<pool-destroy-timeout>
| |
Description | Connection Pool을 Destroy할 때 대기하는 시간이다. 리소스 어댑터를 Undeploy할 때 Pool을 Destroy하게 되는데 이때 커넥션을 닫으면서 리소스와 네트워크 통신을 할 경우 Block될 가능성이 존재한다. 만약, 여기에 설정된 시간만큼 기다린 뒤에도 Destroy가 진행되지 않으면 이를 무시하고 계속 Undeploy를 진행한다. |
Value Type | nonNegativeLongType |
Default Value | 10000 |
(57)
<
jeus-connector-dd
><
connection-pool
><
pool-management
>
<disposable-connection>
| |
Description | @Deprecated. JEUS 6 Fix#7부터는 사용하지 않는 옵션이다. DB Connection Pool과 마찬가지로 <wait-connection> 설정을 사용하지 않을 경우에는 항상 일회용(disposable) 커넥션을 생성한다. |
Value Type | disposable-connectionType |
Child Elements |
(59)
(60)
|
(58)
<
jeus-connector-dd
><
connection-pool
><
pool-management
><
disposable-connection
>
<allow-disposable-connection>
| |
Description | @Deprecated. 커넥션을 얻지 못했을 경우 임시 커넥션을 사용할 것인지를 설정한다. |
Value Type | boolean |
Default Value | true |
(59)
<
jeus-connector-dd
><
connection-pool
><
pool-management
><
disposable-connection
>
<max-disposable-count>
| |
Description | @Deprecated. 임시 커넥션의 최대 개수이다. 임시 커넥션은 사용이 끝나면 자동적으로 제거된다. |
Value Type | nonNegativeIntType |
Default Value | 3 |
(60)
<
jeus-connector-dd
><
connection-pool
>
<property>
| |
Description | ManagedConnectionFactory에 적용할 속성을 추가한다. ra.xml에 설정된 값보다 우선된다. |
Value Type | typePropertyType |
Child Elements |
(62)
(63)
(64)
|
(61)
<
jeus-connector-dd
><
connection-pool
><
property
>
<name>
| |
Description | 프로퍼티의 이름이다. |
Value Type | token |
(62)
<
jeus-connector-dd
><
connection-pool
><
property
>
<value>
| |
Description | 프로퍼티의 값을 설정한다. java.util.Properties 타입이면, Value는 key=value |
Value Type | token |
(63)
<
jeus-connector-dd
><
connection-pool
><
property
>
<type>
| |
Description | 프로퍼티 값의 Type을 설정한다. |
Value Type | token |
Value Description | Java Primitive 타입이 올 수 있다. 또한 java.util.Properties 타입이 오면 Value의 값을 프로퍼티에 입력한다. |
(64)
<
jeus-connector-dd
>
<java-security-permission>
| |
Description | JEUS가 J2SE Security를 사용할 때 해당 애플리케이션에게 허용할 J2SE Permission을 설정한다. |
Value Type | securityPermissionType |
Child Elements |
(67)
|
(65)
<
jeus-connector-dd
><
java-security-permission
>
<security-permission-spec>
| |
Description | Security Permission을 기술한다. 형식은 Java Policy 파일을 따른다. |
Value Type | token |
(66)
<
jeus-connector-dd
><
java-security-permission
>
<description>
| |
Description | Security Permission 설정에 대한 설명을 입력할 수 있다. |
Value Type | token |
[예 20.1] jeus-connector-dd.xml 파일 예제
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <jeus-connector-dd xmlns="http://www.tmaxsoft.com/xml/ns/jeus"> <module-name>whitebox-xa</module-name> <use-workmanager>true</use-workmanager> <!-- Work Manager Configuration --> <worker-pool> <min>3</min> <max>10</max> <step>1</step> <pre-allocation>true</pre-allocation> <submit-timeout>5000</submit-timeout> <release-timeout>60000</release-timeout> <!-- Do not wait for running tasks while work manager is shutting down. --> <shutdown-timeout>-1</shutdown-timeout> <pooled-timeout>600000</pooled-timeout> </worker-pool> <!-- Connection Pool Configuration --> <connection-pool> <export-name>datasource1</export-name> <log-file> <file-name>c:\logs\whitebox-xa.log</file-name> <buffer-size>512</buffer-size> <!-- To roll over log file every day. --> <valid-day>1</valid-day> </log-file> <!-- Defined values are NoTransaction, LocalTransaction, XATransaction and XATransactionOnly. --> <transaction-support>XATransaction</transaction-support> <user>scott</user> <password>tiger</password> <use-wrapper>true</use-wrapper> <!-- Works only if the resource adapter supported dissociation. --> <dissociation-timeout>60000</dissociation-timeout> <invalidation-timeout>300000</invalidation-timeout> <!-- Works only if the resource adapter implemented ValidatingManagedConnectionFactory --> <validation-timeout>600000</validation-timeout> <skip-connection-matching>false</skip-connection-matching> <pool-management> <min>0</min> <max>20</max> <pooled-timeout>600000</pooled-timeout> <wait-connection> <wait-connection>true</wait-connection> <max-waiter-count>5</max-waiter-count> <max-wait-trial>5</max-wait-trial> <wait-timeout>10000</wait-timeout> </wait-connection> <disposable-connection> <allow-disposable-connection>true</allow-disposable-connection> <max-disposable-count>3</max-disposable-count> </disposable-connection> </pool-management> <property> <name>Vendor</name> java.lang.String <value>TmaxSoft</value> </property> </connection-pool> </jeus-connector-dd>