|
| |
| Sun Java System Message Queue 3 2005Q1 관리 설명서 | |
17장
JMS 자원 어댑터 속성 참조Message Queue JMS 자원 어댑터(JMS RA)를 사용하면 표준 JCA(J2EE Connector Architecture)를 통해 Sun Java System Message Queue를 J2EE 1.4 응용 프로그램 서버와 통합할 수 있습니다. Message Queue JMS 자원 어댑터를 응용 프로그램 서버에 플러그 인하면 해당 응용 프로그램 서버에 배포된 응용 프로그램에서 Message Queue를 사용하여 JMS 메시지를 보내고 받을 수 있습니다.
Message Queue JMS 자원 어댑터는 세 가지 JavaBean 세 구성 요소를 통해서 구성 속성을 제공합니다.
이러한 항목에 대한 속성 값을 설정하려면 응용 프로그램 서버에서 자원 어댑터의 구성과 배포 및 MDB의 배포를 위해 제공하는 도구를 사용하십시오.
이 장에서는 Message Queue JMS 자원 어댑터의 구성 속성을 나열하고 설명합니다. 이 장은 다음 내용으로 구성되어 있습니다.
ResourceAdapter JavaBeanResourceAdapter 구성은 기본 JMS 자원 어댑터 동작을 구성합니다. 표 17-1에서는 이 JavaBean을 구성할 때 사용할 수 있는 속성을 나열하고 설명합니다. 각주는 필수 등록 정보를 각각 표시합니다.
표 17-1 자원 어댑터 속성
이름
설명
기본값
addressList1
자원 어댑터가 Message Queue 서비스에 설정하는 연결로 메시지 서비스 주소 형식을 사용하여 지정됩니다.
자원 어댑터가 기본값을 제공합니다.
이 속성 이름 addressList는 Sun Java System Message Queue와 관련되어 있지만 표준 속성 connectionURL과 같은 의미를 갖습니다. Sun Java System Message Queue에서는 두 속성 이름을 모두 제공합니다. connectionURL 또는 ddressList를 설정해야 합니다. 두 속성은 동일합니다.
mq://localhost:7676
/jmsaddressListBehavior
자원 어댑터가 Message Queue 서비스에 연결하는 방법을 지정하는 문자열입니다. 값은 PRIORITY 또는 RANDOM입니다.
PRIORITY 연결은 주소 목록(addressList)에 지정된 첫 번째 주소를 선택하여 Message Queue 브로커를 선택합니다.
RANDOM 연결은 주소 목록에서 Message Queue 브로커를 임의로 선택합니다.
연결 실패 후의 재연결은 PRIORITY와 RANDOM이 동일합니다. 재연결 시도는 연결이 실패한 브로커에서 시작됩니다. 재연결 시도도 실패할 경우 자원 어댑터는 활성 주소 목록을 통해 순차적으로 연결을 시도합니다.
PRIORITY
addressListIterations
주소 목록을 통해 반복하는 횟수입니다. 이 값은 초기 연결과 후속 재연결 시도에 적용됩니다.
1
connectionURL
자원 어댑터가 Message Queue 서비스에 설정하는 연결로 메시지 서비스 주소 형식을 사용하여 지정됩니다.
addressList 속성과 동일합니다. 자세한 내용은 위 설명을 참조하십시오.
mq://localhost:7676
/jms
userName1
자원 어댑터가 Message Queue 서비스에 연결할 때 사용하는 기본 사용자 아이디입니다.
자원 어댑터가 기본값을 제공합니다.
guest
password1
자원 어댑터가 Message Queue 서비스에 연결할 때 사용하는 기본 비밀번호입니다.
자원 어댑터가 기본값을 제공합니다.
guest
reconnectAttempts
주소 목록의 단일 항목에 재연결을 시도하는 횟수입니다. 이 속성은 reconnectEnabled를 true로 설정할 때 사용됩니다.
6
reconnectEnabled
연결 실패 후 재연결을 시도할지 여부를 지정하는 부울 값입니다.
재연결 시도 동작은 reconnectInterval 및 reconnectAttempts의 값에 따라 결정됩니다.
false
reconnectInterval
재연결 시도 간격(밀리초)입니다. 이 속성은 reconnectEnabled를 true로 설정할 때 사용됩니다.
30000
1이 등록 정보는 필수입니다.
ManagedConnectionFactory JavaBean관리 대상 연결 팩토리는 자원 어댑터가 Message-Driven Bean에 제공하는 연결을 설정하고 정의합니다. ResourceAdapter JavaBean에 유사한 속성이 있는 속성을 설정하면 해당 설정이 ResourceAdapter Bean에 지정된 유사 값보다 우선합니다.
표 17-2에서는 Message Queue 자원 어댑터가 제공하는 관리 대상 연결 팩토리의 구성 가능한 속성을 나열하고 설명합니다.
표 17-2 관리 대상 연결 팩토리 속성
이름
설명
기본값
addressList
이 관리 대상 연결 팩토리에서 파생된 연결 목록입니다.
이 등록 정보 형식은 표 17-1에서 설명한 대로 메시지 서비스 addressList를 따릅니다. 이 값을 설정하지 않을 경우 ResourceAdapter JavaBean에 지정되고 해당 표에 설명된 addressList 값이 연결에 사용됩니다.
없음
addressListBehavior
자원 어댑터가 Message Queue 서비스에 연결하는 방법을 지정하는 문자열입니다. 값은 PRIORITY 또는 RANDOM입니다.
PRIORITY 연결은 주소 목록(addressList)에 지정된 첫 번째 주소를 선택하여 Message Queue 브로커를 선택합니다.
RANDOM 연결은 주소 목록에서 Message Queue 브로커를 임의로 선택합니다.
연결 실패 후의 재연결은 PRIORITY와 RANDOM이 동일합니다. 재연결 시도는 연결이 실패한 브로커에서 시작됩니다. 재연결 시도도 실패할 경우 연결 시도는 활성 주소 목록을 통해 순차적으로 처리됩니다.
PRIORITY
addressListIterations
주소 목록을 통해 반복하는 횟수입니다. 이 값은 초기 연결과 후속 재연결 시도에 적용됩니다.
1
clientID
이 관리 대상 연결 팩토리에서 파생된 연결에 사용할 클라이언트 식별자입니다.
없음
password
(선택 사항) 연결에 사용할 비밀번호입니다.
이 값을 설정하지 않으면 표 17-1에 설명한 대로 ResourceAdapter JavaBean에 지정된 비밀번호가 연결에 사용됩니다.
guest
reconnectAttempts
주소 목록의 단일 항목에 재연결을 시도하는 횟수입니다.
6
reconnectEnabled
연결 실패 후 재연결을 시도할지 새 연결을 시도할지 여부를 지정하는 부울 값입니다.
재연결 시도는 reconnectInterval 및 reconnectAttempts 등록 정보에 따라 결정됩니다.
false
reconnectInterval
Message Queue 서비스에 재연결을 시도하기 위해 대기하는 최소 간격(밀리초)입니다.
30000
userName
(선택 사항) 연결에 사용할 사용자 아이디입니다.
이 값을 설정하지 않으면 표 17-1에 설명한 대로 ResourceAdapter JavaBean에 지정된 사용자 아이디가 연결에 사용됩니다.
guest
ActivationSpec JavaBeanActivationSpec JavaBean 등록 정보는 응용 프로그램 서버가 메시지 종점을 활성화하여 Message-Driven Bean에 연결하도록 자원 어댑터에 지시할 때 사용됩니다.
표 17-3에서는 메시지 종점 활성화 사양에 대해 구성 가능한 속성을 나열하고 설명합니다. 이 표는 Message Queue 자원 어댑터 관련 등록 정보와 Enterprise JavaBean 2.1 표준 또는 J2EE CA(J2EE Connector Architecture) 1.5 표준 관련 등록 정보를 나타냅니다.