Axis2開(kāi)發(fā)webservice總結(jié)

關(guān)于本章

本章描述內(nèi)容如下表所示。

1.1 Web Service技術(shù)

1.1.1 Web Service消息內(nèi)容遵循的標(biāo)準(zhǔn)

l           SOAP

所有Web Service消息符合WS-I基本綱要（WS-I Basic Profile Version 1.0:"Final Material"）的SOAP使用定義。

編碼方式為：“document/literal”。

發(fā)起業(yè)務(wù)請(qǐng)求時(shí)，在SOAP HEADER里設(shè)置timeStamp、sendAddress、platType、provType、TID、version、callerSID、providerSID、providerEID、providerECID、providerIFName、UID、callingType參數(shù)，然后在服務(wù)器端提取參數(shù)，進(jìn)行相應(yīng)處理。

l           XML

所有Web Service消息符合WS-I基本綱要（WS-I Basic Profile Version 1.0:"Final Material"）的XML使用定義。

l           HTTP

所有Web Service消息符合WS-I基本綱要（WS-I Basic Profile Version 1.0:"Final Material"）的HTTP使用定義。

關(guān)于本章

本章描述內(nèi)容如下表所示。

2.1 開(kāi)發(fā)前的準(zhǔn)備工作

2.1.1 PC機(jī)配置要求

選擇一臺(tái)PC機(jī)作為開(kāi)發(fā)平臺(tái)。PC機(jī)的最低配置要求如表2-1所示。

表2-1 PC機(jī)最低配置要求表

2.1.2 工具下載

在以下提供的工具下載頁(yè)面中找到指定的下載鏈接，下載各個(gè)工具，并將其安裝在C:\Program Files下。

JDK1.5

l           JDK1.5下載頁(yè)面。

http://java./javase/downloads/index_jdk5.jsp

l           jdk-1_5_0_13-windows-i586-p.exe下載鏈接。

http://192.18.108.145/ECom/EComTicketServlet/BEGINA3B0EEAA08A312C1FAEC55BAC2297BBB/-2147483648/2402513439/1/852050/851882/2402513439/2ts+/westCoastFSEND/jdk-1.5.0_13-oth-JPR/jdk-1.5.0_13-oth-JPR:3/jdk-1_5_0_13-windows-i586-p.exe

l           安裝JDK。

雙擊jdk-1_5_0_13-windows-i586-p.exe按照默認(rèn)配置安裝JDK1.5。

Eclipse（開(kāi)發(fā)環(huán)境）

l           Eclipse下載頁(yè)面。

http://www./downloads

l           eclipse-SDK-3.3.1-win32.zip下載鏈接。http://www./downloads/download.php?file=/eclipse/downloads/drops/R-3.3.1-200709211145/eclipse-SDK-3.3.1-win32.zip&url=http://download./eclipse/eclipse/downloads/drops/R-3.3.1-200709211145/eclipse-SDK-3.3.1-win32.zip&mirror_id=385

l           安裝Eclipse。

解壓縮eclipse-SDK-3.3.1-win32.zip即可（不需安裝）。

Tomcat（Web服務(wù)器）

l           Tomcat6.0下載頁(yè)面。

http://tomcat./download-60.cgi

l           apache-tomcat-6.0.14.zip下載鏈接。

http://apache.mirror./tomcat/tomcat-6/v6.0.14/bin/apache-tomcat-6.0.14.zip

l           安裝Tomcat。

解壓縮apache-tomcat-6.0.14.zip即可（不需安裝）。

AXIS（SOAP引擎）

l           AXIS2下載頁(yè)面。

http://ws./axis2/download.cgi

l           axis2-1.4-bin.zip下載鏈接。

http://apache.mirror./ws/axis2/1_4/axis2-1.4-bin.zip

l           axis2-1.4-war.zip下載鏈接。

http://apache.mirror./ws/axis2/1_4/axis2-1.4-war.zip

l           安裝AXIS。

解壓縮axis2-1.4-bin.zip和axis2-1.4-war.zip即可（不需安裝）。

2.1.3 環(huán)境變量配置

按照如下步驟配置JAVA_HOME和AXIS2_HOME環(huán)境變量。

                                步驟 1     右鍵單擊“我的電腦”。

                                步驟 2     選擇“屬性”。

                                步驟 3     單擊“高級(jí)”頁(yè)簽。

