SpringBoot日志框架如何使用
不管是開發(fā)過程中調(diào)試還是線上問題的定位追蹤，日志都發(fā)揮著及其重要的作用。平時，我們會用System.out.println()打印一些信息到控制臺，我們可以使用該語句輸出日志，但是System.out會增加資源的消耗，所以最好使用日志框架打印日志信息。
Java中的日志框架有JCL、Jboss-logging、slf4j、logback、log4j、log4j2等等，其中JCL、Jboss-logging、slf4j屬于日志門面（日志的抽象），logback、log4j、log4j2是日志框架的具體實現(xiàn)。阿里巴巴開發(fā)規(guī)范強制要求使用日志的門面而不要直接使用日志系統(tǒng)的API。
【強制】應(yīng)用中不可直接使用日志系統(tǒng)（Log4j、Logback）中的 API，而應(yīng)依賴使用日志框架（SLF4J、JCL--Jakarta Commons Logging）中的 API，使用門面模式的日志框架，有利于維護和各個類的日志處理方式統(tǒng)一。
日志門面不是日志解決方案，它只服務(wù)于各種各樣的日志系統(tǒng)，這就允許最終用戶在部署應(yīng)用時可以隨意使用其所希望的日志系統(tǒng)。也就是說如果開始使用slf4j+logback記錄日志，則項目會按logback的風(fēng)格打印日志，后期如果我們想更改為log4j風(fēng)格的輸出，則只需將logback替換為log4j即可，不需改變項目中的任何代碼。
slf4j+logback也是SpringBoot中默認整合的日志框架。
如何使用
public class LoggerService {
private static final Logger logger = LoggerFactory.getLogger(LoggerService.class);
public void printLog() {
logger.trace("trace日志……");
logger.debug("debug日志……");
logger.info("info日志……");
logger.warn("warn日志……");
logger.error("error日志……");
}
}
使用LoggerFactory生成Logger對象，然后調(diào)用Logger對象的相應(yīng)日志級別的方法打印即可。另外，在輸出日志時，字符串的拼接要使用占位符替換不要使用append等方法。
【強制】在日志輸出時，字符串變量之間的拼接使用占位符的方式。說明：因為 String 字符串的拼接會使用 StringBuilder 的 append()方式，有一定的性能損耗。使用占位符僅是替換動作，可以有效提升性能。正例：logger.debug("Processing trade with id: {} and symbol: {}", id, symbol);
上述代碼的運行效果：
2020-12-28 13:32:40.751 INFO 16016 --- [nio-8080-exec-2] c.c.e.e.service.LoggerService : info日志…… 2020-12-28 13:32:40.751 WARN 16016 --- [nio-8080-exec-2] c.c.e.e.service.LoggerService : warn日志…… 2020-12-28 13:32:40.751 ERROR 16016 --- [nio-8080-exec-2] c.c.e.e.service.LoggerService : error日志……
從運行效果可以看出，SpringBoot默認的日志級別（trace < debug < info < warn < error）是info。
指定配置
SpringBoot日志的默認配置在org\springframework\boot\spring-boot\2.4.1\spring-boot-2.4.1.jar!\org\springframework\boot\logging\logback\defaults.xml文件中，內(nèi)容如下：
<?xml version="1.0" encoding="UTF-8"?>
<!--
Default logback configuration provided for import
-->
<included>
<conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter" />
<conversionRule conversionWord="wex" converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter" />
<conversionRule conversionWord="wEx" converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter" />
<property name="CONSOLE_LOG_PATTERN" value="${CONSOLE_LOG_PATTERN:-%clr(%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd HH:mm:ss.SSS}}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>
<property name="CONSOLE_LOG_CHARSET" value="${CONSOLE_LOG_CHARSET:-default}"/>
<property name="FILE_LOG_PATTERN" value="${FILE_LOG_PATTERN:-%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd HH:mm:ss.SSS}} ${LOG_LEVEL_PATTERN:-%5p} ${PID:- } --- [%t] %-40.40logger{39} : %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>
<property name="FILE_LOG_CHARSET" value="${FILE_LOG_CHARSET:-default}"/>
<logger name="org.apache.catalina.startup.DigesterFactory" level="ERROR"/>
<logger name="org.apache.catalina.util.LifecycleBase" level="ERROR"/>
<logger name="org.apache.coyote.http11.Http11NioProtocol" level="WARN"/>
<logger name="org.apache.sshd.common.util.SecurityUtils" level="WARN"/>
<logger name="org.apache.tomcat.util.net.NioSelectorPool" level="WARN"/>
<logger name="org.eclipse.jetty.util.component.AbstractLifeCycle" level="ERROR"/>
<logger name="org.hibernate.validator.internal.util.Version" level="WARN"/>
<logger name="org.springframework.boot.actuate.endpoint.jmx" level="WARN"/>
</included>
里面定義了默認的日志輸出格式， org\springframework\boot\spring-boot\2.4.1\spring-boot-2.4.1.jar!\org\springframework\boot\logging\logback\base.xml 文件中定義了日志默認級別。如果想要使用自定義的配置，在類路徑下放上日志框架自己對應(yīng)的配置文件即可，如logback對應(yīng)logback-spring.xml或logback.xml，log4j2對應(yīng)log4j2-spring.xml或log4j2.xml，這樣Springboot便不在使用默認配置。
SpringBoot 官方建議在日志配置中使用 -spring 的配置方式(例如，使用 logback-spring.xml 而不是 logback.xml)。如果使用標(biāo)準(zhǔn)配置位置，Spring 無法完全控制日志初始化。
另外官方文檔中有明確提到，JUL(ava Util Logging) 在 FATJAR 場景下存在一些已知的類加載問題，所以要盡量避免在 FATJAR 場景下使用 JUL。
使用這種命名方式日志框架就不會直接加載日志的配置，而改由SpringBoot加載，同時使用SpringBoot的高級Profile功能指定某段配置只在某個環(huán)境下生效。
<springProfile name="dev"> <!-- 激活dev下的配置 --> </springProfile> <springProfile name="!production"> <!-- 激活非production下的配置 --> </springProfile>
示例
<appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">
<layout class="ch.qos.logback.classic.PatternLayout">
<!-- 該輸出格式只在dev下生效 -->
<springProfile name="dev">
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} ----> [%thread] ---> %-5level %logger{50} - %msg%n</pattern>
</springProfile>
</layout>
</appender>
logback配置詳解
logback完整配置如下
<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false">
<!-- 日志文件的地址，windows和Linux下都要寫絕對地址 -->
<property name="LOG_HOME" value="/home" />
<!-- 日志輸出格式：%d表示日期，%thread表示線程名，%-5level：級別從左顯示5個字符寬度,%msg：日志消息，%n是換行符 -->
<property name="LOG_PATTERN" value="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n" />
<!--控制臺輸出 -->
<appender name="CONSOLE_OUT" class="ch.qos.logback.core.ConsoleAppender">
<encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
<!-- 輸出格式，直接引用上面定義的property -->
<pattern>${LOG_PATTERN}</pattern>
</encoder>
</appender>
<!--文件輸出， 每天生成日志文件 -->
<appender name="FILE_OUT" class="ch.qos.logback.core.rolling.RollingFileAppender">
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<!--日志文件名-->
<FileNamePattern>${LOG_HOME}/XXX.log.%d{yyyy-MM-dd}.log</FileNamePattern>
<!--日志文件保留天數(shù)，15天是阿里巴巴開發(fā)規(guī)范中的最低要求-->
<MaxHistory>15</MaxHistory>
</rollingPolicy>
<encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
<!--輸出格式，同上-->
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
</encoder>
<!--日志文件最大的大小-->
<triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
<MaxFileSize>10MB</MaxFileSize>
</triggeringPolicy>
</appender>
<!-- myibatis日志配置 -->
<logger name="com.apache.ibatis" level="TRACE"/>
<logger name="java.sql.Connection" level="DEBUG"/>
<logger name="java.sql.Statement" level="DEBUG"/>
<logger name="java.sql.PreparedStatement" level="DEBUG"/>
<!-- 日志輸出級別 -->
<root level="DEBUG">
<appender-ref ref="CONSOLE_OUT" />
<appender-ref ref="FILE_OUT"/>
</root>
</configuration>
更換日志框架
SpringBoot中的日志實現(xiàn)默認是logback，假如我們要更換其他日志實現(xiàn)，假如要更換為Log4j2，該怎么做呢？
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <exclusions> <!-- 移除原實現(xiàn) --> <exclusion> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-logging</artifactId> </exclusion> </exclusions> </dependency> <!-- 引入新實現(xiàn) --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-log4j2</artifactId> </dependency>
總結(jié)一下就是分為兩步：
移除原日志的實現(xiàn)，根據(jù)新使用的日志實現(xiàn)不同需移除的項目也有所不同，如要使用log4j則需移除以下依賴。
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <exclusions> <exclusion> <artifactId>logback-classic</artifactId> <groupId>ch.qos.logback</groupId> </exclusion> <exclusion> <artifactId>log4j-over-slf4j</artifactId> <groupId>org.slf4j</groupId> </exclusion> </exclusions> </dependency>
引入新實現(xiàn)的依賴。
log4j需引入，這是一個適配層的包，其自動依賴了log4j。
<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> </dependency>
log4j2需引入。
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-log4j2</artifactId> </dependency>
以上就是SpringBoot日志框架如何使用的詳細內(nèi)容，更多關(guān)于SpringBoot日志框架的資料請關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
這篇文章主要介紹了java服務(wù)器端跨域問題解決方案,文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友可以參考下2020-01-01
這篇文章主要為大家詳細介紹了java實現(xiàn)簡單貪吃蛇小游戲，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2021-05-05
面向?qū)ο缶幊淌且环N編程方式，此編程方式的落地需要使用“類”和 “對象”來實現(xiàn)，所以，面向?qū)ο缶幊唐鋵嵕褪菍?nbsp;“類”和“對象” 的使用，面向切面編程，簡單的說，就是動態(tài)地將代碼切入到類的指定方法、指定位置上的編程思想就是面向切面的編程2022-10-10
Mybatis中傳遞多個參數(shù)的4種方法總結(jié)
這篇文章主要給大家介紹了關(guān)于Mybatis中傳遞多個參數(shù)的4種方法，并且介紹了關(guān)于使用Mapper接口時參數(shù)傳遞方式，文中通過示例代碼介紹的非常詳細，需要的朋友可以參考借鑒，下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧。2018-04-04
Java synchronize底層實現(xiàn)原理及優(yōu)化
這篇文章主要介紹了Java synchronize底層實現(xiàn)原理及優(yōu)化,文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友可以參考下2020-03-03
Spring Boot的listener(監(jiān)聽器)簡單使用實例詳解
監(jiān)聽器（Listener）的注冊方法和 Servlet 一樣，有兩種方式：代碼注冊或者注解注冊。接下來通過本文給大家介紹Spring Boot的listener(監(jiān)聽器)簡單使用,需要的朋友可以參考下2017-04-04
這篇文章主要給大家介紹了關(guān)于Idea打War包流程的相關(guān)資料,IDEA導(dǎo)出war包的方式與MyEclipse有一點不同,文中通過圖文介紹的非常詳細,需要的朋友可以參考下2023-08-08
SpringBoot整合Redis的哨兵模式的實現(xiàn)
Redis提供了哨兵模式來處理主從切換和故障轉(zhuǎn)移,本文主要介紹了SpringBoot整合Redis的哨兵模式的實現(xiàn),文中通過示例代碼介紹的非常詳細,對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2024-08-08
這篇文章主要介紹了Java編程中的equals方法使用全解,是Java入門學(xué)習(xí)中的基礎(chǔ)知識,需要的朋友可以參考下2015-10-10
本篇文章主要介紹了如何解決springboot讀取配置文件的中文亂碼問題，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看2018-05-05