转：用Axis开发基于Java的Web服务

HHJ — Tue, 28 Mar 2006 08:05:00 GMT

概述

　　本文介绍了一个比较简单实用的��Z��Java的SOAP引擎——Apache�l�织推出的Axis——的安装、配�|�和应用开发方法，希望�Ҏ��兴趣做基于Java的Web Services应用开发的朋友有所帮助�?br />
Axis��?br />
　　Axis是Apache�l�织推出的SOAP引擎�Q�Axis��目是Apache�l�织著名的SOAP��目的后�l�项目，目前最新版本是采用Java开发的1.1版本�Q�C++的版本正在开发之中。Axis v1.1软�g包可以从http://ws.apache.org/axis/dist/1_1/下蝲得到�?

　　Axis的安�?/b>

　　应用Axis开发Web Services�Q�你需要有一个支持Servlet的服务器引擎�Q�比如广��Z�h知的Tomcat�Q�Tomcat也是由Apache�l�织所提供的，目前的最新版本�ؓ4.1.24�Q�下载地址为http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/v4.1.24/�Q�。在此之前当然你机器必须已经装好了JDK1.3以上的版本，当安装好Tomcat之后�Q�只需��下载的Axis软�g包解压羃�Q�将其中的“webapps”目录下的“axis”目录整个拷贝到Tomcat安装目录下的“webapps”目录下卛_��?/p>

　　Axis的配�|?/b>

　　Axis��Z��Java开发，可以部��v于多�U�操作系�l�，使用前需要配�|�一�p�d��的系�l�变量，在此假定你已�l�在本机上装好了Tomcat 4.0以上的版本，需要配�|�的�pȝ��变量如下表所�C�：

CATALINA_HOME
C:\Tomcat_4_1

�Q�此处应为Tomcat的安装位�|�，注意路径名中不要有空��|��

AXIS_HOME
%CATALINA_HOME%\webapps\axis

AXIS_LIB
%AXIS_HOME%\lib

AXISCLASSPATH
%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery.jar; %AXIS_LIB%\commons-logging.jar;%AXIS_LIB%\jaxrpc.jar; %AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar; %AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar

　　如果你不愿做�q�么�J�琐的类路径讄��Q�可以直接将axis软�g包中“lib”目录下的所�?jar文�g加入到系�l�环境变量CLASSPATH中即可�?/p>

　　Axis的测�?/b>

　　安装配置完毕后，应测试一下是否Axis可以正确�q�行了�?/p>

　　启动Tomcat服务器，在浏览器中访�?a href="http://localhost:8080/axis/happyaxis.jsp">http://localhost:8080/axis/happyaxis.jsp�Q�如果页面显�C�有错误�Q�则需要回头检查一下相关配�|�是否正��，如果��览��面能正��显�C�出�pȝ��l��g、属性等参数配置信息�Q�则表示安装成功�Q�如下图所�C�：

　　现在可以开始开发你的Web Services应用了�?br />
服务的发�?br />
　　Axis提供了两�U�服务发布方式，一�U�是��x��发布�Q�Instant Deployment�Q�，一�U�是定制发布�Q�Custom Deployment�Q��?

　　使用��x��发布

　　对即时发布的支持是Axis的特色之一�Q��用即时发布��用户只需有提供服务的Java�cȝ��源代码，卛_��其�q�速发布成Web服务。每当用戯��用这�c�L��务的时候，Axis会自动进行编译，即��服务器重启了也不必对其做��M��处理�Q��用非常简单快捗��?/p>

　　使用��x��发布首先需要一个实现服务功能的Java源文�Ӟ��其扩展名改�?jws�Q�Java Web Service的羃写）�Q�然后将该文件放到“……\webapps\axis”目录下卛_��?/p>

　　在此�l�出一个从英里到公里的长度单位转换的服务，其源码如下：

文�gDistance.jws

/**

* @author 飞鹰

public class Distance

{

public double convertMile2Kilometre( double mile )

{

//实现英里到公里的距离转换

return mile * 1.609;

}//convertMile2Kilometre()

}/* Distance */

　　��其攑ֈ�“……\webapps\axis”目录，通过讉K��http://localhost:8080/axis/Distance.jws?wsdl可以看到�q�个服务的WSDL描述文�g�Q�这说明Distance服务被成功发布了。如下图所�C�：

　　使用定制发布

　　��x��发布是一��o人激动的技术，它��Web服务的开发变得如此简单；然而即时发布�ƈ不��L��最好的选择�Q�比如有些应用系�l�是�W�三�Ҏ��供的�Q�我们没有购买源代码�Q�只�?class文�g�Q�但我们又希望将�q�个应用�pȝ��的一些功能对外发布成Web服务�Q��其能够在更大范围内��生作用，�q�个时候即时发布技术就无能为力了。此外，��x��发布技术�ƈ不灵�z�，无法�q�行更多的服务配�|�，�q��得它�q�不能满��一些特定系�l�的需求�?/p>

　　因此�Q�Axis提供了另一�U�服务发布方式，�q�就是定制发布�?/p>

