前言
本文将讲述使用eclipse发布axis2服务的环境准备到发布过程。
1、基础准备
eclipse需要两个插件(eclipse_axis2-插件-直接解压到dropins)
javascript:void(0)
然后是axis2的war包和bin包,前者我们可以直接看到axis2服务启动的样子,并且把我们的webservice服务直接添加到这个axis2项目中,后面的bin包则直接为eclipse开发
axis2提供了环境支持。
axis2的war和bin下载(当然你也可以从apache的官网下载较新版本)
下载地址
javascript:void(0)
你本地需要有可以启动的服务器,我这里是tomcat
2、解压axis2-1.7.4-war.zip和axis2-1.7.4-bin.zip
得到axis2.war和axis2-1.7.4
对于axis2.war的处理
放到tomcat服务器webapps下启动
访问 http://localhost:8080/axis2/
点击Administration ,右面有个username和password,这是axis2提供的demo的管理员登陆页,默认是 admin/axis2
如果是生产环境一定记得修改,位置为axis2\WEB-INF\conf\axis2.xml
点击Services,就可以看到axis2自带的webservice服务了
对于axis2-1.7.4的处理
把axis2-1.7.4复制到某一个位置,比如你的D盘然后需要在3中设置了
3、在eclipse中配置axis2的开发环境
点击preferences
然后如上图设置axis2的bin路径,里面的一些jar包等会为eclipse提供支持
eclipse中axis2的插件
eclipse的两个axis2的插件解压到eclipse/dropins,然后重启eclipse
这样,你的eclipse中就可以看到这两个东西了,一个用于将java方法生成为服务端,一个则用于生成客户端
4、下面将写个简单的例子
这个例子包含两个部分,一是服务的发布,二是服务的访问
服务的发布包含简单方法的发布和复杂方法的发布
服务的访问包含axis2客户端访问和axis2的RPC访问
4.1 方法1-接口和接口的实现
接口类
1. package stu.demo.service;
2.
3. public interface Axis2TestImpl {
4. public String WriteStr(String str);
5. }
实现类,也是具体服务的发布类
1. package stu.demo.service;
2.
3. public class AxisTestService implements Axis2TestImpl {
4.
5. public String WriteStr(String str){
6. "您输入的是:"+str);
7. return str;
8. }
9.
10. }
4.2 使用axis2的插件AxisTestService输出为webservice服务
注意红色方框圈中的区域,new来自于eclipse左上角的File
选择服务所在项目的classes文件夹
一路点下去
继续点
还点
再点一下,得到
Service name就是webservice的名字,Class name是方法所在类的路径,然后按下Load,下面会显示Method name,点next
那个location是文件输出路径,你自定义的,下面File name是输出文件的名字(我这个文是后面写的,所以名字和下面的配图不一样)
然后在你设置的位置得到下面的文件(axis2test_service.aar)
4.3 把服务发布到axis2.war中
还记得tomcat中的那个项目吗
先停止tomcat服务器
把axis2test_service.aar复制到axis2这个项目的axis2\WEB-INF\services\下
(记得把axis2.war删除)
然后重启tomcat
这样你就已经把你刚写的服务发布到这个axis2中去了
访问http://localhost:8080/axis2/services/listServices
4.4 编写并发布另外两个服务
刚才发布的是一个以接口实现类形式展现的类,返回的是String类型,下面将发布不实现任何接口的类,以及返回为实体类型的方法
发布的方法不再赘述
不实现接口的类发布为webservice服务
1. package stu.demo.noimpl;
2.
3. public class Axis2NoImpl {
4.
5. public String WriteYourName(String name){
6. "你输入的名字为:"+name);
7. return name;
8. }
9.
10. }
eclipse产生的对应的aar文件为 axis2noImpl.aar
返回类型为实体类的发布为webservice服务
需要实体类
1. package stu.demo.fz;
2.
3. public class ModelUser {
4.
5. private String userName;
6. private String userPwd;
7. public String getUserName() {
8. return userName;
9. }
10. public void setUserName(String userName) {
11. this.userName = userName;
12. }
13. public String getUserPwd() {
14. return userPwd;
15. }
16. public void setUserPwd(String userPwd) {
17. this.userPwd = userPwd;
18. }
19.
20.
21.
22. }
然后是包含发布方法的类
1. package stu.demo.fz;
2.
3. public class Axis2Fz {
4. public ModelUser WriteModelUser(ModelUser modelUser){
5. "你输入的用户名为:"+modelUser.getUserName());
6. "你输入的密码为:"+modelUser.getUserPwd());
7. return modelUser;
8. }
9. }
eclipse产生的对应的aar文件为 axis2Fz.aar
4.5 axis2插件生成客户端访问webservice
这里涉及到要为哪一个webservice设置客户端
所以先获取webservice的wsdl地址
方法如下
如下
然后接着说eclipse的下一步
Next
Next
选择输出到向项目,然后直接选择一个项目的路径(到项目名字即可)
然后Finesh
得到客户端
当然,如果你为复杂的返回类型那个生成客户端,则会有一个实体类文件生成
4.5 axis2的客户端调用和RPC调用
这里不赘述了了,直接把客户端的调用方法和PRC的调用方法贴出来
需要注意的是,如果只是PRC调用的话,对于返回参数为某个实体类的话,需手动创建实体类文件
需要强调的是,对于客户端调用,其方法名字是和你调用的服务的类的名字息息相关的,但是大体思路是
实例化Stub stub
实例化入参类型 入参
实例化返回类型 返回
返回=stub.方法(入参)
返回.getreturn()就是返回值
1. package stu.demo.test;
2.
3. import java.rmi.RemoteException;
4.
5. import javax.xml.namespace.QName;
6.
7. import junit.framework.TestCase;
8.
9. import org.apache.axis2.AxisFault;
10. import org.apache.axis2.addressing.EndpointReference;
11. import org.apache.axis2.client.Options;
12. import org.apache.axis2.rpc.client.RPCServiceClient;
13. import org.junit.Test;
14.
15. import stu.demo.fz.xsd.ModelUser;
16. import stu.demo.noimpl.Axis2NoImplStub;
17. import stu.demo.noimpl.WriteYourName;
18. import stu.demo.noimpl.WriteYourNameResponse;
19.
20. public class Axis2ClientNoImpl {
21. /**
22. * 使用axis2客户端调用
23. */
24. @Test
25. public void testAxis2NoImpl(){
26. try {
27. "Jecket";
28. // Axis2NoImplStub Axis2NoImpl =new Axis2NoImplStub();//这个方法访问地址被封装到了客户端代码
29. new Axis2NoImplStub("http://localhost:8080/axis2/services/Axis2NoImpl.Axis2NoImplHttpSoap12Endpoint/");//如果生产地址和测试不一致,则需要指定,灵活运用
30.
31. new WriteYourName ();
32. writeYourName.setName(name);
33.
34. new WriteYourNameResponse();
35.
36. writeYourNameResponse=Axis2NoImpl.writeYourName(writeYourName);
37.
38. "方法返回的名字和你输入的名字不一致", writeYourNameResponse.get_return()==name);
39. catch (AxisFault e) {
40. // TODO Auto-generated catch block
41. e.printStackTrace();
42. catch (RemoteException e) {
43. // TODO Auto-generated catch block
44. e.printStackTrace();
45. }
46. }
47.
48. /**
49. * 使用axis2的RPC调用
50. */
51. @Test
52. public void testAxis2NoImpl2(){
53. "";
54. try {
55.
56. "http://localhost:8080/axis2/services/Axis2NoImpl?wsdl";
57. //使用RPC方式调用WebService
58. new RPCServiceClient();
59. Options options = serviceClient.getOptions();
60. //设置2秒超时
61. options.setTimeOutInMilliSeconds(2000L);
62. //指定调用WebService的URL
63. new EndpointReference(serviceUrl);
64. options.setTo(targetEPR);
65.
66. //指定接口方法的参数值
67. new Object[] {"Jecket"};
68. //指定方法返回值的数据类型的Class对象
69. new Class[] { String.class };
70. //指定调用的方法及WSDL文件的命名空间 QName("targetNamespace","method Name");
71. new QName("http://noimpl.demo.stu","WriteYourName");
72. //调用getVersioin方法并输出该方法的返回值,
73. //返回对象是一个Object的数组,拿数组的第一个值,转换强转即可
74. 0].toString();
75. catch (Exception e) {
76. e.printStackTrace();
77. result = e.getMessage();
78.
79.
80. }
81. "返回值result="+result);
82. }
83.
84. /**
85. * 使用axis2的RPC调用
86. * 入参和反参都是复杂类型
87. */
88. @Test
89. public void testAxis2Fz(){
90. "";
91. try {
92.
93. "http://localhost:8080/axis2/services/Axis2Fz?wsdl";
94. //使用RPC方式调用WebService
95. new RPCServiceClient();
96. Options options = serviceClient.getOptions();
97. //设置2秒超时
98. options.setTimeOutInMilliSeconds(2000L);
99. //指定调用WebService的URL
100. new EndpointReference(serviceUrl);
101. options.setTo(targetEPR);
102.
103. //指定接口方法的参数值
104. new ModelUser();
105. "Jecket");
106. "123456");
107. new Object[] {modelUser};
108. //指定方法返回值的数据类型的Class对象
109. new Class[] { ModelUser.class };
110. //指定调用的方法及WSDL文件的命名空间 QName("targetNamespace","method Name");
111. new QName("http://fz.demo.stu","WriteModelUser");
112. //调用getVersioin方法并输出该方法的返回值,
113. //返回对象是一个Object的数组,拿数组的第一个值,转换强转即可
114. 0];
115.
116. "name:"+modelUser.getUserName());
117. "password:"+modelUser.getUserPwd());
118. catch (Exception e) {
119. e.printStackTrace();
120. result = e.getMessage();
121.
122.
123. }
124.
125. }
126.
127.
128.
129. }
4.6 axis2的webservice服务添加到自己的项目中发布结合spring+maven
首先建议阅读官方文档http://axis.apache.org/axis2/java/core/docs/spring.html
然后就是实践了
1、maven的pom.xml中关于axis2的配置
1. <dependency>
2. <groupId>org.apache.axis2</groupId>
3. <artifactId>axis2-transport-http</artifactId>
4. <version>1.7.2</version>
5. </dependency>
6. <dependency>
7. <groupId>org.apache.axis2</groupId>
8. <artifactId>axis2-spring</artifactId>
9. <version>1.7.2</version>
10. </dependency>
11. <dependency>
12. <groupId>org.apache.axis2</groupId>
13. <artifactId>axis2</artifactId>
14. <version>1.6.2</version>
15. </dependency>
16. <dependency>
17. <groupId>org.apache.axis2</groupId>
18. <artifactId>axis2-transport-local</artifactId>
19. <version>1.7.2</version>
20. </dependency>
21. <dependency>
22. <groupId>org.apache.axis2</groupId>
23. <artifactId>axis2-kernel</artifactId>
24. <version>1.6.2</version>
25. </dependency>
2、编写axis2的对外提供服务的类以及方法(我这里不写接口了,熟悉spring的应该知道最好使用接口以及接口的实现)
我的项目名称是 mavenssh,包路径为com.bestcxx.mavenstu.mavenssh.axis2,类名为Axis2Webservice,方法只有一个叫getStrA
1. package com.bestcxx.mavenstu.mavenssh.axis2;
2.
3. public class Axis2Webservice {
4.
5. public String getStrA(){
6. "123";
7. "你输入的是:"+str);
8. return str;
9. }
10.
11. }
3、spring的applicationContext.xml中将Axis2Webservice注册为bean
1. <!--如果没有ServletContext配置 则需要增加下面这句 -->
2. <bean id="applicationContext"
3. class="org.apache.axis2.extensions.spring.receivers.ApplicationContextHolder" /> -->
4.
5. <bean id="springAwareService" class="com.bestcxx.mavenstu.mavenssh.axis2.Axis2Webservice" scope="prototype"/>
4、web.xml编写
1. <listener>
2. <description>Spring ApplicationContext 载入</description>
3. <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
4. </listener>
5. <!-- Spring ApplicationContext配置文件的路径,可使用通配符,多个路径用,号分隔 此参数用于后面的Spring Context
6. >
7. <context-param>
8. <param-name>contextConfigLocation</param-name>
9. <param-value>classpath:spring/applicationContext.xml</param-value>
10. </context-param>
11.
12. <!-- axis2设置 -->
13. <servlet>
14. <servlet-name>AxisServlet</servlet-name>
15. <servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
16. </servlet>
17.
18. <servlet-mapping>
19. <servlet-name>AxisServlet</servlet-name>
20. <url-pattern>/services/*</url-pattern>
21. </servlet-mapping>
5、最后是services.xml的编写,这里需要注意路径
比如这里我的项目名称为mavenssh
就需要把services.xml放置到项目的如下路径中
-webapp
-WEB-INF
services.xml的内容为
1. <service name="SpringAwareService"><!-- 访问的时候,这个是wsdl服务的名字 -->
2. <description>
3. simple spring example
4. </description>
5. <parameter name="ServiceObjectSupplier">org.apache.axis2.extensions.spring.receivers.SpringServletContextObjectSupplier</parameter>
6. <parameter name="SpringBeanName">springAwareService</parameter><!-- 这个是spring中配置的bean名字 -->
7. <parameter name="getStrA"><!-- 这个是对外提供的服务的具体方法名 -->
8. <span style="white-space:pre"> </span> <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
9. </parameter>
10. </service>
6、这样之后,服务就已经可以正常启动和访问了
http://localhost:8085/mavenssh/services/SpringAwareService?wsdl
7、但是控制台提示
Please update your axis2.xml file!
只需把我们上面实验的axis2.war中的WEB_INF/conf/下的axis2.xml复制到mavenssh(你的项目)下的WEB_INF目录下即可
里面有个用户名和密码,建议注释掉。