将支持 Web Service 的客户机 WAR 文件组装到 EAR 文件中
在生成应用程序工件后,您需要组装这些工件以创建在 Web Service 应用程序中使用的企业归档 (EAR) 文件。
开始之前
可以使用 WebSphere® Application Server 提供的组装工具来组装基于 Java 的 Web Service 模块。
限制: 在应用程序归档中打包的文件名不能包含井号 (#)。由于内部处理问题,当应用程序归档中的文件名包含井号时,应用程序服务器无法正确部署应用程序。发生这种故障时,如果处理应用程序,可能会发生异常。而且,在部署应用程序后,应用程序的某些部分可能会丢失。要解决此问题,请重命名应用程序归档中的任何文件名,以使其不包含井号。
关于此任务
用提供的步骤组装允许应用程序客户机访问 Web Service 的客户机代码和工件:
过程
- 启动组装工具。 请参阅 Rational® Application Developer 文档中关于启动组装工具的信息。
- 如果尚未完成,请配置组装工具使它在 Java EE 模块上工作。需要确保启用了 Java EE 和 Web 类别。 请参阅 Rational Application Developer 文档中关于配置组装工具的信息。
- 将使用 Assembly Toolkit、Application Assembly Tool (AAT) 或其他工具创建的 WAR 文件迁移至 Rational Application Developer 组装工具。要迁移这些文件,请将 WAR 文件导入组装工具。 请参阅 Rational Application Developer 文档中关于使用组装工具导入 Web 应用程序归档 (WAR) 文件的信息。
结果
示例
此组装过程示例使用 AddressBookWeb.war WAR 文件和 AddressBook.ear EAR 文件:
WEB-INF/MANIFEST.MF
WEB-INF/web.xml
WEB-INF/wsdl/AddressBook.wsdl
WEB-INF/AddressBook_mapping.xml
WEB-INF/ibm-webservicesclient-ext.xmi (optional)
WEB-INF/ibm-webservicesclient-bnd.xmi
com/ibm/websphere/samples/webservices/addr/Address.class
com/ibm/websphere/samples/webservices/addr/AddressBook.class
com/ibm/websphere/samples/webservices/addr/AddressBookClient.class
com/ibm/websphere/samples/webservices/addr/AddressBookService.class
...other generated classes...
组装 AddressBookWeb.war 文件到 AddressBook.ear 文件后,AddressBook.ear 文件包含下列文件:
META-INF/MANIFEST.MF
AddressBookWeb.war
META-INF/application.xml
下一步做什么
对于 Java™ API for XML-Based Web Services (JAX-WS) 应用程序,您已准备好部署 Web Service 客户机应用程序。
对于 Java API for XML-based RPC (JAX-RPC) 应用程序,需要使用组装工具配置客户机部署描述符绑定,这样客户机才能与部署在服务器上的 Web Service 进行通信。