Axis2.x WebService 开发
指南
Axis 的简单准备
Axis 的入门实例
Axis 复杂对象类型的 WebService
Axis 的辅助工具发布、调用 WebService
Axis WebService 会话 Session 的管理
Axis 用控制台 Dos 命令发布 WebService
Axis 跨多个 WebService 管理 Session
Axis 用 Spring 的 JavaBean 发布 WebService
Axis 异步调用 WebService
Axis 的 Module 模块
Axis 使用 SoapMonitar 监视 WebService 的请求和响应信息
Version1.0 2011-03-15
I T 达 人
自 由 I T 职 业
b l o g . c s d n . n e t / I B M _ h o o j o
h p : / / h o o j o . c n b l o g s . c o m /
5 0 6 6 3 7 3 1 5
2 0 1 1 - 3 - 1 5
hoojo
授之以鱼，不如授之以渔！希望能给广大 IT 朋友带
来一些帮助
1
Axis WebService 技术指南
Axis2.x WebService
上次介绍了 axis1.x 的用法，这次继续上次的，将叙述 axis2 的用法。
Axis1.x 在 线 博 文 ： http://www.cnblogs.com/hoojo/archive/
2010/12/20/1911349.html
一、 准备工作
1、开发准备
首先需要下载 axis2 的相关 jar 包，到 axis 的官方网站即可获得开发的依赖包。
下载地址：http://axis.apache.org/axis2/java/core/download.cgi
现在最高的版本是 1.5.4 的
然后你需要下载官方提供的 axis 的 eclipse 插件工具，可以帮助我们打包（aar）及其生
产客户端调用代码。
下载页面：http://axis.apache.org/axis2/java/core/tools/index.html
Service Archive Wizard - Eclipse Plug-in
Code Generator Wizard - Eclipse Plug-in
2、安装 eclipse 插件
如果你的 eclipse 插件安装成功后，会看到如下效果：
3、分析 axis2-bin 文件目录结构
下载下来的 axis2 的依赖库，其中有一个 axis2-1.5.3-bin.zip 的库文件，目录结构如下：
bin 文件夹是 axis2 的常用工具，其中有将 wsdl 文件转换成客户端调用的 wsdl2java 工
具及将 java 转换成 wsdl 文件的工具
conf 是 axis2 的配置文件
lib 运行所要的依赖库
2
Axis WebService 技术指南
repository 是发布过的 axis 服务和文件
sample 是示例
webapp 是 web 文件和 jsp 页面等
4、我们需要将下载下来的 axis2-1.5.3-war.zip 中的 axis2.war 这个文件放在我们的
tomcat 目录下，启动 tomcat 就会把 war 文件转成一个可以跑起来的 axis2 的项目。
Tomcat 启动后，在浏览器中输入：http://localhost:8080/axis2/你可以看到
二、 Axis2 的简单 WebService 示例
1、编写一个简单的 WebService 的服务器端代码，代码如下：
import java.util.Random;
/**
* <b>function:</b> WebService HelloWorld 服务示例
* @author hoojo
* @createDate 2011-1-5 下午 03:35:06
* @file HelloWorldService.java
* @package com.hoo.service
* @project Axis2WebService
* @blog http://blog.csdn.net/IBM_hoojo
* @email hoojo_@126.com
* @version 1.0
*/
public class HelloWorldService {
public String sayHello(String name) {
return name + " say: hello [axis2]";
}
public int getAge(int i) {
return i + new Random().nextInt(100);
}
}
注意，上面的 HelloWorldService 是没有 package 的。Copy 这个类的 class 文件，放
到 tomcat 目录下的 webapps 的 axis2 的 WEB-INF 目录的 pojo 文件夹下。如果没有
pojo 这 个 目 录 就 手 动 创 建 一 个 一 个 文 件 夹 。 然 后 在 浏 览 器 输 入 ： http://
3
Axis WebService 技术指南
localhost:8080/axis2/
点击 Services 的链接就可以看到我们手动发布的 HelloWorldService 了，或者是浏览器地址
栏输入：http://localhost:8080/axis2/services/listServices
你就可以看到你刚才粘贴过去的这个 WebService 了。
点击链接就可以看到 wsdl 文件的内容了。内容很多，如果你看过 axis1.x 的介绍就知道
wsdl 文件的大致结构了。
下面讲解下为什么要将 class 放 在 pojo 文 件 夹 下 。 首 先 我 们 看 看 [tomcat_home]/
webapps/axis2/WEB-INF/conf/axis2.xml
该文件中有这样一行代码：
<deployer extension=".class" directory="pojo"
class="org.apache.axis2.deployment.POJODeployer"/>
.class 的后缀文件放在目录 pojo 目录下。
2、测试这个 WebService 的方法
复制上面的 HelloWorldService 的链接地址，然后带上方法名称和参数值即可测试调用是
否成功。如下：
http://localhost:8080/axis2/services/HelloWorldService/sayHello?name=jack
http://localhost:8080/axis2/services/HelloWorldService
这个 是 WebService 的 地
址
/sayHello 是方法名称，？name=jack 是参数名称和值
在浏览器中输入上面的地址后，可以看到如下效果：
4
Axis WebService 技术指南
可以看到返回值，和方法名称。ns:sayHelloResponse 是方法名称，所有的方法名称后
都会带上 Response，后面的 ns 当然是当前方法所在的类的包名了，这里没有 package
就是默认的 axis2 的域名。
同样，getAge 方法，也是一样的调用方法。
http://localhost:8080/axis2/services/HelloWorldService/getAge?i=22
结果如下：
3、下面我们看下客户端调用代码的编写，代码如下：
package com.hoo.service;
import javax.xml.namespace.QName;
import org.apache.axis2.AxisFault;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.rpc.client.RPCServiceClient;
/**
* <b>function:</b>HelloWorldService 客户端调用代码
* @author hoojo
* @createDate 2011-1-7 下午 03:55:05
* @file HelloWorldClient.java
* @package com.hoo.service
* @project Axis2WebService
* @blog http://blog.csdn.net/IBM_hoojo
* @email hoojo_@126.com
* @version 1.0
*/
public class HelloWorldClient {
public static void main(String[] args) throws AxisFault {
//RPCServiceClient 是 RPC 方式调用
RPCServiceClient client = new RPCServiceClient();
Options options = client.getOptions();
//设置调用 WebService 的 URL
String address =
"http://localhost:8080/axis2/services/HelloWorldService";
EndpointReference epf = new EndpointReference(address);
