13.3. WSDL 扩展

概述

您可以在合同中插入 WSDL 扩展元素（在绑定范围、服务范围或端口范围）来指定 JMS 传输的基本配置。WSDL 扩展允许您指定引导 JNDI InitialContext 的属性，然后可以用来查找 JMS 目的地。您还可以设置一些影响 JMS 传输层行为的属性。

SOAP/JMS 命名空间

SOAP/JMS WSDL 扩展在 http://www.w3.org/2010/soapjms/ 命名空间中定义。要在 WSDL 合同中使用它们，请在 wsdl:definitions 元素中添加以下设置： 

<wsdl:definitions ...
    xmlns:soapjms="http://www.w3.org/2010/soapjms/"
  ... >

WSDL 扩展元素

表 13.4 “SOAP/JMS WSDL 扩展元素” 显示可用于配置 JMS 传输的所有 WSDL 扩展元素。

表 13.4. SOAP/JMS WSDL 扩展元素

element默认描述

soapjms:jndiInitialContextFactory

 

指定 JNDI 提供程序的完全限定 Java 类名称。等同于设置 java.naming.factory.initial Java 系统属性。

soapjms:jndiURL

 

指定初始化 JNDI 供应商的 URL。等同于设置 java.naming.provider.url Java 系统属性。

soapjms:jndiContextParameter

 

指定用于创建 JNDI InitialContext 的额外属性。使用 name 和 value 属性来指定属性。

soapjms:jndiConnectionFactoryName

 

指定 JMS 连接工厂的 JNDI 名称。

soapjms:deliveryMode

PERSISTENT

指定是否使用 JMS PERSISTENT 或 NON_PERSISTENT 消息语义。对于 PERSISTENT delivery 模式，JMS 代理在确认信息前将消息存储在持久存储中，而 NON_PERSISTENT 消息仅保存在内存中。

soapjms:replyToName

 

[可选] 指定队列消息的回复目的地。回复目的地会出现在 JMSReplyTo 标头中。对于具有请求语义的应用程序，建议设置此属性，因为 JMS 提供程序将在没有指定临时回复队列时分配临时回复队列。

此属性的值根据 JMS URI 中指定的变体进行解释：

  • JNDI 变体 - 由 JNDI 解析的目的地队列的名称
  • 队列 变体 - 使用 JMS 解析的目的地队列的名称

soapjms:priority

4

指定 JMS 消息优先级，范围从 0 （最低）到 9 （最高）。

soapjms:timeToLive

0

JMS 提供程序丢弃消息的时间（以毫秒为单位）。0 代表一个无限生命周期。

配置范围

WSDL 合同中的 WSDL 元素会影响对合同中定义的端点更改的范围。SOAP/JMS WSDL 元素可以放在 wsdl:binding 元素、wsdl:service 元素或 wsdl:port 元素的子项。SOAP/JMS 元素的父项决定配置要放入哪些范围。

绑定范围
您可以通过在 wsdl: binding 元素中放置扩展元素，在绑定范围内 配置 JMS 传输。此范围内的元素定义使用该绑定的所有端点的默认配置。绑定范围内的所有设置都可以在服务范围或端口范围中覆盖。
服务范围
您可以通过将扩展元素放入 wsdl: service 元素，在服务范围内 配置 JMS 传输。此范围内的元素定义此服务中的所有端点的默认配置。服务范围内的任何设置都可以在端口范围内覆盖。
端口范围
您可以通过将扩展元素放入 wsdl: port 元素，在端口范围内 配置 JMS 传输。端口范围中的元素定义此端口的配置。它们覆盖服务范围或绑定范围中定义的相同扩展元素的默认值。

示例

例 13.9 “带有 SOAP/JMS 配置的 WSDL 合同” 显示 SOAP/JMS 服务的 WSDL 合同。它会在绑定范围内配置 JNDI 层、服务范围内的消息传送详细信息，以及端口范围内的回复目的地。

例 13.9. 带有 SOAP/JMS 配置的 WSDL 合同

<wsdl:definitions ...
    xmlns:soapjms="http://www.w3.org/2010/soapjms/"
  ... >
  ...
  <wsdl:binding name="JMSGreeterPortBinding" type="tns:JMSGreeterPortType">
    ...
    <soapjms:jndiInitialContextFactory>
      org.apache.activemq.jndi.ActiveMQInitialContextFactory
    </soapjms:jndiInitialContextFactory>
    <soapjms:jndiURL>tcp://localhost:61616</soapjms:jndiURL>
    <soapjms:jndiConnectionFactoryName>
      ConnectionFactory
    </soapjms:jndiConnectionFactoryName>
    ...
  </wsdl:binding>
  ...
  <wsdl:service name="JMSGreeterService">
    ...
    <soapjms:deliveryMode>NON_PERSISTENT</soapjms:deliveryMode>
    <soapjms:timeToLive>60000</soapjms:timeToLive>
    ...
    <wsdl:port binding="tns:JMSGreeterPortBinding" name="GreeterPort">
      <soap:address location="jms:jndi:dynamicQueues/test.cxf.jmstransport.queue" />
      <soapjms:replyToName>
        dynamicQueues/greeterReply.queue
      </soapjms:replyToName>
      ...
    </wsdl:port>
    ...
  </wsdl:service>
  ...
</wsdl:definitions>

例 13.9 “带有 SOAP/JMS 配置的 WSDL 合同” 中的 WSDL 执行以下操作：

为 SOAP/JMS 扩展声明命名空间。

在绑定范围内配置 JNDI 连接。

将 JMS 交付方式设置为非持久性，并将每条消息设置为 live （一分钟）。

指定目标目的地。

配置 JMS 传输，以便回复消息在greeter Reply.queue 队列 上发送。