5天學會jaxws-webservice編程第一天

標籤：.com   xmlns   而且   bean   div   href   out   tab   let   

前言：

隨著近幾年來，SOA，EAI等架構體系的日漸成熟，Webservice越來越熾手可熱，尤其是在企業做異質平台整合時成為了首選的技術。

Java的Webservice技術更是層出不窮，比較流行的有：

Axis2，spring WS以及Jaxws。

本人在日常工作和以往工程中，在使用了上述這些Webservice後進行了總結，比較，最終覺得jaxws是目前最標準，需要額外第三方外掛程式最少，配置最少最靈活的webservice。

JAXWS適合幾乎所有Webservice用戶端的調用，因此不少巨頭型的廠商如：IBM，Weblogic等，在他們的產品上都使用了以JAXWS為標準的Webservice介面。

本教程分成五天，為初級教程。

通過本教程，可以使一個沒有Webservice概念或者沒有寫過Webservice的Java Resource快速上手入門，並能滿足一般中小型項目中Webservice的應用。

對於Webservice Security，在（初級）教程中並不提供，會在進階教程中詳細描述。

不過真正利用Webservice Security特性即XML加密技術的工程並不多，少之又少，大多還是以http: //xxx/xxxService?userId=&password=這樣的形式來進行“假安全”通訊的。

必經我們的大部分項目是運行在Intranet裡的，而且有很好的監控和布防。

下面開始我們的教程。

 

第一天

 

目標:

1． 理解jaxws

2． 寫jaxws之前的準備工作

3． 一切始於HelloWorld

4． 理解同步，非同步

一、理解jaxws1.1JAX-WS概述

JAX-WS2.0 的全稱為 Java API for XML-Based Webservices (JAX-WS) 2.0。JAX-WS 2.0 是對 JAX-RPC 1.0 規範的擴充，是 JAX-RPC 1.1 的後續版本， JAX-RPC 2.0 標準發布不久後便被重新命名為 JAX-WS 2.0。 JAX-WS 2.0 是面向 Java 5 的開發 Web services 的最新編程標準，它提供了新的編程模型和對以往的 JAX-RPC 方式的 Web services 進行了增強。 JAX-WS2.0 (JSR 224)是Sun新的web services協議棧，是一個完全基於標準的實現。在binding層，使用的是the Java Architecture for XMLBinding (JAXB, JSR 222)，在parsing層，使用的是the Streaming API for XML (StAX, JSR 173)，同時它還完全支援schema規範。

1.2JAX-WS 2.1特性

??支援SOAP 1.1（預設）、1.2

??支援XML/HTTP Binding

??支援WS-Addressing

??支援document/literal樣式

??支援WS-I Basic Profile 1.1

??支援訊息傳輸最佳化機制（Message Transmission Optimization Mechanism，MTOM）

二、寫jaxws之前的準備工作2.1JDKjavaversion "1.6.0_x"。2.2JAX-WS RI 2.1.1 in JDK 62.2.1 JAX-WS RI 2.1.1安裝註解

JAX-WS RI組件下載後為一個”.jar”檔案，它並不能直接在工程中使用，它是一個以JAVA Swing為介面的JAXWS的安裝程式包。

我們需要開啟一個命令列視窗，並輸入：

  

 

輸入完這條命令後，你會得到一個安裝介面如下：

 

下一步，下一步完成安裝後你會得到這樣的一個目錄：

這個目錄裡有我們寫JAXWS所需的所有lib包以及JAXWS內建的教程。

 

三、一切始於HelloWorld3.1建立Webservice的Server端工程

 

 

可以看到我們這個目錄除傳統的src，WebContent目錄外還有幾個目錄，它們分別是：

 

?    build
?    wsdl
?    wssrc

 

我們來書寫我們的第一個Webservice吧，它的名字叫Hello(Come on, 老套了，又來了)。

package ctsjavacoe.ws.fromjava;   import javax.jws.WebMethod; import javax.jws.WebService;   @WebService public class Hello {     @WebMethod     public String say(String name) {        return ("Hello: "+name);     } }

注意：

@WebService

注釋在了Class之上，這告訴了JAXWS，此類為Webservice。

@WebMethod

注釋在了public方法上，這告訴了JAXWS，此方法為soap方法，該方法有兩個參數，一個input的String，一個output的String。

商務邏輯很簡單，用戶端調用傳入一個Name，服務端返回給用戶端一個”Hello: “+name的字串。

現在我們通過Java檔案來產生Webservice相關布署檔案以及調用介面。

3.2通過Java類編譯Webservice

JAX-WS 2.0 有兩種開發過程：自頂向下和自底向上。自頂向下方式指通過一個 WSDL 檔案來建立Web Service，自底向上是從 Java 類出發建立 Web Service。兩種開發過程最終形成的檔案包括：

