axis2 1.7.1使用教程

写在前面

　本文只说Axis2的用法。

1、下载与部署

　　需要下载两个文件：

　　下载地址：http://mirrors.cnnic.cn/apache/axis/axis2/java/core/1.7.1/axis2-1.7.1-war.zip，该文件是部署所用；

下载地址：http://mirrors.cnnic.cn/apache/axis/axis2/java/core/1.7.1/axis2-1.7.1-bin.zip，该文件是开发所用；

解压axis2-1.7.1-war.zip会得到一个axis2.war，将之扔到tomcat之webapps目录之下，启动tomcat，war包会自动解压；

测试：http://localhost:8080/axis2，看到欢迎界面了吧，恭喜第一步成功了！

2、配置axis2

　  打开/axis2/WEB-INF/conf/axis2.xml配置文件，找到<parameter name="hotupdate">false</parameter>改为true；

只是为了热更新，方便调试。不配置也可以的。

3、HelloWorld

在/axis2/WEB-INF目录下，新建一个目录pojo，在该目录下新建一个java文件：

?

1 2 3 4 5 6

public class HelloWorld {     public String sayHello(){         return "hello world!";     } }

编译之，shift，在此处打开命令行，javac HelloWorld.java, 不用解释吧？

看到多了一个HelloWorld.class文件吧，就是它！

打开浏览器，输入：http://localhost:8080/axis2/services/HelloWorld;

4、pojo目录说明

   为什么是pojo目录，新建个不行么？

当然行，不过需要配置一下下，打开/axis2/WEB-INF/conf/axis2.xml配置文件，找到如下内容，新增目录

?

1 2	<deployer extension=".class" directory="pojo" class="org.apache.axis2.deployment.POJODeployer"/><BR> <!--新增的目录--> <deployer extension=".class" directory="pojo2" class="org.apache.axis2.deployment.POJODeployer"/>

注意：这里面放置的类不能保护package，另外如果多个目录，service名称不能重复.

5、no package？那怎么能行！

    打开eclipse,建一个java project，并建立com.ws.test.services包，在该包下创建一个类HelloService，代码如下：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

package com.ws.test.services;    public class HelloService {            /**      * 没有返回值      * @param info      */     public void send(String info) {         System.out.println(info);     }        /**      * 有返回值      * @param x      * @param y      * @return      */     public int add(int x, int y) {         return x + y;     } }

在src目录下新建META-INF文件夹，在其下建立两个文件：MANIFEST.MF和services.xml

serviecs.xml代码如下：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

<?xml version="1.0" encoding="UTF-8"?>    <service name="HelloService">     <description>一个简单的WebService</description>     <!-- 服务全类名 -->     <parameter name="ServiceClass">com.ws.test.services.HelloService</parameter>        <operation name="send">         <!-- 信息接收器， 无返回值用：RPCInOnlyMessageReceiver-->         <messageReceiver mep="http://www.w3.org/ns/wsdl/in-only"             class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />     </operation>     <operation name="add">         <!-- 信息接收器， 有返回值用：RPCMessageReceiver-->         <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"             class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />     </operation>    </service>

注：\axis2-1.7.1\samples\pojo\src\META-INF目录下有services.xml例子，可以复制过来修改。

6、打包

     选择包名和META-INF，export为server.jar，修改为servier.aar,扔进\webapps\axis2\WEB-INF\services目录下，重启tomcat

     测试：http://localhost:8080/axis2，点击services,出现如下界面：

     

成功了一大步！

　  测试：http://localhost:8080/axis2/services/HelloService/send?info=hello，如果tomcat控制台输出hello，测试成功！

测试：http://localhost:8080/axis2/services/HelloService/add?x=1&y=4，如果返回5，测试成功！

7、如何发布多个Service呢？

    在com.ws.test.services目录下新建HelloService2,代码如下：

?

1 2 3 4 5 6 7

package com.ws.test.services;    public class HelloService2 {     public int sub(int x, int y) {         return x - y;     } }

修改services.xml文件：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32

