Java日志框架:Logback

0. 概述

• 日志:用来记录程序运行过程中的信息，并可以进行永久存储

• 日志技术具备的优势:
  可以将系统执行的信息选择性的记录到指定的位置（控制台、文件中、数据库中）。
  可以随时以开关的形式控制是否记录日志，无需修改源代码。

• 在Java中提供了俩套实现日志规范的接口Commons Logging(简称：JCL)和Simple Logging Facade for Java(简称：slf4j)

  这俩个接口目的是提供给日志的实现框架设计的标准

  其中Commons Logging是sun公司开发的,因为对Commons Logging的接口不满意，所以有人就搞了SLF4J

• 常见的日志实现框架:

  Log4j(刚出bug那个)

  JUL（java.util.loggiing）

  Logback

1. Logback

1.1 Logback概述

• Logback是由log4j创始人基于slf4j的日志规范实现的日志框架，是一个开源的日志组件，性能比log4j要好
• 官方网站：https://logback.qos.ch/index.html
• Logback主要分为三个技术模块：
  logback-core： logback-core 模块为其他两个模块奠定了基础，必须有。
  logback-classic：它是log4j的一个改良版本，同时它完整实现了slf4j API。
  logback-access 模块与 Tomcat 和 Jetty 等 Servlet 容器集成，以提供 HTTP 访问日志功能

1.2 Logback使用步骤

1. 将Logback的相关jar包（四个）导入到项目中，并添加为库

2. 将Logback的核心配置文件logback.xml拷贝到src下

3. 创建Logback日志对象（左边创建slf4j下的Logger,右边是slf4j的实现类,使用了多态的写法）

   因为我们只需要一个日志对象,因此可以设置为静态且为常量

public static final Logger LOGGER = LoggerFactory.getLogger(当前类.class);

4. 使用日志对象的方法输出日志信息并将日志信息保存到文件中

1.3 logback.xml配置详解

Logback日志系统的特性都是通过核心配置文件logback.xml控制的。

1.3.1 Logback日志输出位置、格式设置：

通过logback.xml 中的<append>标签可以设置输出位置和日志信息的详细格式。

通常可以设置2个日志输出位置：一个是控制台、一个是系统文件中

输出到控制台的具体配置:

<!-- CONSOLE ：表示当前的日志信息是可以输出到控制台的。-->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <!--输出流对象 默认 System.out(正常打印) 改为 System.err(红色错误的形式打印)-->
        <target>System.out</target>
        <encoder>
            <!--格式化输出：%d表示日期, %c表示取类名,%thread表示线程名([方法名])，%-5level：级别从左显示5个字符宽度
                %msg：日志消息，%n是换行符-->
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%-5level]  %c [%thread] : %msg%n</pattern>
        </encoder>
    </appender>

输出到系统文件的配置标志:

<!-- File是输出的方向通向文件的 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
            <charset>utf-8</charset>
        </encoder>
        <!--日志输出路径-->
        <file>D:/workspace_idea/dataLog/dataDemo1.log</file>
        <!--指定日志文件拆分和压缩规则, 因为有的系统可能一下子运行好几年,一大堆日志,这个时候就需要拆分-->
        <rollingPolicy
                class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <!--通过指定压缩文件名称，来确定分割文件方式,i表示是拆分压缩的第几个文件-->
            <fileNamePattern>D:/workspace_idea/dataLog/dataDemo2-%d{yyyy-MMdd}.log%i.gz</fileNamePattern>
            <!--文件拆分大小,表示超出1MB就继续拆分文件-->
            <maxFileSize>1MB</maxFileSize>
        </rollingPolicy>
    </appender>

配置日志输出级别(root权限):

<!--
    level:用来设置打印级别，大小写无关：TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF
   ， 默认debug
   例如设置为ERROR,那就只会答错误信息的日志
    <root>可以包含零个或多个<appender-ref>元素，标识这个输出位置将会被本日志级别控制。
    -->
    <root level="ALL">
        <!-- 配置关联控制台与文件,表示在控制台和文件中都打所有信息 -->
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="FILE" />
    </root>

总的xml配置:

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

    <!-- CONSOLE ：表示当前的日志信息是可以输出到控制台的。-->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <!--输出流对象 默认 System.out(正常打印) 改为 System.err(红色错误的形式打印)-->
        <target>System.out</target>
        <encoder>
            <!--格式化输出：%d表示日期, %c表示取类名,%thread表示线程名([方法名])，%-5level：级别从左显示5个字符宽度
                %msg：日志消息，%n是换行符-->
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%-5level]  %c [%thread] : %msg%n</pattern>
        </encoder>
    </appender>

    <!-- File是输出的方向通向文件的 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
            <charset>utf-8</charset>
        </encoder>
        <!--日志输出路径-->
        <file>D:/workspace_idea/dataLog/dataDemo1.log</file>
        <!--指定日志文件拆分和压缩规则, 因为有的系统可能一下子运行好几年,一大堆日志,这个时候就需要拆分-->
        <rollingPolicy
                class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <!--通过指定压缩文件名称，来确定分割文件方式,i表示是拆分压缩的第几个文件-->
            <fileNamePattern>D:/workspace_idea/dataLog/dataDemo2-%d{yyyy-MMdd}.log%i.gz</fileNamePattern>
            <!--文件拆分大小,表示超出1MB就继续拆分文件-->
            <maxFileSize>1MB</maxFileSize>
        </rollingPolicy>
    </appender>

    <!--
    level:用来设置打印级别，大小写无关：TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF
   ， 默认debug
   例如设置为ERROR,那就只会答错误信息的日志
    <root>可以包含零个或多个<appender-ref>元素，标识这个输出位置将会被本日志级别控制。
    -->
    <root level="ALL">
        <!-- 配置关联控制台与文件,表示在控制台和文件中都打所有信息 -->
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="FILE" />
    </root>
</configuration>

1.4 日志输出级别

• 可以通过设置日志的输出级别来控制哪些日志信息输出或者不输出,只输出级别高于设定级别的日志信息

级别程度依次是：TRACE(路径跟踪级别,用于跟踪运行到哪了)< DEBUG(调试级别)< INFO(关键信息级别)<WARN(警告级别)<ERROR(错误级别) ; 默认级别是debug（忽略大小写），日志级别对应了日志对象的方法

ALL 和 OFF分别是打开全部日志信息，及关闭全部日志信息

具体设置:在<root level=“INFO”>标签的level属性中设置日志级别