Netty 实现 WebSocket 聊天功能

上一次我们用 Netty 快速实现了一个 Java 聊天程序（见http://www.waylau.com/netty-chat/）。现在，我们要做下修改，加入 WebSocket 的支持，使它可以在浏览器里进行文本聊天。

准备

  • JDK 7+
  • Maven 3.2.x
  • Netty 4.x
  • Eclipse 4.x

WebSocket

WebSocket 通过“Upgrade handshake（升级握手）”从标准的 HTTP 或HTTPS 协议转为 WebSocket。因此，使用 WebSocket 的应用程序将始终以 HTTP/S 开始，然后进行升级。在什么时候发生这种情况取决于具体的应用;它可以是在启动时，或当一个特定的 URL 被请求时。

在我们的应用中，当 URL 请求以“/ws”结束时，我们才升级协议为WebSocket。否则，服务器将使用基本的 HTTP/S。一旦升级连接将使用的WebSocket 传输所有数据。

整个服务器逻辑如下：

  1. 客户端/用户连接到服务器并加入聊天
  2. HTTP 请求页面或 WebSocket 升级握手
  3. 服务器处理所有客户端/用户
  4. 响应 URI “/”的请求，转到默认 html 页面
  5. 如果访问的是 URI“/ws” ，处理 WebSocket 升级握手
  6. 升级握手完成后 ，通过 WebSocket 发送聊天消息

服务端

让我们从处理 HTTP 请求的实现开始。

处理 HTTP 请求

HttpRequestHandler.java

public class HttpRequestHandler extends SimpleChannelInboundHandler<FullHttpRequest> { //1 private final String wsUri;
 private static final File INDEX;

 static {
 URL location = HttpRequestHandler.class.getProtectionDomain().getCodeSource().getLocation();
 try {
 String path = location.toURI() + "WebsocketChatClient.html";
 path = !path.contains("file:") ? path : path.substring(5);
 INDEX = new File(path);
 } catch (URISyntaxException e) {
 throw new IllegalStateException("Unable to locate WebsocketChatClient.html", e);
 }
 }

 public HttpRequestHandler(String wsUri) {
 this.wsUri = wsUri;
 }

 @Override public void channelRead0(ChannelHandlerContext ctx, FullHttpRequest request) throws Exception {
 if (wsUri.equalsIgnoreCase(request.getUri())) {
 ctx.fireChannelRead(request.retain()); //2
 } else {
 if (HttpHeaders.is100ContinueExpected(request)) {
 send100Continue(ctx); //3
 }

 RandomAccessFile file = new RandomAccessFile(INDEX, "r");//4

 HttpResponse response = new DefaultHttpResponse(request.getProtocolVersion(), HttpResponseStatus.OK);
 response.headers().set(HttpHeaders.Names.CONTENT_TYPE, "text/html; charset=UTF-8");

 boolean keepAlive = HttpHeaders.isKeepAlive(request);

 if (keepAlive) { //5
 response.headers().set(HttpHeaders.Names.CONTENT_LENGTH, file.length());
 response.headers().set(HttpHeaders.Names.CONNECTION, HttpHeaders.Values.KEEP_ALIVE);
 }
 ctx.write(response); //6 if (ctx.pipeline().get(SslHandler.class) == null) { //7
 ctx.write(new DefaultFileRegion(file.getChannel(), 0, file.length()));
 } else {
 ctx.write(new ChunkedNioFile(file.getChannel()));
 }
 ChannelFuture future = ctx.writeAndFlush(LastHttpContent.EMPTY_LAST_CONTENT); //8 if (!keepAlive) {
 future.addListener(ChannelFutureListener.CLOSE); //9
 }

