logback学习

    logback 配置简单，容易上手
    一个日志文件中，只能是某一个级别的日志
    一个类中可以指定多个不同的日志，并且生成的每个日志文件只包含其本身的内容。
    可以关闭或者打开某几个包的日志，并且可以设置不同的包，使用不同的日志级别。

logback，slf4j，log4j之间的关系。
    slf4j 是The Simple Logging Facade for java的简称。 是一个简单的日志门面抽象框架，它本身只提供了日志Facade API和
简单的日志类实现。一般常常配合log4j，logback，java.util.logging使用，
    slf4j和log4j都是开源日志工具库。logBack是log4j的改良版本。比log4j拥有更多的特性。
    logback官方建议配合slf4j使用，这样可以灵活的替换底层日志框架。



    logback被分为3个组件，logback-core，logback-classic,logback-access.
    其中logback-core只提供了LogBack的核心功能，是另外两个组件的基础。
    logback-classic 则实现了slf4j的API，所以当想配置SLF4j使用时，需要将logback-classic加入classpath

    程序运行时，logback会依次寻找：
        1.查找默认的配置文件logback-test.xml
        2.查找logback.grooxy
        3.查找logback.xml
    如果没有找到它就会使用默认的配置。将日志打印到console中。

    配置详解：
        根节点<configuartion>包含的属性。
        scan 当属性设置为true的时候，配置文件如果发生改变，就会被重新加载，默认为true。
        scanPeriod： 设置检测配置文件是否有修改的时间间隔，如果没有给出时间单位，默认单位是毫秒。
            当scan为true，此属性生效，默认的时间间隔为一分钟
        debug： 当此属性设置为true的时候，将打印出logback内部日志信息。实时查看logback运行状态，默认为false。

        logback配置大概分为三个部分：appender，logger，root

        <contextName> 设置上下文的名称，默认为default。
            可以用于区分不同的应用程序的记录，一旦设置，不能修改。
        <property>  设置变量
            <property name="" value="" />
            使用的时候，${}
        <timestamp> 获取时间戳字符串
            <timestamp key="" datePattern="" /> 设置当前时间转换成字符串的模式。
        <logger> 用来设置一个包或者具体的某一个类的日志打印级别。，以及指定<appender>
            <logger>仅有一个name属性，一个可选level和一个可选的additivity属性。
            name：用来指定此logger约束的某一个包或者具体的某一个类。
            level：用来设置打印的级别，大小写无关。trace，debug，info，warn，error，all，off
                还有一个特殊值inherited或者null，代表强制执行上级的级别。
                如果没有设置此属性，那么当前的logger将会继承上级的级别。
            additivity：是否向上级传递打印消息。默认为true。

        <root> 也是<logger>元素，但是他不是根Logger。只有一个level属性。
            level: 用来设置打印的级别。默认为debug。
        <root>可以包含零个或者多个<appender-ref>元素，标识这个appender将会添加到这个logger。

<appender>详解：
    <appender>是<configuration>的子节点，是负责写日志的组件。
        两个必要属性：name和class。name指定appender名称，class指定appender的全限定名。

    ConsoleAppender 把日志添加到控制台。有以下子节点：、
        <encoder> ：对日志进行格式化
        <target> : 字符串System.out 或者 System.err。默认是System.out
    FileAppender: 把日志添加到文件
        <file>: 被写入的文件名，可以是相对目录也可以是绝对目录。如果不存在就创建。
        <append>:如果是true，日志被追加到文件结尾，如果是false，就清空现存文件。默认为true。
        <encoder>:对记录时间进行格式化
        <prudent>: 如果是true，日志会被安全的写入文件，即使其他的FileAppender也在向此文件做写入操作，效率低，默认false。
   RollingFileAppender： 滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件。
        <...>同FileAppender
        <rollingPolicy> 当发生滚动时。决定rollingFileAppender的行为，设计文件移动和重命名。
        <triggeringPolicy> 告知RollingFileAppender何时滚动。
        TimeBasedRollingPolicy：基于时间的滚动策略，既负责滚动也负责触发滚动。
            <fileNamePattern> : required   包含文件名及%d
                支持SimpleDateFormat的时间格式。默认为yyyy-MM-dd
            <maxHistory> 可选节点，控制保留的归档文件的最大数量。
         FixedWindowRollingPolicy: 根据固定窗口算法重命名文件的滚动策略。
            <minIndex> 窗口索引最小值
            <maxIndex> 窗口索引最大值，当用户指定的窗口过大时，会自动设置为12.
            <fileNamePattern> 必须包含%i，比如：mylog%i.log会产生归档文件mylog1.log和mylog3.log
        SizeBasedTriggeringPolicy : 查看定期那活动文件的大小，如果超过指定大小会告知RollingFileAppender触发当前文件滚动。
            只有一个节点：
                <maxFileSize>  这是活动文件的大小，默认值是10MB

   另外还有：
    SocketAppender，SMTPAppender，DBAppender，SyslogAppender,SiftingAppender,AsyncAppender
    还可以自定义Appender。


