WebService框架整理（二） Axis1+Spring

初识Axis1就要把它集成到Spring框架上。一方面是当时的项目要求，在一方面更是我对于Spring情有独钟。 
Axis1+Spring比较简单，这种便利得益于Spring的ServletEndpointSupport类支持。 

相关链接： 
WebService框架整理（一） Axis1  
WebService框架整理（二） Axis1+Spring  

我们将用到以下Jar： 

引用

activation.jar 
axis.jar 
commons-discovery.jar 
commons-logging.jar 
jaxrpc.jar 
log4j-1.2.15.jar 
mail.jar 
wsdl4j.jar 
spring.jar 

主要就是加入了spring.jar包！ 

再看看web.xml，加入了Spring的相关内容。大家都熟悉Spring，我就不废话了！ 

Xml代码  

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <web-app  
3.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
4.     xmlns="http://java.sun.com/xml/ns/javaee"  
5.     xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"  
6.     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"  
7.     id="WebApp_ID"  
8.     version="2.5">  
9.     <display-name>spring-axis-1</display-name>  
10.     <context-param>  
11.         <param-name>log4jConfigLocation</param-name>  
12.         <param-value>classpath:log4j.xml</param-value>  
13.     </context-param>  
14.     <context-param>  
15.         <param-name>log4jRefreshInterval</param-name>  
16.         <param-value>60000</param-value>  
17.     </context-param>  
18.     <context-param>  
19.         <param-name>contextConfigLocation</param-name>  
20.         <param-value>/WEB-INF/applicationContext.xml</param-value>  
21.     </context-param>  
22.     <filter>  
23.         <filter-name>UTF-8 Filter</filter-name>  
24.         <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>  
25.         <init-param>  
26.             <param-name>encoding</param-name>  
27.             <param-value>UTF-8</param-value>  
28.         </init-param>  
29.         <init-param>  
30.             <param-name>forceEncoding</param-name>  
31.             <param-value>true</param-value>  
32.         </init-param>  
33.     </filter>  
34.     <filter-mapping>  
35.         <filter-name>UTF-8 Filter</filter-name>  
36.         <url-pattern>/*</url-pattern>  
37.     </filter-mapping>  
38.     <listener>  
39.         <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>  
40.     </listener>  
41.     <listener>  
42.         <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>  
43.     </listener>  
44.     <servlet>  
45.         <display-name>Apache-Axis Servlet</display-name>  
46.         <servlet-name>axis</servlet-name>  
47.         <servlet-class>org.apache.axis.transport.http.AxisServlet</servlet-class>  
48.         <load-on-startup>0</load-on-startup>  
49.     </servlet>  
50.     <servlet-mapping>  
51.         <servlet-name>axis</servlet-name>  
52.         <url-pattern>/services/*</url-pattern>  
53.     </servlet-mapping>  
54. </web-app>  

我们定义一个用于计算的CalcService接口及其实现CalcServiceImpl，如下： 

Java代码  

1. /** 
2.  * 简单计算 
3.  *  
4.  * @author 梁栋 
5.  * @version 1.0 
6.  * @since 1.0 
7.  */  
8. public interface CalcService {  
9.   
10.     /** 
11.      * 求和 
12.      *  
13.      * @param a 
14.      * @param b 
15.      * @return 
16.      */  
17.     int add(int a, int b);  
18.   
19. }  

给出对应的实现内容： 

Java代码  

1. import org.zlex.axis.service.CalcService;  
2.   
3. /** 
4.  * 计算 
5.  *  
6.  * @author 梁栋 
7.  * @version 1.0 
8.  * @since 1.0 
9.  */  
10. public class CalcServiceImpl implements CalcService {  
11.   
12.     @Override  
13.     public int add(int a, int b) {  
14.         return a + b;  
15.     }  
16.   
17. }  

再简单不过的1+1问题！  
将其注入到Spring的容器中，applicationContext.xml如下所示： 

Xml代码  

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <beans  
3.     xmlns="http://www.springframework.org/schema/beans"  
4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
5.     xmlns:context="http://www.springframework.org/schema/context"  
6.     xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd  
7.         http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">  
8.     <bean  
9.         id="calcService"  
10.         class="org.zlex.axis.service.impl.CalcServiceImpl" />  
11. </beans>  

作为spring与axis1对接，需要做一个ServletEndpointSupport继承实现WebService，如下所示： 

Java代码  

1. import javax.xml.rpc.ServiceException;  
2.   
3. import org.springframework.context.ApplicationContext;  
4. import org.springframework.remoting.jaxrpc.ServletEndpointSupport;  
5. import org.zlex.axis.service.CalcService;  
6.   
7. /** 
8.  * WebService入口 
9.  *  
10.  * @author 梁栋 
11.  * @version 1.0 
12.  * @since 1.0 
13.  */  
14. public class WebService extends ServletEndpointSupport {  
15.   
16.     private ApplicationContext applicationContext;  
17.     private CalcService calcService;  
18.   
19.     /* 
20.      * (non-Javadoc) 
21.      *  
22.      * @see org.springframework.remoting.jaxrpc.ServletEndpointSupport#onInit() 
23.      */  
24.     @Override  
25.     protected void onInit() throws ServiceException {  
26.         // 初始化Spirng 配置  
27.         applicationContext = super.getApplicationContext();  
28.   
29.         calcService = (CalcService) applicationContext.getBean("calcService");  
30.   
31.     }  
32.   
33.     /** 
34.      * 求和 
35.      *  
36.      * @param a 
37.      * @param b 
38.      * @return 
39.      */  
40.     public String add(int a, int b) {  
41.         return String.valueOf(calcService.add(a, b));  
42.     }  
43.   
44. }  

