Sun Java 로고     이전      목차      색인      다음     

Sun 로고
Sun Java System Message Queue 3 2005Q4 관리 설명서 

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 JavaBean

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

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

등록 정보

기본값

설명

addressList1

mq://localhost:7676
   /jms

자원 어댑터가 Message Queue 서비스에 설정하는 연결로 메시지 서비스 주소 형식을 사용하여 지정됩니다.

자원 어댑터가 기본값을 제공합니다.

이 등록 정보 이름 addressList는 Sun Java System Message Queue와 관련되어 있지만 표준 등록 정보 connectionURL과 같은 의미를 갖습니다. Sun Java System Message Queue에서는 두 등록 정보 이름을 모두 제공합니다. connectionURL 또는 ddressList를 설정해야 합니다. 두 속성은 동일합니다.

addressListBehavior

PRIORITY

자원 어댑터가 Message Queue 서비스에 연결하는 방법을 지정하는 문자열입니다. 값은 PRIORITY 또는 RANDOM입니다.

PRIORITY 연결은 주소 목록(addressList)에 지정된 첫 번째 주소를 선택하여 Message Queue 브로커를 선택합니다.

RANDOM 연결은 주소 목록에서 Message Queue 브로커를 임의로 선택합니다.

연결 실패 후의 재연결은 PRIORITY와 RANDOM이 동일합니다. 재연결 시도는 연결이 실패한 브로커에서 시작됩니다. 재연결 시도도 실패할 경우 자원 어댑터는 활성 주소 목록을 통해 순차적으로 연결을 시도합니다.

addressListIterations

1

주소 목록을 통해 반복하는 횟수입니다. 이 값은 초기 연결과 후속 재연결 시도에 적용됩니다.

connectionURL

mq://localhost:7676
   /jms

자원 어댑터가 Message Queue 서비스에 설정하는 연결로 메시지 서비스 주소 형식을 사용하여 지정됩니다.

addressList 등록 정보와 동일합니다. 자세한 내용은 위 설명을 참조하십시오.

userName1

guest

자원 어댑터가 Message Queue 서비스에 연결할 때 사용하는 기본 사용자 아이디입니다.

자원 어댑터가 기본값을 제공합니다.

password1

guest

자원 어댑터가 Message Queue 서비스에 연결할 때 사용하는 기본 비밀번호입니다.

자원 어댑터가 기본값을 제공합니다.

reconnectAttempts

6

주소 목록의 단일 항목에 재연결을 시도하는 횟수입니다. 이 등록 정보는 reconnectEnabled를 true로 설정할 때 사용됩니다.

reconnectEnabled

false

연결 실패 후 재연결을 시도할지 여부를 지정하는 부울 값입니다.

재연결 시도 동작은 reconnectInterval 및 reconnectAttempts의 값에 따라 결정됩니다.

reconnectInterval

30000

재연결 시도 간격(밀리초)입니다. 이 등록 정보는 reconnectEnabled를 true로 설정할 때 사용됩니다.

1이 등록 정보는 필수입니다.


ManagedConnectionFactory JavaBean

관리 대상 연결 팩토리는 자원 어댑터가 MDB에 제공하는 연결을 설정하고 정의합니다. ResourceAdapter JavaBean에 유사한 등록 정보가 있는 속성을 설정하면 해당 설정이 ResourceAdapter Bean에 지정된 유사 값보다 우선합니다.

표 17-2에서는 Message Queue 자원 어댑터가 제공하는 관리 대상 연결 팩토리의 구성 가능한 속성을 나열하고 설명합니다.

표 17-2 관리 대상 연결 팩토리 속성 

속성

기본값

설명

addressList

없음

이 관리 대상 연결 팩토리에서 파생된 연결 목록입니다.

이 속성 형식은 표 17-1에서 설명한 대로 메시지 서비스 addressList를 따릅니다. 이 값을 설정하지 않을 경우 ResourceAdapter JavaBean에 지정되고 해당 표에 설명된 addressList 값이 연결에 사용됩니다.

addressListBehavior

PRIORITY

자원 어댑터가 Message Queue 서비스에 연결하는 방법을 지정하는 문자열입니다. 값은 PRIORITY 또는 RANDOM입니다.

PRIORITY 연결은 주소 목록(addressList)에 지정된 첫 번째 주소를 선택하여 Message Queue 브로커를 선택합니다.

RANDOM 연결은 주소 목록에서 Message Queue 브로커를 임의로 선택합니다.

연결 실패 후의 재연결은 PRIORITY와 RANDOM이 동일합니다. 재연결 시도는 연결이 실패한 브로커에서 시작됩니다. 재연결 시도도 실패할 경우 연결 시도는 활성 주소 목록을 통해 순차적으로 처리됩니다.

addressListIterations

1

주소 목록을 통해 반복하는 횟수입니다. 이 값은 초기 연결과 후속 재연결 시도에 적용됩니다.

clientID

없음

이 관리 대상 연결 팩토리에서 파생된 연결에 사용할 클라이언트 식별자입니다.

password

guest

(선택 사항) 연결에 사용할 비밀번호입니다.

이 값을 설정하지 않으면 표 17-1에 설명한 대로 ResourceAdapter JavaBean에 지정된 비밀번호가 연결에 사용됩니다.

reconnectAttempts

6

주소 목록의 단일 항목에 재연결을 시도하는 횟수입니다.

reconnectEnabled

