开发 JAX-RPC 应用程序的 WSDL 文件

可以开发 Web Service 描述语言 (WSDL) 文件来描述 Java™ API for XML-based RPC (JAX-RPC) Web Service 应用程序的特征,包括服务所在的位置以及如何使用 XML 格式调用服务。

开始之前

根据开发路径的不同,请从 JavaBeans 实现中开发服务端点接口或者从企业 Bean 实现中开发服务端点接口。

关于此任务

您需要 WSDL 文件以使用 Web Service。您可开发您自己的 WSDL 文件或通过电子邮件、下载或统一资源定位符 (URL) 从 Web Service 提供程序处获取。本文档假设您正在创建您自己的 WSDL 文件。

通过执行列示的操作来开发 WSDL 文件:

过程

  1. [IBM i]运行“启动 Qshell”(STRQSH) 命令以启动 Qshell。
  2. [IBM i]更新 CLASSPATH 环境变量以包括服务端点接口类以及其他被引用类的位置,例如:
    export -s CLASSPATH=/myapp/myclass.class:/myapp/myjar.jar
  3. [AIX Solaris HP-UX Linux Windows][z/OS]将服务端点接口类和已引用的类配置到您的 CLASSPATH 变量中。
    • 在 Windows 系统上,设置 CLASSPATH="%CLASSPATH%;<应用程序 Java 归档 (JAR) 文件和类的列表>"。
    • 在 UNIX 和 Linux 系统上,请导出 CLASSPATH="$CLASSPATH:<应用程序 JAR 文件和类的列表>"。
  4. 运行 Java2WSDL seiInterface 命令。 创建名为 seiInterface.wsdl 的 WSDL 文件。
    支持的配置 支持的配置: z/OS® 平台不支持 Java2WSDL 命令行工具。此功能由本产品的 z/OS 版本附带的组装工具提供。请阅读有关用于 Java API for XML-based Remote Procedure Call (JAX-RPC) 应用程序的 Java2WSDL 命令行工具的内容,以了解有关此工具的更多信息。sptcfg
    • 如果您正在使用 Enterprise JavaBeans (EJB),请将 WSDL 文件移至 META-INF/wsdl 子目录。
    • 如果您正在使用 JavaBeans,请将 WSDL 文件移至 WEB-INF/wsdl 子目录。
  5. 编辑生成的 WSDL 文件,并检查部件名。 WSDL 部件具有 arg_0_0 之类的名称。请修改 WSDL 文件以使用 Java 参数的实际名称。
  6. (可选)使用 Java2WSDL 命令工具生成正确的 WSDL 文件部件名。 您可以使用 Java2WSDL 命令工具自动生成和设置正确的部件名。生成和设置部件名是通过以 Java 实现类(此实现类所实现的方法与服务端点接口相同,并且在启用调试信息的情况下进行编译)形式提供其他信息给 Java2WSDL 命令工具完成的。参数名称存储在 .class 文件中,并带有调试信息。如果您的实现类编译为启用调试,那么您可使用 Java2WSDL -implClass seiImpl seiInterface 命令生成具有正确部件名的 WSDL 文件。

结果

定义由服务端点接口描述的 Web Service 的 WSDL 文件。

示例

本示例使用了 JAR 文件名 AddressBook.jar,后者包含名为 AddressBook.class 的类文件。

您必须将 AddressBook.jar 文件添加到您的 CLASSPATH 以创建 WSDL 文件。JAR 文件包含 EJB 实现类,它编译为启用调试信息。运行 Java2WSDL -implClass addr.AddressBookBean addr.AddressBook 命令以创建文件 AddressBook.wsdl

下一步做什么

根据您的开发路径,为 JavaBeans 开发 Web Service 部署描述符模板,或为企业 Bean 实现开发 Web Service 部署描述符模板。

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



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