二、Quick Start

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

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

2.1編寫WSDL

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

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

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

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

E．點(diǎn)擊“Finish”按鈕就可以看到MyEclipse提供的WSDL 設(shè)計(jì)器的界面了。可以看到設(shè)計(jì)器為WSDL默認(rèn)的添加了一個(gè)現(xiàn)操作。

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

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

<?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的編寫已經(jīng)完成。

2.2從WSDL生成Java代碼

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

B.點(diǎn)擊“Browse”來選取存放在src目錄下的SayHello.wsdl文件，“Next”進(jìn)入下一步。設(shè)置如下：

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

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

這個(gè)時(shí)候發(fā)現(xiàn)test.org.tonyzhangcn.ws.sayhello下面的SayHelloTest.java仍然存在問題。點(diǎn)擊此文件中package 關(guān)鍵子前面的紅“x”,會提示有兩個(gè)選項(xiàng)，我們選擇下面的那個(gè)。

選擇public class SayHelloTest前的紅“x”，選擇第一項(xiàng)。

進(jìn)行完這幾個(gè)改動(dòng)之后，生成的代碼就沒有問題了。其中

SayHelloRequest，SayHelloResponse是輸入輸出參數(shù)對象。

SayHelloSkeleton是服務(wù)端對象，用來編寫業(yè)務(wù)邏輯調(diào)用。

SayHelloStub是客戶端用來定位endpoint（就是發(fā)布的Web Services的地址）的類，客戶端根據(jù)其提供的方法定位Web服務(wù)并發(fā)起調(diào)用

SayHelloMessageReceiverInOut是一個(gè)實(shí)現(xiàn)同步調(diào)用的web服務(wù)信息轉(zhuǎn)換處理類。

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

SayHelloTest是一個(gè)客戶端的TestCase示例，用戶可以根據(jù)這個(gè)示例來編寫自己的客戶端調(diào)用類。

2.3編寫業(yè)務(wù)代碼

打開SayHelloSKeleton.java文件將其中的實(shí)現(xiàn)方法

2.4打包

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

B.選擇編譯好的class文件所在目錄（本項(xiàng)目應(yīng)該是WebRoot下面WEB-INF/classes），“Next”進(jìn)入下一步。

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

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

 2.5部署

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

B.啟動(dòng)Tomcat（即點(diǎn)擊Tomcat安裝目錄下的startup.bat，linux或unix下執(zhí)行startup.sh）。

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

   可以看到SayHello已經(jīng)被部署。點(diǎn)擊SayHello提供的連接可以看到與之對應(yīng)的WSDL。

2.6調(diào)用測試

A.修改SayHelloTest.java文件中的方法testSayHello的內(nèi)容為：

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 服務(wù)已經(jīng)正確的返回了結(jié)果。那么，不用TestCase類可以調(diào)用WebServices嗎？答案是肯定的，我們可以隨便些一個(gè)帶有main方法的類，并仿照SayHelloTest.java中的testSayHello()方法就可以達(dá)到調(diào)用Web Services的目的了。

在我實(shí)際操作工程中，還遇到了兩個(gè)問題：

一個(gè)是缺少xalan包中的jar文件，

解決辦法：從官網(wǎng)下載，添加進(jìn)lib中就好了

一個(gè)是在自動(dòng)產(chǎn)生的JUnit Test類中有兩個(gè)方法，都要實(shí)現(xiàn)，

解決辦法：可以去掉一個(gè)方法。