配置 Java 消息服务 (JMS) 传输策略

如果您正在将 SOAP over JMS 与 Java™ API for XML-Based Web Services (JAX-WS) 应用程序配合使用,那么可以定义 Java 消息服务 (JMS) 传输策略配置。

开始之前

您可以对定制策略集的策略配置一些设置。不能编辑提供的缺省策略集。您必须创建缺省策略集的副本或者创建新的策略集,这样才能对其指定策略。

关于此任务

将 SOAP over JMS 传输与 JAX-WS 应用程序配合使用时,您可以通过配置 JMS 传输策略来定制传输。SOAP over JMS 传输用于替代 HTTPS 在客户机与服务器之间传输 SOAP 请求和响应消息。请参阅有关使用 SOAP over JMS 来传输 Web Service 的文档,以了解有关此传输协议的更多信息。

只能通过策略集来配置策略。因此,必须存在包含 JMS 传输策略的策略集,才能配置 JMS 传输策略。要对包含 JMS 传输策略的策略集进行定制,您必须先创建一个策略集并将 JMS 传输策略添加到新的策略集中。

请使用 JMS 传输策略设置面板来定制 JMS 传输策略属性的值,例如请求超时值。为 JMS 传输策略定制的值现在适用于包含该定制 JMS 传输策略的策略集。您可以将这个包含定制 JMS 传输策略的策略集连接到 JAX-WS 应用程序、它的服务、端点或操作。此更改会影响该策略集所连接到的所有 JAX-WS 应用程序。要了解有关如何将策略集连接到应用程序的更多信息,请参阅有关管理应用程序级别的服务提供程序和服务客户机的策略集的文档。

过程

  1. 创建包含 JMS 传输策略的策略集。
    1. 创建定制策略集。 在管理控制台中,请单击服务 > 策略集 > 应用程序策略集。在此面板中,您可以创建新的策略集、从缺省存储库中导入策略集副本或者从指定位置导入现有策略集。
    2. 将 JMS 传输策略添加到此策略集中。 在管理控制台中,请单击服务 > 策略集 > 应用程序策略集 > policy_set_name。在策略集合中,单击 JMS 传输。“JMS 传输”窗口将显示用于配置传输策略的 JMS 设置的选项。
    3. 指定 JMS 传输请求的 JMS 连接属性。 下列字段用于配置此传输的 JMS 功能:
      请求超时
      指定是否启用请求超时值。请求超时值是客户机在将请求发送到服务器之后等待响应的时间量。范围从 0 到 2147483647。
      允许将事务消息传递用于单向操作和异步操作
      指定此选项以使客户机能够在单向或异步双向请求中使用事务。选中此复选框以启用事务消息传递。
      如果选中此选项,那么在客户机处理事务时,客户机运行时环境将通过 JMS 传输以事务方式与服务器交换 SOAP 请求和响应消息。此过程表明,客户机事务用于将 SOAP 请求消息发送到目标队列或主题,而服务器仅在客户机落实事务后才能接收请求消息。同样,服务器在容器管理的事务控制下接收请求消息,然后在适当时使用同一事务将应答消息发回给客户机。这样,客户机只有在服务器事务落实完成后才会接收到应答消息。
      如果未选中此选项,那么客户机和服务器运行时环境将以非事务方式执行消息传递操作,即,为 JMS 请求临时地暂挂事务。这些事务将在请求完成后再次启用。
      支持的配置 支持的配置: 不支持事务消息传递操作进行双向同步操作,因为这会导致死锁情况。sptcfg
  2. 定制 JMS 传输提供程序绑定。
    1. 浏览到 JMS 传输提供程序绑定。 在管理控制台中,请单击服务 > 策略集 > 常规提供程序策略集绑定 > provider_policy_set_binding_name > JMS 传输

      “JMS 传输提供程序绑定”窗口将显示用于为异步服务响应定义基本认证以及为 JMS 服务提供程序绑定配置定义定制属性的选项。

    2. 指定用于异步服务响应的基本认证属性。

      可以使用 JMS 传输提供程序策略绑定来配置通过 JMS 传输将异步响应消息发回给客户机的服务。应用程序服务器运行时环境在连接到 JMS 消息传递提供程序时将使用您配置的用户名和密码,并且,此配置使该服务能够以安全方式将异步响应消息发送到客户机。

      下列字段确定来自服务器的响应的认证要求:

      用户名
      指定服务提供程序的异步服务响应的用户名。
      密码
      指定来自服务提供程序的异步服务响应的密码的占位符。可以在此字段中输入或编辑密码。将屏蔽实际的密码。
      确认密码
      指定来自服务提供程序的异步服务响应的密码的占位符,此密码必须与密码字段中的密码匹配。将屏蔽实际的密码。
  3. 定制 JMS 传输客户机绑定。
    1. 浏览到 JMS 传输客户机绑定。 在管理控制台中,请单击服务 > 策略集 > 常规客户机策略集绑定 > client_policy_set_binding_name > JMS 传输

      “JMS 传输提供程序绑定”窗口将显示用于为出站服务请求定义基本认证以及为 JMS 客户机绑定配置定义定制属性的选项。

    2. 指定出站服务请求的基本认证属性。

      可以使用 JMS 传输客户机策略绑定来配置通过 JMS 传输将请求消息发送到服务器的客户机。客户机运行时环境在连接到 JMS 消息传递提供程序时将使用您配置的用户名和密码。此配置使客户机能够以安全方式将请求消息发送到服务器。

      下列字段确定向服务器发送的请求的认证要求:

      用户名
      指定客户机运行时在连接到 JMS 消息传递提供程序以便将出站请求发送到目标队列或主题时使用的用户名。在此字段中输入用户名。
      密码
      指定客户机运行时在连接到 JMS 消息传递提供程序以便将出站请求发送到目标队列或主题时使用的密码的占位符。可以在此字段中输入或编辑密码。将屏蔽实际的密码。
      确认密码
      指定客户机运行时在连接到 JMS 消息传递提供程序以便将出站请求发送到目标队列或主题时使用的密码的占位符。请在此字段中再次输入密码。此密码必须与密码字段中的密码匹配。将屏蔽实际的密码。
  4. 将 com.ibm.ws.websvcs.transport.jms.enableBasicAuthOnResponse JVM 定制属性设置为 true

    有关如何指定此属性的描述,请参阅“Java 虚拟机定制属性”主题。

  5. 保存更改。

