slf4j+log4j2的配置

昨天自己测试了一下slf4j+log4j2的配置，可以正常使用，虽然配置十分简单，但好记性不如烂笔头，想想还是记录下来吧。

运行的环境：jdk1.7、tomcat7、Maven的web项目

1.在新建的maven项目的pom文件中添加jar包依赖（依赖代码在步骤末尾）：

需要添加依赖的jar包有：

slf4j的api接口包：slf4j-api

log4j2的核心包：log4j-core

log4j2的api接口包：log4j-api

slf4j对应log4j2日志框架的驱动包：log4j-slf4j-impl

log4j2的异步日志功能包：com.lmax.disruptor

解决web项目log4j可能出现警告的jar包：log4j-web

2.配置log4j2.xml日志配置文件（日志配置文件内容放在步骤末尾）：

·日志配置文件默认读取路径为src/main/resource

·若文件放置在默认读取路径下则无需配置读取路径

·若文件放置到其他路径下则需要在web.xml中设置日志配置文件的读取路径，代码如下：

<context-param>
   <param-name>log4jConfiguration</param-name>
   <param-value>classpath:log4j2.xml</param-value>
</context-param>

3.在代码中使用日志功能：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class logTest {

    // 通过slf4j接口创建Logger对象
    private static final Logger logger = LoggerFactory.getLogger(logTest.class);

    public static void main(String[] args) {
        logger.info("this is info");
        logger.error("this is error");
    }
}

运行效果：

 

关于日志配置文件的详细说明请参考log4j2配置文件log4j2.xml详解，以下是pom.xml需要加入的jar包依赖以及日志配置文件log4j2.xml内容示例：

pom.xml需要加入的jar包依赖：

<properties>

<!-- jar包版本设置 -->

<slf4j.version>1.7.21</slf4j.version>

<log4j.version>2.11.0</log4j.version>

</properties>

<dependencies>

<!-- 导入slf4j的接口包以及对应日志框架的驱动包 -->

<!-- https://mvnrepository.com/artifact/org.slf4j/slf4j-api -->

<dependency>

<groupId>org.slf4j</groupId>

<artifactId>slf4j-api</artifactId>

<version>${slf4j.version}</version>

</dependency>

<!--用于slf4j与log4j2保持桥接 -->

<!-- https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-slf4j-impl -->

<dependency>

    <groupId>org.apache.logging.log4j</groupId>

    <artifactId>log4j-slf4j-impl</artifactId>

    <scope>runtime</scope>

    <version>${log4j.version}</version>

</dependency>

 

<!-- 导入日志框架核心包与接口包 -->

<!-- https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-core -->

<dependency>

<groupId>org.apache.logging.log4j</groupId>

<artifactId>log4j-core</artifactId>

<scope>runtime</scope>

<version>${log4j.version}</version>

</dependency>

<!-- https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-api -->

<dependency>

    <groupId>org.apache.logging.log4j</groupId>

    <artifactId>log4j-api</artifactId>

    <version>${log4j.version}</version>

</dependency>

 

<!--用于解决web环境下关闭服务器时可能出现的log4j线程无法及时关闭的warn，web工程需要包含log4j-web，非web工程不需要 -->

<!-- https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-web -->

<dependency>

<groupId>org.apache.logging.log4j</groupId>

<artifactId>log4j-web</artifactId>

<scope>runtime</scope>

<version>${log4j.version}</version>

</dependency>

 

<!--使用log4j2的AsyncLogger时需要包含disruptor -->

<!-- https://mvnrepository.com/artifact/com.lmax/disruptor -->

<dependency>

    <groupId>com.lmax</groupId>

    <artifactId>disruptor</artifactId>

    <scope>runtime</scope>

    <version>3.4.2</version>

</dependency>

</dependencies>

日志配置文件内容示例：

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

<!-- 
 日志说明：

（1）请根据实际情况配置各项参数

（2）需要注意日志文件备份数和日志文件大小，注意预留目录空间

（3）实际部署的时候backupFilePatch变量需要修改成linux目录

 -->

<configuration status="error">

    <Properties>

        <Property name="fileName">front.log</Property>

        <Property name="backupFilePatch">d:/usr/front/log/</Property>

      </Properties>

    <!--先定义所有的appender-->

    <appenders>

        <!--这个输出控制台的配置-->

        <Console name="Console" target="SYSTEM_OUT">

             <!--控制台只输出level及以上级别的信息（onMatch），其他的直接拒绝（onMismatch）-->

            <ThresholdFilter level="trace" onMatch="ACCEPT" onMismatch="DENY" />

            <!--这个都知道是输出日志的格式-->

            <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n" />

        </Console>

        

        <!--这个会打印出所有的信息，每次大小超过size，则这size大小的日志会自动存入按年份-月份建立的文件夹下面并进行压缩，作为存档-->

        <RollingFile name="RollingFile" fileName="${backupFilePatch}/${fileName}"

            filePattern="${backupFilePatch}$${date:yyyy-MM}/app-%d{yyyyMMddHHmmssSSS}.log.gz">

            <PatternLayout

                pattern="%d{yyyy-MM-dd HH:mm:ss.SSS z} %-5level %class{36} %L %M - %msg%xEx%n" />

            

            <!-- 日志文件大小 -->

            <SizeBasedTriggeringPolicy size="20MB" />

            <!-- 最多保留文件数 -->

            <DefaultRolloverStrategy max="20"/>

        </RollingFile>

    </appenders>

    

    <!--然后定义logger，只有定义了logger并引入的appender，appender才会生效-->

    <loggers>

        <!--建立一个logger，此logger监听name对应的包名下的日志输出，level表示日志级别-->

        <Logger name="com.testlog" level="trace"

            additivity="true">

            <AppenderRef ref="RollingFile" />

        </Logger>

        <!--建立一个默认的root的logger-->

        <Root level="error">

         <!-- 在root中关联appender才会在对应的位置输出日志，定义一个输出到文件的appender也必须关联到此处才会保存日志到文件 -->

            <AppenderRef ref="Console" />

        </Root>

    </loggers>

</configuration>