log4j+slf4j管理日誌項目遷移logback+slf4j
作為一個剛踏入java語言的小學生,最近被安排了一個任務,原有的項目中使用的是log4j日誌管理 要轉換成logbacak的日誌管理。介於之前並未深究log4j和logback日誌,所以做起來也很是頭疼,不得不查詢資料問別人,才勉強完成,所以記錄一下從頭的步驟,以供別人參考,有不對地方還請大神斧正。
首先提供一下log4j和slf4j以及logback的關系圖
第一步:我們項目是log4j+轉slf4j管理的,要替換成logback,所以需要刪除掉log4j和slf4j-log4j12的所有jar包依賴,項目中用到了maven依賴傳遞無法直接刪除,我在maven的pom文件排除了相關依賴。
<exclusions>
<exclusion>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
</exclusion>
<exclusion>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
</exclusion>
<exclusion>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-slf4j-impl</artifactId>
</exclusion>
<exclusion>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
</exclusion>
</exclusions>
第二步:然後引入相關logback的jar包依賴
<!-- logback日誌配置開始 -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
</dependency>
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.1.2</version>
</dependency>
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-core</artifactId>
<version>1.1.2</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>log4j-over-slf4j</artifactId>
<version>1.7.7</version>
</dependency>
<!-- logback日誌配置結束 -->
第三步:將原有的log4j.xml或者是log4j.properties刪除掉,添加進來logback的配置文件logback.xml,格式依照網上的模板只是改變一下相應的輸出位置和文件路徑以及日誌級別等
<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false">
<!-- 定義日誌文件 輸入位置 -->
<property name="log_dir" value="/logs/log" />
<!-- 控制臺輸出 -->
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
<pattern>%d %-5p %c{2} - [%m]%n</pattern>
</encoder>
</appender>
<!-- 按照每天生成日誌文件 -->
<appender name="DEFAULT-APPENDER" class="ch.qos.logback.core.rolling.RollingFileAppender">
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<!--日誌文件輸出的文件名-->
<FileNamePattern>${log_dir}/default/default.log.%d{yyyyMMdd}</FileNamePattern>
<!-- 日誌生成30天有效 -->
<MaxHistory>30</MaxHistory>
</rollingPolicy>
<encoder charset="UTF-8">
<pattern>%d %-5p %c{2} - [%m]%n</pattern>
</encoder>
</appender>
<appender name="BUSINESS-APPENDER" class="ch.qos.logback.core.rolling.RollingFileAppender">
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<!--日誌文件輸出的文件名-->
<FileNamePattern>${log_dir}/business/business.log.%d{yyyyMMdd}</FileNamePattern>
<!-- 日誌生成30天有效 -->
<MaxHistory>30</MaxHistory>
</rollingPolicy>
<encoder charset="UTF-8">
<pattern>%d %-5p %c{2} - [%m]%n</pattern>
</encoder>
</appender>
<!-- ERROR級別日誌 -->
<!-- 滾動記錄文件,先將日誌記錄到指定文件,當符合某個條件時,將日誌記錄到其他文件 RollingFileAppender -->
<appender name="ERROR-APPENDER" class="ch.qos.logback.core.rolling.RollingFileAppender">
<!-- 過濾器,只記錄ERROR級別的日誌 -->
<filter class="ch.qos.logback.classic.filter.LevelFilter">
<level>ERROR</level>
<onMatch>ACCEPT</onMatch>
<onMismatch>DENY</onMismatch>
</filter>
<!-- 最常用的滾動策略,它根據時間來制定滾動策略.既負責滾動也負責出發滾動 -->
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<!--日誌輸出位置 -->
<fileNamePattern>${log_dir}/error/error.log.%d{yyyyMMdd}</fileNamePattern>
<!-- 保留 30天數據-->
<MaxHistory>30</MaxHistory>
</rollingPolicy>
<encoder charset="UTF-8">
<pattern>%d %-5p %c{2} - [%m]%n</pattern>
</encoder>
</appender>
<logger name="com.logs.user.log" additivity="false">
<level value="INFO"/>
<appender-ref ref="BUSINESS-APPENDER"/>
<appender-ref ref="ERROR-APPENDER"/>
</logger>
<!-- 日誌輸出級別 -->
<root level="DEBUG">
<appender-ref ref="DEFAULT-APPENDER" />
<appender-ref ref="ERROR-APPENDER" />
<appender-ref ref="STDOUT" />
</root>
</configuration>
最後一步:查看代碼中引用的依賴和代碼是否正確。
我們項目中有的用了slf4j,所以這個不用更改代碼,因為logback適配到slf4j的代碼完全與log4j一樣。
如果是用了log4j管理的,那就要更改代碼了。例如我們項目:
import org.log4j.Logger;引用了log4j的依賴
private static final Logger LOGGER = Logger.getLogger(Testcache.class)
更改後的代碼:
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
private static final Logger LOGGER = LoggerFactory.getLogger(Testcache.class);
這樣就結束了。也可以寫一個本地方法來測試一下:
import org.slf4j.LoggerFactory;
import org.slf4j.Logger;
public class Test {
private static Logger logger = (Logger) LoggerFactory.getLogger(Test.class);
public static void main(String[] args) {
logger.debug("debug");
logger.info("info");
logger.error("error");
}
}
執行這個main方法查看日誌的輸出路徑、位置、格式、都正確以後就ok了。
log4j+slf4j管理日誌項目遷移logback+slf4j