spring logback 加异常消息编码 logback springproperty

转载

冷月星 2024-04-17 13:58:46

文章标签 logback不输出至文件 logback日志打印出方法 spring boot logback 文章分类 架构后端开发

每一个成功人士的背后，必定曾经做出过勇敢而又孤独的决定。

放弃不难，但坚持很酷~

一、logback日志框架

logback 是一个开源的日志组件，由三个部分组成：logback-core，logback-classic，logback-access。其中 logback-core 是其他两个模块的基础。

在 spring boot 中，由于 spring-boot-starter-web 和 spring-boot-starter-logging 是有依赖关系的，所以只需要引入 spring-boot-starter-web 就可以使用 logback 框架了。

logback 中有几个常用标签：

property、appender，encoder、filter、rollingPolicy、logger、root 等，下文会有详细介绍。

spring boot 会默认加载 logback-spring.xml 文件，如果自定义配置名称(logback-test.xml)的话，可在 application.xml 文件内添加：

logging:
config: classpath:logback-test.xml

先来看一下配置大概：

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

...

configuration 标签有三个属性：

scan：当此属性设置为 true 时，spring boot 会每隔一段时间扫描一次该文件，默认是 true 。
scanperiod：设置扫描间隔时间，如果没有设置时间单位，默认为毫秒。当 scan 为 true 时，此属性生效。默认的时间间隔为 1 分钟。
debug：当此属性设置为 true 时，将打印 logback 的内部日志，实时查看 logback 运行状态。默认值为 false 。

二、自定义logback-spring.xml文件

2.1、日志输出到控制台：

<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%nUTF-8
appender>

表示对日志输出进行编码：

%d{HH: mm:ss.SSS}：日志输出时间
%thread：输出日志的进程名字，这在 Web 应用以及异步任务处理中很有用。
%-5level：日志级别，并且使用5个字符靠左对齐
%logger{36}：日志输出的类名
%msg：日志消息
%n：换行符

2.2、日志输出到文件

按日志级别输出到文件，将 error 级别的日志与其它级别的日志进行分离：

<appender name="FILE-INFO-ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender">

<append>trueappend>
${LOG_PATH}/info/${LOG_INFO_FILE}}
ERRORDENYismatch>ACCEPTismatch>
${LOG_PATH}/info/info.%d{yyyy-MM-dd}.%i.log.gz10MB20GBistory>60istory>
%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%nUTF-8
appender>


<appender name="FILE-ERROR-ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender">

<append>trueappend>
${LOG_PATH}/error/${LOG_ERROR_FILE}
ERROR
${LOG_PATH}/error/error.%d{yyyy-MM-dd}.%i.log.gz10MB20GBistory>60istory>

%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger - %msg%nUTF-8
appender>

关于日志输出到文件的配置代码有很多，本文尽量详细地一一说明：

property：用来定义变量值的标签。property 标签有两个属性，name 和 value ，其中 name 的值是变量的名称，value 的值是变量定义的值。定义变量后，可以使 “${name}” 来使用变量。
appender：有两个属性 name 和 class，name 指定 appender 名称，class 指定 appender 的全限定名。
append：如果是 true ，日志被追加到文件结尾，如果是 false，清空现存文件，默认是 true 。
filter：可以为 appender 添加一个或多个过滤器，可以用任意条件对日志进行过滤。执行一个过滤器会有返回 DENY，NEUTRAL，ACCEPT 其中之一。

DENY：日志将立即被抛弃不再经过其他过滤器。
NEUTRAL：有序列表里的下个过滤器过接着处理日志。
ACCEPT：日志会被立即处理，不再经过剩余过滤器。
appender 有多个过滤器时，按照配置顺序执行。过滤器种类分为：
LevelFilter：级别过滤器，根据日志级别进行过滤。如果日志级别等于配置级别，过滤器会根据 onMath 和 onMismatch 接收或拒绝日志。有以下子标签：

：设置过滤级别。
：用于配置符合日志级别的操作。
ismatch>：用于配置不符合日志级别的操作。

ThresholdFilter：临界值过滤器，过滤掉低于指定临界值的日志。当日志级别等于或高于临界值时，过滤器返回 NEUTRAL 。当日志级别低于临界值时，日志会被拒绝。

rollingPolicy：描述滚动策略，这个只有 appender 的 class 是 RollingFileAppender 时才需要配置。滚动策略有很多，本文使用的是 SizeAndTimeBasedRollingPolicy ，是基于时间和文件大小的滚动策略。

