WebService+CXF+Spring練習之手機號碼歸屬地查詢
阿新 • • 發佈:2019-02-02
基礎知識簡述:
WebService:- WebService是使用http傳輸SOAP協議資料的一種遠端呼叫技術,跨防火牆(防火牆預設對http協議不攔截),跨平臺(使用XML封裝資料),支援面向物件。
- WSDL: web服務描述語言,是WebService服務端的使用說明書,說明服務、介面、方法、引數和返回值,是伴隨服務釋出成功自動生成,無需編寫。
- 地址: 服務地址+?wsdl
- 閱讀方式: 從下往上,service>binding>portType>方法、引數和返回值
- SOAP: SOAP即簡單物件訪問協議,是使用http傳輸XML格式的資料,跨平臺,跨防火牆
- 客戶端需使用wsimport命令生成客戶端程式碼 ,只支援SOAP1.1
- -p: 指定包名 -d: 指定輸出路徑
- CXF是一個開源的WebService框架,提供很多完善功能,可以實現快速開發
- CXF支援的協議:SOAP1.1/1.2,REST
- CXF支援的資料格式:XML,JSON(僅在REST方式下支援)
- REST可以精確定位網上資源,無需生成客戶端。
- 用wsdl2java命令(類似wsimport命令)可以根據WSDL生成客戶端程式碼 ,wsdl2java支援SOAP1.1和SOAP1.2
- -p: 指定包名 -d: 指定輸出路徑
- 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託管平臺,若需查閱請移步:手機號歸屬地查詢