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 扩展元素。
| element | 默认 | 描述 |
|---|---|---|
|
|
指定 JNDI 提供程序的完全限定 Java 类名称。等同于设置 | |
|
|
指定初始化 JNDI 供应商的 URL。等同于设置 | |
|
|
指定用于创建 JNDI | |
|
| 指定 JMS 连接工厂的 JNDI 名称。 | |
|
|
|
指定是否使用 JMS |
|
|
[可选] 指定队列消息的回复目的地。回复目的地会出现在 此属性的值根据 JMS URI 中指定的变体进行解释：
| |
|
|
| 指定 JMS 消息优先级，范围从 0 （最低）到 9 （最高）。 |
|
|
|
JMS 提供程序丢弃消息的时间（以毫秒为单位）。 |
配置范围
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 队列 上发送。