 file.close();
 }
 }

 private static void send100Continue(ChannelHandlerContext ctx) {
 FullHttpResponse response = new DefaultFullHttpResponse(HttpVersion.HTTP_1_1, HttpResponseStatus.CONTINUE);
 ctx.writeAndFlush(response);
 }

 @Override public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
 Channel incoming = ctx.channel();
 System.out.println("Client:"+incoming.remoteAddress()+"异常");
 // 当出现异常就关闭连接
 cause.printStackTrace();
 ctx.close();
 }
}
  1. 扩展 SimpleChannelInboundHandler 用于处理 FullHttpRequest信息
  2. 如果请求是 WebSocket 升级，递增引用计数器（保留）并且将它传递给在 ChannelPipeline 中的下个 ChannelInboundHandler
  3. 处理符合 HTTP 1.1的 "100 Continue" 请求
  4. 读取默认的 WebsocketChatClient.html 页面
  5. 判断 keepalive 是否在请求头里面
  6. 写 HttpResponse 到客户端
  7. 写 index.html 到客户端，判断 SslHandler 是否在 ChannelPipeline 来决定是使用 DefaultFileRegion 还是 ChunkedNioFile
  8. 写并刷新 LastHttpContent 到客户端，标记响应完成
  9. 如果 keepalive 没有要求，当写完成时，关闭 Channel

HttpRequestHandler 做了下面几件事，

  • 如果该 HTTP 请求被发送到URI “/ws”，调用 FullHttpRequest 上的 retain()，并通过调用 fireChannelRead(msg) 转发到下一个 ChannelInboundHandler。retain() 是必要的，因为 channelRead() 完成后，它会调用 FullHttpRequest 上的 release() 来释放其资源。 （请参考我们先前的 SimpleChannelInboundHandler 在第6章中讨论）
  • 如果客户端发送的 HTTP 1.1 头是“Expect: 100-continue” ，将发送“100 Continue”的响应。
  • 在 头被设置后，写一个 HttpResponse 返回给客户端。注意，这是不是 FullHttpResponse，唯一的反应的第一部分。此外，我们不使用 writeAndFlush() 在这里 - 这个是在最后完成。
  • 如果没有加密也不压缩，要达到最大的效率可以是通过存储 index.html 的内容在一个 DefaultFileRegion 实现。这将利用零拷贝来执行传输。出于这个原因，我们检查，看看是否有一个 SslHandler 在 ChannelPipeline 中。另外，我们使用 ChunkedNioFile。
  • 写 LastHttpContent 来标记响应的结束，并终止它
  • 如果不要求 keepalive ，添加 ChannelFutureListener 到 ChannelFuture 对象的最后写入，并关闭连接。注意，这里我们调用 writeAndFlush() 来刷新所有以前写的信息。

处理 WebSocket frame

WebSockets 在“帧”里面来发送数据，其中每一个都代表了一个消息的一部分。一个完整的消息可以利用了多个帧。 WebSocket "Request for Comments" (RFC) 定义了六中不同的 frame; Netty 给他们每个都提供了一个 POJO 实现 ，而我们的程序只需要使用下面4个帧类型：

  • CloseWebSocketFrame
  • PingWebSocketFrame
  • PongWebSocketFrame
  • TextWebSocketFrame

在这里我们只需要显示处理 TextWebSocketFrame，其他的会由 WebSocketServerProtocolHandler 自动处理。

下面代码展示了 ChannelInboundHandler 处理 TextWebSocketFrame，同时也将跟踪在 ChannelGroup 中所有活动的 WebSocket 连接

TextWebSocketFrameHandler.java

public class TextWebSocketFrameHandler extends SimpleChannelInboundHandler<TextWebSocketFrame> {

 public static ChannelGroup channels = new DefaultChannelGroup(GlobalEventExecutor.INSTANCE);

 @Override protected void channelRead0(ChannelHandlerContext ctx,
 TextWebSocketFrame msg) throws Exception { // (1)
 Channel incoming = ctx.channel();
 for (Channel channel : channels) {
 if (channel != incoming){
 channel.writeAndFlush(new TextWebSocketFrame("[" + incoming.remoteAddress() + "]" + msg.text()));
 } else {
 channel.writeAndFlush(new TextWebSocketFrame("[you]" + msg.text() ));
 }
 }
 }