fileNamePattern：滚动文件的名称。
maxFileSize：单个文件最大容量，到达这一阈值，就会生成滚动文件。
totalSizeCap：日志所有文件的总大小，如果总大小大于该阈值，它将删除旧文件。
maxHistory：按照 fileNamePattern 设置的最小单位来设定，示例配置代码的最小单位是天，则该配置就是保留多少天的历史日志。

2.3、自定义包/类的日志级别

<appender-ref ref="CONSOLE"/>
<appender-ref ref="FILE-INFO-ROLLING"/>
<appender-ref ref="FILE-ERROR-ROLLING"/>

上述配置表示：com.study.spring.helloDemo 这个类中的 warn 级别日志将会使用 CONSOLE、FILE-INFO-ROLLING、FILE-ERROR-ROLLING 来打印。logger 有三个属性和一个子标签：

name：用来指定受此 logger 约束的某一个包或者具体的某一个类。
level：用来设置打印级别(TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF)。
addtivity：用来描述是否向上级 logger 传递打印信息。默认是 true 。
appender-ref：指定具体 appender。

2.4、项目所有日志输出设置

<appender-ref ref="CONSOLE"/>
<appender-ref ref="FILE-INFO-ROLLING"/>
<appender-ref ref="FILE-ERROR-ROLLING"/>

上述配置指定项目所有日志输出级别，也是一种 logger ，且只有一个 level 属性。appender-ref 标签用来指定具体的 appender 。

三、main 方法加载日志配置

spring-logback.xml 文件是 spring boot 启动项目时进行加载的。但如果单单执行一个 main 方法，由于没有加载 spring-logback.xml 文件，所以日志不会被加载到文件中，只会输出在控制台。所以首先需要使用代码实现配置文件的加载。完整代码如下：

import ch.qos.logback.classic.LoggerContext;
import ch.qos.logback.classic.joran.JoranConfigurator;
import ch.qos.logback.core.joran.spi.JoranException;
import ch.qos.logback.core.util.StatusPrinter;
import org.slf4j.LoggerFactory;

import java.io.File;
import java.io.IOException;

/**
* @description: 加载配置文件
*/
public class LogBackConfigLoader {

public static void load (String externalConfigFileLocation) throws IOException, JoranException {
LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory;

File externalConfigFile = new File(externalConfigFileLocation);
if(!externalConfigFile.exists){
throw new IOException("Logback External Config File Parameter does not reference a file that exists");
}else{
if(!externalConfigFile.isFile){
throw new IOException("Logback External Config File Parameter exists, but does not reference a file");
}else{
if(!externalConfigFile.canRead){
throw new IOException("Logback External Config File exists and is a file, but cannot be read.");
}else{
JoranConfigurator configurator = new JoranConfigurator;
configurator.setContext(lc);
lc.reset;
configurator.doConfigure(externalConfigFileLocation);
StatusPrinter.printInCaseOfErrorsOrWarnings(lc);
}
}
}
}
}

我们新建一个类，创建一个 main 方法，在 main 方法中添加 spring-logback.xml 文件的加载代码：

LogBackConfigLoader.load(Objects.requireNon(LogbackTest.class.getClassLoader.getResource("logback-spring.xml")).getPath);

再结合

四、junit 测试类加载日志配置

测试类，我试着默认情况下也是不加载日志配置的，有两种方法可以解决：

使用 main 方法那种方式来加载日志配置。
使用 spring boot 的注解也可以解决。

先说第一种：使用 main 方法那种方式来加载日志配置。

优点：运行测试类，执行速度快。

缺点：配置较第二种方式较复杂，代码量多。

import ch.qos.logback.core.joran.spi.JoranException;
import org.junit.Test;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.IOException;
import java.util.Objects;

/**
* @description: 测试类加载日志配置测试
*/
public class LogbackTest {

private static final Logger logger = LoggerFactory.getLogger(LogbackTest.class);

@Test
public void test{
try {
LogBackConfigLoader.load(Objects.requireNon(LogbackTest.class.getClassLoader.getResource("logback-spring.xml")).getPath);
} catch (IOException | JoranException e) {
e.printStackTrace;
}
logger.info("info123");
logger.warn("warn");
logger.debug("debug");
logger.error("error");
}
}

再说第二种方式：使用 spring boot 注解

优点：配置简单，俩注解完事，代码量少。

缺点：运行测试类，要先类似于启动一遍 spring boot，执行速度慢。

import org.junit.Test;
import org.junit.runner.RunWith;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;

/**
* @description: 测试类加载日志配置测试
*/
@RunWith(SpringRunner.class)
@SpringBootTest
public class LogbackTest {

private static final Logger logger = LoggerFactory.getLogger(LogbackTest.class);

@Test
public void test{
logger.info("info123");
logger.warn("warn");
logger.debug("debug");
logger.error("error");
}
}