当前位置:   article > 正文

WebSocket的基本使用_websocket使用

websocket使用

目录

为何使用websocket

1.后端搭建

2.搭建webSocket前后分离

1.配置跨域过滤器与初始化websocket

2.定义websocket服务

3.定义控制器进行测试webSocket向前端发送消息

2.前端准备

3.进行测试

向后端发送消息测试

后端向前端发送消息测试


为何使用websocket

在浏览器与服务器通信间,传统的 HTTP 请求在某些场景下并不理想,比如实时聊天、实时性的小游戏等等,

其面临主要两个缺点:

  • 无法做到消息的「实时性」;
  • 服务端无法主动推送信息;

其基于 HTTP 的主要解决方案有:

  • 基于 ajax 的轮询:客户端定时或者动态相隔短时间内不断向服务端请求接口,询问服务端是否有新信息;其缺点也很明显:多余的空请求(浪费资源)、数据获取有延时;
  • Long Poll:其采用的是阻塞性的方案,客户端向服务端发起 ajax 请求,服务端挂起该请求不返回数据直到有新的数据,客户端接收到数据之后再次执行 Long Poll;该方案中每个请求都挂起了服务器资源,在大量连接的场景下是不可接受的;

可以看到,基于 HTTP 协议的方案都包含一个本质缺陷 —— 「被动性」,服务端无法下推消息,仅能由客户端发起请求不断询问是否有新的消息,同时对于客户端与服务端都存在性能消耗。

WebSocket 是 HTML5 开始提供的一种浏览器与服务器间进行全双工通讯的网络技术。 WebSocket 通信协议于2011年被IETF定为标准RFC 6455,WebSocketAPI 被 W3C 定为标准。 在 WebSocket API 中,浏览器和服务器只需要要做一个握手的动作,然后,浏览器和服务器之间就形成了一条快速通道。两者之间就直接可以数据互相传送。

WebSocket 是 HTML5 中提出的新的网络协议标准,其包含几个特点:

  • 建立于 TCP 协议之上的应用层;
  • 一旦建立连接(直到断开或者出错),服务端与客户端握手后则一直保持连接状态,是持久化连接;
  • 服务端可通过实时通道主动下发消息;
  • 数据接收的「实时性(相对)」与「时序性」;
  • 较少的控制开销。连接创建后,ws客户端、服务端进行数据交换时,协议控制的数据包头部较小。在不包含头部的情况下,服务端到客户端的包头只有2~10字节(取决于数据包长度),客户端到服务端的的话,需要加上额外的4字节的掩码。而HTTP协议每次通信都需要携带完整的头部。
  • 支持扩展。ws协议定义了扩展,用户可以扩展协议,或者实现自定义的子协议。(比如支持自定义压缩算法等)

实践

1.后端搭建

准配工作

所需要架包 注意:springboot环境 版本2.7.7

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-web</artifactId>
  4. </dependency>
  5. <dependency>
  6. <groupId>org.springframework.boot</groupId>
  7. <artifactId>spring-boot-starter-websocket</artifactId>
  8. </dependency>
  9. <dependency>
  10. <groupId>org.projectlombok</groupId>
  11. <artifactId>lombok</artifactId>
  12. <optional>true</optional>
  13. </dependency>
  14. <dependency>
  15. <groupId>org.springframework.boot</groupId>
  16. <artifactId>spring-boot-starter-test</artifactId>
  17. <scope>test</scope>
  18. </dependency>
  19. <!-- <dependency>
  20. <groupId>cn.hutool</groupId>
  21. <artifactId>hutool-json</artifactId>
  22. <version>5.8.9</version>
  23. </dependency>-->
  24. <dependency>
  25. <groupId>com.alibaba</groupId>
  26. <artifactId>fastjson</artifactId>
  27. <version>2.0.21</version>
  28. </dependency>
  29. <dependency>
  30. <groupId>org.apache.commons</groupId>
  31. <artifactId>commons-lang3</artifactId>
  32. <version>3.7</version>
  33. </dependency>

application配置

  1. server.port=8080
  2. server.servlet.context-path=/

2.搭建webSocket前后分离

