Axis(Apache eXtensible Interaction System)是一款开源的WebService运行引擎。它是SOAP协议的一个实现,其本身来自于Apache的另一个项目Apache SOAP。Aixs分为1.X系列和2系列,两个系列体系结构和使用上有较大的区别。相对而言,Axis1.X更加稳定,文档也比较齐全。本小节介绍的是Axis1.X系列,在下一节介绍Axis2系列。
①Axis的下载
登录http://axis.apache.org/axis/站点,Axis的最终版是1.4,下载axis-bin-1_4.zip,解压该文件,文件结构如下:
Ø Docs:存放Axis的说明文档,如API文档等
Ø Lib:存放Axis的二进制发布包
Ø Samples:存放利用axis发布的WebService示例代码
Ø Webapps:存放安装Axis的基础应用
Ø Xmls:存放相关说明文档
②Axis的安装
安装Axis前,首先必须保证已安装web服务器,如Tomcat等。在本小节中使用的是Tomcat5.5,将axis-bin-1_4.zip解压后的webapps的Axis目录全部复制到Tomcat的webapps下,然后在浏览器地址栏中输入http://localhost:8088/axis,若Axis安装成功,则出现下图所示界面:
③生成stub
在浏览器上访问服务器端的服务,可以下载到User.wsdl文件,保存到E盘,通过Axis的相关工具,可以自动从WSDL文件中生成Web Service的客户端代码。
必须把xercesImpl-2.6.1.jar xml-apis-2.0.2.jar xml-apis.jar activation.jar mail.jar xerces-2.6.2.jar这些jar包加入到路径lib中否则无法解析
编写一个WSDL2Java.bat文件,其内容如下:
set Axis_Lib=D:\software\Axis\axis-bin-1_4\axis-1_4\lib
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%
set Output_Path=D:\project\MiracleDataManager\src
set Package=com.miracle.dm.service.client
%Java_Cmd% org.apache.axis.wsdl.WSDL2Java -o%Output_Path% -p%Package% User.wsdl
cmd
注意,.bat文件中的路径不能有空格和中文字符,执行这个批处理文件就可以生成client stub.