二、Quick Start

環境準備好后，先從一個簡單的例子開始。以便對使用Axis來開發Web services的大致流程有個了解。這個例子就是SayHello，請求端輸入一個名字字符串，返回的將是一個問候語。

例如：輸入了Tom，那么返回的事Hi，Tom.How are you？

2.1編寫WSDL

A．啟動MyEclipse，新建立一個WebApps（File->New->Project->Web Project）,給Project Name 為SayHello，其他保持不改變。

B．選擇File->New-Other菜單，進入后找到MyEclipse->Web Services并選擇WSDL.

C. 選擇“src”目錄作為“Enter or select the parent folder”的值，“File name”值給定為SayHello.wsdl。點擊“Next”進入下一步。

D.將目標命名空間設置為“http://ws.tonyzhangcn.org/SayHello/”.在生成代碼的時候一般以這個命名空間為package的名字，例如：org.tonyzhangcn.ws.sayhello。這些值可以按需要設置。

E．點擊“Finish”按鈕就可以看到MyEclipse提供的WSDL 設計器的界面了。可以看到設計器為WSDL默認的添加了一個現操作。

即圖中的“NewOperation”。現在將其改名為SayHello,如下圖：

         之后點擊設計界面中的“Source”Tab來查看其代碼。如下：可以看到我們定義了一個SayHello的Web Services，她提供了一個SayHello的方法，她能夠接受一個String（事實上是tns:SayHelloRequest對象，她對String進行了封裝）類型的輸入參數SayHelloRequest并返回一個String（事實上是tns:SayHelloResponse對象，她對String進行了封裝）類型的SayHelloResponse結果。更多關于WSDL的信息，請參考W3C的規范文檔。

<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://ws.tonyzhangcn.org/SayHello/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="SayHello" targetNamespace="http://ws.tonyzhangcn.org/SayHello/">

<wsdl:types>

<xsd:schema targetNamespace="http://ws.tonyzhangcn.org/SayHello/">

<xsd:element name="SayHelloResponse" type="xsd:string" />

<xsd:element name="SayHelloRequest" type="xsd:string" />

</xsd:schema>

</wsdl:types>

<wsdl:message name="SayHelloResponse">

<wsdl:part element="tns:SayHelloResponse" name="SayHelloResponse" />

</wsdl:message>

<wsdl:message name="SayHelloRequest">

<wsdl:part element="tns:SayHelloRequest" name="SayHelloRequest" />

</wsdl:message>

<wsdl:portType name="SayHello">

<wsdl:operation name="SayHello">

<wsdl:input message="tns:SayHelloRequest" />

<wsdl:output message="tns:SayHelloResponse" />

</wsdl:operation>

</wsdl:portType>

<wsdl:binding name="SayHelloSOAP" type="tns:SayHello">

<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" />

<wsdl:operation name="SayHello">

<soap:operation soapAction="http://ws.tonyzhangcn.org/SayHello/NewOperation" />

<wsdl:input>

<soap:body use="literal" />

</wsdl:input>

<wsdl:output>

<soap:body use="literal" />

</wsdl:output>

</wsdl:operation>

</wsdl:binding>

<wsdl:service name="SayHello">

<wsdl:port binding="tns:SayHelloSOAP" name="SayHelloSOAP">

<soap:address location="http://www.example.org/" />

</wsdl:port>

</wsdl:service>

</wsdl:definitions>

至此WSDL的編寫已經完成。

2.2從WSDL生成Java代碼

A.選擇菜單“File->New->Other”，從對話框中選取“Axis2 Wizards”下面的“Axis2 Code Generator”.點擊“Next”進入下一個頁面，保持“Generate java source code from WSDL file”被選中，點擊“Next”進入下一步。

B.點擊“Browse”來選取存放在src目錄下的SayHello.wsdl文件，“Next”進入下一步。設置如下：

 C.點擊“next”進入下一個頁面，設置“Output path”為本Project的src目錄。點擊“finish”后代在SayHello項目上按F5刷新就可以看到有代碼生成好了。但是能看到一堆紅“x”，這是由于沒有將Axis2的jar包放入class path 中以及源代碼的package不為org.tonyzhangcn.ws.sayhello引起的。

下面解決這個問題，首先選擇“SayHello”項目，并右擊選擇“Build path->Add External Archives..”,選擇上面部署在tomcat中的axis2 web應用WEB-INF/lib目錄中的所有jar包。之后右擊“src.org.tonyzhangcn.ws.sayhello”項目，選擇“Refactor->rename”,做如下修改，并選擇OK完成。

