logback的架构
# 模块划分
当前 logback 被分为了三个模块
- logback-core,为其他两个模块提供基础功能
- logback-classic,是一个相对于 log4j 的显著改进版本,实现了 slf4j 的 api,所以可以轻松的切换其他日志框架,比如 jul
- logback-access.提供了 servlet 容器的 http 访问日志记录的功能
# Logger,Appenders 和 Layouts
这个 logback 建立在这三个主要的类上面,这三个组件提供了,允许开发着在选择何种等级的日志(Appenders) 、控制日志的格式(Layouts)、和在哪里打日志(logger)
Logger 是在 logback-classic 中的、Appenders 和 Layouts 是在 logback-core 中的。
# Logger
# 名称继承
通常情况下,我们给 Logger 命名都是通过类的全限定类名。
LoggerContext 负责创建 Logger,并且按照树一样的格式来进行管理,所以 Logger 也是分等级的,root logger 就是顶端,分级规则也很简单,就是通过一个英文点来进行分,比如 com.unclezs.log,名字为 com.unclezs 的 Logger 就比名字为 com.unclezs.log 的 Logger 等级高。
获取 root logger:
Logger rootLogger = LoggerFactory.getLogger(org.slf4j.Logger.ROOT_LOGGER_NAME);
# 日志级别与继承的关系
slf4j 提供的日志级别 TRACE, DEBUG, INFO, WARN 和 ERROR
TRACE < DEBUG < INFO < WARN < ERROR.
获取日志的有效等级,当一个 log.xx 方法执行时,如果当前命名空间没有对应 Level,就会根去查找祖先节点的日志级别,直到找到为止
判断日志是否会被打印:
摘自官方文档:
A log request of level p issued to a logger having an effective level q, is enabled if p >= q.
比如 com.unclezs.a 配置的 logger 日志级别为 info com.unclezs.a.b 配置的 logger 日志级别为 error 在 com.unclezs.a.b 调用 log.warn
得到有效日志等级为 error,请求日志等级为 warn,warn < error 则不打印
# 检索 Logger
通常情况下我们都是通过 Clazz.class 来获取 Logger,但是也可以传入他的全限定类名。
当然这个名字都是自己定义的,你可以命名为 abc,bcd 之类的,但是没有什么意义,安装全限定类名进行命名可以很好的利用日志级别按照名称继承等级的好处。
# Appender
Appender 允许我们将日志打到各种地方,可以是控制台,可以是文件,也可以是数据库、JML 等等
一个 logger 可以拥有多个 Appender,并且都会执行,所以你可以通过一个 logger 就能把日志打到控制台和文件。
Appender 也是有累加性质的,也就是会查看父及 logger 有没有 Appender ,如果有,则一起执行。可以在 logger 上配置 additivity=false 来关闭这个特性。
# Layout
Appender 的子节点,定义日志的格式。
%-4relative [%thread] %-5level %logger{32} - %msg%n
输出
176 [main] DEBUG manual.architecture.HelloWorld2 - Hello world.
第一个参数代表程序启动后所过时间。
# 参数化打印日志
下面这种方式会引起 不论是否启用日志记录,都会有构造消息参数的消耗(类型转换)
logger.debug("Entry number: " + i + " is " + String.valueOf(entry[i]));
通常情况下通过下面这种防止来防止消息参数的构造消耗,但是通过这种方法如果日志是开启的情况下,还是会出现同样的情况,甚至还多了个 boolean 类型的判断消耗
if(logger.isDebugEnabled()) {
logger.debug("Entry number: " + i + " is " + String.valueOf(entry[i]));
}
2
3
更好的方案,这样的操作的好处就是,在不进行日志打印的时候,不会进行消息参数构造,也就不会有类型转换的消耗。
logger.debug("The new entry is {}.", entry);
logger.debug("Value {} was inserted between {} and {}.", paramArray);
2