Sun Java System Message Queue 3.7 UR1 관리 설명서

17장 JMS 자원 어댑터 등록 정보 참조

이 장에서는 Message Queue^TM JMS 자원 어댑터(JMS RA)의 구성 등록 정보에 대해 설명합니다. JMS 자원 어댑터를 사용하면 표준 J2EE Connector Architecture(JCA)를 통해 Sun Java System^TM Message Queue를 J2EE 1.4 Application Server에 통합할 수 있습니다. 응용 프로그램 서버에 연결하면 해당 응용 프로그램 서버에 배포된 응용 프로그램은 자원 어댑터를 통해 Message Queue에서 JMS 메시지를 보내고 받을 수 있습니다.

Message Queue JMS 자원 어댑터는 세 가지 JavaBean 세 구성 요소를 통해서 구성 등록 정보를 제공합니다.

ResourceAdapter JavaBean( ResourceAdapter JavaBean)은 자원 어댑터의 전체 동작에 영향을 미칩니다.
ManagedConnectionFactory JavaBean( ManagedConnectionFactory JavaBean)은 message-driven bean(MDB)에서 사용하도록 자원 어댑터에서 생성하는 연결에 영향을 줍니다.
ActivationSpec JavaBean( ActivationSpec JavaBean)은 메시징 시스템과의 상호 작용에서 MDB를 나타내는 메시지 종점에 영향을 줍니다.

이러한 엔티티에 대한 등록 정보 값을 설정하려면 자원 어댑터 구성/배포 및 MDB 배포를 위해 응용 프로그램 서버에서 제공하는 도구를 사용합니다.

이 장에서는 Message Queue JMS 자원 어댑터의 구성 등록 정보를 나열하고 설명합니다. 이 장은 다음 내용으로 구성되어 있습니다.

ResourceAdapter JavaBean

ResourceAdapter 구성은 기본 JMS 자원 어댑터 동작을 구성합니다. 표 17–1에서는 이 JavaBean을 구성할 때 사용할 수 있는 등록 정보를 나열하고 설명합니다.

표 17–1 자원 어댑터 등록 정보


등록 정보	유형	기본값	설명
`addressList`	문자열	`mq://localhost:7676/jms`	(필수) Message Queue 서비스에 연결하기 위한 메시지 서비스 주소 `connectionURL`(아래)과 동일하며 둘 중 하나를 선택해야 합니다.
`connectionURL`	문자열	`mq://localhost:7676/jms`	Message Queue 서비스에 연결하기 위한 메시지 서비스 주소 `addressList`(위)와 동일하며 둘 중 하나를 선택해야 합니다.
`userName`	문자열	`guest`	(필수) Message Queue 서비스에 연결하기 위한 기본 사용자 이름
`password`	문자열	`guest`	(필수) Message Queue 서비스에 연결하기 위한 기본 비밀번호
`addressListBehavior`	문자열	`PRIORITY`	Message Queue 서비스에 대한 연결 시도 순서: `PRIORITY`: 주소 목록에 지정된 순서 `RANDOM`: 임의의 순서 주 – 연결에 실패한 브로커에서는 연결 실패 후에 재연결 시도를 시작하고 이 우선 순위 설정 값에 상관없이 주소 목록을 순차적으로 처리합니다.
`addressListIterations`	정수	`1`	연결 설정 또는 재설정을 시도하며 주소 목록을 반복하는 횟수
`reconnectEnabled`	부울	`false`	손실된 연결을 다시 연결하시겠습니까?
`reconnectAttempts`	정수	`6`	다음 주소로 이동하기 전에 주소 목록의 각 주소에 대한 재연결 시도 횟수
`reconnectInterval`	긴 정수	`30000`	재연결 시도 간격(밀리초)

ManagedConnectionFactory JavaBean

관리 대상 연결 팩토리는 자원 어댑터가 message-driven bean에 제공하는 연결을 정의합니다. 표 17–2에서는 ManagedConnectionFactory JavaBean의 등록 정보를 보여 줍니다. 이러한 등록 정보는 설정된 경우 ResourceAdapter JavaBean의 해당 등록 정보를 무시합니다.

표 17–2 관리 대상 연결 팩토리 등록 정보


