架构师都必须掌握的java项目日志框架使用,适配,桥接

写作目的

1. 了解slf4j 和其他日志框架集成
2. 学习日志框架的切换和嫁接
3. 如何处理第三方项目的日志依赖问题
4. 熟悉 log4j-over-slf4j.jar, log4j-slf4j-impl.jar 等包, 看完本文内容,从此不怕日志依赖处理.

本文讨论并不设置某个日志框架的具体配置,只是介绍其他日志框架和slf4j 的切换与桥接,以及各日志框架的简单使用.

各种包介绍

1. log4j
   • log4j : 实现和接口都在这个包
2. log4j2
   • log4j-core : 核心包,日志实现
   • log4j-api : 日志api
3. logback
   • logback-core : logback 核心包
   • logback-classic : 实现包,实现了slf4j-api
4. commons-logging
   • commons-logging : jcl的原生全部内容
   • log4j-jcl : jcl到log4j2的桥梁 , 使用jcl的实现, 但是使用log4j2的接口
   • jcl-over-slf4j ：jcl到slf4j的桥梁,使用slf4j 的api, 日志打印 实现使用jcl

桥接器包

什么是桥接器, 就是某个日志的具体实现, 要想配合slf4j的api使用, 但是在使用slf4j 的api的打印, 无法找到对应的实现类,
这个时候需要第三方包桥接一下, 当slf4j 打印日志的时候,交给具体的日志实现类.

1. slf4j-jdk14 ：slf4j到jdk-logging的桥梁
2. slf4j-log4j12 ：slf4j到log4j1的桥梁
3. log4j-slf4j-impl ：slf4j到log4j2的桥梁
4. logback-classic ：slf4j到logback的桥梁
5. slf4j-jcl ：slf4j到commons-logging的桥梁

切换器包

什么是切换器, 就是当一个模块使用了他自己的日志实现和api , 但是想将日志的输出交给slf4j 管理. 这个时候需要一个切换器将第三方模块的日志切换到slf4j.

1. jul-to-slf4j ：jdk-logging到slf4j的切换器
2. log4j-over-slf4j ：log4j1到slf4j的切换器
3. jcl-over-slf4j ：commons-logging到slf4j的切换器

截至本文发布, 目前没有找到关于log4j2 切换到slf4j 的切换器.

日志方案:

直接使用api和实现

1. 直接使用java common log 模块: use-jcl-log
2. 直接使用log4j 的api和实现 模块: use-log4j
3. 直接使用log4j2 的api和实现 模块: use-log4j2-impl-and-log4j2-api
4. 直接使用jdk-logging 实现和api 模块: use-jdk-logging
5. 直接使用slf4j-api和slf4j-simple简单的日志实现 模块: slf4j-sample-impl

使用slf4j自带

1. 使用slf4j的api,没有任何实现 模块: nologImpl
2. 使用slf4j的api, 并且同时使用slf4f-nop,和slf4j-sample 实现 模块: multilogImpl

使用第三方实现 和slf4j 的api

1. 使用log4j 的实现,结合slf4j 的api 模块: user-log4jImpl-and-slf4japi
2. 使用jdk的实现,结合slf4j 的api 模块: use-jdk-logging-imple-and-sl4j-api
3. 使用 jcl 日志实现,结合slf4j的api 模块: use-jcl-imple-and-slf4j-api
4. 使用logback的日志实现,结合slf4j的api 模块: use-logback-imple-and-slf4j-api
5. 使用log4j2 的日志实现,结合slf4j 的api 模块: use-log4j2-imple-and-slf4j-api

日志切换器,引用的模块使用了自己的日志实现和api, 将日志输出切换到slf4j 上面 (项目中常用,常见依赖处理)

1. jcl 切换到 slf4j , 最终由logback 打印 模块: remove-common-logging-use-slf4j
2. log4j 切换到 slf4j ,最终由logback 打印 模块: remove-log4j-use-slf4j-and-use-logback-impl
3. jdk logging 切换到 slf4j,最终由logback 打印 模块: remove-jdk-loggin-use-slf4j-and-logback-impl

由于作者水平有限, 出现的错误请多多包含. 烦请指点一二.
转载请注明文章出处

本文所有代码: https://gitee.com/imomoda/log4-study
参考slf4j官方文档: http://www.slf4j.org/manual.html