1. 程式人生 > >WebService+CXF+Spring練習之手機號碼歸屬地查詢

WebService+CXF+Spring練習之手機號碼歸屬地查詢

基礎知識簡述:

WebService:
  1. WebService是使用http傳輸SOAP協議資料的一種遠端呼叫技術,跨防火牆(防火牆預設對http協議不攔截),跨平臺(使用XML封裝資料),支援面向物件。
  2. WSDL: web服務描述語言,是WebService服務端的使用說明書,說明服務、介面、方法、引數和返回值,是伴隨服務釋出成功自動生成,無需編寫。
    1. 地址:  服務地址+?wsdl 
    2. 閱讀方式:  從下往上,service>binding>portType>方法、引數和返回值
  3. SOAP: SOAP即簡單物件訪問協議,是使用http傳輸XML格式的資料,跨平臺,跨防火牆
  4. 客戶端需使用wsimport命令生成客戶端程式碼 ,只支援SOAP1.1
    • -p: 指定包名  -d: 指定輸出路徑
CXF框架:
  1. CXF是一個開源的WebService框架,提供很多完善功能,可以實現快速開發
  2. CXF支援的協議:SOAP1.1/1.2,REST
  3. CXF支援的資料格式:XML,JSON(僅在REST方式下支援)
  4. REST可以精確定位網上資源,無需生成客戶端。
  5. 用wsdl2java命令(類似wsimport命令)可以根據WSDL生成客戶端程式碼 ,wsdl2java支援SOAP1.1和SOAP1.2
    • -p: 指定包名  -d: 指定輸出路徑
  6. WSDL檢視地址:http://ip地址:埠號/專案名稱/Servlet攔截路徑?wsdl

專案需求:

  • 整合公網手機號歸屬地查詢服務
  • 對外釋出自己的手機號歸屬地查詢服務
  • 提供查詢介面

開發步驟:

第一步:建立web專案(引入jar包)

第二步生成公網客戶端程式碼

 在專案src下shift+右鍵開啟命令列介面,輸入wsdl2java命令:

wsdl2java -p cn.striner.mobile.server.client -d . http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl

 ps:若jdk版本為1.8.0或更高,需要在/path/to/jdk1.8.0/jre/lib下建立名為jaxp.properties的檔案,內容:
javax.xml.accessExternalSchema = all
命令列視窗無報錯則公網客戶端程式碼生成成功



第三步建立SEI介面

package cn.striner.mobile.server;

import javax.jws.WebService;

/**
 * 手機號歸屬地查詢  _SEI介面
 * @author striner
 *
 */
@WebService
public interface MobileInterface {
	
	public String queryMobile(String phoneNum);
}


第四步:建立SEI實現類

package cn.striner.mobile.server;

import cn.striner.mobile.server.client.MobileCodeWSSoap;

/**
 * 手機號歸屬地查詢  _SEI實現類
 * @author striner
 *
 */
public class MobileInterfaceImpl implements MobileInterface {

	private MobileCodeWSSoap mobileClient;
	
	@Override
	public String queryMobile(String phoneNum) {
		return mobileClient.getMobileCodeInfo(phoneNum, "");
	}

	public MobileCodeWSSoap getMobileClient() {
		return mobileClient;
	}

	public void setMobileClient(MobileCodeWSSoap mobileClient) {
		this.mobileClient = mobileClient;
	}
}

第五步:建立queryMobile.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>手機號歸屬地查詢_striner</title>
</head>
<body>
	<form action="queryMobile.action" method="post">
		手機號歸屬地查詢:<input type="text" name="phoneNum"/>
		<input type="submit" value="查詢"/><br/>
		查詢結果:${result}
	</form>
</body>
</html>

第六步建立MobileServlet.java

package cn.striner.mobile.server.servlet;

import java.io.IOException;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.context.ApplicationContext;
import org.springframework.web.context.support.WebApplicationContextUtils;

import cn.striner.mobile.server.MobileInterface;
/**
 * 手機號歸屬地查詢服務端
 * @author striner
 *
 */
public class MobileServlet extends HttpServlet {
	
	private MobileInterface mobileServer;
	