这里为了便于在eclipse演示，将返回值定为String类型！ 
现在我们将该服务植入Axis中，修改server-config.wsdd文件，在原文件中加入如下内容： 

Xml代码  

1. <!-- 自定义服务 -->  
2. <service  
3.     name="WebService"  
4.     provider="java:RPC">  
5.     <parameter  
6.         name="className"  
7.         value="org.zlex.axis.WebService" />  
8. </service>  

修改后的server-config.wsdd文件如下所示： 

Xml代码  

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <deployment  
3.     xmlns="http://xml.apache.org/axis/wsdd/"  
4.     xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">  
5.     <globalConfiguration>  
6.         <parameter  
7.             name="adminPassword"  
8.             value="admin" />  
9.         <parameter  
10.             name="sendXsiTypes"  
11.             value="true" />  
12.         <parameter  
13.             name="sendMultiRefs"  
14.             value="true" />  
15.         <parameter  
16.             name="sendXMLDeclaration"  
17.             value="true" />  
18.         <parameter  
19.             name="axis.sendMinimizedElements"  
20.             value="true" />  
21.         <requestFlow>  
22.             <handler  
23.                 type="java:org.apache.axis.handlers.JWSHandler">  
24.                 <parameter  
25.                     name="scope"  
26.                     value="session" />  
27.             </handler>  
28.             <handler  
29.                 type="java:org.apache.axis.handlers.JWSHandler">  
30.                 <parameter  
31.                     name="scope"  
32.                     value="request" />  
33.                 <parameter  
34.                     name="extension"  
35.                     value=".jwr" />  
36.             </handler>  
37.         </requestFlow>  
38.     </globalConfiguration>  
39.     <handler  
40.         name="Authenticate"  
41.         type="java:org.apache.axis.handlers.SimpleAuthenticationHandler" />  
42.     <handler  
43.         name="LocalResponder"  
44.         type="java:org.apache.axis.transport.local.LocalResponder" />  
45.     <handler  
46.         name="URLMapper"  
47.         type="java:org.apache.axis.handlers.http.URLMapper" />  
48.     <service  
49.         name="AdminService"  
50.         provider="java:MSG">  
51.         <parameter  
52.             name="allowedMethods"  
53.             value="AdminService" />  
54.         <parameter  
55.             name="enableRemoteAdmin"  
56.             value="false" />  
57.         <parameter  
58.             name="className"  
59.             value="org.apache.axis.utils.Admin" />  
60.         <namespace>http://xml.apache.org/axis/wsdd/</namespace>  
61.     </service>  
62.     <service  
63.         name="Version"  
64.         provider="java:RPC">  
65.         <parameter  
66.             name="allowedMethods"  
67.             value="getVersion" />  
68.         <parameter  
69.             name="className"  
70.             value="org.apache.axis.Version" />  
71.     </service>  
72.     <transport  
73.         name="http">  
74.         <requestFlow>  
75.             <handler  
76.                 type="URLMapper" />  
77.             <handler  
78.                 type="java:org.apache.axis.handlers.http.HTTPAuthHandler" />  
79.         </requestFlow>  
80.     </transport>  
81.     <transport  
82.         name="local">  
83.         <responseFlow>  
84.             <handler  
85.                 type="LocalResponder" />  
86.         </responseFlow>  
87.     </transport>  
88.   
89.     <!-- 自定义服务 -->  
90.     <service  
91.         name="WebService"  
92.         provider="java:RPC">  
93.         <parameter  
94.             name="className"  
95.             value="org.zlex.axis.WebService" />  
96.     </service>  
97. </deployment>  

我们随机抽取2个数进行求和运算，并验证WebService和本地计算结果是否一致，测试用例WebServiceTest如下： 

Java代码  

1. /** 
2.  * WebService测试 
3.  *  
4.  * @author 梁栋 
5.  * @version 1.0 
6.  * @since 1.0 
7.  */  
8. public class WebServiceTest {  
9.     private String nameSpaceUri = "http://localhost:8080/axis/services/WebService";  
10.     private String wsdlUrl = nameSpaceUri + "?wsdl";  
11.   
12.     private Service service;  
13.     private Call call;  
14.   
15.     @Before  
16.     public final void init() throws Exception {  
17.         // 创建调用对象  
18.         service = new Service();  
19.         call = (Call) service.createCall();  
20.   
21.         // 调用 远程方法  
22.         call.setOperationName(new QName(nameSpaceUri, "add"));  
23.   
24.         // 设置URL  
25.         call.setTargetEndpointAddress(new URL(wsdlUrl));  
26.     }  
27.   
28.     @Test  
29.     public final void testAdd() throws Exception {  
30.           
31.         // 设置参数  
32.         Random rnd = new Random();  
33.   
34.         int a = rnd.nextInt(100);  
35.   
36.         int b = rnd.nextInt(100);  
37.   
38.         // 执行远程调用，同时获得返回值  
39.         String r = (String) call.invoke(new Object[] { a, b });  
40.   
41.         assertEquals(String.valueOf(a + b), r);  
42.         System.out.println("a(" + a + ") + b(" + b + ") = " + r);  
43.   
44.     }  
45. }  

我们验证一下结果！ 
 
 顺利通过！ 
我们在通过Eclipse验证一下这个服务！ 


Eclipse中输入参数验证WebService，如果要看到返回值就需要把返回值定为String类型。如果用int类型，我们只能通过测试用例检测这个结果！  

完整项目实例见附件！