　　在此�l�出一个从加仑到升的容�U�单位�{换的服务�Q�其源码如下�Q?/p>

　　文�gCapacity.java

package samples.capacity;

/**

* @author 飞鹰

public class Capacity

{

public double convertGallon2Litre( double gallon )

{

//实现加仑到升的容�U��{�?/p>

return gallon * 4.546;

}//convertGallon2Litre()

}/* Capacity */

　　��其�~�译�?class文�g�Q�放�|�到“……\webapps\axis\samples\capacity”目录下�Q�即可着手进行发布�?/p>

　　定制发布不需要构�?jws文�g�Q�但必须创徏服务发布描述文�gdeploy.wsdd�Q�Web Service Deployment Descriptor的羃写）�Q�这个文件负责描�q�服务的名称、入口等信息�Q�其内容如下�Q?/p>

　　文�gdeploy.wsdd

xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">

　　��该文�g也放到“……\webapps\axis\samples\capacity”目录下�Q�然后可以采用Axis提供的一个客��L��理工具——AdminClient来完成服务的定制发布�?/p>

　　在“……\webapps\axis\samples\capacity”目录下�Q�运行：

java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient deploy.wsdd

　　可以看到以下�q�行�l�果�Q?/p>

Processing file deploy.wsdd

Doneprocessing

　　�q�表明Capacity服务定制发布完成�?/p>

　　通过讉K��http://localhost:8080/axis/services/Capacity?wsdl可以看到�q�个服务的WSDL描述文�g�Q�这说明Capacity服务被成功发布了。如下图所�C�：

服务的访�?br />
　　GET方式的服务访�?/b>

　　一般的SOAP消息都是采用POST方式实现传递，但也可以通过GET方式来访问。比如以下给出的一个服务——“HelloWorld”，其源码如下：

文�gHelloWorld.jws

/**

* @author 飞鹰

public class HelloWorld

{

public String helloWorld()

{

//在服务器端打印输�?/p>

System.out.println( "Hello World!" );

//�q�回相应字符�?/p>

return "Hello World!";

}//helloWorld()

}/* HelloWorld */

　　�q�个服务�l�出一个名位“helloWorld”的无入口参数的操作�Q�返回一个内容�ؓ“Hello World�Q�的字符东y��，同时在服务器端打印“Hello World�Q�”，��该文�g攑ֈ�“……\webapps\axis”目录下�Q�即可通过GET�Ҏ��直接讉K��该服务，讉K��的地址为http://localhost:8080/axis/HelloWorld.jws?method=helloWorld�Q�可以看到返回的SOAP信封消息�Q�同时服务器端给��Z��相应的显�C�Z��息“Hello World�Q�”这表明HelloWorld服务被成功访问了。如下图所�C�：

　　客户端服务访问编�E?/b>

　　Axis提供了一套API来实现SOAP�Q�从http://localhost:8080/axis/docs/apiDocs/index.html可以看到Axis的API文档�?/p>

　　其中�Q�org.apache.axis.client.Call和org.apache.axis.client.Service是两个比较常用的�c�，一般的客户端程序欲讉K��一个Web Service�Ӟ��都要生成一个客��L��的Service对象和Call对象�Q�在讉K��服务之前�Q�首先要对Call对象讄��相应的参敎ͼ�包括服务的位�|�、操作名、入口参数、返回值类型等�Q�最后调用Call对象的invoke�Ҏ��讉K��服务�?/p>

　　以下�l�出了一个客��L��讉K��Web服务的例�E�——AXISTest.java�Q?/p>

　　文�gAXISTest.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();

//////////讉K��x��发布的Distance服务

//讄��讉K��?/p>

call.setTargetEndpointAddress( "http://localhost:8080/axis/Distance.jws" );

//讄��操作�?/p>

call.setOperationName( "convertMile2Kilometre" );

//讄��入口参数

call.addParameter( "op1", XMLType.XSD_DOUBLE, ParameterMode.IN );

call.setReturnType( XMLType.XSD_DOUBLE );

Double d1 = new Double( 190 );

//调用服务

System.out.println( d1 + " 英里相当�?" +

call.invoke( new Object[] {d1} ) + " 公里�Q? );

//////////讉K��定制发布的Capacity服务

call = ( Call ) service.createCall();

//讄��讉K��?/p>

call.setTargetEndpointAddress( "http://localhost:8080/axis/services/Capacity" );

//讄��操作�?/p>

call.setOperationName( "convertGallon2Litre" );

//讄��入口参数

call.addParameter( "op1", XMLType.XSD_DOUBLE, ParameterMode.IN );

call.setReturnType( XMLType.XSD_DOUBLE );

d1 = new Double( 10.00 );

//调用服务

System.out.println( d1 + " 加仑相当�?" +

call.invoke( new Object[] {d1} ) + " 升！" );

} //main()

}/* AXISTest */

　　�~�译�q�行后运行可以看��C��下的�l�果�Q?/p>

　　190.0英里相当�?05.71公里�Q?/p>

　　10.0加仑相当�?5.46升！
　
　　注意�E�序在访问即时发布的Distance服务和定制发布的Capacity服务时的不同�Q�前者的服务讉K��点地址为http://localhost:8080/axis/HelloWorld.jws�Q�而后者的则�ؓhttp://localhost:8080/axis/services/Capacity�?/p>

　　�ȝ��

　　Web Services是未来网�l�应用的发展方向�Q�SOAP和WSDL是Web Services的核心协议，Axis�l�出了一个很好的SOAP实现�Q�它使得开发Web Services应用变得��L��而有��?br />

注明

转蝲�?span class="postbody">http://www.yesky.com/SoftChannel/72342371961929728/20030821/1723269.shtml

HHJ 2006-03-28 16:05 发表评论

国产亚洲精品激情都市,精品国产日韩久久亚洲,亚洲一卡2卡3卡4卡5卡6卡

转：用Axis开发基于Java的Web服务