根据 WSDL 文件开发 JAX-RPC Web Service 客户机的客户机绑定
可以根据 Web Service 描述语言 (WSDL) 文件开发 JAX-RPC Web Service 客户机的客户机绑定。
开始之前
要根据 WSDL 文件开发 JAX-RPC Web Service 应用程序的客户机绑定,必须获取要使用的 WSDL 文件的统一资源定位符 (URL)。您需要绑定和部署描述符,以使客户机能够使用 Web Service。
如果 WSDL
文件是本地文件,那么 URL 应该类似以下示例:file:drive:\path\file_name.wsdl。
![[Linux]](../images/linux.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
如果 WSDL
文件是本地文件,那么 URL 应该类似以下示例:file:/path/file_name.wsdl。
还可以使用绝对或相对文件系统路径来指定本地文件。
通过将 WSDL2Java 命令的 -role
develop-client 选项与 -container 选项组合使用来生成客户机绑定。-container 选项采用以下参数:
- -container client
生成驻留在应用程序客户机容器中的客户机的绑定和部署描述符。
- -container ejb
生成作为 Enterprise JavaBeans (EJB) 模块中企业 Bean 的客户机的绑定和部署描述符。
- -container web
生成驻留在 Web 容器中的客户机的绑定和部署描述符。
关于此任务
运行适当的命令,根据 WSDL 文件开发客户机绑定。
最佳实践: 最好的做法是在 WSDL 或模式中使用绝对名称空间。缺省情况下,WSDL2Java 工具不允许使用相对名称空间。XML Plenary Interest Group 不推荐使用相对名称空间,按照“规范 XML V1.0”规范的要求,使用相对名称空间会导致 XML 数字签名失败。可以将任何相对名称空间转换为绝对名称空间。要了解有关将名称空间与 WSDL2Java 工具一起使用的更多信息,请参阅 JAX-RPC 应用程序文档的 WSDL2Java 命令。bprac过程
运行 WSDL2Java -verbose -role develop-client -container type wsdlURL 命令,
其中 type 对于企业 EJB 客户机是 ejb,对于 JavaBeans 客户机是 web,而对于应用程序客户机是 client。
您可以在命令行中使用下列组合:
因为指定了 verbose 选项,所以运行命令时会显示所有已生成文件的列表。- -container web
- -container ejb
- -container client
结果
示例
以下示例使用 AddressBook 企业 Bean AddressBook.wsdl WSDL 文件。在从 WSDL2Java -verbose -role develop-client -container client AddressBook.wsdl 命令生成绑定后,生成以下文件:
Parsing XML file: file:e:/example/app/topdown/step1/AddressBook.wsdl
WSWS3185I: Info: Parsing XML file: AddressBook.wsdl
WSWS3282I: Info: Generating addr\Address.java.
WSWS3282I: Info: Generating addr\Phone.java.
WSWS3282I: Info: Generating addr\StateType.java.
WSWS3282I: Info: Generating addr\AddressBook.java.
WSWS3282I: Info: Generating addr\AddressBookService.java.
WSWS3282I: Info: Generating META-INF\ibm-webservicesclient-bnd.xmi.
WSWS3282I: Info: Generating META-INF\AddressBook_mapping.xml.
WSWS3282I: Info: Generating META-INF\ibm-webservicesclient-ext.xmi.
下一步做什么
通过编写您的客户机应用程序并组装客户机工件来完成客户机实现。
.
任务主题