CXF WebService整合SpringMVC的maven项目

jingshen

　　首先推荐博客：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调用。