Java 后端 / 系统课时

开发第一个 Netty 服务

开发第一个 Netty 服务

本课通过最小可运行示例搭建 Netty TCP 服务端和客户端,理解启动器、Channel、Pipeline 与 EventLoop 如何协作完成一次完整网络通信。

学习目标

  • 掌握 Netty 服务端启动流程和核心组件配置
  • 编写完整客户端连接服务端并完成消息交互
  • 理解 EventLoop 在网络事件处理中的职责

创建基础 Netty 服务端

Netty 服务端启动主要包括创建线程模型、指定 Channel 类型、初始化 Pipeline 和绑定端口。ServerBootstrap 负责组装这些配置,并启动监听流程。

java
import io.netty.bootstrap.ServerBootstrap;
import io.netty.channel.ChannelInitializer;
import io.netty.channel.ChannelOption;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioServerSocketChannel;

public class NettyServer {
    public static void main(String[] args) throws Exception {
        NioEventLoopGroup boss = new NioEventLoopGroup();
        NioEventLoopGroup worker = new NioEventLoopGroup();

        try {
            ServerBootstrap bootstrap = new ServerBootstrap();
            bootstrap.group(boss, worker)
                .channel(NioServerSocketChannel.class)
                .childOption(ChannelOption.SO_KEEPALIVE, true)
                .childHandler(new ChannelInitializer<SocketChannel>() {
                    @Override
                    protected void initChannel(SocketChannel ch) {
                        ch.pipeline().addLast(new ServerHandler());
                    }
                });

            bootstrap.bind(<PORT>).sync().channel().closeFuture().sync();
        } finally {
            boss.shutdownGracefully();
            worker.shutdownGracefully();
        }
    }
}

预期输出

text
Netty server started and listening on port <PORT>

实际端口可能不同,生产环境应通过配置文件管理端口和线程参数。

实现消息处理 Handler

Pipeline 中的 Handler 负责处理进入的数据并生成响应。示例使用字符串消息演示请求接收和响应返回过程。

java
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.SimpleChannelInboundHandler;

public class ServerHandler extends SimpleChannelInboundHandler<String> {
    @Override
    protected void channelRead0(ChannelHandlerContext ctx, String msg) {
        System.out.println("client message: " + msg);
        ctx.writeAndFlush("response: " + msg);
    }
}

预期结果

text
client message: hello
response: hello

编写完整 Netty 客户端

客户端使用 Bootstrap 创建连接。与服务端不同,客户端只需要一个 EventLoopGroup,并且需要在结束后释放资源,避免线程泄漏。

java
import io.netty.bootstrap.Bootstrap;
import io.netty.channel.ChannelInitializer;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioSocketChannel;

public class NettyClient {
    public static void main(String[] args) throws Exception {
        NioEventLoopGroup group = new NioEventLoopGroup();

        try {
            Bootstrap bootstrap = new Bootstrap();
            bootstrap.group(group)
                .channel(NioSocketChannel.class)
                .handler(new ChannelInitializer<SocketChannel>() {
                    @Override
                    protected void initChannel(SocketChannel ch) {
                        ch.pipeline().addLast(new ClientHandler());
                    }
                });

            bootstrap.connect("127.0.0.1", <PORT>).sync();
            System.out.println("client connected");
        } finally {
            group.shutdownGracefully();
        }
    }
}

预期结果

text
client connected

实际连接地址和端口可能不同,需要与服务端监听配置保持一致。

验证完整通信流程

一次 TCP 通信中,客户端通过 Channel 建立连接,EventLoop 负责监听网络事件,Pipeline 按顺序调用 Handler 处理数据,最终通过 Channel 返回响应。

验证时重点检查:

  • 服务端是否成功监听端口。
  • 客户端是否建立连接。
  • Handler 是否收到消息并返回响应。
  • 资源释放是否正常执行。

掌握启动器、EventLoop、Channel 和 Pipeline 的协作关系后,就可以进一步扩展 Netty HTTP 服务、RPC 框架以及高并发长连接应用。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

开发第一个 Netty 服务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通