首先推薦博客: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調用。