SpringBoot集成WebSocket【基于純H5】進(jìn)行點對點[一對一]和廣播[一對多]實時推送

之前實現(xiàn)WebSocket基于STOMP的，覺得SpringBoot封裝的太高，不怎么靈活，現(xiàn)在實現(xiàn)一個純H5的，也大概了解webSocket在內(nèi)部是怎么傳輸?shù)摹?/p>

網(wǎng)站建設(shè)哪家好，找創(chuàng)新互聯(lián)公司！專注于網(wǎng)頁設(shè)計、網(wǎng)站建設(shè)、微信開發(fā)、小程序制作、集團(tuán)企業(yè)網(wǎng)站建設(shè)等服務(wù)項目。為回饋新老客戶創(chuàng)新互聯(lián)還提供了清徐免費建站歡迎大家使用！

1.環(huán)境搭建

因為在上一篇基于STOMP協(xié)議實現(xiàn)的WebSocket里已經(jīng)有大概介紹過Web的基本情況了，所以在這篇就不多說了，我們直接進(jìn)入正題吧，在SpringBoot中，我們還是需要導(dǎo)入WebSocket的包。

在pox.xml加上對springBoot對WebSocket的支持：

 
 
  org.springframework.boot 
  spring-boot-starter-websocket

這里大概說一下自己的一點小見解：客戶端與服務(wù)器建立WebSocket連接，實際上是創(chuàng)建了一個Socket,這個Socket是共享與客戶端和服務(wù)器的。兩者只要往對應(yīng)的Socket里操作，就可以實現(xiàn)雙方實時通訊了

2.編碼實現(xiàn)

一、在SpringBoot中，添加WebSocket的配置

package com.cloud.sbjm.configure;
 
import org.springframework.context.annotation.Configuration;
import org.springframework.web.socket.config.annotation.EnableWebSocket;
import org.springframework.web.socket.config.annotation.WebSocketConfigurer;
import org.springframework.web.socket.config.annotation.WebSocketHandlerRegistry;
import com.cloud.sbjm.security.WebSocketInterceptor;
import com.cloud.sbjm.service.Imp.MyHandler;
 
 
//實現(xiàn)接口來配置Websocket請求的路徑和攔截器。
@Configuration
@EnableWebSocket
public class WebSocketH5Config implements WebSocketConfigurer{
 
	@Override
	public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) {
		
	  //handler是webSocket的核心，配置入口
	  registry.addHandler(new MyHandler(), "/myHandler/{ID}").setAllowedOrigins("*").addInterceptors(new WebSocketInterceptor());
		
	}
 
	
}

1.@Configuration：注解標(biāo)識該類為Spring的配置類

2.@EnableWebSocket：開啟注解接收和發(fā)送消息

3.實現(xiàn)WebSocketConfigurer接口，重寫registerWebSocketHandlers方法，這是一個核心實現(xiàn)方法，配置websocket入口，允許訪問的域、注冊Handler、定義攔截器?？蛻舳送ㄟ^“/myHandler/{ID}”直接訪問Handler核心類，進(jìn)行socket的連接、接收、發(fā)送等操作，這里由于還加了個攔截器，所以建立新的socket訪問時，都先進(jìn)來攔截器再進(jìn)去Handler類，“new WebSocketInterceptor()”是我實現(xiàn)的攔截器，“new MyHandler()”是我實現(xiàn)的一個Handler類。

二、WebSocketInterceptor攔截器的實現(xiàn)：

package com.cloud.sbjm.security;
 
import java.util.Map;
 
import javax.servlet.http.HttpSession;
 
import org.springframework.http.server.ServerHttpRequest;
import org.springframework.http.server.ServerHttpResponse;
import org.springframework.http.server.ServletServerHttpRequest;
import org.springframework.web.socket.WebSocketHandler;
import org.springframework.web.socket.server.HandshakeInterceptor;
 
public class WebSocketInterceptor implements HandshakeInterceptor {
 
  //進(jìn)入hander之前的攔截
  @Override
  public boolean beforeHandshake(ServerHttpRequest request, ServerHttpResponse serverHttpResponse, WebSocketHandler webSocketHandler, Map map) throws Exception {
    if (request instanceof ServletServerHttpRequest) {
      String ID = request.getURI().toString().split("ID=")[1];
      System.out.println("當(dāng)前session的ID="+ID);
      ServletServerHttpRequest serverHttpRequest = (ServletServerHttpRequest) request;
      HttpSession session = serverHttpRequest.getServletRequest().getSession();
      map.put("WEBSOCKET_USERID",ID);
    }
    return true;
  }
 