结果

在定制 JMS 传输策略之后,相关联的策略集将使用此策略来配置 SOAP over JMS 传输的运行时行为。

示例

您可以将策略集连接到应用程序、它的服务、端点或操作。在这个示例方案中,假定应用程序有两个不同的 JAX-WS 服务客户机,但您想让这两个服务客户机使用不同的 JMS 传输请求超时值。要修改 JMS 请求超时值,您可以对连接到应用程序或服务客户机(这就是本例中的情况)的策略集所包含 JMS 传输策略的值进行编辑。此更改将影响包含定制 JMS 传输策略的策略集所连接到的所有应用程序。

本示例描述为同一应用程序服务器中部署的服务客户机配置不同请求超时值的步骤。本示例包含下列假定:
  • 在应用程序服务器中部署了两个 JAX-WS 服务客户机,即 ServiceClient1 和 ServiceClient2。
  • 先前尚未将 JMS 传输策略连接到这些应用程序。
  1. 创建两个新策略集并将 JMS 传输策略添加到其中。例如:JMSServiceClient1PolicyJMSServiceClient2Policy
    1. 单击服务 > 策略集 > 应用程序策略集 > 新建
    2. 输入新应用程序策略集的名称 JMSServiceClient1Policy
    3. 在“策略”集合中,单击添加 > JMS 传输
    4. 单击应用,然后单击保存以将更改保存到主配置。
    5. 重复这些步骤,以便创建 JMSServiceClient2Policy。
  2. 为新创建的 JMSServiceClient1Policy 和 JMSServiceClient2Policy 策略集定制 JMS 传输策略设置。例如,对于 JMSServiceClient1Policy 中包含的 JMS 传输策略,将请求超时值设置为 180 秒。JMSServiceClient2Policy 中包含的 JMS 传输策略指定 300 秒作为请求超时值。
    1. 单击服务 > 策略集 > 应用程序策略集 > JMSServiceClient1Policy
    2. 在“策略”集合中,单击 JMS 传输
    3. 在 JMS 传输策略配置面板中,指定 180 秒作为请求超时值。
    4. 单击应用,然后单击保存以将更改保存到主配置。
    5. 单击服务 > 策略集 > 应用程序策略集 > JMSServiceClient2Policy
    6. 在“策略”集合中,单击 JMS 传输
    7. 在 JMS 传输策略配置面板中,指定 300 秒作为请求超时值。
    8. 单击应用,然后单击保存以将更改保存到主配置。
  3. 将定制 JMS 传输策略 JMSServiceClient1Policy 连接到应用程序 ServiceClient1。同样,将定制 JMS 传输策略 JMSServiceClient2Policy 连接到 ServiceClient2。
    1. 单击服务 > 服务客户机 > ServiceClient1
    2. 在“策略集连接”集合中,选择服务 ServiceClient1
    3. 单击连接客户机策略集,然后单击 JMSServiceClient1Policy
    4. 单击保存以将更改保存到主配置。
    5. 单击服务 > 服务客户机 > ServiceClient2
    6. 在“策略集连接”集合中,选择服务 ServiceClient1
    7. 单击连接客户机策略集,然后单击 JMSServiceClient2Policy
    8. 单击保存以将更改保存到主配置。

这样,ServiceClient1 应用程序现在已与 JMSServiceClient1Policy 相连接,并且 JMS 会话使用的请求超时为 180 秒。ServiceClient2 应用程序与策略 JMSServiceClient2Policy 相连接,并且 JMS 会话使用的请求超时为 300 秒。

下一步做什么

您可以对应用程序所需的其他策略进行定制。


指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_wsspsptjms
文件名:twbs_wsspsptjms.html