普通Java项目中使用Sl4j+Log4j2打印日志

    因工作需要，采用JavaFx开发了一个windows窗口程序。在开发过程中，由于没有引入日志框架，只能自己手动在控制台打印些信息，给调试带来了很多麻烦；因此决定引入日志框架。由于之前接触的项目大部分都是javaWeb项目，web项目的日志输出已经难不倒我了。但普通java项目日志输出配置还是第一次接触，因此记录下整个过程，方便后续借鉴。
    技术概述：采用Sl4j作为日志门面，Log4j2作为日志输出的具体实现；同时结合lombok插件，减少代码的书写。

一、相关Maven依赖

    由于copy jar包是非常麻烦的一件事，因此本次的这个普通java项目也是用Maven来构建的。
    采用Sl4j作为日志门面，Log4j2作为日志的实现，Lombok插件减少代码的书写。具体依赖如下：
        <!--lombok 依赖-->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.6</version>
        </dependency>

        <!--##### log4j2 start  ####-->
        <!--log4j2核心包-->
        <dependency>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-core</artifactId>
            <version>2.11.1</version>
        </dependency>
        <!-- Web项目才需要添加 -->
       <!-- <dependency>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-web</artifactId>
            <version>2.11.1</version>
        </dependency>-->
        <!--用于与slf4j保持桥接（里面自动依赖了slf4j-api）-->
        <dependency>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-slf4j-impl</artifactId>
            <version>2.11.1</version>
        </dependency>
        <!-- slf4j核心包，由于上面的桥接包里自动依赖进来了，因此不用加了-->
       <!-- <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.7.25</version>
        </dependency>-->
        <!--##### log4j2 end  ####-->

二、log4j2.xml的配置

    在加入依赖完成后，我们开始Lo4j2进行配置，这里重点关注log4j2的配置文件的读取位置
    说明：log4j2默认读取配置文件的位置如下
        （1）非Maven项目，src目录下的log4j2.xml
        （2）Maven项目，resouces目录下的log4j2.xml
    我这里是Maven项目，因此在resources目录下建了个log4j2.xml。xml中具体内容如下
<?xml version="1.0" encoding="UTF-8"?>
<!--
    status : 这个用于设置log4j2自身内部的信息输出,可以不设置,当设置成trace时,会看到log4j2内部各种详细输出。
    因此我们直接设置成OFF
 -->
<Configuration status="OFF">
    <!-- 配置输出端  -->
    <Appenders>
        <!-- 输出到控制台  -->
        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="[%-level]%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %logger{36} - %msg%n"/>
        </Console>

        <!-- 输出到文件 -->
        <!--
            name:           输出端的名字
            fileName:       指定当前日志文件的位置和文件名称
            filePattern:    指定当发生自动封存日志时，文件的转移和重命名规则
            这个filePatten结合下面的TimeBasedTriggeringPolicy一起使用，可以实现控制日志按天生成文件.
            自动封存日志的策略可以设置时间策略和文件大小策略（见下面的Policies配置）
            时间策略：
                文件名_%d{yyyy-MM-dd}_%i.log  这里%d表示自动封存日志的单位是天
                如果下面的TimeBasedTriggeringPolicy的interval设为1,
                表示每天自动封存日志一次;那么就是一天生成一个文件。
            文件大小策略：
                如果你设置了SizeBasedTriggeringPolicy的size的话，
                超过了这个size就会再生成一个文件，这里的%i用来区分的
            %d{yyyy-MM-dd}会自动替代为日期，如2017-06-30
        -->
        <RollingFile name="RollingFileInfo" fileName="/log/guitool_info.log"
                     filePattern="/log/%d{yyyy-MM-dd}/guitool_%d{yyyy-MM-dd}_%i.log">
            <!-- 只输出level及以上级别的信息（onMatch），其他的直接拒绝（onMismatch） -->
            <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>
            <!-- 输出的格式  -->
            <PatternLayout pattern="[%d{yyyy-MM-dd HH:mm:ss:SSS}] [%p] - %l - %m%n"/>
            <!--
                Policies：自动封存日志策略，表示日志什么时候应该产生新日志，
                可以有时间策略和大小策略等，并且：只有满足一个策略，就好生成一个新的文件。
                这里使用的是时间和大小都使用了，每隔1天产生新的日志文件
                如果果今天的文件大小到了设定的size，则会新生成一个文件，上面的%i就表示今天的第几个文件
             -->
            <Policies>
                <TimeBasedTriggeringPolicy interval="1"/>
                <SizeBasedTriggeringPolicy size="20MB"/>
            </Policies>
            <!--
                DefaultRolloverStrategy属性如不设置，
                则默认为最多同一文件夹下7个文件，这里设置了20
             -->
            <DefaultRolloverStrategy max="20"/>
        </RollingFile>
    </Appenders>
    <!-- 配置Loggers  -->
    <Loggers>
        <!--
            Logger： 用于指定部分包的日志级别
                日志级别局部的会覆盖全局的
                比如这里hibernate的级别设为debug，而控制台没有设级别，那么控制台会打印debug级别的日志
                而输出到文件这个输出端设置了info级别，那么hibernate的debug级别的日志还是看不了。
                所以最终输出的级别和输出端设置的级别是有关系的。
            name: 包名
            level：日志级别
            additivity：是否冒泡，既在当前logger的输出端输出日志后
                             是否需要在父输出端上输出该日志，默认为 true。
                             如果设为false，则必须配置AppendRef。
         -->
        <Logger name="org.hibernate" level="debug" additivity="true"/>

        <!-- 这个root是配置全局日志级别和输出端功能和老版的log4j中根的配置是一样的 -->
        <Root level="info">
            <!-- 这里引用上面定义的输出端，千万不要漏了。 -->
            <AppenderRef ref="Console"/>
            <!--<AppenderRef ref="RollingFileInfo"/>-->
        </Root>
    </Loggers>
</Configuration>
    如果对这些配置有疑问，可以参考我很久之前写的博客https://www.cnblogs.com/zeng1994/p/9296562.html

三、代码中的使用

    由于这里有引入了lombok插件（如果不懂可以百度或谷歌），在类上面添加@Sl4j的注解，然后下面就可以直接使用log输出日志了；具体的见下面代码
package com.jwx.digital.strategy.parse.impl;
import lombok.extern.slf4j.Slf4j;

/**
 * DbUserNameParseBatFileLineStategy
 *
 * @author ZENG.XIAO.YAN
 * @version 1.0
 * @Date 2019-07-20
 */
@Slf4j
public class DbUserNameParseBatFileLineStategy implements ParseBatFileLineStategy {
    /**
     * 解析内容，并将内容赋值到对应的TextField
     *
     * @param lineSufix
     * @param controller
     */
    @Override
    public void parseLineAndInitTextFieldText(String lineSufix, BaseController controller) {
        log.info("db userName: [{}]", lineSufix);
        CheckJdbcAndOtherController checkJdbcAndOtherController = (CheckJdbcAndOtherController) controller;
        checkJdbcAndOtherController.getDbUserNameField().setText(lineSufix);
    }
}
    重点关注下图中红色方块内的内容
                

四、小结

    （1）普通java项目输出日志和javaweb项目也没啥大的区别，引入相关依赖并配置即可
    （2）log4j2默认读的配置文件位置为src目录下（如果是Maven项目则是resources文件夹下）的log4j2.xml
    （3）输出日志时，建议采用Sl4j日志门面，方便后续切换日志框架
posted @ 2019-07-30 23:36  zeng1994  阅读(7465)  评论(1)  编辑  收藏  举报