  @Override
  public void afterHandshake(ServerHttpRequest serverHttpRequest, ServerHttpResponse serverHttpResponse, WebSocketHandler webSocketHandler, Exception e) {
  	System.out.println("進(jìn)來webSocket的afterHandshake攔截器！");
  }
}

1.實現(xiàn)了HandshakeInterceptor 接口，并實現(xiàn)了beforeHandshake該方法，該方法是在進(jìn)入Handler核心類之前進(jìn)行攔截。

這里主要實現(xiàn)的邏輯是：

截取客戶端建立webSocket連接時發(fā)送的URL地址字符串，并通過對該字符串進(jìn)行特殊標(biāo)識截取操作，獲取客戶端發(fā)送的唯一標(biāo)識（由自己定義的，一般是系統(tǒng)用戶ID唯一標(biāo)識，用以標(biāo)識該用戶），并把它以鍵值對的形式放到Session里，這樣后期可以通過該session獲取它對應(yīng)的用戶ID了。【一個session對應(yīng)著一個webSocketSession】

三、MyHandler核心類的實現(xiàn)

package com.cloud.sbjm.service.Imp;
 
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
import java.util.Set;
import net.sf.json.JSONObject;
import org.springframework.stereotype.Service;
import org.springframework.web.socket.CloseStatus;
import org.springframework.web.socket.TextMessage;
import org.springframework.web.socket.WebSocketHandler;
import org.springframework.web.socket.WebSocketMessage;
import org.springframework.web.socket.WebSocketSession;
 
 
@Service
public class MyHandler implements WebSocketHandler {
	
  //在線用戶列表
  private static final Map users;
 
  
  static {
    users = new HashMap<>();
  }
  //新增socket
  @Override
  public void afterConnectionEstablished(WebSocketSession session) throws Exception {
  	 System.out.println("成功建立連接");
  	 String ID = session.getUri().toString().split("ID=")[1];
     System.out.println(ID);
     if (ID != null) {
       users.put(ID, session);
       session.sendMessage(new TextMessage("成功建立socket連接"));
       System.out.println(ID);
       System.out.println(session);
     }
     System.out.println("當(dāng)前在線人數(shù)："+users.size());
  }
 
  //接收socket信息
  @Override
	public void handleMessage(WebSocketSession webSocketSession, WebSocketMessage<?> webSocketMessage) throws Exception {
  	try{
	  	JSONObject jsonobject = JSONObject.fromObject(webSocketMessage.getPayload());  	
	  	System.out.println(jsonobject.get("id"));
	  	System.out.println(jsonobject.get("message")+":來自"+(String)webSocketSession.getAttributes().get("WEBSOCKET_USERID")+"的消息");
	  	sendMessageToUser(jsonobject.get("id")+"",new TextMessage("服務(wù)器收到了，hello!"));
  	 }catch(Exception e){
   	  e.printStackTrace();
     }
		
	}
 
  /**
   * 發(fā)送信息給指定用戶
   * @param clientId
   * @param message
   * @return
   */
  public boolean sendMessageToUser(String clientId, TextMessage message) {
    if (users.get(clientId) == null) return false;
    WebSocketSession session = users.get(clientId);
    System.out.println("sendMessage:" + session);
    if (!session.isOpen()) return false;
    try {
      session.sendMessage(message);
    } catch (IOException e) {
      e.printStackTrace();
      return false;
    }
    return true;
  }
 
  /**
   * 廣播信息
   * @param message
   * @return
   */
  public boolean sendMessageToAllUsers(TextMessage message) {
    boolean allSendSuccess = true;
    Set clientIds = users.keySet();
    WebSocketSession session = null;
    for (String clientId : clientIds) {
      try {
        session = users.get(clientId);
        if (session.isOpen()) {
          session.sendMessage(message);
        }
      } catch (IOException e) {
        e.printStackTrace();
        allSendSuccess = false;
      }
    }
 
    return allSendSuccess;
  }
 
 
  @Override
  public void handleTransportError(WebSocketSession session, Throwable exception) throws Exception {
    if (session.isOpen()) {
      session.close();
    }
    System.out.println("連接出錯");
    users.remove(getClientId(session));
  }
 
