用AXIS生成WSDL文件(基礎篇)

一、環境搭建

由於AXIS本身是基於JAVA語言開發的項目，並且是以Web應用形式發佈的，因此它運行時需要一個應用服務器作爲支撐。爲了方便我們這裏選用的是Tomcat。由於AXIS本身需要用到處理XML信息的包，所以我們建議使用JDK1.4並安裝Tomcat 4.1.24。下面是環境搭建步驟，讀取根據自身情況進行安裝。

1. 安裝JDK1.4.1
2. 安裝Tomcat 4.1.24到C:/Tomcat並驗證安裝是否成功
3. 下載AXIS項目打包文件axis-1_1.zip解壓縮後將目錄中的webapps目錄下的axis子目錄拷貝到C:/Tomcat/webapps下。
4. 驗證AXIS的安裝：重新啓動Tomcat服務器後打開瀏覽器輸入網址http://localhost:8080/axis 後應該出現如下圖所示頁面，點擊鏈接"Validate"來驗證Axis所需的幾個JAVA包是否齊全。

圖2

點擊超鏈接Validate後，AXIS會自動檢查所需的每一個JAVA組件，這協組件分爲：必需組件以及可選組件，必須保證所有必需組件都存在，如下圖所示即爲驗證成功。

圖2

 

 

二、Web Service服務端開發

 

三、開發java客戶端

 

使用AXIS的工具將使Web服務的訪問和我們之前介紹的創建一個Web服務一樣的簡單。我們前面安裝的AXIS環境中已經包含着這樣的工具，它是一個JAVA類，類名爲：org.apache.axis.wsdl.WSDL2Java。打開命令行窗口，轉到AXIS目錄下的WEB-INF子目錄。確保Tomcat服務已經處於啓動狀態，鍵入命令 ：

該命令執行的結果是在當前所在目錄下產生一個子目錄 localhost/axis/Hello_jws，該目錄下有四個JAVA源文件，它們分別是：

Hello.java 定義了Web服務接口，此例中只有一個hello方法。

HelloService.java 定義了用於獲取Web服務接口的方法。

HelloServiceLocator.java 接口HelloService的具體實現。

HelloSoapBindingStub.java Web服務客戶端樁，通過該類與服務器交互。

這四個JAVA類幫我們處理了大部分的邏輯，我們需要的僅僅是把這些類加到我們的項目然後創建一個我們自己的類來調用它們即可。爲此我們新加一個類Main.java，爲了方便，讓這個類與剛產生的四個類都在同一個包下。內容如下：

使用以下命令進行編譯：

如果編譯沒有問題的話執行該測試程序：

在WSDL2Java工具自動產生的幾個類中，類HelloServiceLocator中保存這一些跟服務器相關的信息，例如URL地址等，當服務器的地址更改後但是服務並沒有改動的時候直接修改該文件中的字符串定義，而無需重新生成這幾個類。具體需要修改的內容，打開該文件便可一目瞭然。

 

經過了前兩步之後我們就可以開始Web服務之旅了！大多數人在學習一種編程語言的第一步都是從Hello world程序開始的，我們也不例外。我們將提供這樣一個Web服務，通過給它傳入姓名，服務返回：你好[姓名]，歡迎來到Web服務的世界。這就是我們的需求。我們將馬上根據AXIS的要求完成我們的需求，你就會發現原來Web服務可以這麼簡單！

編寫JAVA類Hello.java，內容如下：

僅此而已，無需編譯，將該文件改名爲Hello.jws並拷貝到AXIS應用目錄C:/Tomcat/webapps/axis下。

下面我們就可以測試該Web服務了，打開瀏覽器並輸入剛剛創建的文件名對應的URL地址 http://localhost:8080/axis/Hello.jws 瀏覽器顯示如下結果：

點擊頁面上的鏈接查看該Web服務對應的WSDL信息如下所示（我們將在下一小節簡單介紹WSDL）

到此我們已經完成了hello的Web服務了，那我們怎麼告訴用戶如何來使用該服務呢？我們只需要告訴用戶我們的Web服務的URL地址： http://localhost:8080/axis/Hello.jws?wsdl 就可以了！下一節我們將介紹如何通過這個地址來訪問對應的Web服務。