添加 Web service 引用

自 J2EE 1.3 规范开始,应用程序组件(应用程序客户机、Web 模块、EJB 模块)可以通过使用“逻辑”名称(称为 Web service 引用)来定义对外部 Web service 的引用。在 J2EE 1.3 中,引用被添加到模块中的 webservicesclient.xml。自 J2EE 1.4 开始,引用包括在部署描述符中。

在部署时,Web service 引用被绑定至目标运营环境中的 Web service 接口。

对于定义的每个 Web service 引用,都会有一个 service-ref 元素添加到该应用程序组件。Web service 引用的作用域为在其中定义这些引用的应用程序组件或企业 bean,因此在运行时,其他应用程序组件或 bean 不能访问这些引用。其他组件可以使用相同的名称定义 Web service 引用,而不会引起名称冲突。

注: 对于早于 J2EE 1.4 规范级别的项目级别,工作台允许定义 Web service 引用,但 service-ref 元素不会添加到部署描述符(application-client.xml、web.xml 或 ejb-jar.xml)。而会在模块的 WEB-INF 文件夹中的 webservicesclient.xml 文件内声明 Web service 引用。例如,如果将 Web service 引用添加到 J2EE 1.3 应用程序客户机,则引用会添加到 webservicesclient.xml。如果将 Web service 引用添加到 J2EE 1.4 应用程序客户机,则引用会添加到 application-client.xml。
提示: EJB 规范建议在 bean 环境的服务子上下文(java:comp/env/service JNDI 上下文)中组织所有 Web service 引用。

要定义 Web service 引用,请执行以下操作:

  1. 从 J2EE 模块的部署描述符编辑器中打开添加引用向导
  2. 选择服务引用并单击下一步
  3. 从工作空间的 Web service 列表中选择要引用的 Web service。
  4. 名称字段中,为引用指定名称,或者接受向导提供的缺省名称(建议)。名称字段中输入的值用于部署描述符中的 service-ref-name 条目。该名称的值是在企业 bean 代码中使用的环境条目名称。
  5. 单击下一步
  6. 描述文本区域中,输入引用的描述。
  7. 名称空间 URI 字段中,输入新的名称空间 URI,或接受向导提供的值。 在此字段中输入的值在部署描述符中 service-qname 条目中用作 xmlns:prefix 属性。
  8. 本地部分字段中,指示消息目标是使用消息还是发出消息。 在此字段中输入的值用作部署描述符中 service-qname 条目的值:
    <service-qname xmlns:prefix="http://service.directory">
    		prefix:EmployeeDirectoryService
    </service-qname>
  9. 单击完成
相关概念
客户机部署描述符编辑器
相关任务
定义 J2EE 模块中的引用
添加 EJB 引用
添加消息目标引用
添加资源管理器连接工厂引用
添加资源环境引用
添加安全角色引用

反馈