本文介紹使用AXIS作為開發(fā)環(huán)境來體會Web服務(wù)的開發(fā)過程,。

一． 介紹

本文并不是想介紹Web服務(wù)的原理,、系統(tǒng)架構(gòu)等，我們假設(shè)您已經(jīng)了解了關(guān)于Web服務(wù)的一些基本的概念,、原理等知識,。本文主要是針對那些已經(jīng)了解Web服 務(wù)概念，但是還沒有親身體會Web服務(wù)所帶來令人歡欣鼓舞的特征的開發(fā)人員,。在此我們認為你已經(jīng)具備了Java,、XML等基礎(chǔ)知識，如果你還有其他開發(fā)環(huán) 境的經(jīng)驗例如VB,、VC那是再好不過的了,。

1．Web服務(wù)

雖然我們并不想詳細講述Web服務(wù)的體系結(jié)構(gòu)，但是大概的介紹一下還是有必要的,。Web服務(wù)是一種新型的Web應(yīng)用程序,。不同于其他Web應(yīng)用程序，它是 自適應(yīng),、自我描述,、模塊化的應(yīng)用程序，并可以跨越Web進行發(fā)布,、定位以及調(diào)用,。簡單的Web服務(wù)可以提供例如天氣預(yù)報或者航班信息的服務(wù),。一旦部署了 Web服務(wù)，其他的應(yīng)用程序就可以發(fā)現(xiàn)和調(diào)用所部署的服務(wù),。

2．AXIS項目

Axis框架來自 Apache 開放源代碼組織,，它是基于JAVA語言的最新的 SOAP 規(guī)范（SOAP 1.2）和 SOAP with Attachments 規(guī)范（來自 Apache Group ）的開放源代碼實現(xiàn)。有很多流行的開發(fā)工具都使用AXIS作為其實現(xiàn)支持Web服務(wù)的功能,，例如JBuilder以及著名的Eclipse J2EE插件Lomboz。AXIS的最新版本是1.1,，可以從 http://ws./axis/index.html下載,。下圖是AXIS核心引擎的體系結(jié)構(gòu)圖：

圖1

整個AXIS項目包括以下幾個部分：

1. 消息流子系統(tǒng)
   消息流子系統(tǒng)提供了靈活的消息傳遞框架，這個消息傳遞框架包括處理程序,、鏈,、序列化程序和反序列化程序。處理程序是一個處理請求,、響應(yīng)和故障流的對象,。處理程序可被組合在一起成為鏈，而且可以使用一個靈活的部署描述符來配置這些處理程序的順序,。
2. 傳輸框架子系統(tǒng)
   提供了一個傳輸框架,，這個傳輸框架可以幫助您創(chuàng)建自己的可插式傳輸發(fā)送器和傳輸偵聽器。
3. 數(shù)據(jù)編碼子系統(tǒng)
   AXIS完全按照 XML Schema 規(guī)范提供各種數(shù)據(jù)類型的自動序列化,，并且提供功能擴展接口來使用您自己定制的序列化器和反序列化器,。
4. 其他
   AXIS完全支持 WSDL 以及日志記錄、出錯以及故障處理機制,。它同時提供一些工具用來講WSDL文檔轉(zhuǎn)換成客戶端的調(diào)用框架以及根據(jù)類來產(chǎn)生WSDL定義文檔,。

AXIS 目前版本支持的標準是：W3C SOAP 1.1 和 1.2；WSDL 1.1,；SAAJ 1.1（SUN公司：SOAP with Attachments API for Java）,；JAX-RPC（SUN公司：Java API for XML-Based RPC）1.0。

除了前面介紹的AXIS外,，本文中還將會用到TOMCAT,，這里不再另行介紹。另外為了演示W(wǎng)eb服務(wù) 真正與開發(fā)環(huán)境無關(guān)以及AXIS產(chǎn)生的是標準的,、符合規(guī)范的Web服務(wù),，我們還將用到微軟公司的SOAP TOOLKIT以及微軟的開發(fā)環(huán)境VB和VC來做為Web服務(wù)的客戶端。