 @Override public void handlerAdded(ChannelHandlerContext ctx) throws Exception { // (2)
 Channel incoming = ctx.channel();

 // Broadcast a message to multiple Channels
 channels.writeAndFlush(new TextWebSocketFrame("[SERVER] - " + incoming.remoteAddress() + " 加入"));

 channels.add(incoming);
 System.out.println("Client:"+incoming.remoteAddress() +"加入");
 }

 @Override public void handlerRemoved(ChannelHandlerContext ctx) throws Exception { // (3)
 Channel incoming = ctx.channel();

 // Broadcast a message to multiple Channels
 channels.writeAndFlush(new TextWebSocketFrame("[SERVER] - " + incoming.remoteAddress() + " 离开"));

 System.out.println("Client:"+incoming.remoteAddress() +"离开");

 // A closed Channel is automatically removed from ChannelGroup, // so there is no need to do "channels.remove(ctx.channel());"
 }

 @Override public void channelActive(ChannelHandlerContext ctx) throws Exception { // (5)
 Channel incoming = ctx.channel();
 System.out.println("Client:"+incoming.remoteAddress()+"在线");
 }

 @Override public void channelInactive(ChannelHandlerContext ctx) throws Exception { // (6)
 Channel incoming = ctx.channel();
 System.out.println("Client:"+incoming.remoteAddress()+"掉线");
 }

 @Override public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
 Channel incoming = ctx.channel();
 System.out.println("Client:"+incoming.remoteAddress()+"异常");
 // 当出现异常就关闭连接
 cause.printStackTrace();
 ctx.close();
 }

}
  1. TextWebSocketFrameHandler 继承自 SimpleChannelInboundHandler，这个类实现了 ChannelInboundHandler接口，ChannelInboundHandler 提供了许多事件处理的接口方法，然后你可以覆盖这些方法。现在仅仅只需要继承 SimpleChannelInboundHandler 类而不是你自己去实现接口方法。
  2. 覆盖了 handlerAdded() 事件处理方法。每当从服务端收到新的客户端连接时，客户端的 Channel 存入ChannelGroup 列表中，并通知列表中的其他客户端 Channel
  3. 覆盖了 handlerRemoved() 事件处理方法。每当从服务端收到客户端断开时，客户端的 Channel 自动从 ChannelGroup 列表中移除了，并通知列表中的其他客户端 Channel
  4. 覆盖了 channelRead0() 事件处理方法。每当从服务端读到客户端写入信息时，将信息转发给其他客户端的 Channel。其中如果你使用的是 Netty 5.x 版本时，需要把 channelRead0() 重命名为messageReceived()
  5. 覆盖了 channelActive() 事件处理方法。服务端监听到客户端活动
  6. 覆盖了 channelInactive() 事件处理方法。服务端监听到客户端不活动
  7. exceptionCaught() 事件处理方法是当出现 Throwable 对象才会被调用，即当 Netty 由于 IO 错误或者处理器在处理事件时抛出的异常时。在大部分情况下，捕获的异常应该被记录下来并且把关联的 channel 给关闭掉。然而这个方法的处理方式会在遇到不同异常的情况下有不同的实现，比如你可能想在关闭连接之前发送一个错误码的响应消息。

上面显示了 TextWebSocketFrameHandler 仅作了几件事：

  • 当WebSocket 与新客户端已成功握手完成，通过写入信息到 ChannelGroup 中的 Channel 来通知所有连接的客户端，然后添加新 Channel 到 ChannelGroup
  • 如果接收到 TextWebSocketFrame，调用 retain() ，并将其写、刷新到 ChannelGroup，使所有连接的 WebSocket Channel 都能接收到它。和以前一样，retain() 是必需的，因为当 channelRead0（）返回时，TextWebSocketFrame 的引用计数将递减。由于所有操作都是异步的，writeAndFlush() 可能会在以后完成，我们不希望它来访问无效的引用。

