筆記

1. Code first approach:可能不能完全發揮框架和web services的能量，但能完成目標。減少了學習曲線，不用非常透徹了解web services概念，只要對某個框架有一定了解就能完成任務。
2.Contract first approach:根據服務先寫WSDL文件，寫好之后使用框架的工具把WSDL轉換為依賴框架的代碼。

一  介紹

當客戶端調用你的web service的時候，他會發送一個消息過來（可能是soap 消息），如：

<foo:concatRequest>
<s1>abc</s1>
<s2>123</s2>
</foo:concatRequest>

這時候如果有一個轉換器把這個soap消息轉換成java對象，然后調用你提供的java對象（方法）的話將會是非常方便的。幾個最流行的庫就是充當了這種轉換器功能，比如CXF, Axis2 ， Metro （jdk6自帶的有）。

手動創建WSDL文件比較容易出錯，可以使用eclipse進行可視化編輯。

二 生成服務代碼

像CXF這樣的 web service庫可以創建轉換器把進來的SOAP 消息轉換為Java對象，然后作為參數傳給方法。生成這些代碼，只需創建一個main：

1 CXF方式：

public static void main(String[] args) {
    WSDLToJava.main(new String[] {
    "-server",
    "-d", "src/main/java",
    "src/main/resources/SimpleService.wsdl" });
    System.out.println("Done!");
}

運行后會生成service endpoint interface（SEI），我們再寫一個類（比如SimpleServiceImpl）來實現這個接口，寫入自己的業務。還會生成傳入消息對應的java對象。同時生成一個服務器類：

public class SimpleService_P1_Server {
    protected SimpleService_P1_Server() throws Exception {
        System.out.println("Starting Server");
        Object implementor = new SimpleServiceImpl();
        String address = "http://localhost:8080/ss/p1";
        Endpoint.publish(address, implementor);
    }
    public static void main(String args[]) throws Exception {
        new SimpleService_P1_Server();
        System.out.println("Server ready...");
        Thread.sleep(5 * 60 * 1000);
        System.out.println("Server exiting");
        System.exit(0);
    }
}

運行這個類你的web service就可以服務了。

2 Axis2 方式

用類似的寫main方法，或者配置eclipse的axis2插件可生成：在WSDL文件上，右鍵->web service->generate java bean skeleton

界面的上半部分針對服務端，可以根據需要調整生成的級別，下半部分是生成客戶端。具體的級別可參考eclipse的幫助文檔。一路下一步，最后根據命名空間生成包路徑的文件，里面有XXSkeletonInterface.java 文件（如果生成的時候選擇了生成接口的話），還有一個XXSkeleton實現了這個接口，也是我們需要修改這部分代碼完成我們業務的地方。實際上有一個XXMessageReceiverInOut.java的類接收請求的消息，并調用XXSkeletonInterface。使用eclipse的axis2插件的時候，會自動在web-inf文件夾下生成service\xx(你的wsdl服務名)，這下面還要一個meta-inf文件夾裝有wsd文件和一個services.xml配置文件。services.xml文件可配置包括XXMessageReceiverInOut類在內的選項。

二 生成客戶端代碼

為了調用這些web service，同樣可以用CXF這些庫來生成在客戶端運行的轉換器（稱為service stub）。當調用stub里的方法的時候，他會把你的數據/對象 轉換為正確的XML格式，然后發送給真正的web service。當他收到響應的時候，又會把XML轉回Java。

1 CXF 方式

和生成服務器端類似，使用方法

WSDLToJava.main(new String[] {
"-client",
"-d", "src/main/java",
"src/main/resources/SimpleService.wsdl" });

運行后會生成客戶端代碼：

public final class SimpleService_P1_Client {
    private static final QName SERVICE_NAME = new QName("http://ttdev.com/ss",
        "SimpleService");
    private SimpleService_P1_Client() {} 

    public static void main(String args[]) throws Exception {
        URL wsdlURL = SimpleService_Service.WSDL_LOCATION;
        if (args.length > 0) {
            File wsdlFile = new File(args[0]);
            try {
                if (wsdlFile.exists()) {
                wsdlURL = wsdlFile.toURI().toURL();
            } else {
                wsdlURL = new URL(args[0]);
            }
            } catch (MalformedURLException e) {
                e.printStackTrace();
            }
        } 
        SimpleService_Service ss =
        new SimpleService_Service(wsdlURL, SERVICE_NAME);
        SimpleService port = ss.getP1();
        {
            System.out.println("Invoking concat...");
            com.ttdev.ss.ConcatRequest _concat_parameters = null;
            java.lang.String _concat__return = port.concat(_concat_parameters);
            System.out.println("concat.result=" + _concat__return);
        } 
        System.exit(0);
    }
}

SimpleService_Service是創建的service stub，他模擬了客戶端的服務。我們需要修改這個類中的_concat_parameters部分，加入參數：

com.ttdev.ss.ConcatRequest _concat_parameters = new ConcatRequest();
_concat_parameters.setS1("abc");
_concat_parameters.setS2("123");

現在就可以運行客戶端代碼了。SEI中有一些注解，可以修改，不細說。

有兩種SOAP message風格，document 和RPC，他們定義了SOAP message body的格式。使用document風格時（包括wrapped和unwrapped），在wsdl中有一個非空的types部分，這個部分用XML Schema language定義了web service要用到的類型。wsgen工具從SIB（有SEI就足夠了）中生成與XSD對應的java類。用java代碼生成WSDL文件的時候需要一些java類，wsgen工具可以生成這些Java類，生成的這些java類被稱為wsgen artifacts，底層的JWS類庫會用到這些類，特別是JAX-B系列的包，會用來轉換(marshal)java類實例(that is, Java in-memory objects)為XML類型的XML實例（滿足XML Schema document的XML文檔實例），

The inverse operation is used to convert (unmarshal) an XML document instance to an in-memory
object, an object of a Java type or a comparable type in some other language。因此wsgen工具生成的artifacts，支持了Java為基礎的web service的互操作性。JAX-B類庫提供了Java和XSD類型轉換的底層支持。

For the most part, the wsgen utility can be used without our bothering to inspect the artifacts that it produces. For the most part, JAX-B remains unseen infrastructure.

wsgen artifacts實際上是wsdl message的數據類型，他們和XML Schema type綁定，每個message的XML Schema types從這些java類型得來的。注：在當前的jdk1.6.24中，已經融入wsgen自動生成的過程，不需手動調用。

wsgen工具可用來生成wsdl文件，如：% wsgen -cp "." -wsdl ch01.ts.TimeServerImpl 。這為TimeServer服務生成了wsdl。用wsgen生成的wsdl和通過訪問發布的服務生成的wsdl 有個很大的區別：wsgen生成的沒有endpoint,因為這個URL是在發布服務的時候決定的。其他地方兩個wsdl是相同的。

wsimport(以前叫wsdl2java和 java2wsdl更形象)工具可使用WSDL生成用來幫助寫客戶端的artifacts .

1 先契約再編碼方式
一個例子：得到一個tempConvert.wsdl文件，使用命令 wsimport -keep -p ch02.tc tempConvert.wsdl ，命令根據wsdl的portType生成一個SEI類，把SEI的interface換為class，再把方法改為實現就可變為SIB。把該SIB發布，再使用命令wsimport -keep -p clientTC http://localhost:5599/tc?wsdl，來生成客戶端輔助類
2 編碼優先
服務被發布之后，會自動生成WSDL供客戶端使用。然而，使用annotations可以控制WSDL或WSDL-generated artifacts的生成。