写在前面
本文只说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了,结束。