本文介紹了一個(gè)比較簡單實(shí)用的基于Java的SOAP引擎——Apache組織推出的Axis——的安裝、配置和應(yīng)用開發(fā)方法,希望對(duì)有興趣做基于Java的Web Services應(yīng)用開發(fā)的朋友有所幫助。
服務(wù)的發(fā)布 Axis提供了兩種服務(wù)發(fā)布方式,一種是即時(shí)發(fā)布(Instant Deployment),一種是定制發(fā)布(Custom Deployment)。
使用即時(shí)發(fā)布
對(duì)即時(shí)發(fā)布的支持是Axis的特色之一,使用即時(shí)發(fā)布使用戶只需有提供服務(wù)的Java類的源代碼,即可將其迅速發(fā)布成Web服務(wù)。每當(dāng)用戶調(diào)用這類服務(wù)的時(shí)候,Axis會(huì)自動(dòng)進(jìn)行編譯,即使服務(wù)器重啟了也不必對(duì)其做任何處理,使用非常簡單快捷。
使用即時(shí)發(fā)布首先需要一個(gè)實(shí)現(xiàn)服務(wù)功能的Java源文件,將其擴(kuò)展名改為.jws(Java Web Service的縮寫),然后將該文件放到“……\webapps\axis”目錄下即可。
在此給出一個(gè)從英里到公里的長度單位轉(zhuǎn)換的服務(wù),其源碼如下:
文件Distance.jws
/**
* @author 飛鷹
*/
public class Distance
{
public double convertMile2Kilometre( double mile )
{
//實(shí)現(xiàn)英里到公里的距離轉(zhuǎn)換
return mile * 1.609;
}//convertMile2Kilometre()
}/* Distance */
將其放到“……\webapps\axis”目錄,通過訪問http://localhost:8080/axis/Distance.jws?wsdl可以看到這個(gè)服務(wù)的WSDL描述文件,這說明Distance服務(wù)被成功發(fā)布了。如下圖所示:

使用定制發(fā)布
即時(shí)發(fā)布是一項(xiàng)令人激動(dòng)的技術(shù),它使Web服務(wù)的開發(fā)變得如此簡單;然而即時(shí)發(fā)布并不總是最好的選擇,比如有些應(yīng)用系統(tǒng)是第三方提供的,我們沒有購買源代碼,只有.class文件,但我們又希望將這個(gè)應(yīng)用系統(tǒng)的一些功能對(duì)外發(fā)布成Web服務(wù),使其能夠在更大范圍內(nèi)產(chǎn)生作用,這個(gè)時(shí)候即時(shí)發(fā)布技術(shù)就無能為力了。此外,即時(shí)發(fā)布技術(shù)并不靈活,無法進(jìn)行更多的服務(wù)配置,這使得它并不能滿足一些特定系統(tǒng)的需求。
因此,Axis提供了另一種服務(wù)發(fā)布方式,這就是定制發(fā)布。
在此給出一個(gè)從加侖到升的容積單位轉(zhuǎn)換的服務(wù),其源碼如下:
文件Capacity.java
package samples.capacity;
/**
* @author 飛鷹
*/
public class Capacity
{
public double convertGallon2Litre( double gallon )
{
//實(shí)現(xiàn)加侖到升的容積轉(zhuǎn)換
return gallon * 4.546;
}//convertGallon2Litre()
}/* Capacity */
將其編譯成.class文件,放置到“……\webapps\axis\samples\capacity”目錄下,即可著手進(jìn)行發(fā)布。
定制發(fā)布不需要構(gòu)建.jws文件,但必須創(chuàng)建服務(wù)發(fā)布描述文件deploy.wsdd(Web Service Deployment Descriptor的縮寫),這個(gè)文件負(fù)責(zé)描述服務(wù)的名稱、入口等信息,其內(nèi)容如下:
文件deploy.wsdd
<deployment xmlns="http://xml.apache.org/axis/wsdd/"
xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
<service name="Capacity" provider="java:RPC">
<parameter name="className" value="samples.capacity.Capacity"/>
<parameter name="allowedMethods" value="*"/>
</service>
</deployment>
將該文件也放到“……\webapps\axis\samples\capacity”目錄下,然后可以采用Axis提供的一個(gè)客戶端管理工具——AdminClient來完成服務(wù)的定制發(fā)布。
在“……\webapps\axis\samples\capacity”目錄下,運(yùn)行:
java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient deploy.wsdd
可以看到以下運(yùn)行結(jié)果:
Processing file deploy.wsdd
<Admin>Doneprocessing</Admin>
這表明Capacity服務(wù)定制發(fā)布完成。
通過訪問http://localhost:8080/axis/services/Capacity?wsdl可以看到這個(gè)服務(wù)的WSDL描述文件,這說明Capacity服務(wù)被成功發(fā)布了。如下圖所示:

