配置处理程序类的 webservices.xml 部署描述符
可以使用组装工具为用户提供的处理程序类配置 webservices.xml 部署描述符。
开始之前
可以使用应用程序服务器提供的组装工具来配置部署描述符。
处理程序类是为修改 SOAP 消息而编写的类,表示远程过程调用 (RPC) 请求或响应。处理程序可以与 Web Service 或 Web Service 客户机关联。
与 Java™ API for XML-based RPC (JAX-RPC) Web Services 类似,可以使用部署描述符来描述 Java API for XML Web Services (JAX-WS) Web Service。对于 JAX-WS Web Service,可以选择是否使用 webservices.xml 部署描述符,这是因为您可以使用注释来指定该部署描述符文件所包含的所有信息。可以使用部署描述符文件来扩充或覆盖现有 JAX-WS 注释。您在 webservices.xml 部署描述符中定义的任何信息将覆盖由注释指定的任何相应信息。
要完成本任务,您需要要配置的应用程序的企业归档 (EAR) 文件。对于某些处理程序的使用(例如记录或跟踪),仅服务器或客户机应用程序需要配置。对于其他处理程序的使用(包括在 SOAP 头中发送信息),必须使用对称的处理程序配置客户机和服务器应用程序。
关于此任务
EAR 文件中的模块包含要配置的处理程序类。这些类实现 javax.xml.rpc.handler.Handler 接口。有关写处理程序类的更多信息,请参阅 Web Services for Java EE 规范的第 6 章。请参阅 JAX-WS 规范中的第 9 章或 JAX-RPC 规范中的第 12 章,以获取有关编程模型的处理程序框架的其他信息。这些应用程序模块必须包含 webservices.xml 部署描述符。请参阅 Web Service 规范和 API 信息,以查看 JAX-RPC 规范以及支持的标准和规范的完整列表。
过程
- 启动组装工具。 请参阅 Rational® Application Developer 信息中关于启动组装工具的信息。
- 如果尚未完成,请配置组装工具使它在 Java EE 模块上工作。需要确保启用了 Java EE 和 Web 类别。 请参阅 Rational Application Developer 信息中关于配置组装工具的信息。
- 将使用 Assembly Toolkit、Application Assembly Tool (AAT) 或其他工具创建的 Web 应用程序归档 (WAR) 文件迁移至 Rational Application Developer 组装工具。 要迁移这些文件,请将 WAR 文件导入组装工具。请参阅 Rational Application Developer 信息中关于将代码工件迁移到组装工具的信息。
- 配置客户机部署描述符。 请参阅 Rational Application Developer 信息中关于配置客户机部署描述符的信息。