1.配置跨域过滤器与初始化websocket

  1. package com.zking.web.websocketdemo.config;
  2. import org.slf4j.Logger;
  3. import org.slf4j.LoggerFactory;
  4. import org.springframework.context.annotation.Bean;
  5. import org.springframework.context.annotation.Configuration;
  6. import org.springframework.web.servlet.config.annotation.CorsRegistry;
  7. import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
  8. import org.springframework.web.socket.server.standard.ServerEndpointExporter;
  9. /**
  10. * Spring MVC 配置
  11. */
  12. @Configuration
  13. public class WebMvcConfig implements WebMvcConfigurer {
  14. private final Logger logger = LoggerFactory.getLogger(WebMvcConfig.class);
  15. //服务器支持跨域
  16. @Override
  17. public void addCorsMappings(CorsRegistry registry) {
  18. registry.addMapping("/**")
  19. .allowedOrigins("*")
  20. .allowedMethods("GET", "POST","OPTIONS")
  21. .allowedHeaders("*")
  22. .exposedHeaders("Access-Control-Allow-Headers",
  23. "Access-Control-Allow-Methods",
  24. "Access-Control-Allow-Origin",
  25. "Access-Control-Max-Age",
  26. "X-Frame-Options")
  27. .allowCredentials(false)
  28. .maxAge(3600);
  29. }
  30. /**
  31. * The bean shown in the preceding example registers any @ServerEndpoint
  32. * annotated beans with the underlying WebSocket container. When deployed to a
  33. * standalone servlet container, this role is performed by a servlet container
  34. * initializer, and the ServerEndpointExporter bean is not required.
  35. *
  36. * @return
  37. * 在Spring中可以直接使用Java WebSocket API来提供服务,如果使用内置的web容器,需要做的仅仅是需要在下面添加
  38. */
  39. /** 注入ServerEndpointExporter,这个bean会自动注册使用了@ServerEndpoint注解声明的Websocket endpoint 。
  40. * 要注意,如果使用独立的servlet容器,而不是直接使用springboot的内置容器,就不要注入ServerEndpointExporter,因为它将由容器自己提供和管理。*/
  41. @Bean
  42. public ServerEndpointExporter serverEndpointExporter() {
  43. return new ServerEndpointExporter();
  44. }
  45. }

2.定义websocket服务