<?xml version="1.0" encoding="UTF-8"?> <serviceGroup>     <service name="HelloService">         <description>一个简单的WebService</description>         <!-- 服务全类名 -->         <parameter name="ServiceClass">com.ws.test.services.HelloService         </parameter>            <operation name="send">             <!-- 信息接收器， 无返回值用：RPCInOnlyMessageReceiver -->             <messageReceiver mep="http://www.w3.org/ns/wsdl/in-only"                 class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />         </operation>         <operation name="add">             <!-- 信息接收器， 有返回值用：RPCInOnlyMessageReceiver -->             <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"                 class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />         </operation>        </service>        <service name="HelloService2">         <description>一个简单的WebService 2</description>         <parameter name="ServiceClass">com.ws.test.services.HelloService2         </parameter>         <operation name="sub">             <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"                 class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />         </operation>     </service>    </serviceGroup>

重新打包，扔进\webapps\axis2\WEB-INF\services目录下；

测试：http://localhost:8080/axis2/services/HelloService2/sub?x=5&y=2，返回3，则测试成功！

8、如何在程序中调用webservice呢？

     先加入jar包，jar包路径：\axis2-1.7.1\lib\*.jar

（1）直接看代码吧，这个方法比较麻烦

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37

package com.ws.test.client;    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;    public class TestClient {        public static void main(String[] args) throws AxisFault {            RPCServiceClient serviceClient = new RPCServiceClient();         Options options = serviceClient.getOptions();            EndpointReference targetEPR = new EndpointReference(                 "http://localhost:8080/axis2/services/HelloService");         options.setTo(targetEPR);            Object[] entryArgs = new Object[] { 4, 2 };         //命名空间：wsdl:definitions标签targetNamespace属性         QName opName = new QName("http://services.test.ws.com", "add");            //有返回值         Object result = serviceClient.invokeBlocking(opName, entryArgs,                 new Class[] { int.class })[0];         System.out.println(result);            opName = new QName("http://services.test.ws.com", "send");            //无返回值         serviceClient.invokeRobust(opName, new Object[]{"hello world!"});                }    }

 (2)使用wsdl2java

使用方法：

①先配置axis2客户端环境变量

AXIS2_HOME:D:\Program Files\axis2-1.7.1

path追加：%AXIS2_HOME%\bin

②在项目目录下，即跟src目录同级，shift进入命令行窗口，输入如下命令：

?

1	wsdl2java -uri http://localhost:8080/axis2/services/HelloService?wsdl -p com.ws.test.stubs -s

③进入项目F5

是不是多了一个包叫做：com.ws.test.stubs下面有给类叫做HelloServiceStub，打开看看，吓死宝宝了，好多内容，还好不用管他。

④客户端代码，直接看代码了

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

package com.ws.test.client;    import java.rmi.RemoteException; import com.ws.test.stubs.HelloServiceStub; import com.ws.test.stubs.HelloServiceStub.Add;    public class TestClient2 {        public static void main(String[] args) throws RemoteException {         HelloServiceStub stub = new HelloServiceStub();         Add add = new Add();         add.setX(1);         add.setY(2);         int result = stub.add(add).get_return();         System.out.println(result);     } }

 宝宝用起来很舒服！

9、wsdl2java好强大，是不是可以转换任何的WebService啊？

当然可以了，废话少说，代码如下：

①干啥？当然运行命令了

?

1	wsdl2java -uri http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl -p com.ws.test.stubs -s

②客户端测试代码

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

package com.ws.test.client;    import java.rmi.RemoteException; import com.ws.test.stubs.WeatherWebServiceStub; import com.ws.test.stubs.WeatherWebServiceStub.ArrayOfString; import com.ws.test.stubs.WeatherWebServiceStub.GetSupportCity;    public class TestWeather {        public static void main(String[] args) throws RemoteException {         WeatherWebServiceStub stub = new WeatherWebServiceStub();         GetSupportCity gsc = new GetSupportCity();         gsc.setByProvinceName("山东");         ArrayOfString as = stub.getSupportCity(gsc).getGetSupportCityResult();         for (String city : as.getString()) {             System.out.println(city);         }     } }

看控制台输出：

济南 (54823)
青岛 (54857)
淄博 (54830)
威海 (54774)
曲阜 (54918)
临沂 (54938)
烟台 (54765)
枣庄 (58024)
聊城 (54806)
济宁 (54915)
菏泽 (54906)
泰安 (54827)
日照 (54945)
东营 (54736)
德州 (54714)
滨州 (54734)
莱芜 (54828)
潍坊 (54843)

ok了，结束。