创建新的网关服务配置

使用 Web Service 网关来将现有的服务(入站服务或出站服务)映射到表现为由该网关提供的新 Web Service。网关服务充当代理:网关服务用户不需要了解底层服务是以内部方式提供的还是以外部方式提供的。

开始之前

要了解有关如何在总线支持的 Web Service 整体配置过程中配置 Web Service 网关的高级任务概述,请参阅通过服务集成总线来启用 Web Service

您为特定网关实例配置每个网关服务,因此,必须先创建网关实例,然后才能为它配置任何网关服务。

网关服务 WSDL 是根据第一个目标服务的 WSDL 创建的。如果该目标服务是外部 Web Service,那么它已经具有相关联的 WSDL。如果这是内部服务:
本主题还假定:

决定要用于配置这些资源的方法。可按本任务所述使用管理控制台创建新网关服务,也可使用 createWSGWGatewayService 命令进行创建。

关于此任务

下图说明网关服务对客户机请求者应用程序的作用(就好像它是入站服务一样)。但是,网关服务还会映射至提供了目标服务(内部服务或外部提供的 Web Service)的服务目标。客户机请求被端点侦听器接收到,然后通过入站端口传递至网关服务;目标服务是目标上直接提供的内部服务或目标上通过一个或多个出站端口提供的外部服务;还可在端口应用 JAX-RPC 处理程序和 WS-Security 绑定。

图 1. 网关服务将入站服务映射至目标服务的方式此图用四周的文本描述。

网关服务是底层服务(目标服务)的 Web 接口。网关服务是在另一个位置提供给目标服务的,因此,您可以替换或重新定位目标服务,而不必更改相关网关服务的详细信息。每个网关服务也可以有多个目标服务(即,同一逻辑服务的多个实现)。有关更多信息,请参阅目标服务和网关服务

目标服务可以是外部提供的 Web Service,也可以是在组织内部提供的服务,并且,它可以位于与网关服务不在同一总线中的目标上。 如果目标服务是内部服务,那么新的网关服务始终是根据该服务的模板 WSDL 和要提供该服务的总线目标创建的。如果它是外部提供的 Web Service,那么新的网关服务通常是根据该服务的以外部方式发布的 WSDL 创建的,并且是在新的总线目标上创建的。但是,如果该目标是以外部方式提供的 Web Service 并且已在某个总线目标上可用(例如,这是因为它先前已被配置为出站服务),那么您在新网关服务的创建过程中应该提供目标细节。否则,同一个外部 Web Service 在两个不同的目标上都可用。

您可以采用下列方式来控制和监视对网关服务的访问:
  • 通过使服务仅可通过特定网关实例可用,可以控制能够访问特定网关服务的用户组有哪些。
  • 可以使 JAX-RPC 处理程序列表与端口相关联,以便处理程序可以监视该端口的活动以及根据通过该端口传递的每条消息的发送方和内容来执行适当的操作。
  • 您可以设置要应用于消息的安全级别(WS-Security 绑定)。可以为请求消息和响应消息分别设置安全级别。

在创建新的网关服务时,您配置一个目标服务作为似乎是该网关提供的新 Web Service。在创建新的网关服务之后,可以通过修改现有的网关服务配置来添加更多的目标服务(即,同一个逻辑服务的更多实现)。

要使用管理控制台创建新的网关服务,请完成下列步骤。有关新网关服务属性的更多信息,请参阅网关服务设置