1．SEI。一個SEI對應WSDL中WebService的一個port，在Java中是一個Java介面。

2．SEI實作類別。

3．WSDL和XSD檔案。

結合公司內項目的特點，我們更多的是碰到以下兩種情況：

1.  Onsite要我們做一個Webservice或者是客戶要求我們提供Webservice介面；

2.  Onsite已經有一個Webservice了，現在要我們做用戶端整合。

 

因此，我們選用Server端通過Java Class產生webservice，而用戶端通過wsdl產生Java調用類的做法。

 

JAXWS為我們提供了兩個工具：

ü  wsgen

主要用於Server端通過Java類編譯成Webservice及相關的wsdl檔案

ü  wsimport

主要用於Client端（調用端）通過wsdl編譯出調用Server端的Java檔案

我們就來產生一下上面的這個Hello，開啟一個command視窗，鍵入如下命令：

 

-wsdl參數代表產生webservice

- s參數代表產生的.java檔案置於何處

-d 參數代表產生的編譯class檔案置於何處（這個可以忽略，我們利用eclipse編譯）

-r 參數代表產生的.wsdl檔案與.xsd檔案產生在何處

-cp參數代表classpath，即Hello.class的所在，為什麼我們的-cp後是這麼長一個路徑呢？請看Eclipse裡工程編譯輸出目錄的路徑就知道了：

 

3.2.1 產生的src檔案

 

好，我們現在回到eclipse工程裡，重新整理一下工程：

 

看到在wssrc目錄下已經產生了我們所需的java檔案了，請手工cut（對，是cut）這些檔案到我們工程的”src”目錄，如果不cut，下次繼續使用該目錄產生webservice類時，wsgen有時會產生不了，但也不報錯，不知道為什麼，查了一下，可能是一個bug，因該會在後續的jdk1.6.30up裡改進。

3.2.2 產生的wsdl及xsd檔案

 

這裡我們有兩個檔案，一個是wsdl檔案，這個就是我們的webservice的entry，一個是xsd檔案，這個是什嗎？

這個就是我們java的方法裡的參數的對應，或者換句話說，它就是xml格式的java bean，在webservice的世界裡，xsd是作為資料結構描述用的。

現在我們的webservice的服務端有了。

3.2.3 布署webservice

布署前的準備：

在工程的WEB-INF目錄下建立“sun-jaxws.xml”檔案，內容如下：

<?xml version="1.0" encoding="UTF-8"?> <endpoints xmlns=‘http://java.sun.com/xml/ns/jax-ws/ri/runtime‘     version=‘2.0‘>     <endpoint name=‘Hello‘ implementation=‘ctsjavacoe.ws.fromjava.Hello‘         url-pattern=‘/HelloService‘ /> </endpoints>

將ctsjavacoe.ws.fromjava.Hello聲明為Web Service。

 

 

 

 

 

 

如果是從WSDL產生的Web Service，則寫法為，

<?xml version="1.0" encoding="UTF-8"?> <endpoints version="2.0" xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime"> <endpoint implementation="ctsjavacoe.ws.fromjava.HelloSEI" name="Hello" url-pattern="/HelloService" /> </endpoints>

修改WEB-INF目錄下的web.xml檔案，增加如下內容：

<servlet>         <servlet-name>Hello</servlet-name>         <servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class>         <load-on-startup>2</load-on-startup> </servlet> <servlet-mapping>         <servlet-name>Hello</servlet-name>         <url-pattern>/HelloService</url-pattern> </servlet-mapping>

為每一個WebService聲明一個com.sun.xml.ws.transport.http.servlet.WSServlet。

 

開始布署：

1.  在tomcat的webapps目錄下建立一個目錄叫“D:\tomcat2\webapps\JaxWSSample”

2.  把eclipse工程JaxWSSample下WebContent目錄下所有的東西copy至該目錄下

3.  重啟tomcat

在ie中輸入：

http://localhost:9090/JaxWSSample/HelloService?wsdl

可以看到我們的webservice已經產生了。

 

3.3通過Server端的WSDL產生供JAVA調用的用戶端3.3.1 同步與非同步

 

同步調用，很好理解，即一來一回，Client端request到Server端，Sever端立刻回一個response。

非同步呼叫，就是用戶端調用一次服務端後，服務端處理事務並不是即時返回的，比如說傳一個600MB檔案給服務端，服務端在處理接收和解析檔案時，用戶端不會馬上得到一個響應，它會等待一段時間，等伺服器處理完後，再通知用戶端“我處理完了”。

3.3.2 利用wsimport產生用戶端

