CXF WebService整合SpringMVC的maven項目

首先推薦博客：http://www.cnblogs.com/xdp-gacl/p/4259481.html

　　　　　　   http://blog.csdn.net/hu_shengyang/article/details/38384597

CXF是webService技術的一種實現工具，為什么用CXF來實現webService：

1.      Java的webService實現本身就是一個很耗性能的實現方案（xml與java對象之間在服務端以及客戶端的互轉比較消耗性能）；

2.      目前java主流的webService應用以CXF、AXIS2為主；

3.      通過網絡渠道的了解,目前CXF的效率要比AXIS2高出至少50%；

4.      另外有一個webService的工具metro的效率比CXF高出10%；

5.      CXF的實現資料網上可以隨便找出一大堆，metro的資料相對少一些；

6.      CXF在java應用實現中已經很成熟，企業更傾向於用這樣一個成熟的解決方案；

基於以上原因，我選擇CXF來實現webService。

CXF WebService整合SpringMVC：

1、web.xml 作如下修改：

<servlet>  
        <servlet-name>CXFServlet</servlet-name>  
        <servlet-class>  
               org.apache.cxf.transport.servlet.CXFServlet  
        </servlet-class>  
        <load-on-startup>1</load-on-startup>  
</servlet>  
  
<servlet-mapping>  
         <servlet-name>CXFServlet</servlet-name>  
         <url-pattern>/webservice/*</url-pattern>  
</servlet-mapping>

2、引用CXF

下載cxf工具包。解壓CXF之后，把cxf工具包lib下的jar包全部放到工程的lib下。此處用到的cxf工具包版本為：apache-cxf-2.7.13，或者maven引用：

<!-- 在properties中注明CFX的版本 -->
<properties>
        <!-- spring版本號 -->
	<spring.version>4.0.2.RELEASE</spring.version>
	<!-- mybatis版本號 -->
	<mybatis.version>3.2.6</mybatis.version>
	<!-- log4j日志文件管理包版本 -->
	<slf4j.version>1.7.7</slf4j.version>
	<log4j.version>1.2.17</log4j.version>
	<!-- webService -->
	<cxf.version>2.7.13</cxf.version>
</properties>
<!-- webService:CXF Dependencies -->
<dependency>  
         <groupId>org.apache.cxf</groupId>  
         <artifactId>cxf-rt-frontend-jaxws</artifactId>  
         <version>${cxf.version}</version>  
</dependency>  
<dependency>  
         <groupId>org.apache.cxf</groupId>  
         <artifactId>cxf-rt-transports-http</artifactId>  
         <version>${cxf.version}</version>  
</dependency>  
<dependency>  
         <groupId>org.apache.cxf</groupId>  
         <artifactId>cxf-rt-transports-http-jetty</artifactId>  
         <version>${cxf.version}</version>  
</dependency>  
<dependency>  
         <groupId>org.apache.cxf</groupId>  
         <artifactId>cxf-rt-ws-security</artifactId>  
         <version>${cxf.version}</version>  
</dependency>  
<dependency>  
         <groupId>org.apache.cxf</groupId>  
         <artifactId>cxf-rt-ws-policy</artifactId>  
         <version>${cxf.version}</version>  
</dependency>  
<dependency>  
         <groupId>org.apache.cxf</groupId>  
         <artifactId>cxf-bundle-jaxrs</artifactId>  
         <version>${cxf.version}</version>  
</dependency>  
<dependency>  
         <groupId>javax.ws.rs</groupId>  
         <artifactId>jsr311-api</artifactId>  
         <version>1.1.1</version>  
</dependency>
<dependency>  
        <groupId>commons-httpclient</groupId>  
        <artifactId>commons-httpclient</artifactId>  
        <version>3.0</version>  
</dependency>
<!-- webService:End of CXF Dependencies -->    

3、spring.xml中配置

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:context="http://www.springframework.org/schema/context"
	xmlns:tx="http://www.springframework.org/schema/tx"
	xmlns:aop="http://www.springframework.org/schema/aop"
	xmlns:jaxws="http://cxf.apache.org/jaxws"
	xsi:schemaLocation="http://www.springframework.org/schema/beans 
	http://www.springframework.org/schema/beans/spring-beans.xsd 
	http://www.springframework.org/schema/tx 
	http://www.springframework.org/schema/tx/spring-tx.xsd
	http://www.springframework.org/schema/aop 
	http://www.springframework.org/schema/aop/spring-aop.xsd 
	http://www.springframework.org/schema/context 
	http://www.springframework.org/schema/context/spring-context-3.0.xsd
	http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd" >

   <import resource="classpath:META-INF/cxf/cxf.xml"/>  
   <import resource="classpath:META-INF/cxf/cxf-extension-soap.xml"/>  
   <import resource="classpath:META-INF/cxf/cxf-servlet.xml"/> 
      
   <jaxws:endpoint id="orderWebService" address="/orderWebService"  
          implementor="com.bsit.webservice.impl.OrderWebServiceImpl" />  
    <bean id="client" class="com.bsit.webservice.OrderWebServiceI" factory-bean="clientFactory" factory-method="create"/> <bean id="clientFactory" class="org.apache.cxf.jaxws.JaxWsProxyFactoryBean"> <property name="serviceClass" value="com.bsit.webservice.OrderWebServiceI"/> <property name="address" value="http://192.168.1.20:8080/order/webservice/orderWebService?wsdl"/> </bean>

</beans>

4、接口及實現類

　　定義一個interface，使用@WebService注解標注接口，使用@WebMethod注解標注接口中定義的所有方法；實現類，使用@WebService注解標注實現類，實現接口中定義的所有方法（注意@WebService(endpointInterface="接口的包名.接口名", serviceName="服務名")中的配置），如下所示：

//接口
package com.bsit.webservice;

import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;

import com.bsit.orders.model.Orders;

@WebService
public interface OrderWebServiceI {
	
	//使用@WebMethod注解標注WebServiceI接口中的方法
	@WebMethod
	String sayHello(@WebParam(name="name") String name);
	
	@WebMethod
	Orders getOrdersByNum(String num);

}

//實現類
package com.bsit.webservice.impl;

import javax.jws.WebService;

import org.springframework.beans.factory.annotation.Autowired;

import com.bsit.orders.mapper.OrdersMapper;
import com.bsit.orders.model.Orders;
import com.bsit.webservice.OrderWebServiceI;

@WebService(endpointInterface="com.bsit.webservice.OrderWebServiceI",serviceName="OrderWebService")
public class OrderWebServiceImpl implements OrderWebServiceI{
	
	@Autowired
	private OrdersMapper ordersMapper;

	@Override
	public String sayHello(String name) {
		System.out.println("WebService sayHello " + name);
		return "Hello " + name + ", nice to meet you.";
	}

	@Override
	public Orders getOrdersByNum(String num) {
		Orders orders = ordersMapper.getOrdersBySalesNum(num);　　//數據庫操作，ordersMapper注入

　　　　　　　　　 System.out.println(orders.getSales_order_num()); 

　　　　　　　　　 return orders; 
　　　　 } 
}

5、簡單效果

　　啟動tomcat，webservice隨之啟動，瀏覽器中輸入：http://192.168.1.20:8080/order/webservice，

表示webservice服務已經啟動。左邊是暴漏出來的接口的方法名，點擊右方的WSDL的鏈接，可以查看方法的具體參數信息：也可以直接輸入：http://192.168.1.20:8080/order/webservice/orderWebService?wsdl，打開下圖

6、測試

　　一、

package org.bsit.webService;

import org.junit.Test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

import com.bsit.orders.model.Orders;
import com.bsit.webservice.OrderWebServiceI;

public class OrderWebService1Test {
	
	/* 
	 * 客戶端調用webService的方法，如果spring.xml中配置了紅色部分，則調用時factory.getBean("client")，強制轉換成webService的接口
	*/
	@Test
	public void testOrderWebService(){
		ApplicationContext factory = new ClassPathXmlApplicationContext("/spring.xml"); 
		//轉換OrderWebServiceI
		OrderWebServiceI client = (OrderWebServiceI)factory.getBean("client");
		
		Orders orders = new Orders();
		orders = client.getOrdersByNum("BS20160331-2");
		System.out.println(orders.getId() + ", " + orders.getSales_order_num());
	}
}