作者:飛鷹出處:yesky責(zé)任編輯: 方舟 [ 2003-08-21 16:50 ]
本文介紹了一個(gè)比較簡單實(shí)用的基于Java的SOAP引擎的安裝、配置和應(yīng)用開發(fā)方法
服務(wù)的訪問 GET方式的服務(wù)訪問 一般的SOAP消息都是采用POST方式實(shí)現(xiàn)傳遞,但也可以通過GET方式來訪問。比如以下給出的一個(gè)服務(wù)——“HelloWorld”,其源碼如下:
文件HelloWorld.jws
/**
* @author 飛鷹
*/
public class HelloWorld
{
public String helloWorld()
{
//在服務(wù)器端打印輸出
System.out.println( "Hello World!" );
//返回相應(yīng)字符串
return "Hello World!";
}//helloWorld()
}/* HelloWorld */
這個(gè)服務(wù)給出一個(gè)名位“helloWorld”的無入口參數(shù)的操作,返回一個(gè)內(nèi)容為“Hello World!的字符串”,同時(shí)在服務(wù)器端打印“Hello World!”,將該文件放到“……\webapps\axis”目錄下,即可通過GET方法直接訪問該服務(wù),訪問的地址為http://localhost:8080/axis/HelloWorld.jws?method=helloWorld,可以看到返回的SOAP信封消息,同時(shí)服務(wù)器端給出了相應(yīng)的顯示信息“Hello World!”這表明HelloWorld服務(wù)被成功訪問了。如下圖所示:

客戶端服務(wù)訪問編程
Axis提供了一套API來實(shí)現(xiàn)SOAP,從http://localhost:8080/axis/docs/apiDocs/index.html可以看到Axis的API文檔。
其中,org.apache.axis.client.Call和org.apache.axis.client.Service是兩個(gè)比較常用的類,一般的客戶端程序欲訪問一個(gè)Web Service時(shí),都要生成一個(gè)客戶端的Service對(duì)象和Call對(duì)象,在訪問服務(wù)之前,首先要對(duì)Call對(duì)象設(shè)置相應(yīng)的參數(shù),包括服務(wù)的位置、操作名、入口參數(shù)、返回值類型等,最后調(diào)用Call對(duì)象的invoke方法訪問服務(wù)。
以下給出了一個(gè)客戶端訪問Web服務(wù)的例程——AXISTest.java:
文件AXISTest.java
package axisexercise;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType;
import javax.xml.rpc.ParameterMode;
/**
* @author 飛鷹
*/
public class AXISTest
{
public static void main( String[] args ) throws Exception
{
Service service = new Service();
Call call = ( Call ) service.createCall();
//////////訪問即時(shí)發(fā)布的Distance服務(wù)
//設(shè)置訪問點(diǎn)
call.setTargetEndpointAddress( "http://localhost:8080/axis/Distance.jws" );
//設(shè)置操作名
call.setOperationName( "convertMile2Kilometre" );
//設(shè)置入口參數(shù)
call.addParameter( "op1", XMLType.XSD_DOUBLE, ParameterMode.IN );
call.setReturnType( XMLType.XSD_DOUBLE );
Double d1 = new Double( 190 );
//調(diào)用服務(wù)
System.out.println( d1 + " 英里相當(dāng)于 " +
call.invoke( new Object[] {d1} ) + " 公里!" );
//////////訪問定制發(fā)布的Capacity服務(wù)
call = ( Call ) service.createCall();
//設(shè)置訪問點(diǎn)
call.setTargetEndpointAddress( "http://localhost:8080/axis/services/Capacity" );
//設(shè)置操作名
call.setOperationName( "convertGallon2Litre" );
//設(shè)置入口參數(shù)
call.addParameter( "op1", XMLType.XSD_DOUBLE, ParameterMode.IN );
call.setReturnType( XMLType.XSD_DOUBLE );
d1 = new Double( 10.00 );
//調(diào)用服務(wù)
System.out.println( d1 + " 加侖相當(dāng)于 " +
call.invoke( new Object[] {d1} ) + " 升!" );
} //main()
}/* AXISTest */
編譯運(yùn)行后運(yùn)行可以看到以下的結(jié)果:
190.0英里相當(dāng)于305.71公里!
10.0加侖相當(dāng)于45.46升!
注意程序在訪問即時(shí)發(fā)布的Distance服務(wù)和定制發(fā)布的Capacity服務(wù)時(shí)的不同,前者的服務(wù)訪問點(diǎn)地址為http://localhost:8080/axis/HelloWorld.jws,而后者的則為http://localhost:8080/axis/services/Capacity。
來自:http://hi.baidu.com/zxhcloth/blog/item/bb8637dbf28e0b67d0164ea5.html