定义 Web service 处理程序

对于包括 Web service 引用的 J2EE 1.3 和 1.4 模块,可以使用部署描述符编辑器为每个 Web service 引用定义和配置 Web service 处理程序。处理程序使您可以为远程调用 Web service 处理 SOAP 消息头通信。SOAP 头由 SOAP 规范定义。处理程序由 JAX-RPC 和 Web Services for J2EE 规范定义。
为了定义 Web service 处理程序,必须首先定义 Web service 引用

为 Web service 引用定义处理程序时,handler 元素会添加到相关服务引用(service-ref 元素)。对于 J2EE 1.3,service-ref 元素位于 webservicesclient.xml 文件中。对于 J2EE 1.4,它位于部署描述符中。

要为 Web service 引用定义 Web service 处理程序,请执行以下操作:

  1. 在 J2EE 透视图的“项目资源管理器”中,展开项目树,选择项目的“部署描述符”节点(要在其中定义 Web service 处理程序)。 可以在 EJB 项目、应用程序客户机项目和动态 Web 项目中为 Web Service 引用定义 Web Service 处理程序。
  2. 右键单击“部署描述符”节点,并从弹出菜单中选择打开方式 > 部署描述符编辑器 此时会打开与您的模块类型相对应的适当部署描述符。例如,在 EJB 部署描述符编辑器中打开 EJB 模块。
  3. 单击 WS 处理程序选项卡,以转至部署描述符编辑器的“处理程序”页。
  4. 服务引用下拉列表中,选择要为其定义处理程序的 Web service 引用。
  5. 单击添加以打开“新建处理程序”对话框,并定义处理程序:
    1. 显示名称字段中,为部署描述符中的 display-name 元素输入值。
    2. 描述字段中,为处理程序的 description 元素输入值。
    3. 处理程序名称字段中,为 handler-name 元素输入值。
    4. 处理程序类字段中,为处理程序的 Java™ 类输入标准名称。此值用于 handler-class 元素。可以单击浏览来查找 Java 类。
  6. 单击完成。处理程序已添加到为所选引用定义的处理程序的列表。如果选择此处理程序,可以查看并修改属性。
  7. 可选: 图标部分中,可以指定小的或大的 GIF 或 JPEG 图像,以在运行时标识 Web service 处理程序。必须首先将图像导入到项目。
  8. 可选: 初始参数部分中,单击添加按钮,以便为所选处理程序的初始参数定义名称和值。
  9. 可选: SOAP 头部分中,单击添加按钮,以便为处理程序的新 SOAP 头定义名称空间 URL 和本地部分。
相关概念
客户机部署描述符编辑器

反馈