這個時候發現test.org.tonyzhangcn.ws.sayhello下面的SayHelloTest.java仍然存在問題。點擊此文件中package 關鍵子前面的紅“x”,會提示有兩個選項，我們選擇下面的那個。

選擇public class SayHelloTest前的紅“x”，選擇第一項。

進行完這幾個改動之后，生成的代碼就沒有問題了。其中

SayHelloRequest，SayHelloResponse是輸入輸出參數對象。

SayHelloSkeleton是服務端對象，用來編寫業務邏輯調用。

SayHelloStub是客戶端用來定位endpoint（就是發布的Web Services的地址）的類，客戶端根據其提供的方法定位Web服務并發起調用

SayHelloMessageReceiverInOut是一個實現同步調用的web服務信息轉換處理類。

Resources目錄下的services.xml文件是webservices的描述文件。

SayHelloTest是一個客戶端的TestCase示例，用戶可以根據這個示例來編寫自己的客戶端調用類。

2.3編寫業務代碼

打開SayHelloSKeleton.java文件將其中的實現方法

2.4打包

A.選擇菜單“File->New->Other”，從對話框中選取“Axis2 Wizards”下面的“Axis2 Services Archive”.點擊“Next”進入下一個頁面。

B.選擇編譯好的class文件所在目錄（本項目應該是WebRoot下面WEB-INF/classes），“Next”進入下一步。

C.選擇WSDL文件所在目錄，此處為src目錄下的SayHello.wsdl文件。“Next”,再“Next”。選擇services.xm文件，本文應該是生成再src/resources下面的services.xml文件。之后選取“Generate the services.xml automatically”,然后再點擊一下使其變為非選中狀態，之后點擊“Back”按鈕，再點擊一次“Next”。（注意：這里本應該不是這么來回折騰的，但是我的機器上只有這樣操作finish按鈕才能生效。懷疑這是一個bug，如果讀到此文的用戶沒有這種情況，忽略此提示）

D.點擊“Next”，將記入最后一個頁面，此處有兩個選項，一個是輸出目錄一個是處處文件名稱。我這里的輸出文件名稱給的是SayHello。點擊“Finish”完成。

 2.5部署

A．將打包好的文件SayHello.jar(或者可以改名為SayHello.aar),拷貝到Tomcat中已經部署的Axis2應用的WEB-INF/services目錄下面。

B.啟動Tomcat（即點擊Tomcat安裝目錄下的startup.bat，linux或unix下執行startup.sh）。

C.打開瀏覽器，輸入http://ipaddress:port/axis2（一般為http://localhost:8080/axis2）,并點擊其中的“services”鏈接

   可以看到SayHello已經被部署。點擊SayHello提供的連接可以看到與之對應的WSDL。

2.6調用測試

A.修改SayHelloTest.java文件中的方法testSayHello的內容為：

public void testSayHello() throws java.lang.Exception

{

String url="http://localhost:8080/axis2/services/SayHello";

org.tonyzhangcn.ws.sayhello.SayHelloStub stub = new org.tonyzhangcn.ws.sayhello.SayHelloStub(url); // the

org.tonyzhangcn.ws.sayhello.SayHelloRequest request = (org.tonyzhangcn.ws.sayhello.SayHelloRequest) getTestObject(org.tonyzhangcn.ws.sayhello.SayHelloRequest.class);

request.setSayHelloRequest("tonyzhangcn");

System.out.println(stub.SayHello(request).getSayHelloResponse());

// todo Fill in the param14 here

assertNotNull(stub.SayHello(request));

}

B.從菜單中選擇“Run－>Run as->JUnit Test”。

     可以看到web 服務已經正確的返回了結果。那么，不用TestCase類可以調用WebServices嗎？答案是肯定的，我們可以隨便些一個帶有main方法的類，并仿照SayHelloTest.java中的testSayHello()方法就可以達到調用Web Services的目的了。

在我實際操作工程中，還遇到了兩個問題：

一個是缺少xalan包中的jar文件，

解決辦法：從官網(http://apache.mirror.phpchina.com/xml/xalan-j/binaries/)下載xalan-j_2_7_0-bin.zip，將xalan-j_2_7_0-bin.zip\xalan-j_2_7_0 目錄下的Jar包全都添加進Tomcat的webapps\axis2\WEB-INF\lib目錄中就好了

一個是在自動產生的JUnit Test類中有兩個方法，都要實現，

解決辦法：可以去掉一個方法。