通过实例讲解springboot整合WebSocket
一、背景
我们都知道 http 协议只能浏览器单方面向服务器发起请求获得响应,服务器不能主动向浏览器推送消息。想要实现浏览器的主动推送有两种主流实现方式:
- 轮询:缺点很多,但是实现简单
- websocket:在浏览器和服务器之间建立 tcp 连接,实现全双工通信
springboot 使用 websocket 有两种方式,一种是实现简单的 websocket,另外一种是实现stomp协议。这一篇实现简单的 websocket,stomp 下一篇在讲。
注意:如下都是针对使用 springboot 内置容器
二、实现
1、依赖引入
要使用 websocket 关键是@serverendpoint这个注解,该注解是 javaee 标准中的注解,tomcat7 及以上已经实现了,如果使用传统方法将 war 包部署到 tomcat 中,只需要引入如下 javaee 标准依赖即可:
<dependency> <groupid>javax</groupid> <artifactid>javaee-api</artifactid> <version>7.0</version> <scope>provided</scope> </dependency>
如使用 springboot 内置容器,无需引入,springboot 已经做了包含。我们只需引入如下依赖即可:
<dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-websocket</artifactid> <version>1.5.3.release</version> <type>pom</type> </dependency>
2、注入 bean
首先注入一个serverendpointexporterbean,该 bean 会自动注册使用@serverendpoint 注解申明的 websocket endpoint。代码如下:
@configuration public class websocketconfig { @bean public serverendpointexporter serverendpointexporter(){ return new serverendpointexporter(); } }
3、申明 endpoint
建立mywebsocket.java类,在该类中处理 websocket 逻辑
@serverendpoint(value = "/websocket") //接受websocket请求路径 @component //注册到spring容器中 public class mywebsocket { //保存所有在线socket连接 private static map<string,mywebsocket> websocketmap = new linkedhashmap<>(); //记录当前在线数目 private static int count=0; //当前连接(每个websocket连入都会创建一个mywebsocket实例 private session session; private logger log = loggerfactory.getlogger(this.getclass()); //处理连接建立 @onopen public void onopen(session session){ this.session=session; websocketmap.put(session.getid(),this); addcount(); log.info("新的连接加入:{}",session.getid()); } //接受消息 @onmessage public void onmessage(string message,session session){ log.info("收到客户端{}消息:{}",session.getid(),message); try{ this.sendmessage("收到消息:"+message); }catch (exception e){ e.printstacktrace(); } } //处理错误 @onerror public void onerror(throwable error,session session){ log.info("发生错误{},{}",session.getid(),error.getmessage()); } //处理连接关闭 @onclose public void onclose(){ websocketmap.remove(this.session.getid()); reducecount(); log.info("连接关闭:{}",this.session.getid()); } //群发消息 //发送消息 public void sendmessage(string message) throws ioexception { this.session.getbasicremote().sendtext(message); } //广播消息 public static void broadcast(){ mywebsocket.websocketmap.foreach((k,v)->{ try{ v.sendmessage("这是一条测试广播"); }catch (exception e){ } }); } //获取在线连接数目 public static int getcount(){ return count; } //操作count,使用synchronized确保线程安全 public static synchronized void addcount(){ mywebsocket.count++; } public static synchronized void reducecount(){ mywebsocket.count--; } }
4、客户的实现
客户端使用 h5 原生 websocket,部分浏览器可能不支持。代码如下:
<html> <head> <title>websocket测试</title> <meta charset="utf-8" /> </head> <body> <button onclick="sendmessage()">测试</button> <script> let socket = new websocket("ws://localhost:8080/websocket"); socket.onerror = err => { console.log(err); }; socket.onopen = event => { console.log(event); }; socket.onmessage = mess => { console.log(mess); }; socket.onclose = () => { console.log("连接关闭"); }; function sendmessage() { if (socket.readystate === 1) socket.send("这是一个测试数据"); else alert("尚未建立websocket连接"); } </script> </body> </html>
三、测试
建立一个 controller 测试群发,代码如下:
@restcontroller public class homecontroller { @getmapping("/broadcast") public void broadcast(){ mywebsocket.broadcast(); } }
然后打开上面的 html,可以看到浏览器和服务器都输出连接成功的信息:
浏览器: event {istrusted: true, type: "open", target: websocket, currenttarget: websocket, eventphase: 2, …} 服务端: 2018-08-01 14:05:34.727 info 12708 --- [nio-8080-exec-1] com.fxb.h5websocket.mywebsocket : 新的连接加入:0
点击测试按钮,可在服务端看到如下输出:
2018-08-01 15:00:34.644 info 12708 --- [nio-8080-exec-6] com.fxb.h5websocket.mywebsocket : 收到客户端2消息:这是一个测试数据
再次打开 html 页面,这样就有两个 websocket 客户端,然后在浏览器访问localhost:8080/broadcast测试群发功能,每个客户端都会输出如下信息:
messageevent {istrusted: true, data: "这是一条测试广播", origin: "ws://localhost:8080", lasteventid: "", source: null, …}
源码可在 github 上下载
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
上一篇: CDR文件如何转为AI文件
下一篇: 使用Scala生成随机数的方法示例
推荐阅读
-
springboot整合websocket后运行测试类报错:javax.websocket.server.ServerContainer not available
-
SpringBoot和Redis实现Token权限认证的实例讲解
-
用图解&&实例讲解php是如何实现websocket实时消息推送的
-
MySQL通过实例化对象参数查询实例讲解
-
SpringBoot整合模板引擎过程代码实例
-
Springboot+Netty+Websocket实现消息推送实例
-
php通过pecl方式安装扩展的实例讲解
-
SpringBoot Kafka 整合 实例 源码
-
springboot2.3.3引用Tomcat9整合jsp开发实例
-
如何抠图?通过实例来讲解在抠图中的一些技巧