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:definitions ...
    xmlns:soapjms="http://www.w3.org/2010/soapjms/"
  ... >

Copy to Clipboard

Toggle word wrap

WSDL 扩展元素
复制链接

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

Expand

表 13.4. SOAP/JMS WSDL 扩展元素
元素	默认	描述
`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 PROJECTI `STENT` 或 `NON_PROJECTISTENT` 消息语义。如果是 BASEI `STENT` 交付模式，JMS 代理会在确认它们前将消息存储在持久性存储中；而 `NON_955ISTENT` 消息仅保存在内存中。
`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 元素可以放置为 ws: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>

<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>

Copy to Clipboard

Toggle word wrap

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

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

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

将 JMS delivery 风格设置为非持久性，每个消息都设置为 live。

指定目标目的地。

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

概述
复制链接

SOAP/JMS 命名空间
复制链接

WSDL 扩展元素
复制链接

配置范围
复制链接

示例
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

13.3. WSDL 扩展

概述复制链接链接已复制到粘贴板!

SOAP/JMS 命名空间复制链接链接已复制到粘贴板!

WSDL 扩展元素复制链接链接已复制到粘贴板!

配置范围复制链接链接已复制到粘贴板!

示例复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

概述
复制链接

SOAP/JMS 命名空间
复制链接

WSDL 扩展元素
复制链接

配置范围
复制链接

示例
复制链接