使用logback轻松管理日志

最近才开始在项目中使用logback，有一种相见恨晚的感觉，因为它很轻易的满足了我的几个需求：

 

        1. 配置简单，易于上手

        2. 一个日志文件中只能某一个级别的日志

        3. 一个类中可以指定多个不同的日志，并且生成的每个日志文件中只包含其本身的内容

        4. 可以关闭或者打开某几个包的日志，并且可以设置不同的包使用不同的日志级别。

 

       一、易用性

        logback的易用性不用多讲，只需要通过下面两行就可以在console中输出日志：

 

<pre name="code" class="html">Logger debugLogger = LoggerFactory.getLogger(MyClass.class);
</pre>logger.info("This is a log");

      程序运行时，logback会查找默认的配置文件logback.xml或者logback-test.xml文件，如果没有找到它就会使用默认的配置，将日志打印到console中。下面是一个简单配置文件（http://logback.qos.ch/manual/configuration.html）：

 

 

<configuration>

  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <!-- encoders are assigned the type
         ch.qos.logback.classic.encoder.PatternLayoutEncoder by default -->
    <encoder>
      <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
  </appender>

  <root level="debug">
    <appender-ref ref="STDOUT" />
  </root>
</configuration>

       二、日志级别限制

 

       在多数的Log工具中，级别是可以传递，例如如果指定了日志输出级别为DEBUG，那么INFO、ERROR级别的log也会出现在日志文件。这种默认给程序的调试带来了很多的麻烦。而在logback中可以通过appender中的filter来严格限制日志的输出级别：

 

<filter class="ch.qos.logback.classic.filter.LevelFilter">
    <level>INFO</level>
    <onMatch>ACCEPT</onMatch>
    <onMismatch>DENY</onMismatch>
</filter>

上面的设置中只会在文件中出现级别为INFO的日志内容。

 

 

     三、同一个类中包含不同的日志

     有时候一个类中可能要求打印不同的日志信息，例如有的用来调试，有的用来记录程序运行中的某些参数的变化等等。这时候可以通过下面的语句声明不同的日志：

 

Logger debugLogger = LoggerFactory.getLogger(MyClass.class);
Logger monitorLogger = LoggerFactory.getLogger("monitor");

    然后在配置文件中分别指定不同的输出文件（debugLogger使用默认的配置）：

 

 

    <appender name="monitor" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <File>${log.dir}/monitor.log</File>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} : %m%n</pattern>
        </encoder>
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>INFO</level>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${log.dir}/sensitive.log.%d{yyyy-MM-dd}</fileNamePattern>
        </rollingPolicy>
    </appender>
        <logger name="monitor" additivity="false" level="INFO">
<span style="white-space:pre">      </span><appender-ref ref="monitor" />
<span style="white-space:pre">  </span></logger>

 这里通过设置additivity="false"禁止monitor里的内容向上传递，否则会同时显示在默认的日志中。

 

 

         四、精确控制日志的应用范围

         在程序调试中，经常出现的情况是：错误只在某一个或者几个类或者包里，所以只需要打开这几个类或者包里的DEBUG级别的log。在以前的项目，使用Spring和Hibernate时，一旦打开DEBUG级别的log，程序本身的debug信息就会被Spring和Hibernate的大量日志淹没，大大降低了调试的效率。而logback让这一切变的简单起来了：

 

<logger name="org" level="ERROR" />

这一行就将org包下面的所有日志级别设为了ERROR，不会再打扰我们的DEBUG。