Java Web 服务: Metro 简介

核心提示： 要使用 Ant build.xml 构建示例应用程序，打开一个控制台，Java Web 服务: Metro 简介(7)，进入下载文件的根目录，输入 ant，Metro 和 Axis2 对这方面的相似问题采取不同的方法，在下一篇文章中，这将首先调用 JAX-WS wsimport 工具（包括在 M

要使用 Ant build.xml 构建示例应用程序，打开一个控制台，进入下载文件的根目录，输入 ant。这将首先调用 JAX-WS wsimport 工具（包括在 Metro 中），然后编译客户端和服务器，最后将服务器代码打包为 WAR。接着可以将生成的 metro-library.war 文件部署到测试服务器，并在在控制台输入 ant run，尝试运行示例客户端。示例客户端运行，经过一系列对服务器的请求，打印出每个请求的简要结果。

不幸的是，Metro 处理不会完全地执行例子。当 Metro 服务器代码将异常转换成 SOAP Fault 消息时，它还（默认地）发送栈跟踪细节。Metro 客户端代码不能识别响应中的 Fault 数据，只是抛出适当的 Fault 对象，而不会填充包含的数据。在例子代码中，这会导致一个 NullPointerException。

为了改变这种令人惊讶的默认行为，需要在服务器 JVM 上设置一个 com.sun.xml.ws.fault.SOAPFaultBuilder.disableCaptureStackTrace=false 属性。（是的，正是这样 — 将 disableCaptureStackTrace 属性设为 false，以禁止发送栈跟踪）。通常需要在 Java Web 服务器启动时进行这样的属性设置。对于 Tomcat，可以通过定义一个环境变量来完成这项工作：

CATALINA_OPTS=　
　-Dcom.sun.xml.ws.fault.SOAPFaultBuilder.disableCaptureStackTrace=false

对服务器配置进行了更改并且重新启动服务器后，应该可以完全运行示例程序。

结束语

在本文中，您看到了使用 Metro Web 服务栈的基本知识。由于 Metro 使用 JAX-WS 2.x 注释进行配置，因此 “Axis2 中的 JAXB 和 JAX-WS” 中使用的 JAX-WS 2.x 示例应用程序代码在 Metro 中也可以使用。唯一需要关心的是如何打包代码并将其部署到服务器端，Metro 和 Axis2 在这方面有明显的差异。Metro 使用嵌入式方法为每个服务或服务组创建一个 Web 应用程序（不提供控制或监视功能）。而 Axis2 通常使用一个专用的 Web 应用程序作为任意数量的服务的宿主（通过 Web 页面直接提供基本的控制和监视功能）。

除了基本的 Web 服务消息交换外，Metro 还支持 SOAP 扩展，例如 WS-Security。和服务打包问题一样，Metro 和 Axis2 对这方面的相似问题采取不同的方法。在下一篇文章中，您将看到 Metro 如何处理在前面的文章中使用 Axis2 处理的 WS-Security 例子。

本文示例源代码或素材下载