/*************************************************************************************/
<?xml version="1.0" encoding="UTF-8"?>
<!--
-scan:当此属性设置为true时，配置文件如果发生改变，将会被重新加载，默认值为true
-scanPeriod:设置监测配置文件是否有修改的时间间隔，如果没有给出时间单位，默认单位是毫秒。
-           当scan为true时，此属性生效。默认的时间间隔为1分钟
-debug:当此属性设置为true时，将打印出logback内部日志信息，实时查看logback运行状态。默认值为false。
-
- configuration 子节点为 appender、logger、root
-->
<configuration scan="true" scanPeriod="60 second" debug="false">

    <!-- 负责写日志,控制台日志 -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">

        <!-- 一是把日志信息转换成字节数组,二是把字节数组写入到输出流 -->
        <encoder>
            <Pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%5level] [%thread] %logger{0} %msg%n</Pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>

    <!-- 文件日志 -->
    <appender name="DEBUG" class="ch.qos.logback.core.FileAppender">
        <file>debug.log</file>
        <!-- append: true,日志被追加到文件结尾; false,清空现存文件;默认是true -->
        <append>true</append>
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <!-- LevelFilter: 级别过滤器，根据日志级别进行过滤 -->
            <level>DEBUG</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <encoder>
            <Pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%5level] [%thread] %logger{0} %msg%n</Pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>

    <!-- 滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件 -->
    <appender name="INFO" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <File>info.log</File>

        <!-- ThresholdFilter:临界值过滤器，过滤掉 TRACE 和 DEBUG 级别的日志 -->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>INFO</level>
        </filter>

        <encoder>
            <Pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%5level] [%thread] %logger{0} %msg%n</Pattern>
            <charset>UTF-8</charset>
        </encoder>

        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 每天生成一个日志文件，保存30天的日志文件
            - 如果隔一段时间没有输出日志，前面过期的日志不会被删除，只有再重新打印日志的时候，会触发删除过期日志的操作。
            -->
            <fileNamePattern>info.%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>30</maxHistory>
            <TimeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </TimeBasedFileNamingAndTriggeringPolicy>
        </rollingPolicy>
    </appender >

    <!--<!– 异常日志输出 –>-->
    <!--<appender name="EXCEPTION" class="ch.qos.logback.core.rolling.RollingFileAppender">-->
        <!--<file>exception.log</file>-->
        <!--<!– 求值过滤器，评估、鉴别日志是否符合指定条件. 需要额外的两个JAR包，commons-compiler.jar和janino.jar –>-->
        <!--<filter class="ch.qos.logback.core.filter.EvaluatorFilter">-->
            <!--<!– 默认为 ch.qos.logback.classic.boolex.JaninoEventEvaluator –>-->
            <!--<evaluator>-->
                <!--<!– 过滤掉所有日志消息中不包含"Exception"字符串的日志 –>-->
                <!--<expression>return message.contains("Exception");</expression>-->
            <!--</evaluator>-->
            <!--<OnMatch>ACCEPT</OnMatch>-->
            <!--<OnMismatch>DENY</OnMismatch>-->
        <!--</filter>-->

        <!--<triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">-->
            <!--<!– 触发节点，按固定文件大小生成，超过5M，生成新的日志文件 –>-->
            <!--<maxFileSize>5MB</maxFileSize>-->
        <!--</triggeringPolicy>-->
    <!--</appender>-->

    <appender name="ERROR" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>error.log</file>

        <encoder>
            <Pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%5level] [%thread] %logger{0} %msg%n</Pattern>
            <charset>UTF-8</charset>
        </encoder>

        <!-- 按照固定窗口模式生成日志文件，当文件大于20MB时，生成新的日志文件。
        -    窗口大小是1到3，当保存了3个归档文件后，将覆盖最早的日志。
        -    可以指定文件压缩选项
        -->
        <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
            <fileNamePattern>error.%d{yyyy-MM}(%i).log.zip</fileNamePattern>
            <minIndex>1</minIndex>
            <maxIndex>3</maxIndex>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
    </appender>

    <!-- 异步输出 -->
    <appender name ="ASYNC" class= "ch.qos.logback.classic.AsyncAppender">
        <!-- 不丢失日志.默认的,如果队列的80%已满,则会丢弃TRACT、DEBUG、INFO级别的日志 -->
        <discardingThreshold >0</discardingThreshold>
        <!-- 更改默认的队列的深度,该值会影响性能.默认值为256 -->
        <queueSize>512</queueSize>
        <!-- 添加附加的appender,最多只能添加一个 -->
        <appender-ref ref ="ERROR"/>
    </appender>

    <!--
    - 1.name：包名或类名，用来指定受此logger约束的某一个包或者具体的某一个类
    - 2.未设置打印级别，所以继承他的上级<root>的日志级别“DEBUG”
    - 3.未设置additivity，默认为true，将此logger的打印信息向上级传递；
    - 4.未设置appender，此logger本身不打印任何信息，级别为“DEBUG”及大于“DEBUG”的日志信息传递给root，
    -  root接到下级传递的信息，交给已经配置好的名为“STDOUT”的appender处理，“STDOUT”appender将信息打印到控制台；
    -->
    <logger name="ch.qos.logback" />

    <!--
    - 1.将级别为“INFO”及大于“INFO”的日志信息交给此logger指定的名为“STDOUT”的appender处理，在控制台中打出日志，
    -   不再向次logger的上级 <logger name="logback"/> 传递打印信息
    - 2.level：设置打印级别（TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF），还有一个特殊值INHERITED或者同义词NULL，代表强制执行上级的级别。
    -        如果未设置此属性，那么当前logger将会继承上级的级别。
    - 3.additivity：为false，表示此logger的打印信息不再向上级传递,如果设置为true，会打印两次
    - 4.appender-ref：指定了名字为"STDOUT"的appender。
    -->
    <logger name="com.weizhi.common.LogMain" level="INFO" additivity="false">
        <appender-ref ref="STDOUT"/>
        <!--<appender-ref ref="DEBUG"/>-->
        <!--<appender-ref ref="EXCEPTION"/>-->
        <!--<appender-ref ref="INFO"/>-->
        <!--<appender-ref ref="ERROR"/>-->
        <appender-ref ref="ASYNC"/>
    </logger>

    <!--
    - 根logger
    - level:设置打印级别，大小写无关：TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF，不能设置为INHERITED或者同义词NULL。
    -       默认是DEBUG。
    -appender-ref:可以包含零个或多个<appender-ref>元素，标识这个appender将会添加到这个logger
    -->
    <root level="DEBUG">
        <appender-ref ref="STDOUT"/>
        <!--<appender-ref ref="DEBUG"/>-->
        <!--<appender-ref ref="EXCEPTION"/>-->
        <!--<appender-ref ref="INFO"/>-->
        <appender-ref ref="ASYNC"/>
    </root>
</configuration>
/******************************************************************************************/

-------------------------------------------------------------------------------------------------------------
如果是web环境的话，在web.xml中配置：
 <servlet>
        <servlet-name>ViewStatusMessages</servlet-name>
        <servlet-class>ch.qos.logback.classic.ViewStatusMessagesServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>ViewStatusMessages</servlet-name>
        <url-pattern>/lbClassicStatus</url-pattern>
    </servlet-mapping>
    可以检测logback启动过程