使用 wsadmin 脚本编制发布 WSDL 文件

发布每个支持 Web Service 的模块中的 Web Service 描述语言 (WSDL) 文件到您指定的文件系统位置。您可在 Web Service 客户机的开发和配置进程中提供这些 WSDL 文件,这样他们可调用您的 Web Service。

开始之前

在发布 WSDL 文件前,您可配置 Web Service 以 URL 片段格式指定端点信息,以启用 WSDL 端口的完整 URL 规范。请参阅描述对端点 URL 信息进行配置的任务。

要发布 Web Service 描述语言 (WSDL) 文件,您需要企业应用程序(又称为企业归档 (EAR) 文件),其包含支持 Web Service 的模块,并已部署到 WebSphere® Application Server。有关更多信息,请参阅“将 Web Service 应用程序部署至应用程序服务器”相关信息。

关于此任务

发布 WSDL 文件的目的是提供使用 Web Service 描述的客户机,包括标识服务位置的 URL。

在安装 Web Service 应用程序,并可选地修改端点信息后,您可能需要包含已更新端点信息的 WSDL 文件。可通过将已更新的 WSDL 文件发布到文件系统来获得这些文件。如果您是客户机开发者或系统管理员,您可使用 WSDL 文件使客户机能连接到 Web Service。

wsadmin 工具可以按本地方式(例如 -conntype NONE)或远程方式发布 WSDL 文件。但是,以本地方式,在调用 wsadmin 命令的同一个节点上找到目标应用程序。

下列步骤假设已部署应用程序,且应用程序服务器正在运行。

过程

  1. 使用下列命令从命令提示符处启动 wsadmin 工具:
    • [Windows]profile_root\bin\wsadmin
    • [Linux][IBM i][z/OS]profile_root/bin/wsadmin
  2. 在 wsadmin 命令提示符下,输入两个命令中的一个:
    • $AdminApp publishWSDLapp_name path_name
    • $AdminApp publishWSDLapp_name path_name soapAddressPrefixes
    其中:
    • app_name 是应用程序名
    • path_name 是到包含已发布的 WSDL 文件的压缩文件的绝对路径。压缩文件保存在运行 WebSphere Application Server 的机器上,因此,如果服务器正在不同的机器上运行,那么您需要从该机器获取压缩文件。结果压缩文件的目录结构是基于下列信息:
      Application_file_name/module_file_name/META-INF/ or WEB-INF/wsdl/WSDL_file_name
      请参阅使用方案,获取此目录结构的示例。
    • soapAddressPrefixes 是格式为 {{module {{binding partial-url}}}} 的参数。此参数逐个模块地描述应用程序中每个绑定的部分 URL 信息。
      • module 标识模块的名称
      • binding 是 http 或 jms(他们都是小写的)
      • partial-url 是相关 SOAP 绑定的部分 SOAP 地址。对于 HTTP 绑定,格式为 http://host:port/https://host:port
        对于 Java 消息服务 (JMS) 绑定,格式为
        jms:/queue?destination=dest&connectionFactory=cf
        jms:/topic?destination=dest&connectionFactory=cf

    使用 $AdminApp publishWSDL app_Name path_Name 命令以用缺省端点 URL 地址发布 WSDL 文件。如果要修 WSDL 文件的 SOAP 地址前缀,请使用命令的其他格式。

    使用 $AdminApp publishWSDL app_Name path_Name {{module {{binding partial-url}}}} 命令来为每个模块定制 WSDL SOAP 地址。可以为每个 SOAP 绑定指定不同的地址前缀。

结果

发布 Web Service 的 WSDL 文件到指定的压缩文件。压缩文件可用于创建访问已部署服务的 Web Service 客户机。已发布的 WSDL 文件不包含 Enterprise JavaBeans (EJB) 绑定信息。

示例

为名为 WebServicesSamples 的 Web Service 发布 WSDL 文件的命令可以是 $AdminApp publishWSDL WebServicesSamples c:/temp/samplesWsdl.zip

$AdminApp publishWSDL WebServicesSamples c:/temp/sampleswsdl.zip { {AddressBookJ2WB.war {{http http://localhost:9080}}} {StockQuote.jar {{http https://localhost:9443}}} }

此创建的压缩文件的目录结构为
WebServicesSamples.ear/StockQuote.jar/META-INF/wsdl/StockQuoteFetcher.wsdl 
WebServicesSamples.ear/AddressBookW2JE.jar/META-INF/wsdl/AddressBookW2JE.wsdl 
WebServicesSamples.ear/AddressBookJ2WE.jar/META-INF/wsdl/AddressBookJ2WE.wsdl 
WebServicesSamples.ear/AddressBookJ2WB.war/WEB-INF/wsdl/AddressBookJ2WB.wsdl 
WebServicesSamples.ear/AddressBookW2JB.war/WEB-INF/wsdl/AddressBookW2JB.wsdl

下一步做什么

开发 Web Service 客户机或为现有 Web Service 配置端点信息。

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



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