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

在前一篇文章中，讲述了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

 1 package  hello;
 2
 3 public   class  CircleFunctions  {
 4
 5     public   double  getArea( double  radius)  {
 6         return  java.lang.Math.PI  *  (r  *  r);
 7     }
 8
 9     public   double  getCircumference( double  radius)  {
10         return   2   *  java.lang.Math.PI  *  r;
11    }
12 }
13
14

 

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

Java 代码 列表2

 1package hello;
 2
 3import javax.jws.WebService;
 4
 5@WebService
 6
 7public class CircleFunctions {
 8   public double getArea(double r) {
 9       return java.lang.Math.PI * (r * r);
10    }
11
12   public double getCircumference(double r) {
13        return 2 * java.lang.Math.PI * r;
14    }
15
16}
17
18

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

Java 代码 列表3

 1import javax.xml.ws.Endpoint;
 2
 3public static void main(String[] args) {
 4
 5      Endpoint.publish(
 6         "http://localhost:8080/WebServiceExample/circlefunctions",
 7         new CircleFunctions());
 8
 9}
10
11

现在，用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:  // localhost:8080/WebServiceExample/circlefunctions?WSDL    

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