如圖2-1所示。

圖2-1 系統(tǒng)屬性

                                步驟 4     在圖2-1中單擊“環(huán)境變量”。

                                步驟 5     增加系統(tǒng)變量JAVA_HOME，變量值為JDK安裝目錄。

如圖2-2所示。

圖2-2 新建JAVA_HOME系統(tǒng)變量

                                步驟 6     增加系統(tǒng)變量CLASSPATH。

l           變量名：

CLASSPATH

l           變量值：

%JAVA_HOME%\lib;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar

                                步驟 7     在Path系統(tǒng)環(huán)境變量中增加axis2-1.4的bin目錄，單擊“確定”。

如圖2-3所示。

圖2-3 編輯Path系統(tǒng)環(huán)境變量

l      在設(shè)置環(huán)境變量的值時(shí)，新增的環(huán)境變量值與已存在的環(huán)境變量值之間用“;”隔開(kāi)。

l      其中D:\axis2-1.4\bin需要根據(jù)實(shí)際情況設(shè)置。

                                步驟 8     單擊編輯用戶變量界面里的“確定”。

                                步驟 9     環(huán)境變量界面里的“確定”

---結(jié)束

2.1.4 解壓縮axis2

具體操作步驟如下。

                                步驟 1     解壓縮axis2-1.4-war.zip。

                                步驟 2     將axis2.war拷貝到%TOME_HOME%\webapps目錄下。

                                步驟 3     雙擊%TOME_HOME%\bin\startup.bat，啟動(dòng)Tomcat服務(wù)器。

----結(jié)束

啟動(dòng)過(guò)程會(huì)自動(dòng)將axis2.war解壓縮，在%TOME_HOME%\webapps 下生成axis2目錄。

2.2 通過(guò)JAVA生成WSDL文件

2.2.1 寫(xiě)java類(lèi)

                                步驟 1     在Eclipse中新建一個(gè)java工程。

                                步驟 2     單擊“file > new > java>project”。如圖2-4所示。

圖2-4 新建java工程

                                步驟 3     輸入工程名，其他默認(rèn)，單擊“finish”。如圖2-5所示。

圖2-5 輸入工程名

步驟4  生成類(lèi) hello.java

                                步驟 4     根據(jù)接口文件在類(lèi)中寫(xiě)方法和參數(shù)，如圖2-9所示。

圖2-6 類(lèi)中寫(xiě)的方法和參數(shù)

2.2.2 使用AXIS2的工具生成wsdl文件

                                步驟 1     拷貝生成的java文件的.class文件。需要拷貝bin目錄下面所有的包，如圖2-10所示。

                                步驟 2     復(fù)制到axis2的bin目錄下，如圖2-11所示。

圖2-7 axis2的bin目錄

使用java2WSDL命令將“Hello.class”轉(zhuǎn)化為“Hello.wsdl”文件。如圖2-13所示。

圖2-8 轉(zhuǎn)化文件

生成的wsdl文件如下：

l      使用全路徑。

l      中間的–of，–cn等字符請(qǐng)參照本地的系統(tǒng)所給的命令，可以執(zhí)行java2WSDL命令查看。

----結(jié)束

2.2.3 修改WSDL文件使其符合規(guī)范

查看規(guī)范的wsdl文件，將命名空間統(tǒng)一，按照規(guī)范wsdl中的標(biāo)準(zhǔn)來(lái)修改。

2.3 客戶端業(yè)務(wù)開(kāi)發(fā)實(shí)例

2.3.1 使用工具將wsdl文件生成java源碼

使用工具按照如下步驟將wsdl文件生成java源碼。

                                步驟 1     運(yùn)行cmd，進(jìn)入命令行控制臺(tái)，進(jìn)入axis2的bin目錄下，如圖2-25所示。

                                步驟 2     使用“WSDL2java.bat”生成一個(gè)客戶端WSDL2java.bat -uri，如圖2-26所示。

圖2-9 客戶端源碼

                                步驟 3     可以看到bin目錄下產(chǎn)生了一個(gè)src文件夾，準(zhǔn)備將其導(dǎo)入到eclipse工程中，如圖2-27所示。

圖2-10 Src文件夾

                                步驟 4     在eclipse中創(chuàng)建一個(gè)普通的java工程，操作步驟為單擊“file > new > javaproject”，如圖2-28所示。

