log4j2配合slf4j使用

說明

  log4j2被用於日誌輸出。由於剛接觸log4j2,所以記個博客備用。
  log4j2是一個日誌框架,slf4j是日誌框架接口,之因此使用log4j2和slf4j搭配使用是爲了之後若是項目對日誌有其它要求而須要更換日誌框架時能夠不改動代碼,只須要把依賴的jar包換掉就能夠了。web

依賴

// log4j2依賴
log4j-api-2.8.2.jar
log4j-core-2.8.2.jar
// log4j2和slf4j橋接依賴
log4j-slf4j-impl-2.8.2.jar
// slf4j依賴
slf4j-api-1.7.25.jar

注意,log4j依賴和橋接依賴的jar包版本最好保持一致。spring

配置文件

  使用log4j2以前須要在classpath下新建一個配置文件。須要注意的是log4j 2.x版本再也不支持像1.x中的.properties後綴的文件配置方式,2.x版本配置文件後綴名只能爲".xml",".json"或者".jsn"。數據庫

系統選擇配置文件的優先級(從先到後)以下:json

  • classpath下的名爲log4j2-test.json 或者log4j2-test.jsn的文件
  • classpath下的名爲log4j2-test.xml的文件
  • classpath下名爲log4j2.json 或者log4j2.jsn的文件
  • classpath下名爲log4j2.xml的文件

  咱們通常默認使用log4j2.xml進行命名。若是本地要測試,能夠把log4j2-test.xml放到classpath,而正式環境使用log4j2.xml,則在打包部署的時候不要打包log4j2-test.xml便可。api

默認配置文件:mybatis

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
    <Appenders>                
        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
        </Console>
    </Appenders>
    <Loggers>
        <Root level="error">
            <AppenderRef ref="Console"/>
        </Root>
    </Loggersration>

配置文件實例:app

<?xml version="1.0" encoding="UTF-8"?>  
<!DOCTYPE xml>
<configuration status="debug" monitorInterval="30">
<!--     先定義全部的appender -->
    <appenders>
<!--         這個輸出控制檯的配置 -->
        <Console name="Console" target="SYSTEM_OUT">
<!--               控制檯只輸出level及以上級別的信息(onMatch),其餘的直接拒絕(onMismatch) -->
            <ThresholdFilter level="warn" onMatch="ACCEPT" onMismatch="DENY"/>
<!--             這個都知道是輸出日誌的格式 -->
            <PatternLayout pattern="[%d{HH:mm:ss.SSS}] [%-5p] %l - %m%n"/>
        </Console>
        
<!--         文件會打印出全部信息,這個log每次運行程序會自動清空,由append屬性決定,這個也挺有用的,適合臨時測試用 -->
<!--         append爲TRUE表示消息增長到指定文件中,false表示消息覆蓋指定的文件內容,默認值是true -->
        <File name="log" fileName="log/test.log" append="false">
            <PatternLayout pattern="[%d{HH:mm:ss.SSS}] [%-5p] %l - %m%n"/>
        </File>
        
<!--          添加過濾器ThresholdFilter,能夠有選擇的輸出某個級別以上的類別  onMatch="ACCEPT" onMismatch="DENY"意思是匹配就接受,不然直接拒絕  -->
        <File name="ERROR" fileName="logs/error.log">
            <ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout pattern="[%d{yyyy.MM.dd 'at' HH:mm:ss z}] [%-5p] %l - %m%n"/>
        </File>

<!--         這個會打印出全部的信息,每次大小超過size,則這size大小的日誌會自動存入按年份-月份創建的文件夾下面並進行壓縮,做爲存檔 -->
        <RollingFile name="RollingFile" fileName="logs/web.log"
                     filePattern="logs/$${date:yyyy-MM}/web-%d{MM-dd-yyyy}-%i.log.gz">
            <PatternLayout pattern="[%d{yyyy-MM-dd 'at' HH:mm:ss z}] [%-5p] %l - %m%n"/>
            <SizeBasedTriggeringPolicy size="2MB"/>
        </RollingFile>
    </appenders>
    
<!--     而後定義logger,只有定義了logger並引入的appender,appender纔會生效 -->
    <loggers>
