如何将应用的log4j替换成logback详解

前言

     最近考虑到log4j很久不更新、性能相对弱，以及一些项目本身的原因，经过较为谨慎的考虑，决定改用logback。如果你已经对log4j很熟悉，你也可以很快上手logback。如果你喜欢使用log4j,你也许会迷上使用logback。迁移还是比较顺利的，花了1个小时左右就搞定了，做个简单的笔记。

方法如下

(1) 首先去掉所有log4j相关的依赖，主要有：

?

1 2 3 4

<dependency>   <groupId>log4j</groupId>   <artifactId>log4j</artifactId> </dependency>

以及：

?

1 2 3 4

<dependency>   <groupId>org.slf4j</groupId>   <artifactId>slf4j-log4j12</artifactId> </dependency>

(2) 为项目添加以下依赖：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

<!-- logback日志配置开始 --> <dependency>   <groupId>ch.qos.logback</groupId>   <artifactId>logback-core</artifactId> </dependency> <dependency>   <groupId>ch.qos.logback</groupId>   <artifactId>logback-access</artifactId> </dependency> <dependency>   <groupId>ch.qos.logback</groupId>   <artifactId>logback-classic</artifactId> </dependency> <dependency>   <groupId>org.slf4j</groupId>   <artifactId>log4j-over-slf4j</artifactId> </dependency> <!-- logback日志配置结束 -->

(3) 删除项目/src/main/resources目录下的log4j.properties，并在该目录添加logback.xml文件，logback.xml文件如下：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26

<? xml version = "1.0" encoding = "UTF-8" ?> < configuration >   < appender name = "CONSOLE" class = "ch.qos.logback.core.ConsoleAppender" >   < Target >System.out</ Target >   < encoder >   < pattern >%date [%level] [%thread] %logger{80} [%file : %line] %msg%n</ pattern >   </ encoder >   </ appender >   < appender name = "FILE" class = "ch.qos.logback.core.rolling.RollingFileAppender" >   < encoder >   < pattern >%date [%level] [%thread] %logger{80} [%file : %line] %msg%n</ pattern >   </ encoder >   < rollingPolicy class = "ch.qos.logback.core.rolling.TimeBasedRollingPolicy" >   < fileNamePattern >${catalina.home}/logs/yzf/sql%d{yyyy-MM-dd}.log</ fileNamePattern >   <!-- 保留 30天数据，默认无限-->   < MaxHistory >30</ MaxHistory >   </ rollingPolicy >   </ appender >   < logger name = "org.springframework" level = "INFO" />   < logger name = "org.apache" level = "INFO" />   < logger name = "com.itmuch" level = "WARN" />   < root level = "INFO" >   < appender-ref ref = "CONSOLE" />   < appender-ref ref = "FILE" />   </ root > </ configuration >

最后需要在web.xml中添加日志监听 

<context-param>
    <param-name>logbackConfigLocation</param-name>
    <param-value>classpath:config/log/logback.xml</param-value>
</context-param>
<listener>
    <listener-class>ch.qos.logback.ext.spring.web.LogbackConfigListener</listener-class>
</listener>

              

拓展

slf4j-api、slf4j-log4j12以及log4j之间什么关系？

几乎在每个jar包里都可以看到log4j的身影，在多个子工程构成项目中，slf4j相关的冲突时不时就跳出来让你不爽，那么slf4j-api、slf4j-log4j12还有log4j他们是什么关系？我把自己了解的和大家简单分享一下：

slf4j:Simple Logging Facade for Java，为java提供的简单日志Facade。Facade：门面，更底层一点说就是接口。他允许用户以自己的喜好，在工程中通过slf4j接入不同的日志系统。更直观一点，slf4j是个数据线，一端嵌入程序，另一端链接日志系统，从而实现将程序中的信息导入到日志系统并记录。 

因此，slf4j入口就是众多接口的集合，他不负责具体的日志实现，只在编译时负责寻找合适的日志系统进行绑定。具体有哪些接口，全部都定义在slf4j-api中。查看slf4j-api源码就可以发现，里面除了public final class LoggerFactory类之外，都是接口定义。因此，slf4j-api本质就是一个接口定义。

下图比较清晰的描述了他们之间的关系：

 

当系统采用log4j作为日志框架实现的调用关系：

首先系统包含slf4j-api作为日志接入的接口；

at compile时slf4j-api中public final class LoggerFactor类中

private final static void bind() 方法会寻找具体的日志实现类绑定，主要通过

StaticLoggerBinder.getSingleton();语句调用

slf4j-log4j12:链接slf4j-api和log4j中间的适配器。它实现了slf4j-apiz中StaticLoggerBinder接口，从而使得在编译时绑定的是slf4j-log4j12的getSingleton()方法

log4j:这个是具体的日志系统。通过slf4j-log4j12初始化Log4j，达到最终日志的输出