用JAX-RPC构建RPC服务和客户机:使用Java API构建基于RPC的Web服务(二)

构建客户机来访问 Web 服务

到目前为止，我们用了很多篇幅讨论 JAX-RPC，但是还没有实际使用这个 API。即使在自动部署 BookSearcher 类时，与 JAX-RPC 相关的工作也是由 Axis 完成的。现在，要让 JAX-RPC 发挥作用了。 构建了希望访问的 Web 服务之后，需要编写客户机来使用 Web 服务。

更新类路径

在开始编写代码之前，需要修改类路径。在前面，已经把几个 JAR 文件放在 servlet 引擎的 lib/ 目录中，并使用 Axis 检验 JSP 确认这些 JAR 的位置是正确的。因为为了运行 Web 服务，servlet 引 擎需要 JAX-RPC 和 Axis 类及其依赖项。

对于 Web 服务客户机也是如此。当然，可以重复相同的步骤，把相同的 JAR 文件放在 JDK 或 JRE 的 ext/lib 目录中。但是，这样做会弄乱 Java 系统并导致版本问题，还会把在您的机器上运行 Java 的其他人弄糊涂。更好的方法是更新 CLASSPATH 变量并设置配置文件或环境，使修改只对您的个人用户 设置生效。

添加 JAX-RPC 和 Axis JAR

首先，进入 Axis 安装目录，看看 lib 目录。应该会看到与清单 18 相似的结果：

清单 18. Apache Axis 的 lib/ 目录中的 JAR

[bdm0509:/usr/local/java/axis-1_4]　ls　lib/
axis-ant.jar　　　　　log4j-1.2.8.jar
axis.jar　　　　　log4j.properties
commons-discovery-0.2.jar　　saaj.jar
commons-logging-1.0.4.jar　　wsdl4j-1.5.1.jar
jaxrpc.jar

把所有这些 JAR 文件添加到类路径中。惟一的可选文件是 axis-ant.jar，如果打算用 Ant 构建项目 ，就应该添加这个 JAR；它包含与 Ant 相关的扩展，支持在 Ant 构建文件中添加 Axis 任务。

添加这些 JAR 的最佳方法之一是，在 Windows 系统中设置环境变量，或者在 Mac OS X 或 Linux 环 境中使用 .profile（或 .bashrc）。清单 19 给出我的 .profile 的一部分，它定位 Axis 安装目录， 然后把其中的几个 JAR 添加到类路径中：

清单 19. 这个 .profile 把 Axis JAR 添加到 CLASSPATH 环境变量中

export　JAVA_BASE=/usr/local/java
export　JAVA_HOME=/Library/Java/Home
export　XALAN_HOME=$JAVA_BASE/xalan-j_2_7_1
export　AXIS_HOME=$JAVA_BASE/axis-1_4

export　CLASSPATH=$XALAN_HOME/xalan.jar:
　　　　　　　　　 $XALAN_HOME/xml-apis.jar:
　　　　　　　　　 $XALAN_HOME/xercesImpl.jar:
　　　　　　　　　 $XALAN_HOME/xalan.jar:
　　　　　　　　　 $XALAN_HOME/xsltc.jar:
　　　　　　　　　 $XALAN_HOME/serializer.jar:
　　　　　　　　　 $AXIS_HOME/lib/axis.jar:
　　　　　　　　　 $AXIS_HOME/lib/jaxrpc.jar:
　　　　　　　　　 $AXIS_HOME/lib/commons-logging-1.0.4.jar:
　　　　　　　　　 $AXIS_HOME/lib/commons-discovery-0.2.jar:
　　　　　　　　　 $AXIS_HOME/lib/saaj.jar:
　　　　　　　　　 $AXIS_HOME/lib/wsdl4j-1.5.1.jar:
　　　　　　　　　 .

清单 19 中的硬换行只是为调整格式添加的。在实际的 .profile 文件中，所有类路径项都在一行上 。