axis2 搭建webservice

准备工作:

1.下载axis2相关文件
http://www.apache.org/dist//axis/axis2/java/core/1.6.1/
下载: 1.6.1-bin.zip,axis2-1.6.1-war.zip
下载:二个相应的插件
2.解压axis2-1.6.1-war.zip,将axis2.war复制到tomcat/webaps目录下
3.解压axis2-1.6.1-bin.zip,放至相应目录(后边会用到)
4.启动tomcat,输入:http://localhost:8080/axis2

开始搭建:
1.建立web project工程 axis2Demo(jdk1.5以上)
2.导入上步axis2-1.6.1-bin中lib目录下jar包
3.将第一步中axis2.war/WEB-INF下modules、service和conf三个文 件夹复制到当前工程WEB-INF目录下
4.配置web.xml,在web.xml中增加对axis2的支持
<!-- 加载Axis -->
<servlet>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>AxisServlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>
<!-- 加载Axis 结束 -->

5.创建web project 工程,新建axis2服务类 com.suncf.axis2.server.HelloWorld
public String getHello(String hello){
return "你好,陌生人:"+hello;
}
6.在WEB-INF下新建\services\HelloWorld\META-INF 目录.
7.新建services.xml
<?xml version="1.0" encoding="UTF-8"?>
<service name="HelloWorld">
<description>
HelloWorld Service Example
</description>
<parameter name="ServiceClass">
com.suncf.axis2.server.HelloWrold
</parameter>
<operation name="getHello">
<!-- 当没有返回值时用 org.apache.axis2.rpc.receivers.
RPCInOnlyMessageReceiver，没有参数还是用RPCMessageReceiver-->
<messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
</operation>
</service>

注:如果有多个类实现时可以加上:
<serviceGroup>
<service>
........
</service>
</serviceGroup>

8.发布工程,在浏览器中输入:http://localhost:8080/axis2/services/HelloWorld?wsdl
出现发下画面,则说明service发布成功

9.客户端调用代码(这里例出二种调用方式)
9.1:通过插件升成的客户端代码时这样调用
/**
* main(这里用一句话描述这个方法的作用)
* @作者: suncf
* @创建时间:2013-1-25下午02:31:51
* @param args
* @return void
* @throws Exception
* @since CodingExample　Ver(编码范例查看) 1.1
*/
public static void main(String[] args) throws Exception {
HitSoftAxis2DemoStub sub = new HitSoftAxis2DemoStub();
GetMessage mes = new GetMessage();
mes.setMes("测试消息");
System.out.println(sub.getMessage(mes).get_return());

PMServiceStub sub1 = new PMServiceStub();
ServiceClient ser = sub1._getServiceClient();
}

其中:GetMessage 类为代码自动升成的,此类对应对外接口中的参数名.升成代码请往下边看....
9.2:本机测试时
public static void main(String[] args) {
String url = "http://localhost:8080/axis2/services/HelloWorld";
try {
// 使用RPC方式调用WebService
RPCServiceClient serviceClient = new RPCServiceClient();
Options options = serviceClient.getOptions();
// 指定调用WebService的URL
EndpointReference targetEPR = new EndpointReference(url);
options.setTo(targetEPR);
// 在创建QName对象时，QName类的构造方法的第一个参数表示WSDL文件的命名空间名，也就是<wsdl:definitions>元素的targetNamespace属性值
// 指定getGreeting方法的参数值，如果有多个，继续往后面增加即可，不用指定参数的名称
Object[] opAddEntryArgs = new Object[] {};
// 返回参数类型，这个和axis1有点区别
// invokeBlocking方法有三个参数，其中第一个参数的类型是QName对象，表示要调用的方法名；
// 第二个参数表示要调用的WebService方法的参数值，参数类型为Object[]；
// 第三个参数表示WebService方法的返回值类型的Class对象，参数类型为Class[]。
// 当方法没有参数时，invokeBlocking方法的第二个参数值不能是null，而要使用new Object[]{}
// 如果被调用的WebService方法没有返回值，应使用RPCServiceClient类的invokeRobust方法，
// 该方法只有两个参数，它们的含义与invokeBlocking方法的前两个参数的含义相同
// 指定getGreeting方法返回值的数据类型的Class对象.....

Class[] classes = new Class[] { String.class };
QName opAddEntry = new QName("http://axis2.suncf.com", "getHello");
opAddEntryArgs = new Object[] {"测试消息"};
System.out.println(serviceClient.invokeBlocking(opAddEntry, opAddEntryArgs, classes)[0]);
} catch (Exception e) {
e.printStackTrace();
}
}


插件升成WSDL
1.安装二个插件(这里不在多做说明,请参考其它文档)
2.点击左键,选择new->other->Axis2 Wizards->Axis2 Code Generator->第二项(Generate a WSDL from a java source file) next>
3.Fully Qualified Class name:中添写当前webservice对外的方法(含包名)如:com.suncf.axis2.HitSoftAxis2Demo
4.在Add Folder 中选择 步骤 3 中,添写文件的class目录.指定目录时指定到 WEB-INF/classes 目录中即可.
5.点击TestClass Loading...出现success 是说明成功.否则下 next>是点不上的.
6.保持默认即可
7.选择一个wsdl输出路径及要输出的wsdl的名字,点击完成
8.查看输出位置,会有一个 升成的wsdl文件
9.查看wsdl文件,如果文件后的sop address 不为当前路径所对应的地址时,请改正过来.比如我现在升成的就为:
http://localhost:8080/axis2/services/HitSoftAxis2Demo 改为:
http://localhost:8080/Axis2Demo/services/HitSoftAxis2Demo
(可能是那里配置不对,先手动改一下吧)

通过wsdl升成客户端代码
1.选择new->other->Axis2 Wizards->Axis2 Code Generator->(第一项)Generate java source code from a wsdl file
2.选择wsdl文件位置 next>
3.一路保持默认即可.
4.选择一个输出路径,点击finish即可.
5.将升成的代码,复制到当前工程中.自己把错误改一下(包名不对什么的)
6. 9.1中,只有通过插件升成了客户端代码后,才可以按9.1中的方法调用.