闲人细嚼慢咽啃 Netty:模块依赖

本文以闲适的心态深入理解Netty,通过分析模块间的依赖关系,特别是netty-common模块和logging组件。介绍了如何查看Netty模块依赖,并探讨了InternalLogger接口和日志级别,以及日志框架的选择和实现,包括SLF4J、Log4J和JDK日志的优先级。最后,作者提及将探索JDK日志框架的实现。

前言

最近闲来无事,把 Netty In Action 这本书的前226页翻译了一遍。我说的翻译是开着google 翻译。看了后还是没有什么感觉。就想自己看看代码。反正就学不会,也没有项目的压力,那就走马观花的看吧。把自己想想成一只小狗,酒足饭饱后躺在沙堆里,咬着刚从坑里面刨出来的一根骨头。顺便记录一下,方便以后回顾。本着不学无术,看稀奇的态度,走到哪里,看到哪里,这里没有干货,也不能快速上手(我还没有跑过demo)。管它的,玩呗。

模块间依赖

idea 有提供看模块依赖的功能,只需要选中项目子模块,鼠标右键,选择 Diagrams, 再选择 Show Diagram… 。 接着在弹出框 Show Diagram Type 里面选择 Project modules 就可以看到项目的模块依赖关系了。如果想看全部的项目模块依赖,需要选择 netty-all 这个模块。

上一张图:
netty-all

netty-common 模块

从模块上看,几乎所有的模块都要依赖 netty-common 这个子模块。而这个子模块不依赖于任何其他模块。从名字上也可以看出,他是一个公用模块。存放一些其他模块要用的工具类: 比如日志(logging),并发(concurrent),常量定义类和数据接口工具类等。

netty util

netty-common logging

先看看 logging 这个包的类图吧:
netty logging package class diagrams
可以看到 InternalLogger 这个接口,算是日志这个功能萌发的起点了。它根据日志的级别定了打印日志的不同方式。日志级别是在 InternalLogLevel 这个类里面定义的。

  1. TRACE
  2. DEBUG
  3. INFO
  4. WARN
  5. ERROR

接口定义了打印日志的六种方式:

  • (String message) 直接打印日志消息
  • (String format, Object arg) 给出只能替换一个占位符的日志格式,arg 替换格式中唯一的一个 {} 占位符。