  @Override
  public void afterConnectionClosed(WebSocketSession session, CloseStatus status) throws Exception {
    System.out.println("連接已關(guān)閉：" + status);
    users.remove(getClientId(session));
  }
 
  @Override
  public boolean supportsPartialMessages() {
    return false;
  }
 
  /**
   * 獲取用戶標(biāo)識
   * @param session
   * @return
   */
  private Integer getClientId(WebSocketSession session) {
    try {
      Integer clientId = (Integer) session.getAttributes().get("WEBSOCKET_USERID");
      return clientId;
    } catch (Exception e) {
      return null;
    }
  }
}

1.實現(xiàn)了WebSocketHandler接口，并實現(xiàn)了關(guān)鍵的幾個方法。

① afterConnectionEstablished（接口提供的）：建立新的socket連接后回調(diào)的方法。主要邏輯是：將成功建立連接的webSocketSssion放到定義好的常量[private static final Map users;]中去。這里也截取客戶端訪問的URL的字符串，拿到標(biāo)識，以鍵值對的形式講每一個webSocketSession存到users里，以記錄每個Socket。

② handleMessage（接口提供的）：接收客戶端發(fā)送的Socket。主要邏輯是：獲取客戶端發(fā)送的信息。這里之所以可以獲取本次Socket的ID，是因為客戶端在第一次進(jìn)行連接時，攔截器進(jìn)行攔截后，設(shè)置好ID，這樣也說明，雙方在相互通訊的時候，只是對第一次建立好的socket持續(xù)進(jìn)行操作。

③ sendMessageToUser（自己定義的）：發(fā)送給指定用戶信息。主要邏輯是：根據(jù)用戶ID從常量users(記錄每一個Socket)中，獲取Socket,往該Socket里發(fā)送消息，只要客戶端還在線，就能收到該消息。

④sendMessageToAllUsers （自己定義的）：這個廣播消息，發(fā)送信息給所有socket。主要邏輯是：跟③類型，只不過是遍歷整個users獲取每一個socket,給每一個socket發(fā)送消息即可完廣播發(fā)送

⑤handleTransportError（接口提供的）：連接出錯時，回調(diào)的方法。主要邏輯是：一旦有連接出錯的Socket,就從users里進(jìn)行移除，有提供該Socket的參數(shù)，可直接獲取ID，進(jìn)行移除。這個在客戶端沒有正常關(guān)閉連接時，會進(jìn)來，所以在開發(fā)客戶端時，記得關(guān)閉連接

⑥afterConnectionClosed（接口提供的）：連接關(guān)閉時，回調(diào)的方法。主要邏輯：一旦客戶端/服務(wù)器主動關(guān)閉連接時，將個socket從users里移除，有提供該Socket的參數(shù)，可直接獲取ID，進(jìn)行移除。

后臺的開發(fā)就開發(fā)完了，大家有沒有發(fā)現(xiàn)比基于STOMP協(xié)議實現(xiàn)要靈活得多？

四、客戶端頁面的實現(xiàn)【基于H5】

不需要加入任何的JS包



 
  socket.html
	
  
  
  
  
 
 
 
 
	
	Welcome

頁面比較簡單，簡單解釋一下：

1.new WebSocket("ws://127.0.0.1:9091/cloud-sbjm/myHandler/ID="+userID)，與服務(wù)器建立webSocket連接，后面的ID="+userID，是動態(tài)參數(shù)，跟服務(wù)器配置Handler的訪問地址時對應(yīng)"/myHandler/{ID}"。

2.H5也提供多個回調(diào)函數(shù)

onopen：打開webSokcet連接時，回調(diào)該函數(shù)

onclose：關(guān)閉webSocket連接時，回調(diào)該函數(shù)

onmessage：服務(wù)器給該socket發(fā)送消息時，回調(diào)該函數(shù)，獲取消息

websocket.send(JSON.stringify(postValue));：給Socket發(fā)送消息，服務(wù)器獲取

websocket.close();客戶端主要關(guān)閉連接，會觸發(fā)客戶端的onclose方法和服務(wù)器的afterConnectionClosed方法

到此服務(wù)端的開發(fā)也完成了，下面執(zhí)行一下程序效果圖：

一、建立連接

客戶端：

SpringBoot集成WebSocket【基于純H5】進(jìn)行點對點[一對一]和廣播[一對多]實時推送