使用 wsadmin 脚本编制配置 Web Service 客户机部署的 WSDL 文件名称

将 Web Service 应用程序部署到 WebSphere® Application Server 中时,会为每个应用程序或模块创建一个实例。该实例包含 Web 模块或 Enterprise JavaBeans (EJB) 模块(包括客户机绑定)的部署信息。

开始之前

开始本任务前,您应该让 Web Service 应用程序部署就绪,或已经将 Web Service 部署到 WebSphere Application Server 中。

要完成本任务,您需要了解 Web Service 服务器的 URL 端点地址的拓扑,以及客户机取决于哪个 Web Service。 您可在管理控制台中查看部署描述符,以找到拓扑信息。要了解更多信息,请参阅“在管理控制台中查看 Web Service 服务器部署描述符”信息。

有关 wsadmin 工具选项的更多信息,请参阅关于 AdminApp 对象 install、installInteractive、edit、editInteractive、update 和 updateInteractive 命令的选项的信息。

关于此任务

客户机绑定定义 Web Service 描述语言 (WSDL) 文件名和首选端口。可以在兼容的 WSDL 文件内指定模块中 Web Service 的相对路径,该 WSDL 文件包含要用于请求的实际 URL。仅当原始 WSDL 文件不包含 URL 或当需要不同的地址时才需要此地址。对于定义了多个端口的服务端点,您需要定义备用 WSDL 文件名。

以下步骤描述了在服务器上部署这些绑定后,如何编辑 Web Service 的绑定。当一个 Web Service 与另一个 Web Service 进行通信时,必须配置客户机绑定,以访问下游 Web Service。

您使用本任务中的 WebServicesClientBindDeployedWsdl 命令行选项来更改端点。使用命令行选项的某个好处是您可以避免卸载、修改企业归档 (EAR) 文件和重新安装应用程序以更改绑定配置。另一个好处是在安装期间为不同环境定制 Web Service 绑定应用程序的能力,还可以避免为每个版本创建不同的应用程序 EAR 文件的需要。

开发和组装作为 Web Service 的客户机的 Web Service 模块期间,可以提供多个版本的 WSDL 文件(每个文件都具有不同的服务端点)。安装期间或安装后,当您配置已安装应用程序时,WebServicesClientBindDeployedWsdl 选项可用于指定要使用哪个 WSDL 文件。

因为 WSDL 文件为客户机可以使用的所有端口类型和端口定义所有服务端点或实现,所以部署的 WSDL 文件可以将一组选项分组到一个 WSDL 中。您可以用端口覆盖端点。

您可以使用 Jacl 或 Jython 脚本,但是本任务假定您使用的是 Jacl。有关使用脚本编制进行部署和管理的更多信息,请参阅《脚本编制入门》信息。

要使用 wsadmin 工具配置客户机绑定,请继续以下步骤:

过程

  1. 启动脚本编制命令。 要了解更多信息,请参阅“启动 wsadmin 脚本编制客户机”信息。
  2. wsadmin 命令提示符下,输入命令语法。 您可以使用 install、installInteractive、edit 或 editInteractive 选项。以下示例表示语法:
    $AdminApp edit <app_name> { 
    -WebServicesClientBindDeployedWsdl {{<module_name> <EJB_name> <web_service> 
    <deployed_WSDL_filename>}...} 
    因为您可以编辑多个 URL 片段,所以该示例显示多个节和 URL 端点。 其中:
    • app_name 是应用程序名,例如 WebServicesSample.ear
    • module_name 是 EJB 或 Web 模块名,例如,AddressBookW2JE.jar
    • EJB_name 是 EJB 名(如果模块不是 Web 模块),例如,Exchange
    • web_service 是 Web Service 名称,例如,service/StockQuoteService
    • deployed_WSDL_filename 识别与此模块关联的 WSDL 文件,例如,META-INF/wsdl/AlternativeStockQuoteFetcher.wsdl
  3. $AdminConfig save 命令保存配置更改:

结果

您的 Web Service 客户机绑定已配置。

示例

以下示例将应用程序、模块和部署的 WSDL 文件名表示为它在命令行中所写的内容:
$AdminApp edit MultiEjbJar {-WebServicesClientBindDeployedWSDL {{ejbclientonly.jar Exchange 
service/StockQuoteService META-INF/wsdl/AlternateStockQuoteFetcher.wsdl}...}} 

下一步做什么

现在您可以完成任何其他配置、启动或重新启动应用程序,并验证需要的 Web Service 行为。

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



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