写在前面

 本文只说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,出现如下界面:

      axis2 1.7.1使用教程_apache

     成功了一大步!

   测试: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了,结束。