回頁首

二. 環(huán)境搭建

由 于AXIS本身是基于JAVA語言開發(fā)的項目,，并且是以Web應(yīng)用形式發(fā)布的,，因此它運行時需要一個應(yīng)用服務(wù)器作為支撐。為了方便我們這里選用的是 Tomcat,。由于AXIS本身需要用到處理XML信息的包,，所以我們建議使用JDK1.4并安裝Tomcat 4.1.24,。下面是環(huán)境搭建步驟，讀取根據(jù)自身情況進行安裝,。

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服務(wù)器后打開瀏覽器輸入網(wǎng)址http://localhost:8080/axis 后應(yīng)該出現(xiàn)如下圖所示頁面，點擊鏈接"Validate"來驗證Axis所需的幾個JAVA包是否齊全,。

圖2

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

圖3

回頁首

三． Web Service服務(wù)端開發(fā)

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

編寫JAVA類Hello.java,，內(nèi)容如下：

public class Hello{
 public String hello(String name){
  if(name==null)
   name = "";
  return "你好"+name+"，歡迎來到Web服務(wù)的世界,！";
}
}

僅此而已,，無需編譯，將該文件改名為Hello.jws并拷貝到AXIS應(yīng)用目錄C:\Tomcat\webapps\axis下,。

下面我們就可以測試該Web服務(wù)了,，打開瀏覽器并輸入剛剛創(chuàng)建的文件名對應(yīng)的URL地址 http://localhost:8080/axis/Hello.jws 瀏覽器顯示如下結(jié)果：

There is a Web Service here
        
        Click to see the WSDL 
      
      

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

<?xml version="1.0" encoding="UTF-8" ?>
-<wsdl:definitions
 targetNamespace="http://localhost:8080/axis/Hello.jws"
 xmlns="http://schemas./wsdl/"
 xmlns="http://www./2000/xmlns/"
 xmlns:apachesoap="http://xml./xml-soap" 
 xmlns:soapenc="http://schemas./soap/encoding/"
 xmlns:impl="http://localhost:8080/axis/Hello.jws" 
 xmlns:intf="http://localhost:8080/axis/Hello.jws"
 xmlns:wsdlsoap="http://schemas./wsdl/soap/" 
 xmlns:xsd="http://www./2001/XMLSchema"
 xmlns:wsdl="http://schemas./wsdl/">
 - <wsdl:message name="helloRequest">
 <wsdl:part name="name" type="xsd:string" /> 
 </wsdl:message>
 + <wsdl:message name="helloResponse">
 - <wsdl:portType name="Hello">
 - <wsdl:operation name="hello" parameterOrder="name">
 <wsdl:input name="helloRequest" message="intf:helloRequest" /> 
 <wsdl:output name="helloResponse" message="intf:helloResponse" />
 </wsdl:operation> 
 </wsdl:portType>
 - <wsdl:binding name="HelloSoapBinding" type="intf:Hello"> 
 <wsdlsoap:binding style="rpc" transport="http://schemas./soap/http" />
 - <wsdl:operation name="hello"> 
 <wsdlsoap:operation soapAction="" />
 - <wsdl:input name="helloRequest">
 <wsdlsoap:body use="encoded" encodingStyle="http://schemas./soap/encoding/" 
  namespace="http://DefaultNamespace" />  
 </wsdl:input>- <wsdl:output name="helloResponse">  
 <wsdlsoap:body use="encoded" encodingStyle="http://schemas./soap/encoding/"
  namespace="http://localhost:8080/axis/Hello.jws" />   
 </wsdl:output> 
 </wsdl:operation> 
 </wsdl:binding>
 - <wsdl:service name="HelloService">
 - <wsdl:port name="Hello" binding="intf:HelloSoapBinding">
 <wsdlsoap:address location="http://localhost:8080/axis/Hello.jws" /> 
 </wsdl:port>  
 </wsdl:service> 
 </wsdl:definitions>

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

