Netty教程 / 第 901 节

附录合集（A-E）

本文档包含 Netty 教程的所有附录内容，提供额外的参考资料和实用工具。

附录A：Netty API 速查表

A.1 核心类

类名	用途	常用方法
ServerBootstrap	服务端启动器	group(), channel(), childHandler(), bind()
Bootstrap	客户端启动器	group(), channel(), handler(), connect()
Channel	网络通道	read(), write(), close(), isActive()
ChannelPipeline	处理器链	addLast(), addFirst(), remove()
ByteBuf	字节缓冲区	readByte(), writeByte(), release()
EventLoopGroup	事件循环组	next(), shutdownGracefully()

A.2 常用Handler

Handler	用途
StringDecoder	字符串解码
StringEncoder	字符串编码
LineBasedFrameDecoder	行分隔符解码
LengthFieldBasedFrameDecoder	长度字段解码
IdleStateHandler	空闲检测
HttpServerCodec	HTTP编解码
WebSocketServerProtocolHandler	WebSocket协议

A.3 ChannelOption

选项	说明	推荐值
SO_BACKLOG	连接队列大小	1024
TCP_NODELAY	禁用Nagle算法	true
SO_KEEPALIVE	启用TCP保活	true
SO_RCVBUF	接收缓冲区大小	128KB
SO_SNDBUF	发送缓冲区大小	128KB
ALLOCATOR	ByteBuf分配器	PooledByteBufAllocator.DEFAULT

附录B：常见问题 FAQ

B.1 基础问题

Q1: Netty 和 NIO 的关系？ A: Netty 是基于 Java NIO 的网络框架，封装了 NIO 的复杂性，提供更易用的 API。

Q2: 为什么选择 Netty？ A: 高性能、易用、稳定、社区活跃、被广泛应用于生产环境。

Q3: Netty 适合什么场景？ A: RPC 框架、IM 系统、游戏服务器、网关、消息中间件等高性能网络应用。

B.2 性能问题

Q4: 如何提升 Netty 性能？ A:

使用池化 ByteBuf
使用直接内存
禁用 Nagle 算法
增大缓冲区
使用零拷贝
业务逻辑异步化

Q5: 如何避免内存泄漏？ A:

使用 SimpleChannelInboundHandler
手动释放 ByteBuf
启用内存泄漏检测

B.3 开发问题

Q6: 如何解决粘包/拆包？ A: 使用 LengthFieldBasedFrameDecoder 或自定义协议。

Q7: 如何实现心跳检测？ A: 使用 IdleStateHandler 或自定义心跳机制。

Q8: 如何集成 Spring Boot？ A: 创建 @Component 组件，在 @PostConstruct 中启动服务器。

附录C：性能测试工具

C.1 压力测试工具

1. Apache JMeter

下载：https://jmeter.apache.org/
用途：HTTP/WebSocket 压力测试

2. wrk

# 安装
brew install wrk  # macOS
apt-get install wrk  # Ubuntu

# 使用
wrk -t12 -c400 -d30s http://localhost:8080

3. Gatling

下载：https://gatling.io/
用途：高性能负载测试

C.2 性能分析工具

1. JProfiler

CPU 分析
内存分析
线程分析

2. VisualVM

JVM 监控
线程dump
堆dump

3. Arthas

# 启动
java -jar arthas-boot.jar

# 常用命令
dashboard  # 仪表板
thread     # 线程信息
jvm        # JVM信息
monitor    # 方法监控

附录D：学习资源

D.1 官方资源

官方网站

https://netty.io/

官方文档

https://netty.io/wiki/

GitHub

https://github.com/netty/netty

D.2 推荐书籍

《Netty in Action》
- 作者：Norman Maurer, Marvin Allen Wolfthal
- 评价：Netty 官方推荐
《Netty 权威指南》
- 作者：李林锋
- 评价：中文经典
《Netty 实战》
- 作者：诺曼·毛瑞尔
- 评价：实战性强

D.3 在线教程

Netty 官方示例：https://github.com/netty/netty/tree/4.1/example
Netty 用户指南：https://netty.io/wiki/user-guide.html

D.4 社区资源

Stack Overflow：https://stackoverflow.com/questions/tagged/netty
Google Groups：https://groups.google.com/g/netty

附录E：开发工具推荐

E.1 IDE

IntelliJ IDEA

推荐插件：
- Lombok
- Maven Helper
- Rainbow Brackets
- Key Promoter X

Eclipse

推荐插件：
- Buildship (Gradle)
- M2Eclipse (Maven)

E.2 构建工具

Maven

<dependency>
    <groupId>io.netty</groupId>
    <artifactId>netty-all</artifactId>
    <version>4.1.100.Final</version>
</dependency>

Gradle

implementation 'io.netty:netty-all:4.1.100.Final'

E.3 调试工具

1. Wireshark

网络抓包分析

2. tcpdump

tcpdump -i any port 8080 -w capture.pcap

3. netstat

# 查看连接状态
netstat -an | grep 8080

# 查看连接数
netstat -an | grep 8080 | wc -l

E.4 监控工具

1. Prometheus + Grafana

指标收集和可视化

2. Micrometer

@Bean
public MeterRegistry meterRegistry() {
    return new SimpleMeterRegistry();
}

3. Spring Boot Actuator

management:
  endpoints:
    web:
      exposure:
        include: "*"

附录总结

本附录提供了：

✅ API 速查表 - 快速查找常用 API
✅ 常见问题 FAQ - 解答常见疑问
✅ 性能测试工具 - 压力测试和性能分析
✅ 学习资源 - 官方文档、书籍、教程
✅ 开发工具 - IDE、构建工具、调试工具、监控工具

🎓 学习建议

收藏本附录：作为日常开发的参考手册
实践为主：理论结合实践
持续学习：关注 Netty 社区动态
分享交流：参与社区讨论

📞 获取帮助

如果遇到问题，可以通过以下渠道获取帮助：

官方文档：https://netty.io/wiki/
Stack Overflow：搜索或提问
GitHub Issues：报告 bug 或提出建议
Google Groups：参与讨论

祝您学习愉快，成为 Netty 专家！ 🚀