从 JavaBeans 为 JAX-RPC 应用程序开发服务端点接口

如果要从 JavaBeans 实现开发 JAX-RPC Web Service ,那么必须开发服务端点接口。

准备工作

您需要为 Web Service 设置开发环境并访问现有 Java™ Bean Web 应用程序归档 (WAR) 文件。 请参阅“设置 Web service 的开发环境”的相关信息。

有关此任务

此任务是从 Java Bean 开发 JAX-RPC Web Service 的必需步骤。

服务端点接口定义特定 Java API for XML-based RPC (JAX-RPC) Web Service 的方法。 JavaBeans 实现必须实现与服务端点接口上的方法具有相同特征符的方法。 输入以用作服务端点接口方法的参数和结果有很多限制。 在 JAX-RPC 规范中对这些限制作了说明。

也可以通过使用组装工具来创建服务端点接口。

通过执行列出的操作,为 JavaBeans 实现开发服务端点接口:

过程

  1. 创建包含要包含在服务端点接口中的方法的 Java 接口。
    如果从现有 Java 接口开始,请除去不符合 JAX-RPC 规范的任何方法。
  2. 编译接口。

    为要编译的类使用 javac 命令中的服务端点接口类的名称。

    [Windows]使用 javac 命令。

    [Linux][AIX][HP-UX][Solaris]在 AIX 或 Linux®等操作系统上,请参阅开发瘦应用程序客户机代码信息。

    [IBM i]确保 j2ee.jar 文件位于用于编译接口的类路径中。 JAR 文件位于 app_server_root/dev/JavaEE 目录路径中。

结果

已开发可用来开发 Web service 的服务端点接口。

示例

以下示例描述 AddressBook 接口:
package addr;
public interface AddressBook {
    /**
     * Retrieve an entry from the AddressBook.
     * 
     *@param name the name of the entry to look up.
     *@return the AddressBook entry matching name or null if none.
     *@throws java.rmi.RemoteException if communications failure.
     */
    public addr.Address getAddressFromName(java.lang.String name);
}
使用 AddressBook 接口创建服务端点接口:
  1. 制作 AddressBook.java 接口的副本,并且将它命名为 AddressBook_SEI.java。 将此副本用作服务端点接口的模板。
  2. 编译接口。

下一步做什么?

继续收集开发 web service 必需的工件,包括 Web Service 描述语言 (WSDL) 文件。 您需要开发 WSDL 文件,这是因为它是 web service 的引擎。 缺少 WSDL 文件,您就没有 web service。 请参阅“开发 JAX-RPC 应用程序的 WSDL 文件”信息。