<!--        過濾掉spring和mybatis的一些無用的DEBUG信息-->
        <logger name="org.springframework" level="INFO"></logger>
        <logger name="org.mybatis" level="INFO"></logger>
<!--         創建一個默認的root的logger -->
        <root level="trace">
            <appender-ref ref="RollingFile"/>
            <appender-ref ref="Console"/>
            <appender-ref ref="ERROR" />
            <appender-ref ref="log"/>
        </root>

    </loggers>
</configuration>

配置文件說明
  1.根節點Configuration有兩個屬性:status和monitorinterval,有兩個子節點:Appenders和Loggers(代表能夠定義多個Appender和Logger).框架

  • status用來指定log4j自己的打印日誌的級別.
  • monitorinterval用於指定log4j自動從新配置的監測間隔時間,單位是s,最小是5s.

  2.Appenders節點,常見的有三種子節點:Console、RollingFile、File.工具

  • Console節點用來定義輸出到控制檯的Appender.測試

    • name:指定Appender的名字.
    • target:SYSTEM_OUT 或 SYSTEM_ERR,通常只設置默認:SYSTEM_OUT.
    • PatternLayout:輸出格式,不設置默認爲:%m%n.
  • File節點用來定義輸出到指定位置的文件的Appender.

    • name:指定Appender的名字.
    • fileName:指定輸出日誌的目的文件帶全路徑的文件名.
    • PatternLayout:輸出格式,不設置默認爲:%m%n.
  • RollingFile節點用來定義超過指定大小自動刪除舊的建立新的的Appender.

    • name:指定Appender的名字.
    • fileName:指定輸出日誌的目的文件帶全路徑的文件名.
    • PatternLayout:輸出格式,不設置默認爲:%m%n.
    • filePattern:指定新建日誌文件的名稱格式.
    • Policies:指定滾動日誌的策略,就是何時進行新建日誌文件輸出日誌.
    • TimeBasedTriggeringPolicy:Policies子節點,基於時間的滾動策略,interval屬性用來指定多久滾動一次,默認是1hour。modulate=true用來調整時間:好比如今是早上3am,interval是4,那麼第一次滾動是在4am,接着是8am,12am...而不是7am.
    • SizeBasedTriggeringPolicy:Policies子節點,基於指定文件大小的滾動策略,size屬性用來定義每一個日誌文件的大小.
    • DefaultRolloverStrategy:用來指定同一個文件夾下最多有幾個日誌文件時開始刪除最舊的,建立新的(經過max屬性)。

  3.Loggers節點,常見的有兩種:Root和Logger.

  • Root節點用來指定項目的根日誌,若是沒有單獨指定Logger,那麼就會默認使用該Root日誌輸出

    • level:日誌輸出級別,共有8個級別,按照從低到高爲:All < Trace < Debug < Info < Warn < Error < Fatal < OFF.
    • AppenderRef:Root的子節點,用來指定該日誌輸出到哪一個Appender.
  • Logger節點用來單獨指定日誌的形式,好比要爲指定包下的class指定不一樣的日誌級別等。

    • level:日誌輸出級別,共有8個級別,按照從低到高爲:All < Trace < Debug < Info < Warn < Error < Fatal < OFF.
    • name:用來指定該Logger所適用的類或者類所在的包全路徑,繼承自Root節點.
    • AppenderRef:Logger的子節點,用來指定該日誌輸出到哪一個Appender,若是沒有指定,就會默認繼承自Root.若是指定了,那麼會在指定的這個Appender和Root的Appender中都會輸出,此時咱們能夠設置Logger的additivity="false"只在自定義的Appender中進行輸出。

輸出日誌

/**
 * 
 */
package com.petro.test;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * @description 數據庫工具類
 * @author PetterChen
 * @date 2017年10月14日 下午9:38:42 
 */
public class LogTest {
    /**
     * 日誌輸出
     */
    private static Logger log = LoggerFactory.getLogger(LogTest.class);

    /**
     * @description 測試
     * @date 2017年10月14日 下午9:38:42
     * @param args
     */
    public static void main(String[] args) {
        // TODO Auto-generated method stub
        log.trace("trace");
        log.debug("debug");
        log.warn("warn");
        log.info("info");
        log.error("error");
    }

}
相關文章
相關標籤/搜索