我們建立一個eclipse的工程，只需要是JAVA工程就行了，不需要web工程的，因為我們這邊只用代碼做調用：

 

把Server端的wsdl及xsd都手工copy到用戶端工程的wsdl目錄下。

開啟一個cmd視窗敲入如下的命令：

wsimport -keep -d bin -s src wsdl/HelloService.wsdl

 

以上是產生同步用戶端的命令。

如果要產生非同步用戶端命令，需要在工程根目錄下建一個binding.xml的檔案，內容如下：

<?xml version="1.0" encoding="UTF-8"?> <bindings xmlns:xsd="http://www.w3.org/2001/XMLSchema"     xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" wsdlLocation="wsdl/HelloService.wsdl"     xmlns="http://java.sun.com/xml/ns/jaxws">     <bindings node="wsdl:definitions">         <enableAsyncMapping>true</enableAsyncMapping>     </bindings> </bindings>

然後產生用戶端代碼的wsimport命令也會不一樣：

wsimport -keep –b binding.xml  -d bin -s src wsdl/HelloService.wsdl

 

 

我們來看非同步呼叫的代碼（同步代碼比非同步呼叫簡單，留給大家自己做練習）

wsimport命令會在eclipse工程的src目錄中產生你在調用時所用的java src檔案。

 

Hello.java與HelloService.java是wsimport給我們產生的供用戶端調用的java檔案。

我們把HelloService檔案開啟，可以看到兩行：

file:/D:/workspace/JaxWSClient/wsdl/HelloService.wsdl

把它們改成：

http://localhost:9090/JaxWSSample/HelloService?wsdl

有兩行，尤其是Url url=這一行，千萬不要漏改了。

 

我們建立一個調用類，叫：HelloAsyncPollingClient.java檔案，內容如下：

package ctsjavacoe.ws.fromjava;   import javax.xml.ws.Response;   public class HelloAsyncPollingClient {       /**      * @param args      */     public static void main(String[] args) throws Exception {         HelloService service = new HelloService();         Hello port = service.getHelloPort();         Response<SayResponse> sayAsync = port.sayAsync("Mk");         while (!sayAsync.isDone()) {             System.out.println("is not down");         }         try {             SayResponse callNameResponse = sayAsync.get();             String message = callNameResponse.getReturn();             System.out.println(message);         } catch (Exception ex) {         }     }   }

運行，得到結果如下：

 

3.3.3 細說同步與非同步

 

在舊的基於JAX-RPC的webservice編程model中，是不支援非同步service 調用的，在最新的Jax-ws webservice 編程model中，加入了對webservice的非同步呼叫的支援。

首先我來講一下它的原理，大家不要以為在非同步調用下，從client到server 之間的soap message 流也是非同步，其實不是，Soap/Http 協議在同步跟非同步調用下是一樣的，都是用戶端的service在運行時開啟一個connectin,發送請求，然後接收返回，這些都在同一個connection中。這種方式對我們有什麼影響呢？從用戶端程式的角度來講，沒有影響，用戶端的編程模型是由WSDL中的messages跟port types 來定義的，只要這些東西沒有改變，request 跟response是不是在同一個Tcp/ip 的session 中來發送對與我們來說沒由影響，然後從架構跟資源的角度來講，對我們的影響就大了，把串連層的資源跟應用程式層的程式運行狀態綁定起來是由許多弊端的，假如在非同步呼叫時，程式運行出現了異常，將會導致串連層的資源被一直佔用，這樣會極大的影響我們程式的，穩定性，可靠性，資源的使用跟效能。

 

3.3.4 非同步另一種實現

上例中實現的是一種“polling方式的非同步呼叫”，下面給出“callback”方式的非同步呼叫用戶端。

由於此callBack當請求發出去以後當前的這個connection就會關閉 ,為了達到測試的目的，加入了sleep，讓用戶端程式等待伺服器端得返回。

callback類型的client要傳入一個javax.xml.ws.AsyncHandler類型的匿名內部類，當soapMessage 到達時，Jax-ws會調handleResponse這個方法來處理response.

用戶端測試代碼如下：

package ctsjavacoe.ws.fromjava; import javax.xml.ws.AsyncHandler; import javax.xml.ws.Response; public class HelloAsyncCallBackClient {     public static void main(String[] args) throws Exception {         HelloService service = new HelloService();         Hello port = service.getHelloPort();         port.sayAsync("Mk", new AsyncHandler<SayResponse>() {             public void handleResponse(Response<SayResponse> res) {                 try {                     SayResponse response = null;                     response = res.get();                     String message = response.getReturn();                     System.out.println(message);                 } catch (Exception e) {                     e.printStackTrace();                 }             }         });         Thread.sleep(1000);     } }

  

5天學會jaxws-webservice編程第一天