1

什麼是WebService?webService小示例 點此瞭解

下面進入正題:

Java web專案(spring專案)中整合webservice ,實現對外開放介面步驟:

準備:

採用與spring相容性較好的cxf來實現

選擇zip格式下載,解壓後的lib目錄下的jar

需要最少的jar如下:

cxf-2.3.3.jar
geronimo-annotation_1.0_spec-1.1.1.jar
geronimo-jaxws_2.2_spec-1.0.jar
geronimo-stax-api_1.0_spec-1.0.1.jar
geronimo-ws-metadata_2.0_spec-1.1.3.jar
jaxb-api-2.2.1.jar
jaxb-impl-2.2.1.1.jar
neethi-2.0.4.jar
wsdl4j-1.6.2.jar
XmlSchema-1.4.7.jar
wstx-asl-3.2.9.jar

一：建立webservice伺服器

1）建立一個服務介面

1. package com.service;  
2. import javax.jws.WebParam;  
3. import javax.jws.WebService;  
4. @WebService  
5. public interface IHelloWorld {  
6.     public String sayHello(@WebParam(name = "arg0") String text);  
7. }  

2）是介面實現類

1. package com.service.impl;  
2. import javax.jws.WebService;  
3. import com.service.IHelloWorld;  
4. @WebService(endpointInterface = "com.service.IHelloWorld")  
5. public class HelloWorldImpl implements IHelloWorld {  
6.     public String sayHello(String text) {  
7.         return "Hello : " + text;  
8.     }  
9. }  

3）建立spring配置檔案，將服務類加入到容器中

webservice.xml

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"   
4.     xmlns:p="http://www.springframework.org/schema/p"  
5.     xmlns:jaxws="http://cxf.apache.org/jaxws"  
6.     xmlns:cxf="http://cxf.apache.org/core"  
7.     xsi:schemaLocation="http://www.springframework.org/schema/beans  
8.     http://www.springframework.org/schema/beans/spring-beans-2.5.xsd  
9.     http://cxf.apache.org/jaxws  
10.     http://cxf.apache.org/schemas/jaxws.xsd">  
11.     <import resource="classpath*:META-INF/cxf/cxf.xml" />  
12.     <import resource="classpath*:META-INF/cxf/cxf-extension-soap.xml" />  
13.     <import resource="classpath*:META-INF/cxf/cxf-servlet.xml" />  
14.     <!--下面的class屬性值一定要跟你專案中服務實現類的包路徑完全一致-->  
15.     <bean id="hello" class="com.service.impl.HelloWorldImpl"/>  
16.     <jaxws:endpoint id="helloWorld" implementor="#hello" address="/HelloWorld" />  
17. </beans>  

在web.xml中新增webservice.xml配置檔案

1. <context-param>  
2.     <param-name>contextConfigLocation</param-name>  
3.     <param-value>  
4.         /WEB-INF/webservice.xml       
5.     </param-value>  
6. </context-param>  

4）在web.xml中加入cxf servlet

1. <servlet>  
2.     <display-name>CXF Servlet</display-name>  
3.     <servlet-name>CXFServlet</servlet-name>  
4.     <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>  
5.     <load-on-startup>1</load-on-startup>  
6. </servlet>  
7. <servlet-mapping>  
8.     <servlet-name>CXFServlet</servlet-name>  
9.     <url-pattern>/webservice/*</url-pattern>  
10. </servlet-mapping>  

至此，webservice伺服器就建立好了，

在瀏覽器中訪問：http://localhost:8080/test/webservice/HelloWorld?wsdl，(test是專案名稱)。如果出現了類似與

<wsdl:definitions xmlns:ns1="http://service.com/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://impl.service.com/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="HelloWorldImplService" targetNamespace="http://impl.service.com/">
。。。。

就配置成功了。

接下來貼幾個執行時的錯誤解決方法

1：webservice.xml中提示cxf.xml，cxf-servlet.xml not found，我在上面寫的路徑是classpath*:META-INF/cxf/cxf.xml，這裡的classpath後面還跟了一個“*”符號，沒加符號表示只在類路徑下查詢cxf.xml檔案，加了號表示不僅在類路徑下查詢xml檔案，還在jar包中查詢xml檔案。所以當我們在專案類路徑下沒有假如cxf.xml等配置檔案時，就一定要在classpath後加*，這樣spring容器才會去所加入的jar包中找。

2：假如cxf servlet時，對映路徑不要寫成/*，否則會出現訪問不了專案主頁的情況，可以寫成/webservice/*或者別的專案中沒有使用過的路徑來作為cxf servlet的請求路徑。

二：建立webservice客戶端

客戶端可以和伺服器放在同一個專案中用來測試，也可以新建一個Java專案來進行測試。

新建一個Java專案測試時，要假如對應的jar包，跟伺服器一樣，使用spring還要假如spring jar包。

我在這裡新建一個專案，依舊使用spring來測試

1）首先要建立一個和伺服器端一樣的服務介面，（如果客戶端和伺服器端在同一個專案中則可以省略這步）

1. package com.service;  
2. import javax.jws.WebParam;  
3. import javax.jws.WebService;  
4. @WebService  
5. public interface IHelloWorld {  
6.     public String sayHello(@WebParam(name = "arg0") String text);  
7. }  

2）建立spring-client.xml，

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:p="http://www.springframework.org/schema/p"  
4.     xmlns:jaxws="http://cxf.apache.org/jaxws" xmlns:cxf="http://cxf.apache.org/core"  
5.     xsi:schemaLocation="http://www.springframework.org/schema/beans   
6.     http://www.springframework.org/schema/beans/spring-beans-2.5.xsd  
7.     http://cxf.apache.org/jaxws   
8.     http://cxf.apache.org/schema/jaxws.xsd">  
9.     <bean id="client" class="com.service.IHelloWorld" factory-bean="clientFactory" factory-method="create" />  
10.     <bean id="clientFactory" class="org.apache.cxf.jaxws.JaxWsProxyFactoryBean">  
11.         <property name="serviceClass" value="com.service.IHelloWorld" />  
12.         <property name="address" value="http://localhost:8080/test/HelloWorld" />  
13.     </bean>  
14. </beans>  

3）測試類

1. package com.test;  
2. import org.springframework.context.ApplicationContext;  
3. import org.springframework.context.support.ClassPathXmlApplicationContext;  
4. import com.service.IHelloWorld;  
5. public class Test {  
6.     public static void main(String[] args) {  
7.         ApplicationContext ctx = new ClassPathXmlApplicationContext("spring-client.xml");  
8.         IHelloWorld client = (IHelloWorld) ctx.getBean("client");  
9.         String result = client.sayHello("你好!");  
10.         System.out.println(result);  
11.     }  
12. }  

執行成功後顯示

Hello：你好！