logback.xml解读----日志配置解读

初次接触javaweb项目的日志是log4j文件，但是后来发现通过配置logback.xml文件实现日志输出非常好用。经过上午的学习，现总结如下：

直接上配置文件和注释：

<?xml version="1.0" encoding="UTF-8" ?>
<!-- configuration是logback.xml文件的根节点，里面有三个属性：

　　scan:当此属性为true时，logback.xml文件如果发生改变，将会被重新加载，默认值是true

　　scanPeriod:设置监测配置文件是否有修改的时间间隔（通俗讲：就是设置多长时间查看一下logback.xml文件有没有被修改）

　　　　　　　　如果没有给出时间单位，默认是ms,并且当scan为true时，此属性生效，默认间隔时间是1分钟。

　　debug:当此属性设置为true时，将打印出logback.xml内部日志消息，实时查看logback.xml的运行状态，默认值是false。　

-->
<configuration scan="true" scanPeriod="60 seconds" debug="false">

<!-- 整个logback.xml文件中只有四个主要的标签：其一是根标签configuration，其余是三个子标签：appende，logger，root

　　但是有人会疑问：那property和timestamp是做什么的？答案是：这两个标签是用来为以上提到的是三个子标签定义属性和赋值的。例如：

　　第一个property标签中定义了一个USER_HOME属性，其值是/logs，scope是这个属性的作用范围，scope="context"是指该属性只能在本配置文件中使用。

　　而timestamp定义了一个时间戳，也就是定义了一个时间格式，以供三个子标签使用。

-->
    <property name="USER_HOME" value="/logs" />
    <property scope="context" name="FILE_NAME" value="mylog-logback" />
    <timestamp key="byDay" datePattern="yyyy-MM-dd" />

<!-- 第一个子标签appender：

　　name:标签名，为了让其他标签调用的唯一标示，相当于html标签中的id

　　class:引用的类，从此类中可以看出该appender标签定义的是日志输出的位置，也就是往哪里输出

　　ch.qos.logback.core.ConsoleAppender可以看出是往控制台上输出。

　　encoder：该标签中定义了日志的输出格式

-->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
              <!--格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度   %msg：日志消息，%n是换行符
                    级别分别是：TRACE < DEBUG < INFO <WARN < ERROR
              -->
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n </pattern>
        </encoder>
    </appender>

<!--

　　class:从此类中可以看出该appender标签定义的日志输出位置是回滚文件，也就是说：把日志输出到一个文件中，并且该文件可以回滚，至于怎么回滚请看下面的注释

-->
    <appender name="log_file"  class="ch.qos.logback.core.rolling.RollingFileAppender">

<!--   定义了日志文件的目录结构和文件名：磁盘根目录：/logs/mylog-logback.log

　　注意了：该文件名是在日志文件没有触发回滚要求时的文件名，也就是说现在的日志文件还没有满足xxMB，一旦满足了就会按照rollingPolicy里设置的属性进行重新命名

-->
        <file>${USER_HOME}/${FILE_NAME}.log</file>

<!--  rollingPolicy：回滚策略

　　fileNamePattern：标签中定义的是日志文件一旦满足5MB就重新命名成新文件的命名格式，其中minIndex和maxIndex分别对应的是满足5MB的日志文件的命名序号（1~10）对应%i.log中的i值。

如：mylog-logback-2016-07-12-1.log，mylog-logback-2016-07-12-2.log，mylog-logback-2016-07-12-3.log

-->
        <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
            <fileNamePattern>${USER_HOME}/${byDay}/${FILE_NAME}-${byDay}-%i.log</fileNamePattern>

<minIndex>1</minIndex>
            <maxIndex>10</maxIndex>
        </rollingPolicy>
<!-- 触发策略：当日志文件满足5MB就会出发回滚策略-->
        <triggeringPolicy   class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
            <maxFileSize>5MB</maxFileSize>
        </triggeringPolicy>

<encoder>
            <pattern>%d{HH:mm:ss.SSS} %-4relative [%thread] %-5level %logger{35} - %msg%n
            </pattern>
        </encoder>

</appender>
<!-- 设置哪个目录或者包，类使用哪个日志

　　　　将控制impl包下的所有类的日志的打印，level是打印级别：debug，如果不设置level，它将继承它的上级<root>的日志级别“DEBUG”

如果没有设置addtivity，默认为true，将此loger的打印信息向上级传递；

如果没有设置appender-ref，此loger本身不打印任何信息。

-->
    <logger name="com.jbat.service.impl" level="debug" additivity="true">
        <appender-ref ref="log_file" />
    </logger>

<root level="DEBUG">
        <appender-ref ref="STDOUT" />
        <appender-ref ref="log_file" />
    </root>

<!--执行过程总结：

当 执行com.jbat.service.impl类的方法时，会首先执行<logger name="com.jbat.service.impl" />本身如果引用了appender-ref标签，就按照ref="log_file" 设置的格式打印；

当执行不在impl中的方法时，会将级别为“DEBUG”及大于“DEBUG”的日志信息传递给root，root接到下级传递的信息，交给已经配置好的名为“STDOUT”和“log_file”的appender处理，“STDOUT”appender将信息打印到控制台，“log_file”appender将信息打印到日志文件；

-->

</configuration>