14.5. WSDL을 사용하여 JMS 구성

JMS 주소 정보는 jms:address 요소와 해당 하위 요소인 jms:JMSNamingProperties 요소를 사용하여 제공됩니다. jms:address 요소의 속성은 JMS 브로커와 대상을 식별하는 데 필요한 정보를 지정합니다. jms:JMSNamingProperties 요소는 JNDI 서비스에 연결하는 데 사용되는 Java 속성을 지정합니다.

JMS 엔드포인트의 기본 구성은 jms:address 요소를 서비스 포트 요소의 자식으로 사용하여 수행됩니다. WSDL에서 사용되는 jms:address 요소는 구성 파일에서 사용되는 것과 동일합니다. 해당 속성은 표 14.2. “JMS 끝점 속성” 에 나열됩니다.

jms:address WSDL 요소는 jms:JMSNamingProperties 하위 요소를 사용하여 JNDI 공급자에 연결하는 데 필요한 추가 정보를 지정합니다.

JMS 및 JNDI 공급자와의 상호 운용성을 높이기 위해 jms:address 요소에는 JNDI 공급자에 연결할 때 사용되는 속성을 채우는 데 사용되는 값을 지정하는 데 사용되는 값을 지정할 수 있는 하위 요소 jms:JMSNamingProperties 가 있습니다. jms:JMSNamingProperties 요소에는 name 및 value 의 두 가지 속성이 있습니다. 설정할 속성의 이름을 지정합니다. value 속성은 지정된 속성의 값을 지정합니다. JMS:JMSNamingProperties 요소는 공급자 특정 속성의 사양에 사용할 수도 있습니다.

다음은 설정할 수 있는 일반적인 JNDI 속성 목록입니다.

이러한 속성에 사용할 정보에 대한 자세한 내용은 JNDI 공급자의 설명서를 확인하고 Java API 참조 자료를 참조하십시오.

예 14.6. “JMS WSDL 포트 사양” JMS WSDL 포트 사양의 예를 보여줍니다.

<service name="JMSService">
  <port binding="tns:Greeter_SOAPBinding" name="SoapPort">
    <jms:address jndiConnectionFactoryName="ConnectionFactory"
                 jndiDestinationName="dynamicQueues/test.Celtix.jmstransport" >
      <jms:JMSNamingProperty name="java.naming.factory.initial"
                             value="org.activemq.jndi.ActiveMQInitialContextFactory" />
      <jms:JMSNamingProperty name="java.naming.provider.url"
                             value="tcp://localhost:61616" />
    </jms:address>
  </port>
</service>

JMS 소비자 끝점은 사용하는 메시지 유형을 지정합니다. JMS 소비자 끝점은 JMS Cryostat Message 또는 JMS text Message 를 사용할 수 있습니다.

consumer endpoint는 byte[] 를 사용하여 데이터를 저장하고 JMS 메시지 본문에서 데이터를 검색하는 방법으로 사용합니다. 메시지가 전송되면 포맷된 정보를 포함한 메시지 데이터가 byte[] 로 패키지되고 message body에 배치되기 전에 패키지됩니다. 메시지가 수신되면 소비자 끝점은 바이트[] 에 팩된 것처럼 메시지 본문에 저장된 데이터를 차단 해제하려고 합니다.

textMessage 를 사용하는 경우 소비자 끝점은 메시지 본문에서 데이터를 저장하고 검색하는 방법으로 문자열을 사용합니다. 메시지가 전송되면 형식별 정보를 포함한 메시지 정보가 문자열로 변환되어 JMS 메시지 본문에 배치됩니다. 메시지가 수신되면 소비자 끝점은 JMS 메시지 본문에 저장된 데이터를 문자열로 압축 해제하려고 합니다.

네이티브 JMS 애플리케이션이 Apache CXF 소비자와 상호 작용할 때 JMS 애플리케이션은 메시지 및 포멧 정보를 해석합니다. 예를 들어 Apache CXF 계약이 JMS 끝점에 사용된 바인딩이 Cryostat이고 메시지가 text Message 로 패키지되도록 지정하는 경우 수신 JMS 애플리케이션은 모든 Cryostat 조각 정보를 포함하는 텍스트 메시지를 가져옵니다.

JMS 소비자 엔드포인트에서 허용하는 메시지 유형은 선택 사항 jms:client 요소를 사용하여 구성됩니다. jms:client 요소는 WSDL 포트 요소의 자식이며 하나의 속성이 있습니다.

예 14.7. “JMS 소비자 끝점용 WSDL” 은 JMS 소비자 엔드포인트를 구성하기 위한 WSDL을 보여줍니다.

<service name="JMSService">
  <port binding="tns:Greeter_SOAPBinding" name="SoapPort">
    <jms:address jndiConnectionFactoryName="ConnectionFactory"
                 jndiDestinationName="dynamicQueues/test.Celtix.jmstransport" >
      <jms:JMSNamingProperty name="java.naming.factory.initial"
                             value="org.activemq.jndi.ActiveMQInitialContextFactory" />
      <jms:JMSNamingProperty name="java.naming.provider.url"
                             value="tcp://localhost:61616" />
    </jms:address>
    <jms:client messageType="binary" />
  </port>
</service>

JMS 공급자 끝점에는 구성 가능한 여러 동작이 있습니다. 여기에는 다음이 포함됩니다.

공급자 끝점 동작은 선택적 jms:server 요소를 사용하여 구성됩니다. jms:server 요소는 WSDL wsdl:port 요소의 자식이며 다음과 같은 특성을 갖습니다.

예 14.8. “JMS 공급자 엔드 포인트용 WSDL” 은 JMS 공급자 엔드포인트를 구성하기 위한 WSDL을 보여줍니다.

<service name="JMSService">
  <port binding="tns:Greeter_SOAPBinding" name="SoapPort">
    <jms:address jndiConnectionFactoryName="ConnectionFactory"
                 jndiDestinationName="dynamicQueues/test.Celtix.jmstransport" >
      <jms:JMSNamingProperty name="java.naming.factory.initial"
                             value="org.activemq.jndi.ActiveMQInitialContextFactory" />
      <jms:JMSNamingProperty name="java.naming.provider.url"
                             value="tcp://localhost:61616" />
    </jms:address>
    <jms:server messageSelector="cxf_message_selector"
                useMessageIDAsCorrelationID="true"
                transactional="true"
                durableSubscriberName="cxf_subscriber" />
  </port>
</service>