• 日期: 2027-07-18
  • 标签: 常规

Netty 多人聊天室：基于字符串协议的聊天应用实现

本代码示例演示使用 Netty 框架构建多人聊天室应用，自定义字符串协议，实现用户登录、聊天室列表、群聊和私聊等功能。

代码示例

package org.example;
import io.netty.bootstrap.ServerBootstrap;
import io.netty.channel.ChannelFuture;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.ChannelInitializer;
import io.netty.channel.ChannelOption;
import io.netty.channel.EventLoopGroup;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioServerSocketChannel;
import io.netty.handler.codec.string.StringDecoder;
import io.netty.handler.codec.string.StringEncoder;
import io.netty.util.concurrent.DefaultEventExecutorGroup;
import io.netty.util.concurrent.EventExecutorGroup;

import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;

public class MultiChatServer {
    private final int port;
    private final ConcurrentHashMap<String, ChannelHandlerContext> userMap = new ConcurrentHashMap<>();
    private final EventExecutorGroup group = new DefaultEventExecutorGroup(16);

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

    public void run() throws Exception {
        EventLoopGroup bossGroup = new NioEventLoopGroup();// 创建主线程组
        EventLoopGroup workerGroup = new NioEventLoopGroup();// 创建工作线程组
        try {
            ServerBootstrap b = new ServerBootstrap();// 配置服务器启动参数
            b.group(bossGroup, workerGroup)
                    .channel(NioServerSocketChannel.class)
                    .childHandler(new ChannelInitializer<SocketChannel>() {
                        @Override
                        public void initChannel(SocketChannel ch) throws Exception {
                            ch.pipeline().addLast(new StringDecoder(), new StringEncoder(), new MultiChatServerHandler(userMap, group));
                        // 添加处理器到通道的pipeline中
                        }
                    })
                    .option(ChannelOption.SO_BACKLOG, 128)
                    .childOption(ChannelOption.SO_KEEPALIVE, true);

            ChannelFuture f = b.bind(port).sync(); // 绑定端口并启动服务器
            f.channel().closeFuture().sync(); // 等待服务器关闭
        } finally {
            workerGroup.shutdownGracefully(); // 关闭工作线程组
            bossGroup.shutdownGracefully(); // 关闭主线程组
        }
    }

    public static void main(String[] args) throws Exception {
        int port = 8080;
        // 创建服务器实例并运行
        new MultiChatServer(port).run(); // 创建服务器实例并运行
    }
}

package org.example;
import io.netty.channel.ChannelFuture;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.SimpleChannelInboundHandler;
import io.netty.util.concurrent.EventExecutorGroup;

import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
//MultiChatServerHandler类，实现服务器端的消息处理逻辑，包括用户登录、聊天室列表、消息发送和私聊功能。
public class MultiChatServerHandler extends SimpleChannelInboundHandler<String> {
    // 用户映射表，用于保存用户和上下文的映射关系
    private final ConcurrentHashMap<String, ChannelHandlerContext> userMap;
    private final EventExecutorGroup group;
    // 构造函数，初始化用户映射表和事件执行器组
    public MultiChatServerHandler(ConcurrentHashMap<String, ChannelHandlerContext> userMap, EventExecutorGroup group) {
        this.userMap = userMap;
        this.group = group;
    }
    // 当客户端连接到服务器时调用的方法
    @Override
    public void channelActive(ChannelHandlerContext ctx) throws Exception {
        System.out.println('Client connected: ' + ctx.channel().remoteAddress()); // 客户端连接时输出连接地址
    }
    // 当客户端断开连接时调用的方法
    @Override
    public void channelInactive(ChannelHandlerContext ctx) throws Exception {
        System.out.println('Client disconnected: ' + ctx.channel().remoteAddress()); // 客户端断开连接时输出连接地址
        userMap.values().remove(ctx); // 从用户列表中移除断开连接的客户端
    }
    // 接收到客户端消息时调用的方法
    @Override
    protected void channelRead0(ChannelHandlerContext ctx, String msg) throws Exception {
////
        if (msg.contains(ctx.channel().remoteAddress().toString())) { // 只有当消息中包含当前客户端的地址时，才打印消息
            System.out.println(msg);
        }
////
        String[] tokens = msg.split('\|'); // 以'|'分割消息
        String command = tokens[0]; // 获取命令类型

        switch (command) {
            case 'LOGIN':
                handleLogin(ctx, tokens[1], tokens[2]); // 处理登录命令
                break;
            case 'LIST':
                handleList(ctx); // 处理获取聊天室列表命令
                break;
            case 'MSG':
                handleMessage(ctx, tokens[1], tokens[2]); // 处理发送消息命令
                break;
            case 'PRIVATE':
                handlePrivateMessage(ctx, tokens[1], tokens[2]); // 处理发送私聊消息命令
                break;
            case 'RECEIVED':
                handleReceivedMessage(ctx, tokens[1]); // 处理接收到消息的确认命令
                break;

            default:
                ctx.writeAndFlush('Invalid command: ' + command); // 发送无效命令的错误消息
                break;
        }
    }