websocket 是 javax.websocket下面的,不需要任何依赖,直接就可以使用

  @ServerEndpoint 标记声明一个websocket 服务 ,configurator 属性指定 鉴权 配置类,@ServerEndpoint 标记的类 为每个链接会创建一个该对象实例,也就是成员变量这个链接内私有。

  @OnOpen , @OnClose , @OnMessage , @OnError 4个事件方法,对应事件触发的时候调用 (除了@PathParam("path") 标记的参数以外,最多只能有 String message, Session session 两个参数)

  1. package com.zking.web.websocketdemo.component;
  2. import org.apache.commons.lang3.StringUtils;
  3. import org.slf4j.Logger;
  4. import org.slf4j.LoggerFactory;
  5. import javax.websocket.OnClose;
  6. import javax.websocket.OnError;
  7. import javax.websocket.OnMessage;
  8. import javax.websocket.OnOpen;
  9. import javax.websocket.Session;
  10. import javax.websocket.server.PathParam;
  11. import javax.websocket.server.ServerEndpoint;
  12. import org.springframework.stereotype.Component;
  13. import java.io.IOException;
  14. import java.util.concurrent.ConcurrentHashMap;
  15. @ServerEndpoint("/ws/{sid}")
  16. @Component
  17. public class WebSocketServer {
  18. private final static Logger log = LoggerFactory.getLogger(WebSocketServer.class);
  19. //静态变量,用来记录当前在线连接数。应该把它设计成线程安全的。
  20. private static int onlineCount = 0;
  21. //与某个客户端的连接会话,需要通过它来给客户端发送数据
  22. private Session session;
  23. //旧:concurrent包的线程安全Set,用来存放每个客户端对应的MyWebSocket对象。由于遍历set费时,改用map优化
  24. //private static CopyOnWriteArraySet<WebSocketServer> webSocketSet = new CopyOnWriteArraySet<WebSocketServer>();
  25. //新:使用map对象优化,便于根据sid来获取对应的WebSocket
  26. private static ConcurrentHashMap<String,WebSocketServer> websocketMap = new ConcurrentHashMap<>();
  27. //接收用户的sid,指定需要推送的用户
  28. private String sid;
  29. /**
  30. * 连接成功后调用的方法
  31. */
  32. @OnOpen
  33. public void onOpen(Session session,@PathParam("sid") String sid) {
  34. this.session = session;
  35. //webSocketSet.add(this); //加入set
  36. websocketMap.put(sid,this); //加入map中
  37. addOnlineCount(); //在线数加1
  38. log.info("有新窗口开始监听:"+sid+",当前在线人数为" + getOnlineCount());
  39. this.sid=sid;
  40. try {
  41. sendMessage("连接成功");
  42. } catch (IOException e) {
  43. log.error("websocket IO异常");
  44. }
  45. }
  46. /**
  47. * 连接关闭调用的方法
  48. */
  49. @OnClose
  50. public void onClose() {
  51. if(websocketMap.get(this.sid)!=null){
  52. //webSocketSet.remove(this); //set中删除
  53. websocketMap.remove(this.sid); //从map中删除
  54. subOnlineCount(); //在线数减1
  55. log.info("有一连接关闭!当前在线人数为" + getOnlineCount());
  56. }
  57. }
  58. /**
  59. * 收到客户端消息后调用的方法,根据业务要求进行处理,这里就简单地将收到的消息直接群发推送出去
  60. * @param message 客户端发送过来的消息
  61. */
  62. @OnMessage
  63. public void onMessage(String message, Session session) {
  64. log.info("收到来自窗口"+sid+"的信息:"+message);
  65. if(StringUtils.isNotBlank(message)){
  66. for(WebSocketServer server:websocketMap.values()) {
  67. try {
  68. server.sendMessage(message);
  69. } catch (IOException e) {
  70. e.printStackTrace();
  71. continue;
  72. }
  73. }
  74. }
  75. }
  76. /**
  77. * 发生错误时的回调函数
  78. * @param session
  79. * @param error
  80. */
  81. @OnError
  82. public void onError(Session session, Throwable error) {
  83. log.error("发生错误");
  84. error.printStackTrace();
  85. }
  86. /**
  87. * 实现服务器主动推送消息
  88. */
  89. public void sendMessage(String message) throws IOException {
  90. this.session.getBasicRemote().sendText(message);
  91. }
  92. /**
  93. * 群发自定义消息(用set会方便些)
  94. * */
  95. public static void sendInfo(@PathParam("message") String message,@PathParam("sid") String sid) throws IOException {
  96. log.info("推送消息到窗口"+sid+",推送内容:"+message);
  97. /*for (WebSocketServer item : webSocketSet) {
  98. try {
  99. //这里可以设定只推送给这个sid的,为null则全部推送
  100. if(sid==null) {
  101. item.sendMessage(message);
  102. }else if(item.sid.equals(sid)){
  103. item.sendMessage(message);
  104. }
  105. } catch (IOException e) {
  106. continue;
  107. }
  108. }*/
  109. if(StringUtils.isNotBlank(message)){
  110. for(WebSocketServer server:websocketMap.values()) {
  111. try {
  112. // sid为null时群发,不为null则只发一个
  113. if (sid == null) {
  114. server.sendMessage(message);
  115. } else if (server.sid.equals(sid)) {
  116. server.sendMessage(message);
  117. }
  118. } catch (IOException e) {
  119. e.printStackTrace();
  120. continue;
  121. }
  122. }
  123. }
  124. }
  125. public static synchronized int getOnlineCount() {
  126. return onlineCount;
  127. }
  128. public static synchronized void addOnlineCount() {
  129. WebSocketServer.onlineCount++;
  130. }
  131. public static synchronized void subOnlineCount() {
  132. WebSocketServer.onlineCount--;
  133. }
  134. }