false

연결 실패 후 재연결을 시도할지 새 연결을 시도할지 여부를 지정하는 부울 값입니다.

재연결 시도는 reconnectInterval 및 reconnectAttempts 속성에 따라 결정됩니다.

reconnectInterval

30000

Message Queue 서비스에 재연결을 시도하기 위해 대기하는 최소 간격(밀리초)입니다.

userName

guest

(선택 사항) 연결에 사용할 사용자 아이디입니다.

이 값을 설정하지 않으면 표 17-1에 설명한 대로 ResourceAdapter JavaBean에 지정된 사용자 아이디가 연결에 사용됩니다.


ActivationSpec JavaBean

ActivationSpec JavaBean 등록 정보는 응용 프로그램 서버가 메시지 종점을 활성화하여 Message-Driven Bean에 연결하도록 자원 어댑터에 지시할 때 사용됩니다.

표 17-3에서는 메시지 종단점 활성화 사양에 대해 구성 가능한 등록 정보를 나열하고 설명합니다. 이 표는 Message Queue 자원 어댑터 관련 등록 정보와 Enterprise JavaBean 2.1 표준 또는 J2EE CA(J2EE Connector Architecture) 1.5 표준 관련 등록 정보를 나타냅니다.

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

등록 정보

기본값

설명

acknowledgeMode

Auto-acknowledge

(선택 사항) 사용자에 사용할 JMS 세션 확인 모드입니다.

표준 EJB 2.1 및 J2EE CA 1.5 등록 정보입니다.

값은 Auto-acknowledge 또는 Dups-ok-acknowledge일 수 있습니다.

addressList

ResourceAdapter JavaBean 구성의
addressList에서 상속됨

(선택 사항) 메시지 종단점 대신 자원 어댑터에서 만든 연결 사양입니다.

이 등록 정보는 Message Queue JMS 자원 어댑터와 관련됩니다.

유효한 값은 메시지 서비스 연결 주소 구문을 준수해야 합니다.

clientId

없음

이 사용자에 대해 만든 JMS 연결에 사용할 JMS 클라이언트 아이디입니다.

subscriptionDurability 등록 정보를 Durable로 설정한 경우 이 등록 정보를 설정해야 합니다.

표준 EJB 2.1 및 J2EE CA 1.5 등록 정보입니다.

customAcknowledgeMode

없음

MDB 메시지 사용을 위한 모드를 지정하는 문자열입니다.

이 등록 정보에 유효한 값은 No_acknowledge 또는 null입니다.

비트랜잭션, 비영구 주제 가입에 대해서만 No_acknowledge 모드를 사용할 수 있습니다. 트랜잭션 가입 또는 영구 가입에 이 설정을 사용하면 가입이 활성화되지 않습니다.

대상

없음

이 MDB가 메시지를 사용하는 대상의 이름입니다.

이 속성은 필수 등록 정보입니다. 표준 EJB 2.1 및 J2EE CA1.5 등록 정보입니다.

이 값을 Message Queue 대상 관리 대상 객체의 destinationName 등록 정보 값으로 설정해야 합니다.

destinationType

없음

destination 등록 정보에 지정된 대상의 유형입니다. 유효한 값은 javax.jms.Queue 또는 javax.jms.Topic입니다.

이 속성은 필수 등록 정보입니다. 표준 EJB 2.1 및 J2EE CA1.5 등록 정보입니다.

endpointExceptionRedelivery
Attempts

6

MDB가 메시지 전달 중에 예외를 발생할 때 MDB에 메시지를 재전송하는 횟수입니다.

messageSelector

없음

(선택 사항) 사용자에게 전달된 메시지를 필터링할 때 사용할 JMS 메시지 선택기입니다. 값 유형은 문자열입니다.

표준 EJB 2.1 및 J2EE CA 1.5 등록 정보입니다.

sendUndeliverableMsgsToDMQ

true

MDB가 런타임 예외를 발생하고 재전송 시도 횟수가 endpointExceptionRedeliveryAttempts 값을 초과할 때 메시지를 사용 불능 메시지 대기열에 넣을지 여부를 지정하는 부울 값입니다.

값이 false이면 Message Queue 브로커는 동일한 MDB를 포함하여 유효한 사용자에게 메시지를 재전송하려고 시도합니다.

subscriptionDurability

NonDurable

주제 대상의 사용자가 영구 사용자인지 비영구 사용자인지를 지정하는 문자열입니다. 값은 NonDurable 또는 Durable일 수 있습니다.

이 등록 정보는 비영구 가입의 경우 선택 사항이고 영구 가입의 경우 필수 사항입니다. 이 값을 Durable로 설정하는 경우 clientID 및 subscriptionName 등록 정보도 설정해야 합니다.

이 속성은 표준 EJB 2.1 및 J2EE CA1.5 등록 정보이며 destinationType 등록 정보를 avax.jms.Topic으로 설정한 경우에만 유효합니다.

subscriptionName

없음

영구 가입의 이름을 지정할 때 사용할 문자열입니다.

subscriptionDurability 등록 정보를 Durable로 설정한 경우 이 등록 정보를 설정해야 합니다.

표준 EJB 2.1 및 J2EE CA 1.5 등록 정보입니다.



이전      목차      색인      다음     


부품 번호: 819-3563.   Copyright 2005 Sun Microsystems, Inc. 모든 권리는 저작권자의 소유입니다.