    private void handleLogin(ChannelHandlerContext ctx, String username, String password) {
        if (userMap.containsKey(username)) { // 如果用户已经登录则发送错误消息
            ctx.writeAndFlush('User already logged in: ' + username);
        } else {
            userMap.put(username, ctx); // 将用户添加到用户列表中
            ctx.writeAndFlush('Login successful: ' + username); // 发送登录成功消息
        }
    }

    private void handleList(ChannelHandlerContext ctx) {
        StringBuilder sb = new StringBuilder();
        sb.append('Available chat rooms:
');
        for (Map.Entry<String, ChannelHandlerContext> entry : userMap.entrySet()) {
            sb.append(entry.getKey()).append('
'); // 将聊天室名称添加到消息中
        }
        ctx.writeAndFlush(sb.toString()); // 发送聊天室列表消息
    }
/*
    private void handleMessage(ChannelHandlerContext ctx, String roomName, String message) {
        StringBuilder sb = new StringBuilder();
        sb.append('[').append(ctx.channel().remoteAddress()).append('] ').append(message).append('
');
        for (Map.Entry<String, ChannelHandlerContext> entry : userMap.entrySet()) {
            if (entry.getKey().equals(roomName) && entry.getValue() == ctx) { // 只有当接收消息的客户端与当前客户端相同时，才发送消息给客户端
                entry.getValue().writeAndFlush(sb.toString());
            }
        }
    }


 */
//群发
    private void handleMessage(ChannelHandlerContext ctx, String roomName, String message) {
        StringBuilder sb = new StringBuilder();
        sb.append('[').append(ctx.channel().remoteAddress()).append('] ').append(message).append('
');
        for (Map.Entry<String, ChannelHandlerContext> entry : userMap.entrySet()) {
            if (entry.getKey().equals(roomName)) { // 找到指定聊天室的客户端并发送消息
                entry.getValue().writeAndFlush(sb.toString());
            }
        }
    }

    //私发

    private void handlePrivateMessage(ChannelHandlerContext ctx, String recipient, String message) {
        StringBuilder sb = new StringBuilder();
        sb.append('[').append(ctx.channel().remoteAddress()).append('] (private) ').append(message).append('
');
        if (userMap.containsKey(recipient)) { // 找到指定收件人的客户端并发送私聊消息
            userMap.get(recipient).writeAndFlush(sb.toString());
        } else {
            ctx.writeAndFlush('User not found: ' + recipient); // 发送收件人未找到的错误消息
        }
    }
    ////
    private void handleReceivedMessage(ChannelHandlerContext ctx, String message) {
        if (message.contains(ctx.channel().remoteAddress().toString())) { // 只有当消息中包含当前客户端的地址时，才打印消息
            System.out.println(message);
        }
    }
    ///
/*
    private void handleReceivedMessage(ChannelHandlerContext ctx, String message) {
        System.out.println('Received message: ' + message); // 处理接收到的消息的确认命令
    }


 */
    // 异常处理方法，打印异常信息并关闭连接
    @Override
    public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
        cause.printStackTrace();
        ctx.close();
    }
}


package org.example;
import io.netty.bootstrap.Bootstrap;
import io.netty.channel.ChannelFuture;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.ChannelInitializer;
import io.netty.channel.ChannelOption;
import io.netty.channel.EventLoopGroup;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioSocketChannel;
import io.netty.handler.codec.string.StringDecoder;
import io.netty.handler.codec.string.StringEncoder;

import java.io.BufferedReader;
import java.io.InputStreamReader;

public class MultiChatClient {
    private final String host;
    private final int port;
    private ChannelHandlerContext ctx;

    public MultiChatClient(String host, int port) {
        this.host = host;
        this.port = port;
    }

    public void run() throws Exception {
        EventLoopGroup group = new NioEventLoopGroup(); // 创建一个NioEventLoopGroup对象用于处理I/O操作
        try {
            Bootstrap b = new Bootstrap();// 创建一个Bootstrap对象用于配置客户端
            b.group(group)
                    .channel(NioSocketChannel.class)// 指定使用NioSocketChannel作为客户端通道的实现
                    .option(ChannelOption.SO_KEEPALIVE, true)// 设置TCP连接的KeepAlive选项为true
                    .handler(new ChannelInitializer<SocketChannel>() {// 设置ChannelInitializer用于初始化通道
                        @Override
                        public void initChannel(SocketChannel ch) throws Exception {
                            ch.pipeline().addLast(new StringDecoder(), new StringEncoder(), new MultiChatClientHandler());
                            // 添加StringDecoder、StringEncoder和MultiChatClientHandler到通道的pipeline中
                        }
                    });

            ChannelFuture f = b.connect(host, port).sync(); // // 连接服务器并获取ChannelFuture对象
            ctx = f.channel().pipeline().context(MultiChatClientHandler.class);// 获取MultiChatClientHandler的ChannelHandlerContext对象
            BufferedReader in = new BufferedReader(new InputStreamReader(System.in));// 创建一个BufferedReader用于读取用户输入的消息
            while (true) {
                String line = in.readLine(); //// 读取用户输入的消息
                if (line == null) {// 如果输入的消息为空，则退出循环
                    break;
                }

                ctx.writeAndFlush(line + '
'); // 发送消息给服务器
            }
        } finally {
            group.shutdownGracefully(); // 关闭线程组
        }
    }

    public static void main(String[] args) throws Exception {
        String host = 'localhost';// 设置服务器主机名
        int port = 8080;
        new MultiChatClient(host, port).run(); // 创建客户端实例并运行
    }
}

package org.example;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.SimpleChannelInboundHandler;

public class MultiChatClientHandler extends SimpleChannelInboundHandler<String> {
    @Override
    protected void channelRead0(ChannelHandlerContext ctx, String msg) throws Exception {
        System.out.println(msg); // 打印接收到的消息
    }

    @Override
    public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
        cause.printStackTrace(); // 打印异常堆栈信息
        ctx.close(); // 打印异常堆栈信息
    }
}

自定义协议

  1. 消息格式: 使用竖线 (|) 作为分隔符
  2. 命令类型:
    • LOGIN: 登录命令，格式为 LOGIN|用户名|密码
    • LIST: 获取聊天室列表命令，格式为 LIST
    • MSG: 发送消息命令，格式为 MSG|聊天室名称|消息内容
    • PRIVATE: 发送私聊消息命令，格式为 PRIVATE|收件人用户名|消息内容
    • RECEIVED: 接收到消息的确认命令，格式为 RECEIVED|消息内容

服务器端实现

  1. ServerBootstrap: 配置服务器启动参数，指定使用 NioServerSocketChannel 作为服务器通道，并设置 SO_BACKLOG 和 SO_KEEPALIVE 选项
  2. ChannelInitializer: 初始化通道，添加 StringDecoder、StringEncoder 和 MultiChatServerHandler 处理器到通道的 pipeline 中
  3. MultiChatServerHandler: 处理客户端消息
    • channelActive: 客户端连接时输出连接地址
    • channelInactive: 客户端断开连接时输出连接地址并从 userMap 中移除客户端
    • channelRead0: 处理客户端消息
      • 分割消息，获取命令类型
      • 根据命令类型调用对应的方法：
        • handleLogin: 处理登录命令，验证用户名和密码，并将其添加到 userMap 中
        • handleList: 处理获取聊天室列表命令，将所有聊天室名称发送给客户端
        • handleMessage: 处理发送消息命令，将消息发送到指定的聊天室
        • handlePrivateMessage: 处理发送私聊消息命令，将消息发送给指定的收件人
        • handleReceivedMessage: 处理接收到消息的确认命令
  4. ConcurrentHashMap userMap: 用于保存用户和上下文的映射关系

客户端实现

  1. Bootstrap: 配置客户端启动参数，指定使用 NioSocketChannel 作为客户端通道，并设置 SO_KEEPALIVE 选项
  2. ChannelInitializer: 初始化通道，添加 StringDecoder、StringEncoder 和 MultiChatClientHandler 处理器到通道的 pipeline 中
  3. MultiChatClientHandler: 处理接收到的消息并打印到控制台

代码说明

  • 服务器和客户端使用 StringDecoder 和 StringEncoder 将字符串编码成字节数组或将字节数组解码成字符串
  • 服务器使用 ConcurrentHashMap 保存用户和上下文的映射关系，方便查找用户对应的连接
  • 服务器和客户端的 handler 类都实现了 SimpleChannelInboundHandler 接口，用于处理接收到的消息
  • 客户端使用 BufferedReader 从控制台读取用户输入的消息，并发送给服务器

总结

本代码示例演示了使用 Netty 框架构建多人聊天室应用，自定义字符串协议，实现用户登录、聊天室列表、群聊和私聊等功能。代码简洁易懂，可以作为学习 Netty 框架和构建聊天应用的参考。

Netty 多人聊天室：基于字符串协议的聊天应用实现

原文地址: https://www.cveoy.top/t/topic/f3DM 著作权归作者所有。请勿转载和采集!

免费AI点我,无需注册和登录