JMS 대상 구성

JCA(Java™ EE Connector Architecture) 스펙을 준수하는 자원 어댑터가 제공하는 JMS 대상을 구성할 수 있습니다.

이 태스크 정보

설치된 자원 어댑터가 제공하는 JMS 대상 또는 주제 유형의 인스턴스를 하나 이상 구성할 수 있습니다.
다음 유형의 JMS 대상을 위한 구성 요소가 제공됩니다.
  • javax.jms.Destination: jmsDestination
  • javax.jms.Queue: jmsQueue
  • javax.jms.Topic: jmsTopic
참고:

Liberty에 대한 JCA 지원을 추가하려면 WebSphere® Application Server Developer Tools for Eclipse의 서버 구성 편집기의 소스 보기 또는 일부 기타 문서 편집기를 사용하여 server.xml 파일을 편집해야 합니다. 디자인 보기에서 연결 팩토리, 관리 오브젝트, 활성화 스펙 및 자원 어댑터에 대한 구성의 일부 편집은 베타에서 지원되지 않습니다.

프로시저

  1. 하나 이상의 JMS 대상, 큐 또는 주제 인스턴스를 구성하십시오. 대상 인스턴스를 구성할 때 jmsDestination, jmsQueue 또는 jmsTopic 요소를 특정 자원 어댑터가 제공하는 JMS 대상 인터페이스와 연관시키려면 구성 특성을 대체하지 않는 경우에도 properties 하위 요소를 제공해야 합니다. 다음 예제에서 MyAdapter 자원 어댑터는 한 가지 유형의 JMS 대상, 한 가지 유형의 JMS 큐 및 한 가지 유형의 JMS 주제를 제공합니다.
    <jmsDestination jndiName="jms/destination1">
     <properties.MyAdapter name="DEST1"/>
    </jmsDestination>
    
    <jmsQueue jndiName="jms/queue1">
     <properties.MyAdapter queueName="QUEUE1"/> 
    </jmsQueue> 
    
    <jmsTopic id="topic1" jndiName="jms/topic1">
     <properties.MyAdapter topicName="TOPIC1"/>
    </jmsTopic>
  2. (선택사항) 필요한 경우, 사용 가능한 대상, 큐 및 주제 특성 하위 요소 이름을 식별하십시오.
    참고: 이 주제에서는 MyAdapter라는 고유 ID가 있는 자원 어댑터가 이미 서버에서 구성되었다고 가정합니다. 추가 세부사항은 자원 어댑터 구성의 내용을 참조하십시오.

    제한사항: WebSphere Development Tools(WDT)의 디자인 보기에서는 연결 팩토리, 관리 오브젝트, 활성화 스펙 및 자원 어댑터에 대한 자원 어댑터 구성의 특성을 편집할 수 없습니다.

    • 자원 어댑터가 javax.jms.Destination 인터페이스가 있는 단 하나의 관리 오브젝트 유형만 제공하는 경우, 하위 요소 이름은 properties.<rar_identifier>입니다.

    • 구현 이름이 패키지 이름을 제외하면 고유한 경우, 하위 요소 이름은 properties.<rar_identifier>.<ImplementationName> 입니다.

    • 그밖의 경우, 하위 요소 이름은 properties.<rar_identifier>.<fully.qualified.InterfaceName>입니다.

    • 자원 어댑터가 javax.jms.Queue 인터페이스가 있는 단 하나의 관리 오브젝트 유형만 제공하는 경우, 하위 요소 이름은 properties.<rar_identifier>입니다.

    • 구현 이름이 패키지 이름을 제외하면 고유한 경우, 하위 요소 이름은 properties.<rar_identifier>.<ImplementationName> 입니다.

    • 그밖의 경우, 하위 요소 이름은 properties.<rar_identifier>.<fully.qualified.InterfaceName>입니다.

    • 자원 어댑터가 javax.jms.Topic 인터페이스가 있는 단 하나의 관리 오브젝트 유형만 제공하는 경우, 하위 요소 이름은 properties.<rar_identifier>입니다.

    • 구현 이름이 패키지 이름을 제외하면 고유한 경우, 하위 요소 이름은 properties.<rar_identifier>.<ImplementationName> 입니다.

    • 그밖의 경우, 하위 요소 이름은 properties.<rar_identifier>.<fully.qualified.InterfaceName>입니다.

다음 예제를 사용하여 두 개의 JMS 대상과 고유한 구현 클래스 이름을 가진 자원 어댑터를 구성하는 방법을 학습하십시오.

다음 스니펫은 ra.xml 파일에 있으며, MyAdapter 자원 어댑터는 고유한 구현 클래스 이름과 두 개의 JMS 대상을 제공합니다.

<adminobject>
<adminobject-interface>javax.jms.Destination</adminobject-interface>
<adminobject-class>com.vendor.adapter.QueueImpl</adminobject-class>
<config-property>
 <config-property-name>queueName</config-property-name>
 <config-property-type>java.lang.String</config-property-type> 
</config-property>
 ... 
</adminobject>

<adminobject>
<adminobject-interface>javax.jms.Destination</adminobject-interface>
<adminobject-class>com.vendor.adapter.TopicImpl</adminobject-class> 
<config-property>
 <config-property-name>topicName</config-property-name> 
 <config-property-type>java.lang.String</config-property-type> 
</config-property>
...
</adminobject>
다음은 이 시나리오를 위한 서버 구성의 예제입니다.
<jmsDestination jndiName="jms/destination1">
 <properties.MyAdapter.QueueImpl queueName="D1"/>
</adminObject> 

<jmsDestination jndiName="jms/destination2">
 <properties.MyAdapter.TopicImpl topicName="D2"/> 
</jmsDestination>

다음 예제를 사용하여 고유한 구현 클래스 이름이 없고 두 개의 관리 오브젝트가 있는 자원 어댑터를 구성하는 방법을 학습하십시오.

다음 스니펫은 ra.xml 파일에 있으며, MyAdapter 자원 어댑터는 고유하지 않은 구현 클래스 이름과 두 개의 관리 오브젝트를 제공합니다.

<adminobject>
<adminobject-interface>javax.jms.Queue</adminobject-interface>
<adminobject-class>com.vendor.adapter.QueueImpl</adminobject-class>
<config-property>
 <config-property-name>queueName</config-property-name>
 <config-property-type>java.lang.String</config-property-type> 
</config-property>
... 
</adminobject>

<adminobject>
<adminobject-interface>javax.jms.Queue</adminobject-interface>
<adminobject-class>com.vendor.adapter.advanced.QueueImpl</adminobject-class>
<config-property>
 <config-property-name>name</config-property-name>
 <config-property-type>java.lang.String</config-property-type> 
</config-property>
 ...
</adminobject>
다음은 이 시나리오를 위한 서버 구성의 예제입니다.
<jmsQueue jndiName="jms/myQueue">
 <properties.MyAdapter.com.vendor.adapter.QueueImpl queueName="Q1"/>
</jmsQueue>

<jmsQueue jndiName="jms/myAdvancedQueue">
 <properties.MyAdapter.com.vendor.adapter.advanced.QueueImpl name="Q1"/>
</jmsQueue>
일부 시나리오에서 긴 구성 요소 이름은 바람직하지 않습니다. 구성 요소 이름의 접미부를 대체하는 방법에 대해 학습하려면 JCA 구성 요소 사용자 정의에 대한 정보를 참조하십시오.

주제의 유형을 표시하는 아이콘 태스크 주제

파일 이름: twlp_jms_config_dest.html