Spring整合JAX-WS

Mr.Johness發表於2014-07-04

  Jax-ws在使用上很方便,也很輕量級。重點是他是jvnet(dev.java.net)的專案,是基於java標準的(JSR181)。

  不過它與Spring的整合相對麻煩,於此,我將自己的一些研究結果貼出來以供備忘和後來者參考。

  首先我們要有元件支援,包括三部分(我們需要他們的jar包):

    Spring

    jax-ws

    jaxws commons spring

  Spring就不用說了,如果大家使用MyEclipse的話就直接新增支援。

  jax-ws的jar包可以再網站上下載,或者搜尋下載“jax-ws 2.2”。

  jaxws commons spring的jar包是中介軟體,這個可能不好下載,如果不適用maven的話可能就只能在網路上搜尋下載“jaxws-spring-1.8”(包含不只一個jar包哦)。

  

  然後我們匯入jar包並建立web專案。

    

  然後編寫一個測試WebService類:

 1 package org.coderecord.blog;
 2 
 3 import javax.jws.WebMethod;
 4 import javax.jws.WebService;
 5 import javax.jws.soap.SOAPBinding;
 6 import javax.jws.soap.SOAPBinding.Style;
 7 import org.springframework.stereotype.Service;
 8 
 9 /**
10  * 測試服務類<br>
11  * Service註解為在使用Spring的packeage-scan功能進行自動裝配<br>
12  * WebService註解中可以不傳遞引數<br>
13  * SOAPBinding中也可不傳遞引數,或者按照自己的需求進行更改
14  */
15 @Service("helloWorldService")
16 @WebService(targetNamespace = "org.coderecord.blog")
17 @SOAPBinding(style = Style.RPC)
18 public class HelloWorldService {
19 
20     /* 使用Spring來注入dao或service吧
21     @Autowired
22     private XXDao xxDao;*/
23     
24     /**
25      * 介面方法必須加上WebMethod註解
26      */
27     @WebMethod
28     public void sayHello() {
29         System.out.println("Hello World!");
30     }
31 }
HelloWorldService

  然後修改applicationContext.xml,加上webservice的繫結,這裡面有幾個問題,對於wss和ws的schema必須加上:

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <beans xmlns="http://www.springframework.org/schema/beans"
 3     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ws="http://jax-ws.dev.java.net/spring/core"
 4     xmlns:wss="http://jax-ws.dev.java.net/spring/servlet" xmlns:p="http://www.springframework.org/schema/p"
 5     xmlns:context="http://www.springframework.org/schema/context"
 6     xsi:schemaLocation="http://www.springframework.org/schema/beans
 7     http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
 8     http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.2.xsd
 9     http://jax-ws.dev.java.net/spring/core
10     http://jax-ws.dev.java.net/spring/core.xsd
11     http://jax-ws.dev.java.net/spring/servlet
12     http://jax-ws.dev.java.net/spring/servlet.xsd">
13     
14     <context:component-scan base-package="org.coderecord.blog">
15     </context:component-scan>
16 
17     <wss:binding url="/service/hello">
18         <wss:service>
19             <ws:service bean="#helloWorldService" />
20         </wss:service>
21     </wss:binding>
22 </beans>
applicationContext

  最後修改web.xml,修改幾個地方:

    加上Spring的listener,並配置正確;

    加上WSSpringServlet的攔截。

 1 <?xml version="1.0" encoding="ISO-8859-1"?>
 2 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:web="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
 3   <listener>
 4     <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
 5   </listener>
 6   <context-param>
 7     <param-name>contextConfigLocation</param-name>
 8     <param-value>classpath:applicationContext.xml</param-value>
 9   </context-param>
10   <!-- Start WebService Config -->
11     <servlet>
12         <servlet-name>JAXWSServlet</servlet-name>
13         <servlet-class>com.sun.xml.ws.transport.http.servlet.WSSpringServlet</servlet-class>
14         <load-on-startup>2</load-on-startup>
15     </servlet>
16     <servlet-mapping>
17         <servlet-name>JAXWSServlet</servlet-name>
18         <url-pattern>/service/hello</url-pattern>
19     </servlet-mapping>
20     <!-- End WebService Config -->
21 </web-app>
web

  最後就啟動,搞定。

  訪問localhost:8080/ExJaxwsSpring/service/hello?wsdl就是介面;訪問localhost:8080/ExJaxwsSpring就是你的網站。

   

 

於2016-02-22:

有朋友說用新版Spring(Spring4.x)時產生“Caused by: java.lang.IllegalArgumentException: class com.sun.proxy.$Proxy5 has neither @WebSerivce nor @WebServiceProvider annotation”類似錯誤,這是由於“代理”類生成的子類(為了方便AOP)沒有了@WebService註解。如果你不清楚Proxy和AOP,我舉個例子,你繼承一個有註解的類,子類會繼承父類的註解嗎?

那麼解決辦法是在ws:service節點中加入一個impl屬性約定繼承的介面。例如

<wss:binding url="/service/hello">
    <wss:service>
        <ws:service bean="#helloWorldService" impl="org.coderecord.blog.HelloWorldService" />
    </wss:service>
</wss:binding>

 

歡迎您移步我們的交流群,無聊的時候大家一起打發時間:Programmer Union

 或者通過QQ與我聯絡:點選這裡給我發訊息

 (最後編輯時間2016-02-22 10:07:57)

 

相關文章