這篇文章主要介紹了WebSocket整合SSM(Spring,Struts2,Maven)的實現示例,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨着小編來一起學習學習吧
一、WebSocket與HTTP長輪詢
WebSocket屬於HTML5 規範的一部分,提供的一種在單個 TCP 連接上進行全雙工通訊的協議。允許服務端主動向客戶端推送數據。在 WebSocket API 中,瀏覽器和服務器只需要完成一次握手,兩者之間就直接可以創建持久性的連接,並進行雙向數據傳輸。(Tomcat 8以上版本支持)
HTTP 協議是一種無狀態的、無連接的、單向的應用層協議。它採用了請求/響應模型。通信請求只能由客戶端發起,服務端對請求做出應答處理。這種通信模型有一個弊端:HTTP 協議無法實現服務器主動向客戶端發起消息。
HTTP長輪詢:客戶端向服務器發送(http)Ajax請求,服務器接到請求後hold住連接,直到有新消息才返回響應信息並關閉連接,客戶端處理完響應信息後再向服務器發送新的請求。
WebSocket與HTTP長輪詢的通信機制如下:
二、客戶端如何使用WebSocket
瀏覽器通過 JavaScript 向服務器發出建立 WebSocket 連接的請求,連接建立以後,客戶端和服務器端就可以通過 TCP 連接直接交換數據。
當你獲取 Web Socket 連接後,你可以通過send()方法來向服務器發送數據,並通過onmessage事件來接收服務器返回的數據。
1. 創建 WebSocket 對象API
//第一個參數 url, 指定連接的 URL。第二個參數 protocol 是可選的,指定了可接受的子協議。 API:var webSocket = new WebSocket(url, [protocol] );
2. WebSocket 屬性
以下是 WebSocket 對象的屬性。假定我們使用了以上代碼創建了 Socket 對象:
屬性 | 描述 |
---|---|
Socket.readyState |
只讀屬性 readyState 表示連接狀態,可以是以下值:
|
Socket.bufferedAmount |
只讀屬性 bufferedAmount 已被 send() 放入正在隊列中等待傳輸,但是還沒有發出的 UTF-8 文本字節數。 |
3. WebSocket 事件
以下是 WebSocket 對象的相關事件。假定我們使用了以上代碼創建了 Socket 對象:
事件 | 事件處理程序 | 描述 |
---|---|---|
open | Socket.onopen | 連接建立時觸發 |
message | Socket.onmessage | 客戶端接收服務端數據時觸發 |
error | Socket.onerror | 通信發生錯誤時觸發 |
close | Socket.onclose | 連接關閉時觸發 |
4. WebSocket 方法
以下是 WebSocket 對象的相關方法。假定我們使用了以上代碼創建了 Socket 對象:
方法 | 描述 |
---|---|
Socket.send() |
使用連接發送數據 |
Socket.close() |
關閉連接 |
5. WebSocket 實例
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <html> <head> <script type="text/javascript" src="../js/jquery.min.js"></script> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Testing WebSocket</title> </head> <script type="text/javascript"> var webSocket; $(document).ready(function() { //var IP = window.location.host; var url = "ws://your IP/demo/ws/websocket"; //判斷當前瀏覽器是否支持WebSocket if ('WebSocket' in window) { //建立客戶端websocket webSocket = new WebSocket(url); } else { console.log("您的瀏覽器不支持WebSocket"); } //封裝內部監聽事件 function init(){ //連接發生錯誤的回調方法 webSocket.onerror = function(event) { console.log("webSocket連接發生錯誤."); }; //連接成功建立的回調方法 webSocket.onopen = function(event) { console.log("webSocket連接成功."); //心跳檢測重置 heartCheck.start(); }; //接收到消息的回調方法 webSocket.onmessage = function(event) { //拿到任何消息都說明當前連接是正常的 if(event.data=="&"){ console.log("收到心跳回復"+event.data); }else{ console.log("接收到消息="+event.data); onMessage(event); } heartCheck.start(); }; //連接關閉的回調方法 // 斷線重連 webSocket.onclose = function() { console.log("webSocket連接斷開"); } //監聽窗口關閉事件,當窗口關閉時,主動去關閉websocket連接,防止連接還沒斷開就關閉窗口,server端會拋異常。 window.onbeforeunload = function() { webSocket.close(); console.log("窗口關閉,webSocket斷開連接."); } } function onMessage(event) { setMessageInnerHTML(event.data); } function postToServer() { webSocket.send(document.getElementById("msg").value); console.log("向服務器發送消息="+document.getElementById("msg").value); document.getElementById("msg").value = ""; } //將消息顯示在網頁上 function setMessageInnerHTML(innerHTML) { document.getElementById('message').innerHTML += innerHTML + '<br/>'; } function onClose(){ webSocket.close(); } }); //心跳檢測 var heartCheck = { timeout: 10000, timeoutObj: null, serverTimeoutObj: null, start: function(){ console.log("start heartCheck"); var self = this; this.timeoutObj && clearTimeout(this.timeoutObj); this.serverTimeoutObj && clearTimeout(this.serverTimeoutObj); this.timeoutObj = setTimeout(function(){ //這裏發送一個心跳,後端收到後,返回一個心跳消息, console.log('發送心跳&'); webSocket.send("&"); self.serverTimeoutObj = setTimeout(function() { console.log(webSocket); console.log("服務器心跳回復超時"); webSocket.close(); }, self.timeout); }, this.timeout) } } </script> <body> <textarea id="message" readonly></textarea> <br /> <input id="msg" type="text" /> <button type="submit" id="sendButton" onClick="postToServer()">Send!</button> <button type="submit" id="sendButton" onClick="onClose()">End</button> <script type="text/javascript" src="../js/webSocket.js"></script> </body> </html>
三、服務器端如何使用WebSocket
1. pom.xml文件引入對應的依賴包:
<!-- webSocket 開始--> <dependency> <groupId>javax.websocket</groupId> <artifactId>javax.websocket-api</artifactId> <version>1.1</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax</groupId> <artifactId>javaee-api</artifactId> <version>7.0</version> <scope>provided</scope> </dependency> <!-- webSocket 結束-->
2. spring配置文件配置websocket服務類
<!-- websocket --> <bean id="webSocketService" class="minyuantec.tvwall.service.impl.WebSocketServiceImpl" scope="singleton"> </bean>
3. struts2配置文件過濾websocket請求
<!-- 過濾掉ws請求 --> <constant name="struts.action.excludePattern" value="/ws/.*,ws://.*"></constant>
4. 定義Websocket.java類
@ServerEndpoint("/ws/websocket") public class WebSocket { private static Logger logger = Logger.getLogger(WebSocket.class); @SuppressWarnings("static-access") private MessageHandler messageHandler = getWebSocketService().messageHandler; //靜態變量,用來記錄當前在線連接數。應該把它設計成線程安全的 public static int onlineCount = 0; //與某個客戶端的連接會話,需要通過它來給客戶端發送數據 public Session session; /** * 連接建立成功調用的方法 * @param session 可選的參數。session爲與某個客戶端的連接會話,需要通過它來給客戶端發送數據 */ @OnOpen public void onOpen(Session session){ this.session = session; WebSocketMapUtil.put(session.getId(),this);//存入map addOnlineCount(); //在線數加1 messageHandler.onConnect(session.getId()); System.out.println("有新連接加入!當前在線人數爲" + getOnlineCount()); logger.info("有新連接加入!當前在線人數爲" + getOnlineCount()); } /** * 連接關閉調用的方法 */ @OnClose public void onClose(){ WebSocketMapUtil.remove(session.getId()); //從map中刪除 subOnlineCount(); //在線數減1 messageHandler.onDisconnect(session.getId()); try { if(session != null){ session.close(); } } catch (IOException e) { e.printStackTrace(); } System.out.println("有一連接關閉!當前在線人數爲" + getOnlineCount()); logger.info("有一連接關閉!當前在線人數爲" + getOnlineCount()); } /** * 收到客戶端消息後調用的方法 * @param message 客戶端發送過來的消息 * @param session 可選的參數 */ @OnMessage public String onMessage(String message, Session session) { System.out.println("來自客戶端的消息:" + message); logger.info("來自客戶端的消息:" + message); if (message.equals("&")){ return "&"; }else{ messageHandler.onMessage(session.getId(),message); return "Got your message ("+ message +")"; } } /** * 發生錯誤時調用 * @param session * @param error */ @OnError public void onError(Session session, Throwable error){ System.out.println("發生錯誤"); logger.info("發生錯誤:" + error); error.printStackTrace(); } //單發消息 public void sendMessage(String message) throws IOException{ //阻塞式(同步) //this.session.getBasicRemote().sendText(message); //非阻塞式(異步) this.session.getAsyncRemote().sendText(message); } //羣發消息 public void sendMessageAll(String message) throws IOException{ for(WebSocket webSocket : WebSocketMapUtil.getValues()){ webSocket.sendMessage(message); } } public static synchronized int getOnlineCount() { return onlineCount; } public static synchronized void addOnlineCount() { WebSocket.onlineCount++; } public static synchronized void subOnlineCount() { WebSocket.onlineCount--; } public WebSocketServiceImpl getWebSocketService(){ ClassPathXmlApplicationContext classPathXmlApplicationContext = new ClassPathXmlApplicationContext("classpath*:applicationContext.xml"); return (WebSocketServiceImpl) classPathXmlApplicationContext.getBean("webSocketService"); } }
5. 在WebSocketServiceImpl實現類裏實現服務器推送消息的方法
@Override public boolean sendMessage(String message) { logger.info("發送給客戶端的websocket消息message=="+message); if (messageHandler == null) { logger.info("上層調用者沒有給messageHandler賦值,websocket消息無法發送到客戶端"); return false; } if (message == null || "".equals(message)) { logger.info("發送給客戶端的消息message爲空"); return false; } try { for(WebSocket webSocket : WebSocketMapUtil.getValues()){ webSocket.sendMessage(message); logger.info("給sessionId爲" + webSocket.session.getId() + "的客戶端發送消息:"+message+"=成功"); } return true; } catch (IOException e) { logger.info("向所有客戶端發送消息:"+message+"=失敗:" + e); e.printStackTrace(); } return false; }
其實,使用Tomcat8開發WebSocket服務端非常簡單,主要有如下兩種方式:
1. 使用註解方式開發(上述示例代碼),被@ServerEndpoint修飾的Java類即可作爲WebSocket服務端。
2. 繼承Endpint基類實現WebSocket服務端。
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持神馬文庫。