筆記

1. Code first approach:可能不能完全發(fā)揮框架和web services的能量，但能完成目標(biāo)。減少了學(xué)習(xí)曲線(xiàn)，不用非常透徹了解web services概念，只要對(duì)某個(gè)框架有一定了解就能完成任務(wù)。
2.Contract first approach:根據(jù)服務(wù)先寫(xiě)WSDL文件，寫(xiě)好之后使用框架的工具把WSDL轉(zhuǎn)換為依賴(lài)框架的代碼。

一  介紹

當(dāng)客戶(hù)端調(diào)用你的web service的時(shí)候，他會(huì)發(fā)送一個(gè)消息過(guò)來(lái)（可能是soap 消息），如：

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

這時(shí)候如果有一個(gè)轉(zhuǎn)換器把這個(gè)soap消息轉(zhuǎn)換成java對(duì)象，然后調(diào)用你提供的java對(duì)象（方法）的話(huà)將會(huì)是非常方便的。幾個(gè)最流行的庫(kù)就是充當(dāng)了這種轉(zhuǎn)換器功能，比如CXF, Axis2 ， Metro （jdk6自帶的有）。

手動(dòng)創(chuàng)建WSDL文件比較容易出錯(cuò)，可以使用eclipse進(jìn)行可視化編輯。

二 生成服務(wù)代碼

像CXF這樣的 web service庫(kù)可以創(chuàng)建轉(zhuǎn)換器把進(jìn)來(lái)的SOAP 消息轉(zhuǎn)換為Java對(duì)象，然后作為參數(shù)傳給方法。生成這些代碼，只需創(chuàng)建一個(gè)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!");
}

運(yùn)行后會(huì)生成service endpoint interface（SEI），我們?cè)賹?xiě)一個(gè)類(lèi)（比如SimpleServiceImpl）來(lái)實(shí)現(xiàn)這個(gè)接口，寫(xiě)入自己的業(yè)務(wù)。還會(huì)生成傳入消息對(duì)應(yīng)的java對(duì)象。同時(shí)生成一個(gè)服務(wù)器類(lèi)：

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);
    }
}

運(yùn)行這個(gè)類(lèi)你的web service就可以服務(wù)了。

2 Axis2 方式

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

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

二 生成客戶(hù)端代碼

為了調(diào)用這些web service，同樣可以用CXF這些庫(kù)來(lái)生成在客戶(hù)端運(yùn)行的轉(zhuǎn)換器（稱(chēng)為service stub）。當(dāng)調(diào)用stub里的方法的時(shí)候，他會(huì)把你的數(shù)據(jù)/對(duì)象 轉(zhuǎn)換為正確的XML格式，然后發(fā)送給真正的web service。當(dāng)他收到響應(yīng)的時(shí)候，又會(huì)把XML轉(zhuǎn)回Java。

1 CXF 方式

和生成服務(wù)器端類(lèi)似，使用方法

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

運(yùn)行后會(huì)生成客戶(hù)端代碼：

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是創(chuàng)建的service stub，他模擬了客戶(hù)端的服務(wù)。我們需要修改這個(gè)類(lèi)中的_concat_parameters部分，加入?yún)?shù)：

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

現(xiàn)在就可以運(yùn)行客戶(hù)端代碼了。SEI中有一些注解，可以修改，不細(xì)說(shuō)。

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

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為基礎(chǔ)的web service的互操作性。JAX-B類(lèi)庫(kù)提供了Java和XSD類(lèi)型轉(zhuǎn)換的底層支持。

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實(shí)際上是wsdl message的數(shù)據(jù)類(lèi)型，他們和XML Schema type綁定，每個(gè)message的XML Schema types從這些java類(lèi)型得來(lái)的。注：在當(dāng)前的jdk1.6.24中，已經(jīng)融入wsgen自動(dòng)生成的過(guò)程，不需手動(dòng)調(diào)用。

wsgen工具可用來(lái)生成wsdl文件，如：% wsgen -cp "." -wsdl ch01.ts.TimeServerImpl 。這為T(mén)imeServer服務(wù)生成了wsdl。用wsgen生成的wsdl和通過(guò)訪(fǎng)問(wèn)發(fā)布的服務(wù)生成的wsdl 有個(gè)很大的區(qū)別：wsgen生成的沒(méi)有endpoint,因?yàn)檫@個(gè)URL是在發(fā)布服務(wù)的時(shí)候決定的。其他地方兩個(gè)wsdl是相同的。

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

1 先契約再編碼方式
一個(gè)例子：得到一個(gè)tempConvert.wsdl文件，使用命令 wsimport -keep -p ch02.tc tempConvert.wsdl ，命令根據(jù)wsdl的portType生成一個(gè)SEI類(lèi)，把SEI的interface換為class，再把方法改為實(shí)現(xiàn)就可變?yōu)镾IB。把該SIB發(fā)布，再使用命令wsimport -keep -p clientTC http://localhost:5599/tc?wsdl，來(lái)生成客戶(hù)端輔助類(lèi)
2 編碼優(yōu)先
服務(wù)被發(fā)布之后，會(huì)自動(dòng)生成WSDL供客戶(hù)端使用。然而，使用annotations可以控制WSDL或WSDL-generated artifacts的生成。