感受野马（Mustang）性情，体会Java SE 6.0的新特性之二－－Web服务

版本历史：
2006.12.17 发布
2006.12.18 更正不加标准输入流读取字符，程序将立即退出，将不能提供服务。将程序列表的行号去掉，方便代码粘贴。

在前一篇文章中，讲述了Java SE 6.0新特征的概观。本文将介绍Web服务。

Java Web 涉及到的JSR有 105,173,181,222,224,250。

由于Web服务日趋流行，利用Web服务的功能性的API特征正从最新的Java EE版本中向Java SE 6平台迁移。换言之，针对Web服务不需另外加入额外的工具，在Java EE和Java SE平台拥有相同的API。野马将大把不同的Web服务相关的API加到标准的工具柜中：以JSR 181针对Java 平台的Web服务元数据，通过JSR 224的基于XML 的Web服务Java API（JAX-WS）；针对Java的带有附件的SOAP API（SAAJ）作为JSR 67 。

与三个Web服务API相关的包新增到Java SE 6.0里：JAX－WS API 放置到javax.xml.ws包； SAAJ类在javax.xml.soap 包； Web服务的元数据类放置在javax.jws包里。

javax.jws 包

JSR 181 及其针对Java 平台Web服务元数据的规范提供一个在类中利用标注设计和开发Web服务的机制。标注从J2SE 5.0引入，在Java SE 6.0得到了进一步扩展。在第10章将会完整描述。但是，标注基本上允许将@tag加入到类，方法和特性来描述相关的元数据。一个解析器然后能定位标记并采取适当的行动；尽管行动什么时候发生完全依赖于标记自身。

JAX-WS 2.0 很容易使用. 本文将介绍如何使用Java SE 6。以JAX-WS如何建立一个简单的Web服务。首先建立一个建立一个将要作为Web服务发布的类，如表1所示：

Java 代码 列表1

package  hello;

public   class  CircleFunctions  {

    public   double  getArea( double  radius)  {
        return  java.lang.Math.PI  *  (r  *  r);
    }

    public   double  getCircumference( double  radius)  {
        return   2   *  java.lang.Math.PI  *  r;
   }
}

为了输出这些方法，必需做两件事情：引入javax.jws.WebService  包；在类的前面增加@WebService  标注以告诉Java编译器将发布此类为Web服务。下面的代码显示了这种变化（以黑体显示增加的代码）。

Java 代码 列表2

package hello;

import javax.jws.WebService;

@WebService

public class CircleFunctions {
   public double getArea(double r) {
       return java.lang.Math.PI * (r * r);
    }

   public double getCircumference(double r) {
        return 2 * java.lang.Math.PI * r;
    }

}

在此，有两个基本的标注：@WebService和@WebMethod。@WebService标注指明HelloService 类作为Web服务。如果没有制定，标注的名称就是类的名称。也能制定命名空间，服务名，WSDL 位置和endpoint 接口等。在指定的上下文环境中，可以使用javax.xml.ws.Endpoint类的publish()静态方法发布上面的类作为Web服务。代码见列表3：

Java 代码 列表3

import javax.xml.ws.Endpoint;

public static void main(String[] args) {

      Endpoint.publish(
         "http://localhost:8080/WebServiceExample/circlefunctions",
         new CircleFunctions());
        try {
            System.in.read();
        } catch (IOException ex) {
            ex.printStackTrace();
        }
}

现在，用javac编译源代码。但是源文件能做什么呢？通过对源文件运行 javac编译器进行编译只是产生了class文件。并没有产生特殊的东西。但是在编译类之后，也需要运行wsgen 命令行工具（wsgen 是Web service generator的缩写）。编译源代码后还必需完成更多的步骤：像下面一样调用wsgen工具。

>  wsgen –cp . hello.CircleFunctions

Wsgen工具将在一个叫做wsgen子目录下产生大量的源代码，然后将这些源代码编译成class文件。尽管从未编辑这些文件，但是可以浏览这些文件。注意在使用Wsgen工具时，原始的源代码必需在相应的包里。否则将产生错误。

就这么简单。当运行应用程序时，Java SE 6平台拥有一个小的Web应用服务器，它将在地址为http://localhost:8080/WebServiceExample/circlefunctions 发布Web服务。通过显示CircleFunction的WSDL 来验证Web服务。当JVM仍然运行时，在浏览器输入：

 http://ocalhost:8080/WebServiceExample/circlefunctions?WSDL    

如果在浏览器里看见大量描述Web服务的功能的XML代码，那么Web服务就成功发布了。