　　二、

package org.bsit.webService;

import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;
import org.junit.Before;
import org.junit.Test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

import com.bsit.orders.model.Orders;
import com.bsit.webservice.OrderWebServiceI;

public class OrderWebService2Test {
	
	private OrderWebServiceI orderWebService;
	
	/* 
	 * 客戶端調用webService的方法，如果spring.xml中沒有配置紅色部分，則調用時先寫initParam()的初始化
	<jaxws:endpoint id="orderWebService" address="/orderWebService"
      	implementor="com.bsit.webservice.impl.OrderWebServiceImpl" />  
	*/
	@Before
    　　 public void initParam(){
        　　JaxWsProxyFactoryBean factoryBean = new JaxWsProxyFactoryBean();  
        　　factoryBean.setServiceClass(OrderWebServiceI.class);  
        　　factoryBean.setAddress("http://192.168.1.20:8080/order/webservice/orderWebService?wsdl");  
          
        　　orderWebService = (OrderWebServiceI)factoryBean.create();  
    　　}
	
	@Test
	public void testOrderWebService(){
		Orders orders = new Orders();
		orders = orderWebService.getOrdersByNum("BS20160331-2");
		System.out.println(orders.getId() + ", " + orders.getSales_order_num());
	}
}

7、結果：

　　控制台打印：73ccfffc-e7a3-468e-ba7d-5dc75e67886f, BS20160331-2；

　　說明webService中注入mapper成功，可以進行數據庫查詢，簡單的字符串例子沒做測試。

　　當然，這里既可以java調用webService，也可以其他程序如.net調用。