3.定义控制器进行测试webSocket向前端发送消息

  1. package com.zking.web.websocketdemo.controller;
  2. import com.zking.web.websocketdemo.component.WebSocketServer;
  3. import com.zking.web.websocketdemo.config.WebSocketConfig;
  4. import org.springframework.beans.factory.annotation.Autowired;
  5. import org.springframework.stereotype.Controller;
  6. import org.springframework.web.bind.annotation.GetMapping;
  7. import org.springframework.web.bind.annotation.PathVariable;
  8. import org.springframework.web.bind.annotation.RequestMapping;
  9. import org.springframework.web.bind.annotation.ResponseBody;
  10. import org.springframework.web.servlet.ModelAndView;
  11. import java.io.IOException;
  12. import java.util.HashMap;
  13. import java.util.Map;
  14. @Controller
  15. @RequestMapping("/websocket")
  16. public class WebSocketController {
  17. //页面请求
  18. @GetMapping("/socket/{cid}")
  19. public ModelAndView socket(@PathVariable String cid) {
  20. ModelAndView mav=new ModelAndView("/socket");
  21. mav.addObject("cid", cid);
  22. return mav;
  23. }
  24. //推送数据接口
  25. @ResponseBody
  26. @RequestMapping("/socket/push/{cid}")
  27. public Map<String,Object> pushToWeb(@PathVariable String cid, String message) {
  28. Map<String,Object> result = new HashMap<>();
  29. try {
  30. WebSocketServer.sendInfo(message,cid);
  31. result.put("status","success");
  32. } catch (IOException e) {
  33. e.printStackTrace();
  34. result.put("status","fail");
  35. result.put("errMsg",e.getMessage());
  36. }
  37. return result;
  38. }
  39. }

后端准配完毕

2.前端准备

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <title>websocket通讯</title>
  6. </head>
  7. <script src="https://cdn.bootcss.com/jquery/3.3.1/jquery.js"></script>
  8. <script>
  9. var socket;
  10. function openSocket() {
  11. if(typeof(WebSocket) == "undefined") {
  12. console.log("您的浏览器不支持WebSocket");
  13. }else{
  14. console.log("您的浏览器支持WebSocket");
  15. //实现化WebSocket对象,指定要连接的服务器地址与端口 建立连接
  16. //等同于socket = new WebSocket("ws://localhost:8888/xxxx/im/25");
  17. //var socketUrl="${request.contextPath}/im/"+$("#userId").val();
  18. var socketUrl="http://localhost:8080/ws/"+$("#userId").val();
  19. socketUrl=socketUrl.replace("https","ws").replace("http","ws");
  20. console.log(socketUrl);
  21. if(socket!=null){
  22. socket.close();
  23. socket=null;
  24. }
  25. socket = new WebSocket(socketUrl);
  26. //打开事件
  27. socket.onopen = function() {
  28. console.log("websocket已打开");
  29. //socket.send("这是来自客户端的消息" + location.href + new Date());
  30. };
  31. //获得消息事件
  32. socket.onmessage = function(msg) {
  33. console.log(msg.data);
  34. //发现消息进入 开始处理前端触发逻辑
  35. };
  36. //关闭事件
  37. socket.onclose = function() {
  38. console.log("websocket已关闭");
  39. };
  40. //发生了错误事件
  41. socket.onerror = function() {
  42. console.log("websocket发生了错误");
  43. }
  44. }
  45. }
  46. function sendMessage() {
  47. if(typeof(WebSocket) == "undefined") {
  48. console.log("您的浏览器不支持WebSocket");
  49. }else {
  50. console.log("您的浏览器支持WebSocket");
  51. console.log('{"toUserId":"'+$("#toUserId").val()+'","contentText":"'+$("#contentText").val()+'"}');
  52. socket.send('{"toUserId":"'+$("#toUserId").val()+'","contentText":"'+$("#contentText").val()+'"}');
  53. }
  54. }
  55. </script>
  56. <body>
  57. <p>【userId】:<div><input id="userId" name="userId" type="text" value="10"></div>
  58. <p>【toUserId】:<div><input id="toUserId" name="toUserId" type="text" value="20"></div>
  59. <p>【toUserId】:<div><input id="contentText" name="contentText" type="text" value="hello websocket"></div>
  60. <p>【操作】:<div><a onclick="openSocket()">开启socket</a></div>
  61. <p>【操作】:<div><a onclick="sendMessage()">发送消息</a></div>
  62. </body>
  63. </html>

运行前端与后端

3.进行测试

向后端发送消息测试

后端向前端发送消息测试

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/菜鸟追梦旅行/article/detail/85468
推荐阅读
相关标签
  

闽ICP备14008679号