回頁首

四． Web Service客戶端開發(fā)

在這一節(jié)中我們將使用三種不同的語言來訪問剛剛創(chuàng)建的Web服務(wù),，分別是JAVA,、VB、VC,。為了使用VB和VC訪問Web服務(wù),，我們需要安裝微軟公司的Soap Toolkit 開發(fā)工具包，這個工具包可以從微軟公司的主頁

http://download.microsoft.com/download/xml/soap/2.0/W98NT42KMe/EN-US/SoapToolkit20.exe

下載,，下載該軟件包并使用默認方式安裝即可,。

在開始客戶端開發(fā)之前有兩個概念我們必須先粗略的介紹一下,。

SOAP：簡單對象訪問協(xié)議。這是一種在松散的,、分布的環(huán)境中使用XML對等地交換結(jié)構(gòu)化的和類型化的信息提供了一個簡單且輕量級的機制,，它是一個基于 XML的協(xié)議。它包括四個部分：SOAP封裝（envelop）,，封裝定義了一個描述消息中的內(nèi)容是什么,，是誰發(fā)送的，誰應(yīng)當接受并處理它以及如何處理它 們的框架,；SOAP編碼規(guī)則（encoding rules）,，用于表示應(yīng)用程序需要使用的數(shù)據(jù)類型的實例; SOAP RPC表示(RPC representation)，表示遠程過程調(diào)用和應(yīng)答的協(xié)定;SOAP綁定（binding）,，使用底層協(xié)議交換信息。

雖然這四個部分都作為SOAP的一部分,，作為一個整體定義的,，但他們在功能上是相交的、彼此獨立的,。特別的,，信封和編碼規(guī)則是被定義在不同的XML命名空間(namespace)中，這樣使得定義更加簡單,。

SOAP的主要設(shè)計目標是簡明性和可擴展性,。這就意味著有一些傳統(tǒng)消息系統(tǒng)或分布式對象系統(tǒng)中的特性將不包含在SOAP的核心規(guī)范中。這些特性包括：分布式垃圾收集,；批量消息傳輸/處理,；對象引用；對象激活,。

WSDL：Web Service描述語言,。使用了WSDL，我們就可以通過這種跨平臺和跨語言的方法使Web Service代理的產(chǎn)生自動化,。就像COM和CORBA的IDL文件,，WSDL文件由客戶和服務(wù)器約定。由于WSDL設(shè)計成可以綁定除SOAP以外的其 他協(xié)議,，這里我們主要關(guān)注WSDL在HTTP上和SOAP的關(guān)系,。同樣，由于SOAP目前主要用來調(diào)用遠程的過程和函數(shù),，WSDL支持SOAP傳輸?shù)奈臋n 規(guī)范,。

WSDL文檔可以分為兩部分。頂部分由抽象定義組成,，而底部分則由具體描述組成,。抽象部分以獨立于平臺和語言的方式定義SOAP消息,，它們并不包含任何隨機器或語言而變的元素。這就定義了一系列服務(wù),，截然不同的網(wǎng)站都可以實現(xiàn),。

1. JAVA客戶端

使 用AXIS的工具將使Web服務(wù)的訪問和我們之前介紹的創(chuàng)建一個Web服務(wù)一樣的簡單。我們前面安裝的AXIS環(huán)境中已經(jīng)包含著這樣的工具,，它是一個 JAVA類,，類名為：org.apache.axis.wsdl.WSDL2Java。打開命令行窗口,，轉(zhuǎn)到AXIS目錄下的WEB-INF子目錄,。確保 Tomcat服務(wù)已經(jīng)處于啟動狀態(tài)，鍵入命令 ：

Java -Djava.ext.dirs=lib org.apache.axis.wsdl.WSDL2Java http://localhost:8080/axis/Hello.jws?wsdl

