Jax-ws在使用上很方便,也很輕量級。重點是他是jvnet(dev.java.net)的專案,是基於java標準的(JSR181)。
不過它與Spring的整合相對麻煩,於此,我將自己的一些研究結果貼出來以供備忘和後來者參考。
首先我們要有元件支援,包括三部分(我們需要他們的jar包):
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 }
然後修改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>
最後修改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>
最後就啟動,搞定。
訪問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>
(最後編輯時間2016-02-22 10:07:57)