<think>我们正在解决用户关于Netty依赖项找不到的问题,特别是`io.netty:netty-transport`。根据引用[1],我们知道Netty的某些功能(如Unix域套接字)需要额外的包,但用户当前的问题是找不到`netty-transport`。引用[4]提供了一个Maven依赖示例,但版本较老(5.0.0.Alpha1),而引用[1]建议使用`netty-transport-native-unix-common`,但这不是用户需要的核心传输包。 用户的问题:找不到依赖项`io.netty:netty-transport`。 解决方法: 1. 确认项目构建工具(Maven/Gradle)并添加正确的依赖。 2. 确保版本号正确,且与其他Netty组件版本一致。 根据引用[1]和[4],我们可以推荐两种方式: - 方式1:引入整个`netty-all`(如引用[4]),但可能包含不必要的模块- 方式2:只引入需要的模块,如`netty-transport`。 步骤: ### 一、Maven项目添加依赖 #### 方法1:仅引入`netty-transport`(推荐) ```xml <dependency> <groupId>io.netty</groupId> <artifactId>netty-transport</artifactId> <version>4.1.100.Final</version> <!-- 使用最新稳定版 --> </dependency> ``` #### 方法2:引入整个Netty(适用于需要多个模块) ```xml <dependency> <groupId>io.netty</groupId> <artifactId>netty-all</artifactId> <version>4.1.100.Final</version> </dependency> ``` > **版本选择原则**: > - 检查项目其他依赖(如Redisson)要求的Netty版本(引用[1]提到版本需匹配) > - 若无特殊要求,使用最新稳定版(如`4.1.100.Final`) ### 二、Gradle项目添加依赖 ```groovy // 仅引入transport implementation 'io.netty:netty-transport:4.1.100.Final' // 或引入全部 implementation 'io.netty:netty-all:4.1.100.Final' ``` ### 三、验证依赖 1. **检查依赖冲突** 使用命令: ```bash mvn dependency:tree # Maven ./gradlew dependencies # Gradle ``` 查看是否有其他库引入了旧版本Netty导致冲突。 2. **强制统一版本(Maven)** 在`<dependencyManagement>`中锁定版本: ```xml <dependencyManagement> <dependencies> <dependency> <groupId>io.netty</groupId> <artifactId>netty-bom</artifactId> <version>4.1.100.Final</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> ``` 然后声明依赖时无需写版本号: ```xml <dependency> <groupId>io.netty</groupId> <artifactId>netty-transport</artifactId> </dependency> ``` ### 四、特殊场景处理(引用[1]) 若项目需要**Unix域套接字**支持,额外添加: ```xml <dependency> <groupId>io.netty</groupId> <artifactId>netty-transport-native-unix-common</artifactId> <version>4.1.100.Final</version> <!-- 必须与netty-transport版本一致 --> </dependency> ``` --- ### 常见问题排查 | 问题现象 | 解决方案 | |---------|---------| | 编译报错`ClassNotFoundException` | 确认依赖是否成功下载(检查本地仓库路径) | | 运行时出现`NoSuchMethodError` | 版本冲突,使用`mvn dependency:tree`排查并统一版本 | | 涉及Unix域套接字的功能失败 | 补充`netty-transport-native-unix-common`依赖[^1] | > **注意**:Netty 5.x仍处于Alpha阶段(引用[4]),生产环境建议使用4.x稳定版。 --- §§相关问题§§ 1. 如何解决Netty不同模块之间的版本冲突问题? 2. 使用Netty Unix域套接字需要哪些额外配置? 3. 如何确认项目中Netty依赖的实际版本? 4. Netty 4.x与5.x的主要区别是什么?</think>### 解决 Netty 依赖项 `io.netty:netty-transport` 找不到的问题 #### 一、问题根源分析 1. **核心依赖缺失** `netty-transport` 是 Netty 的核心模块,包含 `EventLoopGroup`、`Channel` 等关键组件(引用[1][3]) 2. **版本兼容性问题** - Redisson 等库依赖特定 Netty 版本(如 4.1.77.Final) - 版本不匹配会导致 `ClassNotFoundException`(引用[1]) #### 二、解决方案(Maven 项目) ##### 方法1:添加精确依赖(推荐) ```xml <dependency> <groupId>io.netty</groupId> <artifactId>netty-transport</artifactId> <version>4.1.100.Final</version> <!-- 与项目其他依赖版本一致 --> </dependency> ``` ##### 方法2:使用 BOM 统一管理版本 ```xml <dependencyManagement> <dependencies> <dependency> <groupId>io.netty</groupId> <artifactId>netty-bom</artifactId> <version>4.1.100.Final</version> <!-- 统一版本 --> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>io.netty</groupId> <artifactId>netty-transport</artifactId> <!-- 无需指定版本 --> </dependency> </dependencies> ``` #### 三、特殊场景处理 1. **需要 Unix 域套接字支持** 额外添加原生传输包(引用[1]): ```xml <dependency> <groupId>io.netty</groupId> <artifactId>netty-transport-native-unix-common</artifactId> <version>4.1.100.Final</version> <!-- 必须与核心版本一致 --> </dependency> ``` 2. **使用 Redisson 等框架** 检查框架要求的 Netty 版本: ```xml <!-- 示例:Redisson 3.17.7 要求 Netty 4.1.77.Final --> <dependency> <groupId>io.netty</groupId> <artifactId>netty-transport</artifactId> <version>4.1.77.Final</version> </dependency> ``` #### 四、验证依赖是否生效 1. **检查依赖树** ```bash mvn dependency:tree | grep netty-transport ``` 正常输出示例: ``` [INFO] | \- io.netty:netty-transport:jar:4.1.100.Final:compile ``` 2. **运行时验证代码** ```java public class DependencyCheck { public static void main(String[] args) { // 能正常执行说明依赖正确 EventLoopGroup group = new NioEventLoopGroup(); System.out.println("Netty transport loaded successfully"); group.shutdownGracefully(); } } ``` #### 五、常见错误排查 | 错误类型 | 原因 | 解决方案 | |---------|------|---------| | `ClassNotFoundException: io.netty.channel.EventLoopGroup` | 依赖未正确引入 | 检查`pom.xml`作用域(应为`compile`) | | `NoSuchMethodError` | 版本冲突 | 执行`mvn dependency:tree` 排查多版本 | | `UnsatisfiedLinkError` | 缺少原生依赖 | 添加`netty-transport-native-unix-common`[^1] | > **关键提示**: > - 生产环境避免使用 Netty 5.x(仍为 Alpha 阶段,引用[4]) > - 异步操作需通过 `ChannelFuture` 处理结果(引用[2]) ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值