메시지 대상 추가

J2EE 1.4 스펙은 J2EE 컴포넌트에 대해 메시지 대상 참조라는 "논리" 이름을 사용하여 메시지 대상 오브젝트를 참조할 수 있는 방법을 제공합니다. 사용자는 배치 디스크립터 편집기를 사용하여 메시지 대상 참조를 정의할 수 있습니다.

이 태스크 정보

메시지 대상은 애플리케이션에 논리 메시지 대상을 지정하는 요소입니다. message-destination 요소는 링크를 위해 사용되는 message-destination-name을 정의합니다. 메시지 대상은 J2EE 애플리케이션의 모듈에서 참조 컴포넌트로 정의할 수 있습니다. 메시지 대상 참조 또는 메시지 구동 Bean의 메시지 대상 링크는 메시지 대상의 이름을 가리킵니다.

배치 시 메시지 대상 참조는 대상 운영 환경에 있는 관리 메시지 대상에 바인딩됩니다.

제한사항: 다음 최소 프로젝트 레벨만 메시지 대상을 포함할 수 있습니다.
  • J2EE 1.4 애플리케이션 클라이언트
  • EJB 2.1 프로젝트
  • 2.4 웹 애플리케이션

사용자가 정의하는 각 메시지 대상의 경우 message-destination 요소가 해당 애플리케이션 컴포넌트에 대한 배치 디스크립터에 추가됩니다.

다음 코드는 배치 디스크립터에서 정의된 예제 메시지 대상을 표시합니다.

<message-destination>
	<description></description>
	<message-destination-name>MyDest</message-destination-name>
</message-destination>

프로시저

  1. 메시지 대상을 추가하려는 모듈 프로젝트에 대한 배치 디스크립터 편집기를 여십시오. 이를 수행하려면 Java™ EE 퍼스펙티브의 엔터프라이즈 탐색기에서 사용자 프로젝트에 대한 배치 디스크립터 노드를 두 번 클릭하십시오.
  2. 편집기의 메시지 대상 섹션에서 추가 단추를 클릭하십시오. 이 섹션은 모듈 유형에 따라 편집기의 다른 페이지에 있습니다.
    • 애플리케이션 클라이언트 프로젝트: 개요 페이지
    • 동적 웹 프로젝트: 변수 페이지
    • EJB 프로젝트: 어셈블리 페이지
  3. 이름 필드에 메시지 대상의 이름을 지정하십시오. 이름 필드에 입력된 값은 배치 디스크립터에서 message-destination-name 요소에 사용되며 message-destination-link 요소로 메시지 대상 참조 또는 메시지 구동 Bean에서 사용할 수 있는 값입니다. 메시지 대상을 통해 EJB는 메시지를 동일한 애플리케이션의 특정 메시지 구동 Bean으로 보낼 수 있습니다. 이름은 임의이며, 송신기와 수신기 둘 다 <message-destination-link> 요소에 대한 값과 동일한 이름을 지정합니다. 다음은 샘플 <message-destination> 값이 포함된 코드의 예입니다.
    <?xml version="1.0" encoding="UTF-8"?>
    <ejb-jar xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/ejb-jar_3_0.xsd"
    	version="1.0">
    	<display-name>TestEJB</display-name>
    	<enterprise-beans>
    		<message-driven>
    			<ejb-name>ConsumerBean</ejb-name>
    			<message-destination-link>ConsumerDestination</message-destination-link>
    		</message-driven>
    		<session>
    			<ejb-name>ProducerBean</ejb-name>
    			<message-destination-ref>
    				<message-destination-ref-name>beans.ProducerBean/destination</message-destination-ref-name>
    				<message-destination-link>ConsumerDestination</message-destination-link>
    			</message-destination-ref>
    		</session>
    	</enterprise-beans>
    	<assembly-descriptor>
    		<message-destination>
    			<description></description>
    			<message-destination-name>ConsumerDestination</message-destination-name>
    		</message-destination>
    	</assembly-descriptor>
    </ejb-jar>
     
  4. 설명 텍스트 영역에 메시지 대상에 대한 설명을 입력하십시오. 완료를 클릭하십시오.
  5. 완료를 클릭하십시오.

결과

메시지 대상이 배치 디스크립터에 추가됩니다. 이제 메시지 대상 참조를 정의할 때 이 메시지 대상에 링크할 수 있습니다. 편집기의 메시지 구동 대상 섹션에서 메시지 대상을 선택하고 이름 및 설명을 변경하십시오. 메시지 대상을 제거할 수도 있습니다.

피드백