由于 Netty 处理了其余大部分功能，唯一剩下的我们现在要做的是初始化 ChannelPipeline 给每一个创建的新的 Channel 。做到这一点，我们需要一个ChannelInitializer

WebsocketChatServerInitializer.java

public class WebsocketChatServerInitializer extends ChannelInitializer<SocketChannel> { //1 @Override public void initChannel(SocketChannel ch) throws Exception {//2
 ChannelPipeline pipeline = ch.pipeline();

 pipeline.addLast(new HttpServerCodec());
 pipeline.addLast(new HttpObjectAggregator(64*1024));
 pipeline.addLast(new ChunkedWriteHandler());
 pipeline.addLast(new HttpRequestHandler("/ws"));
 pipeline.addLast(new WebSocketServerProtocolHandler("/ws"));
 pipeline.addLast(new TextWebSocketFrameHandler());

 }
}

1.扩展 ChannelInitializer

2.添加 ChannelHandler　到 ChannelPipeline

initChannel() 方法设置 ChannelPipeline 中所有新注册的 Channel,安装所有需要的　 ChannelHandler。

WebsocketChatServer.java

编写一个 main() 方法来启动服务端。

public class WebsocketChatServer {

 private int port;

 public WebsocketChatServer(int port) {
 this.port = port;
 }

 public void run() throws Exception {

 EventLoopGroup bossGroup = new NioEventLoopGroup(); // (1)
 EventLoopGroup workerGroup = new NioEventLoopGroup();
 try {
 ServerBootstrap b = new ServerBootstrap(); // (2)
 b.group(bossGroup, workerGroup)
 .channel(NioServerSocketChannel.class) // (3)
 .childHandler(new WebsocketChatServerInitializer()) //(4)
 .option(ChannelOption.SO_BACKLOG, 128) // (5)
 .childOption(ChannelOption.SO_KEEPALIVE, true); // (6)

 System.out.println("WebsocketChatServer 启动了");

 // 绑定端口，开始接收进来的连接
 ChannelFuture f = b.bind(port).sync(); // (7) // 等待服务器 socket 关闭 。 // 在这个例子中，这不会发生，但你可以优雅地关闭你的服务器。
 f.channel().closeFuture().sync();

 } finally {
 workerGroup.shutdownGracefully();
 bossGroup.shutdownGracefully();

 System.out.println("WebsocketChatServer 关闭了");
 }
 }

 public static void main(String[] args) throws Exception {
 int port;
 if (args.length > 0) {
 port = Integer.parseInt(args[0]);
 } else {
 port = 8080;
 }
 new WebsocketChatServer(port).run();

 }
}
  1. NioEventLoopGroup 是用来处理I/O操作的多线程事件循环器，Netty 提供了许多不同的 EventLoopGroup 的实现用来处理不同的传输。在这个例子中我们实现了一个服务端的应用，因此会有2个 NioEventLoopGroup 会被使用。第一个经常被叫做‘boss’，用来接收进来的连接。第二个经常被叫做‘worker’，用来处理已经被接收的连接，一旦‘boss’接收到连接，就会把连接信息注册到‘worker’上。如何知道多少个线程已经被使用，如何映射到已经创建的Channel上都需要依赖于 EventLoopGroup 的实现，并且可以通过构造函数来配置他们的关系。
  2. ServerBootstrap 是一个启动 NIO 服务的辅助启动类。你可以在这个服务中直接使用 Channel，但是这会是一个复杂的处理过程，在很多情况下你并不需要这样做。
  3. 这里我们指定使用 NioServerSocketChannel 类来举例说明一个新的 Channel 如何接收进来的连接。
  4. 这里的事件处理类经常会被用来处理一个最近的已经接收的 Channel。SimpleChatServerInitializer 继承自ChannelInitializer 是一个特殊的处理类，他的目的是帮助使用者配置一个新的 Channel。也许你想通过增加一些处理类比如 SimpleChatServerHandler 来配置一个新的 Channel 或者其对应的ChannelPipeline 来实现你的网络程序。当你的程序变的复杂时，可能你会增加更多的处理类到 pipline 上，然后提取这些匿名类到最顶层的类上。
  5. 你可以设置这里指定的 Channel 实现的配置参数。我们正在写一个TCP/IP 的服务端，因此我们被允许设置 socket 的参数选项比如tcpNoDelay 和 keepAlive。请参考 ChannelOption 和详细的 ChannelConfig 实现的接口文档以此可以对ChannelOption 的有一个大概的认识。
  6. option() 是提供给NioServerSocketChannel 用来接收进来的连接。childOption() 是提供给由父管道 ServerChannel接收到的连接，在这个例子中也是 NioServerSocketChannel。
  7. 我们继续，剩下的就是绑定端口然后启动服务。这里我们在机器上绑定了机器所有网卡上的 8080 端口。当然现在你可以多次调用 bind() 方法(基于不同绑定地址)。