등록 정보	유형	기본값	설명
`addressList`	문자열	`ResourceAdapter` JavaBean에서 상속됨(표 17–1 참조)	Message Queue 서비스에 연결하기 위한 메시지 서비스 주소 목록
`userName`	문자열	`guest`	(선택 사항) Message Queue 서비스에 연결하기 위한 사용자 이름
`password`	문자열	`guest`	(선택 사항) Message Queue 서비스에 연결하기 위한 비밀번호
`clientID`	문자열	없음	Message Queue 서비스에 연결하기 위한 클라이언트 식별자
`addressListBehavior`	문자열	`PRIORITY`	Message Queue 서비스에 대한 연결 시도 순서: `PRIORITY`: 주소 목록에 지정된 순서 `RANDOM`: 임의의 순서 주 – 연결 실패한 브로커에서는 연결 실패 후에 재연결 시도를 시작하고 이 우선 순위 설정 값에 상관없이 주소 목록을 순차적으로 처리합니다.
`addressListIterations`	정수	`1`	연결 설정 또는 재설정을 시도하며 주소 목록을 반복하는 횟수
`reconnectEnabled`	부울	`false`	손실된 연결을 다시 연결하시겠습니까?
`reconnectAttempts`	정수	`6`	다음 주소로 이동하기 전에 주소 목록의 각 주소에 재연결을 시도하는 횟수
`reconnectInterval`	긴 정수	`30000`	재연결 시도 간격(밀리초)

ActivationSpec JavaBean

표 17–3에서는 ActivationSpec JavaBean의 구성 등록 정보를 보여줍니다. 이러한 등록 정보는 응용 프로그램 서버에서 자원 어댑터에 메시지 종점을 활성화하여 message-driven bean에 연결하도록 지시하는 데 사용됩니다.

표 17–3 활성화 사양 등록 정보


등록 정보	유형	기본값	설명
`addressList` [Message Queue JMS 자원 어댑터에 관련된 등록 정보]	문자열	`ResourceAdapter` JavaBean에서 상속됨	(선택 사항) Message Queue 서비스에 연결하기 위한 메시지 서비스 주소
`destination` [표준 Enterprise JavaBean(EJB) 및 J2EE Connector Architecture(CA) 등록 정보]	문자열	없음	(필수) 메시지를 사용할 대상의 이름 값은 Message Queue 대상 관리 객체에 대한 `destinationName` 등록 정보 값이어야 합니다.
`destinationType`	문자열	없음	(필수) `destination` 등록 정보에 의해 지정되는 대상 유형: `javax.jms.Queue`: 대기열 대상 `javax.jms.Topic`: 주제 대상
`messageSelector`	문자열	없음	(선택 사항) 사용자에게 전달되는 메시지를 필터링하기 위한 메시지 선택기
`subscriptionName`	문자열	없음	영구 가입 이름 `subscriptionDurability`가 `Durable`로 설정되어 있는 경우 이 등록 정보를 설정해야 합니다.
`subscriptionDurability`	문자열	`NonDurable`	주제 대상의 사용자 지속성: `Durable`: 영구 사용자 `NonDurable`: 비영구 사용자 이 등록 정보는 `destinationType`이 `javax.jms.Topic`으로 설정되어 있는 경우에만 유효하며, 비영구 가입의 경우 선택 사항이고 영구 가입의 경우 필수 사항입니다. `Durable`로 설정된 경우 `clientID` 및 `subscriptionName` 등록 정보도 설정해야 합니다.
`clientId`	문자열	없음	Message Queue 서비스에 연결하기 위한 클라이언트 ID `subscriptionDurability`가 `Durable`로 설정되어 있는 경우 이 등록 정보를 설정해야 합니다.
`acknowledgeMode`	문자열	`Auto-acknowledge`	(선택 사항) 확인 모드: `Auto-acknowledge`: 자동 승인 모드 `Dups-ok-acknowledge`: Dups-OK-acknowledge 모드
`customAcknowledgeMode`	문자열	없음	MDB 메시지 사용을 위한 확인 모드 유효한 값은 `No_acknowledge` 또는 null입니다. 트랜잭션되지 않은 비영구 주제 가입에 대해서만 no-acknowledge 모드를 사용할 수 있습니다. 트랜잭션 가입이나 영구 가입에 대해 이 설정을 사용하면 가입이 활성화되지 않습니다.
`endpointExceptionRedeliveryAttempts`	정수	`6`	MDB가 메시지 전달 중에 예외를 발생하는 경우에 메시지를 다시 전달하는 횟수
`sendUndeliverableMsgsToDMQ`	부울	`true`	MDB에서 런타임 예외가 발생하고 재전달 시도 횟수가 `endpointExceptionRedeliveryAttempts` 값을 초과할 경우 메시지를 사용 불능 메시지 대기열에 넣습니까? 값이 `false`이면 Message Queue 브로커는 동일한 MDB를 포함하여 유효한 사용자에게 메시지를 재전송하려고 시도합니다.