本節內容基於 Spring Boot 2.0.java
更多請在Java技術棧微信公衆號後臺回覆關鍵字:boot。git
Spring Boot 內部代碼使用的是 commons-logging
來記錄日誌的,可是底層日誌實現框架是能夠隨意替換的。Spring Boot爲 Java Util Logging
, Log4J2
, 和 Logback
日誌框架提供了默認配置。github
Spring Boot支持的日誌框架默認配置以下。web
# LOGGING logging.config= # Location of the logging configuration file. For instance, `classpath:logback.xml` for Logback. logging.exception-conversion-word=%wEx # Conversion word used when logging exceptions. logging.file= # Log file name (for instance, `myapp.log`). Names can be an exact location or relative to the current directory. logging.file.max-history=0 # Maximum of archive log files to keep. Only supported with the default logback setup. logging.file.max-size=10MB # Maximum log file size. Only supported with the default logback setup. logging.level.*= # Log levels severity mapping. For instance, `logging.level.org.springframework=DEBUG`. logging.path= # Location of the log file. For instance, `/var/log`. logging.pattern.console= # Appender pattern for output to the console. Supported only with the default Logback setup. logging.pattern.dateformat=yyyy-MM-dd HH:mm:ss.SSS # Appender pattern for log date format. Supported only with the default Logback setup. logging.pattern.file= # Appender pattern for output to a file. Supported only with the default Logback setup. logging.pattern.level=%5p # Appender pattern for log level. Supported only with the default Logback setup. logging.register-shutdown-hook=false # Register a shutdown hook for the logging system when it is initialized.
若是不配置以上任何參數,日誌默認只會以 INFO
以上的級別打印在控制檯,不會記錄在日誌文件中。spring
若是使用了任何 Starters
,那 Spring Boot 默認會使用 Logback
日誌框架記錄日誌,併爲 Logback
提供了支持Java Util Logging
, Commons Logging
, Log4J
, SLF4J
適合的橋接器以便能從這些日誌門面中自由切換。即項目中無論使用哪一個日誌門面,Logback都能正常工做。apache
以下圖,從 spring-boot-starter-web
依賴樹中看出包含了默認日誌框架 Logback
及其餘的橋接器。微信
在配置文件 application.properties
添加如下配置。app
# 日誌級別 logging.level.root=DEBUG # 輸出到日誌文件 logging.file=d:/logs/javastack.log # 控制框架中的日誌級別 logging.level.org.springframework=INFO logging.level.sun=WARN
在 Application
啓動類中添加如下測試代碼。框架
private static final org.apache.commons.logging.Log logger1 = org.apache.commons.logging .LogFactory .getLog(SpringBootBestPracticeApplication.class); private static final org.slf4j.Logger logger2 = org.slf4j.LoggerFactory .getLogger(SpringBootBestPracticeApplication.class); private static final java.util.logging.Logger logger3 = java.util.logging.Logger .getLogger("SpringBootBestPracticeApplication"); @Bean public CommandLineRunner loggerLineRunner() { return (args) -> { logger1.error("commons logging error..."); logger1.info("commons logging info..."); logger2.info("slf4j info..."); logger2.info("java util logging info..."); logger1.debug("commons logging debug..."); }; }
日誌輸出以下。spring-boot
2018-05-24 17:16:21.645 ERROR 3132 --- [ main] c.j.s.SpringBootBestPracticeApplication : commons logging error... 2018-05-24 17:16:21.645 INFO 3132 --- [ main] c.j.s.SpringBootBestPracticeApplication : commons logging info... 2018-05-24 17:16:21.645 INFO 3132 --- [ main] c.j.s.SpringBootBestPracticeApplication : slf4j info... 2018-05-24 17:16:21.645 INFO 3132 --- [ main] c.j.s.SpringBootBestPracticeApplication : java util logging info... 2018-05-24 17:16:21.645 DEBUG 3132 --- [ main] c.j.s.SpringBootBestPracticeApplication : commons logging debug...
程序中使用了三種不一樣的日誌門面測試,和默認的 Logback
框架工做都十分正常,日誌也正常輸出到指定文件中了。
Spring Boot 默認提供配置的形式很是簡單,只適合簡單的日誌應用,雖說日誌輸出格式能夠自定義,但日誌文件如何按天滾動等其餘更復雜的策略卻不能配置,只能經過自定義引用日誌文件的形式。
簡單的日誌配置不能知足實際項目需求,那能夠經過引用定製日誌文件的形式達到目的。Spring Boot能根據類路徑下的類庫和配置文件自動配置對應的日誌框架。
日誌框架 | 配置文件 |
---|---|
Logback | logback-spring.xml, logback-spring.groovy, logback.xml, or logback.groovy |
Log4j2 | log4j2-spring.xml or log4j2.xml |
JDK (Java Util Logging) | logging.properties |
按對應類庫在 classpath 下建立對應支持的日誌配置文件就行,或者經過配置 logging.config
指定。
既然默認是支持 Logback
的,那如今只要在資源根目錄下建立一個 logback-spring.xml
文件便可。xx-spring
這是 Spring Boot 推薦的命名方式,不然 Spring Boot 不能徹底控制日誌初始化,由於默認命名配置文件 logback.xml
加載較早不能獲取到 application.properties
中的配置信息。
看到這裏,相信你對 Spring Boot 的日誌應該有了一個全面的瞭解。如何使用配置文件打印日誌和傳統項目同樣,這裏就不囉嗦了。
全部 Spring Boot 文章示例代碼都在 Github 上面,你們能夠 Star 關注一下。
https://github.com/javastacks...
關注Java技術棧,獲取更多幹貨推送!
本文原創首發於微信公衆號:Java技術棧(id:javastack),關注公衆號在後臺回覆 "boot" 可獲取更多,轉載請原樣保留本信息。