	public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
		String phoneNum = request.getParameter("phoneNum");   //根據頁面request的name值獲取資料
		if (!"".equals(phoneNum) && phoneNum != null) {
			//獲取上下文 從而獲取例項物件
			ApplicationContext context = WebApplicationContextUtils.getWebApplicationContext(this.getServletContext());
			mobileServer = (MobileInterface) context.getBean("mobileServer");
			
			String result = mobileServer.queryMobile(phoneNum);
			request.setAttribute("result", result);   //將result存至request域中
		}
		request.getRequestDispatcher("/WEB-INF/jsp/queryMobile.jsp").forward(request, response);  //跳轉至前端顯示頁面
	}
	public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
		this.doGet(request, response);
	}
}

第七步配置spring配置檔案applicationContext.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:jaxws="http://cxf.apache.org/jaxws"
	xmlns:jaxrs="http://cxf.apache.org/jaxrs" xmlns:cxf="http://cxf.apache.org/core"
	xsi:schemaLocation="http://www.springframework.org/schema/beans 
				            http://www.springframework.org/schema/beans/spring-beans.xsd
				            http://cxf.apache.org/jaxrs http://cxf.apache.org/schemas/jaxrs.xsd
				            http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd
				            http://cxf.apache.org/core http://cxf.apache.org/schemas/core.xsd">
				            
	<!-- <jaxws:server釋出SOAP協議的服務 ,對JaxWsServerFactoryBean類封裝 -->			            
	<jaxws:server address="/mobile" serviceClass="cn.striner.mobile.server.MobileInterface">
		<jaxws:serviceBean>
			<ref bean="mobileServer"/>
		</jaxws:serviceBean>
	</jaxws:server>			            
	<!-- 配置服務實現類 -->	
	<bean name="mobileServer" class="cn.striner.mobile.server.MobileInterfaceImpl">
		<property name="mobileClient" ref="mobileClient"></property>
	</bean>		            
	<!-- 配置公網客戶端 -->
	<jaxws:client id="mobileClient" address="http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx" 
					serviceClass="cn.striner.mobile.server.client.MobileCodeWSSoap"></jaxws:client>			            
				            
</beans>

第八步配置web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
	xmlns="http://xmlns.jcp.org/xml/ns/javaee" 
	xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee 
							http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" 
	id="WebApp_ID" version="3.1">
	
  <display-name>cxf_AdderssOfMobile</display-name>
  
  <!-- 設定spring的環境 -->
  <context-param>
  	<!-- contextConfigLoation是不能修改的 -->
  	<param-name>contextConfigLocation</param-name>
  	<param-value>classpath:applicationContext.xml</param-value>
  </context-param>
  <listener>
  	<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  </listener>
  
  <!-- 配置CXF的Servlet -->
  <servlet>
  	<servlet-name>CXF</servlet-name>
  	<servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
  </servlet>
  <servlet-mapping>
  	<servlet-name>CXF</servlet-name>
  	<url-pattern>/ws/*</url-pattern>
  </servlet-mapping>
  
  <!-- 配置mobileServlet -->
  <servlet>
  	<servlet-name>mobileServlet</servlet-name>
  	<servlet-class>cn.striner.mobile.server.servlet.MobileServlet</servlet-class>
  </servlet>
  <servlet-mapping>
  	<servlet-name>mobileServlet</servlet-name>
  	<url-pattern>*.action</url-pattern>
  </servlet-mapping>
  
  <welcome-file-list>
    <welcome-file>index.html</welcome-file>
    <welcome-file>index.htm</welcome-file>
    <welcome-file>index.jsp</welcome-file>
    <welcome-file>default.html</welcome-file>
    <welcome-file>default.htm</welcome-file>
    <welcome-file>default.jsp</welcome-file>
  </welcome-file-list>
</web-app>

第九步部署tomcat下,啟動tomcat

第十步:測試

  • 測試服務是否釋出成功



  • 測試查詢介面






這裡前端頁面做的比較簡陋,也未實現手機號碼的回顯功能.關於號碼的回顯可以使用ajax對號碼非同步查詢,也可以藉助標籤帶有回顯功能的框架實現,這裡我就拋磚引玉不多做優化了.專案程式碼已傳至github託管平臺,若需查閱請移步:手機號歸屬地查詢