番外 03：Java日志框架引入 log4j2（Log For Java version2.x)

前景概要

不管是做什么项目，日志都是不可或缺的

• 跟踪代码执行过程
• 跟踪错误
• 记录重要操作

而log4j 是功能最强的一个日志工具，用于输出Log。
为了保证Spring系列的完整性，今天简单介绍一下log4j2 的使用和简单配。

实例

简单使用log4j2

项目工程结构

项目结构

运行结果

右键运行 App.java

09:30:26.495 [main] DEBUG me.laiyijie.demo.App - I ' m just try this!
09:30:26.495 [main] DEBUG me.laiyijie.demo.App - I ' m just try this!

项目详解

App.java

package me.laiyijie.demo;

import java.sql.SQLException;

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;

public class App {

    public static final Logger logger = LogManager.getLogger(App.class);

    public static void main(String[] args) throws SQLException, ClassNotFoundException {

        logger.debug("I ' m just try this!");

    }

}

输出日志过程如下：

1. 通过LogManager的getLogger方法拿到App.class的这个类
2. 调用logger.debug输出日志
   用起来非常简单，但是为何一行代码输出了两次log？问题就出在日志的配置上了

而其配置也非常简单：

log4j2.xml

    
        D:/logs/
    

    
        
            
        

        
            
                [%d{MMdd HH:mm:ss SSS}] - %m%n
                UTF-8
            
            
        
        
    


    
        
            
            
        
        
        
            
            
        
    

这些配置，可以满足绝大部分的场景，也就是说，已经是比较完整的一个配置了，只要理解了这个配置，基本上除非有特殊需求，否则无需再进一步配置。
在这个配置中主要涉及到了三个部分（也就是Configuration下面一级配置有三部分）

1. Properties - 只是配置一下常用属性，便于更改，在同一个配置文件中通过${xxx}引用
2. Appenders - 配置Log需要从哪儿输出，输出格式是什么
3. Loggers - 控制不同包里面的日志使用不同的Appenders（输出器）以及输出的日志等级

下面详细介绍Loggers和Appenders

Appenders

在这个配置文件中配置了两个Appenders:

1. Console - 输出到控制台，具体格式为 ，这些输出的格式在此不详细介绍，完全可以用的时候再去查找官方文档
2. RollingFile - 以天为单位分文件输出到指定位置，并指定打包名称，输出文件位置为fileName="${logFilePath}debug/log.txt"，打包文件名称为filePattern="${logFilePath}debug/log-%d{MM-dd-yyyy}.log.gz"，输出样式为[%d{MMdd HH:mm:ss SSS}] - %m%n 详细的配置可以参照RollingFileAppender官方文档

说白了就是配置各种各样不同的输出器，以保证可以输出到不同的位置，而我们运行程序以后看到的样式结果就是通过Console这个Appender来进行输出的。
那到底是为何输出了两条呢？让我来看看Loggers的配置就知道了

Loggers

这个配置中有两条：

• Logger - 以包名为基础控制不同包下的日志输出行为，下面介绍其属性

  1. name - name="me.laiyijie.demo",也就是意味着，在me.laiyijie.demo包下面的所有类中的Logger都被包含在这个Logger之内（注意：包括其所有子包，例如me.laiyijie.demo.service）
  2. level - level="debug" 在debug等级以上的日志都需要输出，日志等级按严重程度递减排序为（fatal，error，info，debug，trace）也就是说，除了trace以外的其他所有都会输出
  3. 关联输出器（Appenders）可以看出Console关联了两个输出器，分别是Console和fileAppender，也就是说既会输出在控制台，也会输出在文件

• ROOT - 根输出器，工程中所有的日志管理，在这里也是配置了两个Appender-ref，Console和fileAppender

有Logger和ROOT分别输出了一条到Console这也是为什么一行语句会有两个输出到控制台的原因！！

如果想解决这个问题，也就是说想要输出过一次日志后不再输出，就要通过additivity="false"来控制，也就是说把Logger的配置更换如下：

增加了一个additivity属性！这样的话，日志检测到后不会继续向下传递到ROOT再次输出。

配置完毕，愉快快的使用log4j2吧！请记住，配置文件要放在classpath中，并且以log4j.xml为名称。详细载入配置文件过程可以参考官方文档中的自动配置

附：

pom.xml

    4.0.0

    me.laiyijie
    demo
    0.0.1-SNAPSHOT
    jar

    

        
        
            org.apache.logging.log4j
            log4j-core
            2.7