恭喜！你已经完成了基于 Netty 聊天服务端程序。

客户端

在程序的 resources 目录下，我们创建一个 WebsocketChatClient.html 页面来作为客户端

WebsocketChatClient.html

<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>WebSocket Chat</title> </head> <body> <script type="text/javascript"> var socket;
 if (!window.WebSocket) {
 window.WebSocket = window.MozWebSocket;
 }
 if (window.WebSocket) {
 socket = new WebSocket("ws://localhost:8080/ws");
 socket.onmessage = function(event) {
 var ta = document.getElementById('responseText');
 ta.value = ta.value + '\n' + event.data
 };
 socket.onopen = function(event) {
 var ta = document.getElementById('responseText');
 ta.value = "连接开启!";
 };
 socket.onclose = function(event) {
 var ta = document.getElementById('responseText');
 ta.value = ta.value + "连接被关闭";
 };
 } else {
 alert("你的浏览器不支持 WebSocket！");
 }

 function send(message) {
 if (!window.WebSocket) {
 return;
 }
 if (socket.readyState == WebSocket.OPEN) {
 socket.send(message);
 } else {
 alert("连接没有开启.");
 }
 }
 </script> <form onsubmit="return false;"> <h3>WebSocket 聊天室：</h3> <textarea id="responseText" style="width: 500px; height: 300px;"></textarea> <br> <input type="text" name="message" style="width: 300px" value="Welcome to www.waylau.com"> <input type="button" value="发送消息" onclick="send(this.form.message.value)"> <input type="button" onclick="javascript:document.getElementById('responseText').value=''" value="清空聊天记录"> </form> <br> <br> <a href="http://www.waylau.com/" >更多例子请访问 www.waylau.com</a> </body> </html>

逻辑比较简单，不累述。

运行效果

先运行 WebsocketChatServer，再打开多个浏览器页面实现多个 客户端访问 http://localhost:8080


源码

见 https://github.com/waylau/netty-4-user-guide-demos 中 websocketchat

参考

时间： 2024-02-27 12:33:42

Netty 实现 WebSocket 聊天功能的相关文章

android怎么实现聊天功能

问题描述 android怎么实现聊天功能 android实现聊天功能,有没有比较好的第三方的聊天API可以调用,实现比较简单的聊天功能 解决方案 建议使用easeMob或者融云 解决方案二: http://blog.csdn.net/beijingshi1/article/details/9464853 解决方案三: Android学习-聊天功能Android仿QQ实现聊天功能Netty 实现 WebSocket 聊天功能

WebSocket 和 Golang 实现聊天功能

这个示例应用程序展示了如何使用 WebSocket, Golang 和 jQuery 创建一个简单的web聊天应用程序.这个示例的源代码在 https://github.com/waylau/goChat . Running the example 运行示例 这个示例需要 Golang 开发环境. 该页面描述如何安装开发环境. 一旦你去启动和运行,您可以下载.构建和运行的例子, 使用命令: go get gary.burd.info/go-websocket-chat go-websocket-

使用JavaWeb webSocket实现简易的点对点聊天功能实例代码_java