該命令執(zhí)行的結(jié)果是在當前所在目錄下產(chǎn)生一個子目錄 localhost/axis/Hello_jws,，該目錄下有四個JAVA源文件,，它們分別是：

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

HelloService.java 定義了用于獲取Web服務(wù)接口的方法,。

HelloServiceLocator.java 接口HelloService的具體實現(xiàn)。

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

這四個JAVA類幫我們處理了大部分的邏輯，我們需要的僅僅是把這些類加到我們的項目然后創(chuàng)建一個我們自己的類來調(diào)用它們即可,。為此我們新加一個類Main.java,，為了方便，讓這個類與剛產(chǎn)生的四個類都在同一個包下,。內(nèi)容如下：

//Main.java
package localhost.axis.Hello_jws;
public class Main{
public static void main(String[] args) throws Exception{
 HelloService service = new HelloServiceLocator();
 Hello hello = service.getHello(); 
 System.out.println("Response:"+hello.hello("罐頭")); 
 }
}

使用以下命令進行編譯：

javac -classpath lib\axis.jar;lib\jaxrpc.jar localhost\axis\Hello_jws\*.java

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

java -Djava.ext.dirs=lib -cp . localhost.axis.Hello_jws.Main//運行結(jié)果：Response:你好罐頭,，歡迎來到Web服務(wù)的世界！

在WSDL2Java工具自動產(chǎn)生 的幾個類中,，類HelloServiceLocator中保存這一些跟服務(wù)器相關(guān)的信息,，例如URL地址等，當服務(wù)器的地址更改后但是服務(wù)并沒有改動的時 候直接修改該文件中的字符串定義,，而無需重新生成這幾個類,。具體需要修改的內(nèi)容，打開該文件便可一目了然,。

2. VB客戶端

有了微軟SOAP toolkit,，用VB調(diào)用Web服務(wù)也是一件令人愉快的事情。

打開VB開發(fā)環(huán)境新建一個標準EXE項目,，打開工程(Project)菜單并選擇引用打開組件引用對話框如下圖所示：找到并選中Microsoft Soap Type Library,。

圖 4

新建并編輯窗體如下圖所示：

圖 5

編輯按鈕Call的點擊事件處理程序如下：（注意窗體的控件名稱要與程序中的名稱對應(yīng)）

Private Sub callBtn_Click()    
‘這種做法需要在工程中引用Soap Type Library  
‘Dim soap As MSSOAPLib.SoapClient  
‘Set soap = New MSSOAPLib.SoapClient
Dim soap  
Set soap = CreateObject("MSSOAP.SoapClient")   
On Error Resume Next
‘soap.mssoapinit urlText.Text 
Call soap.mssoapinit(urlText.Text)   
If Err <> 0 Then   
 MsgBox "初始化SOAP失敗： " + Err.Description       
 urlText.SetFocus 
Else       
 If Len(Trim(nameText.Text)) = 0 Then       
  MsgBox "請輸入您的姓名！"          
  nameText.SetFocus    
 Else          
  responseText.Text = soap.hello(nameText.Text) 
 End If 
 End If
End Sub

保存項目并運行,，輸入姓名并點擊按鈕Call,。

3. VC客戶端

打開VC開發(fā)環(huán)境，新建項目HelloClient,，項目類型為 Win32 Console Application的空項目,。新建C++ Source File文件名為：HelloSoap.cpp，編輯文件內(nèi)容如下：

//#include "stdafx.h"
#include <stdio.h>
#import "msxml3.dll"
using namespace MSXML2;
//根據(jù)自己機器的情況修改下面語句中指定的路徑
#import "C:\Program Files\Common Files\MSSoap\Binaries\mssoap1.dll" \ 
 exclude("IStream", "ISequentialStream", "_LARGE_INTEGER", \ 
 "_ULARGE_INTEGER", "tagSTATSTG", "_FILETIME")