圖2-11 創(chuàng)建java工程

                                步驟 5     創(chuàng)建名為hello_clint的工程

                                步驟 6     點(diǎn)開(kāi)新建的工程，可以看到工程下的庫(kù)和一個(gè)源文件夾，導(dǎo)入axis2所需的jar包。

如下圖：

----結(jié)束

2.4 生成服務(wù)端代碼

2.4.1 安裝配置必要工具

一些必要工具的安裝，配置具體步驟如下。

                                步驟 1     獲得一個(gè)tomcat安裝包和axis2-1.4-war.zip。

                                步驟 2     安裝tomcat，解壓axis2-1.4-war.zip到%TOMCAT_HOME%\webapps目錄下。

                                步驟 3     雙擊% TOMCAT _HOME%\bin\startup.bat，啟動(dòng)Tomcat服務(wù)器。

                                步驟 4     啟動(dòng)后看是否在% TOMCAT _HOME%\webapps下生成了axis2目錄，如生成則說(shuō)明axis2安裝成功。

2.4.2 生成服務(wù)端源代碼

生成服務(wù)端源代碼的具體步驟如下。

                                步驟 1     參見(jiàn)2.3.1 步驟 1。

                                步驟 2     使用WSDL2java.bat -uri weatherInfoNotify.wsdl –ss –sd生成服務(wù)端代碼。

                                步驟 3     能在bin目錄下看到新增了src和resources文件夾。

新增的文件夾會(huì)覆蓋以前的src文件夾，請(qǐng)備份以前的文件夾。

                                步驟 4     參見(jiàn)2.3.1 步驟 4在eclipse中創(chuàng)建一個(gè)普通的java工程，操作步驟為單擊“file > new > javaproject”，如圖2-28所示。

                                步驟 5     參見(jiàn)2.3.1 步驟 5，把名字命名為hello_server。

                                步驟 6     參見(jiàn)2.3.1 步驟 6，和2.3.1 步驟 8，完成后如圖2-37所示

圖2-12 生成代碼

其中HelloSkeleton.java為業(yè)務(wù)代碼實(shí)現(xiàn)類(lèi)，需要重寫(xiě)實(shí)現(xiàn)方法。

----結(jié)束

2.4.3 將服務(wù)端導(dǎo)出并發(fā)布到tomcat上

                                步驟 1     將工程導(dǎo)出為一個(gè)xxx.aar包（本例為hello.aar），放到% TOMCAT _HOME%\webapps\axis2\WEB-INF\services中，如圖2-39 所示。

                                步驟 2     選中axis2的bin目錄下的resources文件夾中的services.xml文件。

                                步驟 3     將選中文件放到weather.aar包中的META-INF目錄下

點(diǎn)擊hello_server build.xml文件生成hello.aar包，將工程文件中的service.xml替換hello.aar包中\ \META-INF中的service.xml。

然后放在 $tomcat_home\ \webapps\axis2\WEB-INF\services目錄下，然后啟動(dòng)tomcat.

Hello.aar位置如圖所示：

啟動(dòng)tomcat 如圖所示，表示發(fā)布成功

2.5 簡(jiǎn)單調(diào)測(cè)

請(qǐng)參考如下操作簡(jiǎn)單調(diào)試發(fā)布的內(nèi)容

                                步驟 1     單擊eclipse客戶端工程中的Test.class類(lèi)，如圖2-46所示。

圖2-13 Test.class類(lèi)

3.1 編寫(xiě)wsdl文件

3.1.1 修改wsdl文件

利用wsdl文件通過(guò)

WSDL2java.bat -uri  hello.wsdl –ss –sd生成服務(wù)端代碼。

WSDL2java.bat -uri hello.wsdl 客戶端代碼。

3.1.2 修改生成的服務(wù)端代碼

  生成的骨架代碼為業(yè)務(wù)實(shí)現(xiàn)方法，需要重寫(xiě)實(shí)現(xiàn)方法 類(lèi)名為 *.Skeleton.java

3.1.3 發(fā)布 *.aar包

通過(guò) 服務(wù)端代碼build.xml生成 aar包，將 工程目錄recourse\service.xml 替換 \build\lib\*.aar包中的service.xml文件。然后copy到tomcat目錄 \\webapps\axis2\WEB-INF\services 下。