首先给大家声明一点:需要 jdk 7 , tomcat需要支持websocket的版本  1.InitServlet    该类主要是用来初始化构造将来存储用户身份信息的map仓库,利用其初始化方法Init 初始化仓库, 利用其静态方法getSocketList 获得对应的用户身份信息.    webSocket ,我认为MessageInbound 用来识别登录人的信息,用它来找到对应的人,推送消息.每次登录都会产生一个MessageInbound.   这里的 HashMap<String,

MINA 实现聊天功能

在<MINA 快速入门>一文中,我们介绍了如何利用 MINA 快速构建一个 Time Server(时间服务器).在<Netty 实现聊天功能>一文,我们也介绍了如何用 Netty 实现聊天功能.由于 MINA 和 Netty 是同一个作者,架构类似,如果你掌握其中一个,学习另外一个也不是难事.现在我们就用 MINA 来实现聊天功能. 准备 JDK 7+ Maven 3.2.x MINA 2.x Eclipse 4.x 服务端 让我们从 handler (处理器)的实现开始,han

B/S架构实现聊天功能

问题描述 使用java实现简单的聊天功能,求大神赐教,还有消息记录怎么实现 解决方案 解决方案二:http接收消息轮询或者websocket接受消息不考虑集群的话,以上就够了,如果集群的话就要考虑集群之间的管理你是哪点不会?解决方案三:聊天功能,要解决消息推送的问题...推荐云推送(jpush,个推一类的框架),轮询是落后的方式,可以放弃拉..消息的历史保存当然是数据库拉..nosql也是可以...参考atitit.web推送实现方案集合-attilax的专栏-博客频道-CSDN...解决方案四

基于Java Socket实现一个简易在线聊天功能（一）_java

先给大家说下实现步骤分这样几大步: 1.使用awt组件和socket实现简单的单客户端向服务端持续发送消息: 2.结合线程,实现多客户端连接服务端发送消息: 3.实现服务端转发客户端消息至所有客户端,同时在客户端显示: 4.把awt组件生成的窗口界面改成前端jsp或者html展示的界面,java socket实现的客户端改为前端技术实现. 这里首先实现第一步的简单功能,难点在于: 1.没有用过awt组件,没有用过java相关的监听事件: 2.长时间没有使用socket进行客户端和服务端的交互,并

基于Socket.IO实现Android聊天功能代码示例

一.简述 Socket.IO是一个完全由JavaScript实现.基于Node.js.支持WebSocket的协议用于实时通信.跨平台的开源框架,它包括了客户端的JavaScript和服务器端的Node.js. 该种官方介绍看起来有点懵逼,简而言之就是:客户端可通过Socket.IO与服务器建立实时通信管道 二.应用 该下就是介绍Socket.IO通信管道的铺设.通信以及销毁工作. 2.1 引入Socket.io包 compile 'io.socket:socket.io-client:0.8.

使用Ajax实现聊天功能

简介:想要用 Asynchronous JavaScript and XML (Ajax) 聊天么?您是否希望弹出一个专用的.开 源 Web 聊天功能以响应系统事件并使您了解正在发生的事情,比如性能低于服务保证水平? developerWorks 的定期撰稿人 Judith Myerson 为系统管理员介绍了双面板(two-panel)聊天的理念, 这样就可以一方面交换私人消息,一方面向一般用户广播消息.她还提供了针对聊天服务器过载等问题的 解决方案,谈到了下载 Ajax Chat.更改配置以及

微软Outlook.com整合Google Talk聊天功能

  微软邮件服务Outlook.com近日整合谷歌Google Talk功能,这样用户在Outlook.com页面即可直接与Google Talk好友聊天.该功能在未来数日内将面向全球用户推出. 该新功能支持Outlook.com页面上的多项应用,如收件箱.日历.地址薄和SkyDrive等.例如,用户在写邮件的同时,即可与谷歌好聊天. 微软Outlook.com高级产品经理达梅什·麦塔(Dharmesh Mehta)周一曾表示:"用户反映,他们不从Gmail转投Outlook.com的原因之一是