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 框架以及高并发长连接应用。
按自己的节奏,确认真正理解。