Logback淺析

1、Logback為取代log4j而生

     Logback是由log4j創始人Ceki Gülcü設計的又一個開源日志組件。logback當前分成三個模塊：logback-core,logback- classic和logback-access。

2、Logback的核心對象：Logger、Appender、Layout

     Logback主要建立於Logger、Appender 和 Layout 這三個類之上。

     Logger:日志的記錄器，把它關聯到應用的對應的context上后，主要用於存放日志對象，也可以定義日志類型、級別。Logger對象一般多定義為靜態常量，如：

package com.logs;

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

public class MyApp {
    final static Logger logger = LoggerFactory.getLogger("MyApp.class");
    public static void main(String[] args) {
        
        logger.trace("trace");
        logger.debug("debug str");
        logger.info("info str");
        logger.warn("warn");
        logger.error("error");
    }
}

     Appender:用於指定日志輸出的目的地，目的地可以是控制台、文件、遠程套接字服務器、 MySQL、 PostreSQL、Oracle和其他數據庫、 JMS和遠程UNIX Syslog守護進程等。

     Layout:負責把事件轉換成字符串，格式化的日志信息的輸出。具體的Layout通配符，可以直接查看幫助文檔。

3、Level 有效級別

    Logger可以被分配級別。級別包括：TRACE、DEBUG、INFO、WARN和ERROR，定義於ch.qos.logback.classic.Level類。程序會打印高於或等於所設置級別的日志，設置的日志等級越高，打印出來的日志就越少。如果設置級別為INFO，則優先級高於等於INFO級別（如：INFO、 WARN、ERROR）的日志信息將可以被輸出,小於該級別的如DEBUG將不會被輸出。為確保所有logger都能夠最終繼承一個級別，根logger總是有級別，默認情況下，這個級別是DEBUG。

4、 三值邏輯

   Logback的過濾器基於三值邏輯（ternary logic），允許把它們組裝或成鏈，從而組成任意的復合過濾策略。過濾器很大程度上受到Linux的iptables啟發。這里的所謂三值邏輯是說，過濾器的返回值只能是ACCEPT、DENY和NEUTRAL的其中一個。

如果返回DENY，那么記錄事件立即被拋棄，不再經過剩余過濾器；

如果返回NEUTRAL，那么有序列表里的下一個過濾器會接着處理記錄事件；

如果返回ACCEPT，那么記錄事件被立即處理，不再經過剩余過濾器。

5、Filter 過濾器

    Logback-classic提供兩種類型的過濾器：常規過濾器和TuroboFilter過濾器。Logback整體流程：Logger 產生日志信息；Layout修飾這條msg的顯示格式；Filter過濾顯示的內容；Appender具體的顯示，即保存這日志信息的地方。

6、具體使用案例

     Java項目中一般都會應用比如struts、spring、hibernate等開源框架，而這些框架很多是應用log4j記錄日志的，所以我們考慮用log4j + slf4j + logback 。這樣我們需要導入log4j-over-slf4j-1.6.4.jar 、logback-classic-1.0.1.jar 、logback-core-1.0.1.jar 、slf4j-api-1.6.4.jar ，如果你要用到EvaluatorFilter過濾器來過濾日志Msg中的特殊字符需要導入其依賴包 janino-2.3.2.jar。其logback.xml

<?xml version="1.0" encoding="UTF-8"?>
<configuration>

    <!-- 控制台輸出 -->
    <appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%date [%thread] %-5level %logger{80} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- 時間滾動輸出 level為 DEBUG 日志 -->
    <appender name="file—debug"
        class="ch.qos.logback.core.rolling.RollingFileAppender">
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>DEBUG</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY </onMismatch>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <FileNamePattern>D:/logs/debug.%d{yyyy-MM-dd}.log</FileNamePattern>
            <MaxHistory>30</MaxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%date [%thread] %-5level %logger{80} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- 時間滾動輸出 level為 ERROR 日志 -->
    <appender name="file—error"
        class="ch.qos.logback.core.rolling.RollingFileAppender">
        <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>D:/logs/error.%d{yyyy-MM-dd}.log</FileNamePattern>
            <MaxHistory>30</MaxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%date [%thread] %-5level %logger{80} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- 特定過濾含有某字符串的日志 -->
    <appender name="file-str"
        class="ch.qos.logback.core.rolling.RollingFileAppender">
        <filter class="ch.qos.logback.core.filter.EvaluatorFilter">
            <evaluator>
                <expression>message.contains("str")</expression>
            </evaluator>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <FileNamePattern>D:/logs/contains.%d{yyyy-MM-dd}.log
            </FileNamePattern>
            <MaxHistory>30</MaxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%date [%thread] %-5level %logger{80} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- 數據庫輸出 -->
    <appender name="db" class="ch.qos.logback.classic.db.DBAppender">
        <connectionSource
            class="ch.qos.logback.core.db.DriverManagerConnectionSource">
            <driverClass>com.mysql.jdbc.Driver</driverClass>
            <url>jdbc:mysql://host_name:3306/datebase_name</url>
            <user>username</user>
            <password>password</password>
        </connectionSource>
    </appender>

    <logger name="java.sql.Connection">
        <level value="DEBUG" />
    </logger>
    <logger name="java.sql.Statement">
        <level value="DEBUG" />
    </logger>
    <logger name="com.ibatis">
        <level value="DEBUG" />
    </logger>
    <logger name="com.ibatis.common.jdbc.SimpleDataSource">
        <level value="DEBUG" />
    </logger>
    <logger name="com.ibatis.common.jdbc.ScriptRunner">
        <level value="DEBUG" />
    </logger>
    <logger name="com.ibatis.sqlmap.engine.impl.SqlMapClientDelegate">
        <level value="DEBUG" />
    </logger>
    <logger name="com.danga.MemCached">
        <level value="INFO" />
    </logger>
    <logger name="org.springframework.test">
        <level value="DEBUG" />
    </logger>
    <logger name="org.apache.struts2">
        <level value="DEBUG" />
    </logger>

    <root level="DEBUG">
        <appender-ref ref="stdout" />
        <appender-ref ref="file—debug" />
        <appender-ref ref="file—error" />
        <appender-ref ref="file-str" />
        <appender-ref ref="db" />
    </root>

</configuration>