網(wǎng)路冷眼@BlogJava

版本歷史：
2006.12.17 發(fā)布
2006.12.18 更正不加標準輸入流讀取字符，程序?qū)⒘⒓赐顺觯瑢⒉荒芴峁┓?wù)。將程序列表的行號去掉，方便代碼粘貼。

在前一篇文章中，講述了Java SE 6.0新特征的概觀。本文將介紹Web服務(wù)。

當(dāng)然，在進行本文之前，請首先下載Java SE 6.0，詳情請瀏覽野馬奔騰而出，Java SE 6 正式版發(fā)布 。

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

由于Web服務(wù)日趨流行，利用Web服務(wù)的功能性的API特征正從最新的Java EE版本中向Java SE 6平臺遷移。換言之，針對Web服務(wù)不需另外加入額外的工具，在Java EE和Java SE平臺擁有相同的API。野馬將大把不同的Web服務(wù)相關(guān)的API加到標準的工具柜中：以JSR 181針對Java 平臺的Web服務(wù)元數(shù)據(jù)，通過JSR 224的基于XML 的Web服務(wù)Java API（JAX-WS）；針對Java的帶有附件的SOAP API（SAAJ）作為JSR 67 。

與三個Web服務(wù)API相關(guān)的包新增到Java SE 6.0里：JAX－WS API 放置到javax.xml.ws包； SAAJ類在javax.xml.soap 包； Web服務(wù)的元數(shù)據(jù)類放置在javax.jws包里。

javax.jws 包

JSR 181 及其針對Java 平臺Web服務(wù)元數(shù)據(jù)的規(guī)范提供一個在類中利用標注設(shè)計和開發(fā)Web服務(wù)的機制。標注從J2SE 5.0引入，在Java SE 6.0得到了進一步擴展。在第10章將會完整描述。但是，標注基本上允許將@tag加入到類，方法和特性來描述相關(guān)的元數(shù)據(jù)。一個解析器然后能定位標記并采取適當(dāng)?shù)男袆樱槐M管行動什么時候發(fā)生完全依賴于標記自身。

JAX-WS 2.0 很容易使用. 本文將介紹如何使用Java SE 6。以JAX-WS如何建立一個簡單的Web服務(wù)。首先建立一個建立一個將要作為Web服務(wù)發(fā)布的類，如表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編譯器將發(fā)布此類為Web服務(wù)。下面的代碼顯示了這種變化（以黑體顯示增加的代碼）。

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服務(wù)。如果沒有制定，標注的名稱就是類的名稱。也能制定命名空間，服務(wù)名，WSDL 位置和endpoint 接口等。在指定的上下文環(huán)境中，可以使用javax.xml.ws.Endpoint類的publish()靜態(tài)方法發(fā)布上面的類作為Web服務(wù)。代碼見列表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();
        }
}

現(xiàn)在，用javac編譯源代碼。但是源文件能做什么呢？通過對源文件運行 javac編譯器進行編譯只是產(chǎn)生了class文件。并沒有產(chǎn)生特殊的東西。但是在編譯類之后，也需要運行wsgen 命令行工具（wsgen 是Web service generator的縮寫）。編譯源代碼后還必需完成更多的步驟：像下面一樣調(diào)用wsgen工具。

>  wsgen –cp . hello.CircleFunctions

就這么簡單。當(dāng)運行應(yīng)用程序時，Java SE 6平臺擁有一個小的Web應(yīng)用服務(wù)器，它將在地址為http://localhost:8080/WebServiceExample/circlefunctions 發(fā)布Web服務(wù)。通過顯示CircleFunction的WSDL 來驗證Web服務(wù)。當(dāng)JVM仍然運行時，在瀏覽器輸入：

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

如果在瀏覽器里看見大量描述Web服務(wù)的功能的XML代碼，那么Web服務(wù)就成功發(fā)布了。