using namespace MSSOAPLib;
void Hello(){ 
 ISoapSerializerPtr Serializer;
 ISoapReaderPtr Reader; 
 ISoapConnectorPtr Connector;
 // Connect to the service 
 Connector.CreateInstance(__uuidof(HttpConnector));
 Connector->Property["EndPointURL"] = "http://localhost:8080/axis/Hello.jws?wsdl";
 Connector->Connect(); 
 // Begin message
 Connector->BeginMessage(); 
 // Create the SoapSerializer 
 Serializer.CreateInstance(__uuidof(SoapSerializer)); 
 // Connect the serializer to the input stream of the connector
 Serializer->Init(_variant_t((IUnknown*)Connector->InputStream)); 
 // Build the SOAP Message 
 Serializer->startEnvelope("","",""); 
 Serializer->startBody(""); 
 Serializer->startElement("hello","","",""); 
 Serializer->startElement("name","","","");
 Serializer->writeString("罐頭"); 
 Serializer->endElement(); 
 Serializer->endElement();
 Serializer->endBody(); 
 Serializer->endEnvelope();  
 
 // Send the message to the web service 
 Connector->EndMessage();   
 
 // Let us read the response
 Reader.CreateInstance(__uuidof(SoapReader)); 
 // Connect the reader to the output stream of the connector
 Reader->Load(_variant_t((IUnknown*)Connector->OutputStream), ""); 
 // Display the result 
 printf("Response: %s\n", (const char*)Reader->RPCResult->text);  
}
int main()
{
 CoInitialize(NULL);
 Hello(); 
 CoUninitialize(); 
 
 return 0; 
}

編譯并運行該項目,。

本節(jié)只是為了演示如果通過VC來訪問使用AXIS創(chuàng)建的Web服務(wù),，至于Soap toolkit的具體使用請參照soap toolkit的幫助手冊，其他語言的訪問請查閱相關(guān)的文檔,。

回頁首

五. AXIS集成

為 了讓我們的WEB應(yīng)用程序支持Web服務(wù)功能,，我們需要將AXIS集成到我們的應(yīng)用程序中。集成AXIS很簡單,，首先需要拷貝AXIS用到的幾個JAR包 文件,，這些文件都在[AXIS]\WEB-INF\lib目錄下，將這些文件拷貝到我們自己的應(yīng)用目錄下的WEB-INF\lib,。另外如果你用的不是 TOMCAT服務(wù)器那就需要拷貝activation.jar,，這個JAR文件可以在[TOMCAT]\common\lib目錄下找到！

拷貝完JAR文件后就是web.xml的配置了,，只需要把AXIS中的web.xml中的配置信息添加到我們自己應(yīng)用程序中的web.xml中即可。最重要的是下面的內(nèi)容：

<servlet>  
 <servlet-name>AxisServlet</servlet-name>  
 <display-name>Apache-Axis Servlet</display-name>   
 <servlet-class> 
  org.apache.axis.transport.http.AxisServlet  
 </servlet-class>
</servlet>
<servlet-mapping>   
 <servlet-name>AxisServlet</servlet-name>  
 <url-pattern>*.jws</url-pattern>
</servlet-mapping>
<mime-mapping>    
 <extension>wsdl</extension>  
 <mime-type>text/xml</mime-type>
</mime-mapping>
<mime-mapping>   
 <extension>xsd</extension>   
 <mime-type>text/xml</mime-type>
</mime-mapping>

回頁首

六 總結(jié)

到 此文章告一段落,，通過以上的演練,，我相信你已經(jīng)對Web服務(wù)有一個感性的認識，但是這個僅僅是開始,，我們也只是很簡單的介紹了Web服務(wù)的一些基本概念并 演示了一個無法再簡單的例子,。Web服務(wù)還有很多其他高級的內(nèi)容例如復(fù)雜類型、數(shù)據(jù)安全等沒有涉及到,，不過沒有關(guān)系,，萬事開頭難，希望本文能夠促進大家理 解和應(yīng)用下一代的應(yīng)用模式并給還沒有動手試驗的開發(fā)人員開一個好頭,。