过程

  1. 启动管理控制台。
  2. 在导航窗格中,单击服务集成 -> 总线 -> bus_name -> [其他属性] Web Service 网关实例 -> instance_name -> 网关服务 这就显示了网关服务集合表单
  3. 单击新建 这就显示了一个面板,通过该面板,您为新的网关服务选择第一个目标服务。
  4. 选择两种方法的其中一种方法来创建网关服务(通过 WSDL 定义的 Web Service 提供程序服务目标),然后单击下一步
    注: 如果目标服务是内部服务,或者是已在目标上可用的以外部方式提供的 Web Service,那么选择服务目标。如果目标服务是在总线目标上尚未可用的以外部方式提供的 Web Service,那么选择 WSDL 定义的 Web Service 提供程序,并对新目标配置该目标服务。
    这将根据您选择的服务创建方法来显示“新建网关服务”向导。
  5. 可选: 如果您选择了 WSDL 定义的 Web Service 提供程序,请执行以下步骤:
    1. 指定网关服务名、网关服务目标和调解。
      注:
      • 选择网关服务名,该网关服务名在当前网关实例内的所有网关和代理服务中应该是唯一的。如果您输入的名称不是唯一的,那么将显示错误消息。
      • 不需要提供网关目标名。如果保留这些字段中的任何一个字段为空白,那么向导在完成它的操作时将生成缺省名称。缺省名称不会显示在面板中。这些名称是按如下方式构造的:
        • 请求目标名与网关服务名相同。例如:myGatewayService
        • 应答目标名与请求目标名相同,但在尾部添加“Reply”。例如:myGatewayServiceReply
      • 可用调解列表包含当前已部署到此服务集成总线的所有调解。如果已经创建了调解并将其部署到总线,那么它将显示在这两个列表中以供您选择。如果您不想对此网关服务使用调解,那么请从其中一个选择列表中或者同时从这两个选择列表中选择
      • 总线成员是添加至此总线的应用程序服务器或集群。请求调解总线成员响应调解总线成员属性定义了相应调解被指定给的总线成员。如果将请求调解响应调解属性值更改为(无),那么应该还将相应总线成员属性值更改为(无)。如果想要使用调解,那么对总线成员指定该调解。如果未这样做,管理控制台就会显示错误消息。
    2. 查找目标服务 WSDL。
    3. 从 WSDL 中选择服务。
      注:
      • 当 WSDL 包含多个服务时,需要使用此选项。缺省情况下,此字段已填写完毕。如果 WSDL 仅包含一个服务,那么可以接受缺省值。
      • 在您选择的服务中,必须已定义了至少一个端口。
    4. 选择要对此服务启用的端口。
      注:
      • 可用端口列表就是 WSDL 文件中描述的端口集合。
      • 至少选择一个端口。
    5. 对出站服务、服务目标及所有端口目标进行命名。
      注:
      • 已生成了缺省名称,但您可以对它们进行重命名。缺省名称在当前服务集成总线中是唯一的。同样,您选择的任何替换名称都必须唯一。如果您输入的名称不是唯一的,那么将显示错误消息。
      • 如果已经创建了端口选择调解并将其部署至总线,那么它将显示在调解列表中以供您选择。如果您不想对此网关服务使用端口选择调解,请从下拉列表中选择。此列表包含所有当前已被部署至此服务集成总线的调解,包括端口选择调解。
      • 可用端口列表就是 WSDL 文件中描述的端口子集。您在上一个步骤中选择了这个子集。
    6. 将每个端口目标和端口选择调解(可选)指定给总线成员。
      注:
      • 仅当您在上一个步骤中选择了调解时,才会显示将端口选择调解指定给总线成员的选项。
    7. 为此网关服务的入站配置选择端点侦听器。
    8. 定义任何 UDDI 发布属性。
      注: 指定用来将此网关服务发布至一个或多个 UDDI 注册中心的 UDDI 发布属性。有关 UDDI 发布属性的信息,请参阅 UDDI 发布设置UDDI 注册中心:可由支持总线的 Web Service 引用的 Web Service 目录
  6. 可选: 如果您选择了服务目标,请执行以下步骤:
    1. 指定网关服务名、网关和目标服务目标以及调解。
      注:
      • 选择网关服务名,该网关服务名在当前网关实例内的所有网关和代理服务中应该是唯一的。如果您输入的名称不是唯一的,那么将显示错误消息。
      • 目标服务不需要与网关服务位于同一总线上,因此,您指定提供了该目标服务的总线以及相关服务目标。
      • 目标总线名字段列示了所有可用总线。目标位置名字段列示了所有可用目标。当您选择总线和相关目标时,选择位于所选总线中的目标。如果未这样做,管理控制台就会显示错误消息。
      • 不需要提供网关目标名。如果保留这些字段中的任何一个字段为空白,那么向导在完成它的操作时将生成缺省名称。缺省名称不会显示在面板中。这些名称是按如下方式构造的:
        • 请求目标名与网关服务名相同。例如:myGatewayService
        • 应答目标名与请求目标名相同,但在尾部添加“Reply”。例如:myGatewayServiceReply
      • 可用调解列表包含当前已部署到此总线的所有调解。如果已经创建了调解并将其部署到总线,那么它将显示在这两个列表中以供您选择。如果您不想对此网关服务使用调解,那么请从其中一个选择列表中或者同时从这两个选择列表中选择
      • 请求调解总线成员响应调解总线成员属性定义了相应调解被指定给的总线成员。如果将请求调解响应调解属性值更改为(无),那么应该还将相应总线成员属性值更改为(无)。要使用调解,应对总线成员指定该调解。如果未这样做,管理控制台就会显示错误消息。
    2. 选择 WSDL 位置。
      注: 对于内部服务,模板 WSDL 是一个特定于服务的 WSDL 文件,该文件描述在某个服务目标上直接可用的服务。
    3. 从 WSDL 中选择服务。
      注:
      • 当 WSDL 包含多个服务时,需要使用此选项。缺省情况下,此字段已填写完毕。如果 WSDL 仅包含一个服务,那么可以接受缺省值。
      • 在您选择的服务中,必须已定义了至少一个端口。
    4. 为此网关服务的入站配置选择端点侦听器。
    5. 定义任何 UDDI 发布属性。
      注: 指定用来将此入站服务发布至一个或多个 UDDI 注册中心的 UDDI 发布属性。有关 UDDI 发布属性的信息,请参阅 UDDI 发布设置UDDI 注册中心:可由支持总线的 Web Service 引用的 Web Service 目录
    6. 如果该目标服务是外部 Web Service,那么“其他属性”部分将包含选项出站 Web Service 支持。单击此选项以修改此目标服务的出站服务配置。 有关更多信息,请参阅修改现有出站服务配置
  7. 单击完成

结果

如果处理成功地完成,那么此网关实例的网关服务列表将更新为包括新的网关服务。否则,将显示错误消息。

下一步做什么

要对新的网关服务进行修改或者对该网关服务添加其他目标服务(即,同一个逻辑服务的其他实现),请参阅修改现有的网关服务配置。要设置对消息应用的安全级别(WS-Security 绑定),请参阅通过使用 WS-Security 来配置 SOAP 消息的安全传输

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



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