前天Spring Boot 1.5終于迎來了第一個RELEASE版本:1.5.0,但是由于一個編譯依賴問題在第二天直接連擊到了1.5.1荞彼。該版本的發(fā)布包含了超過320位貢獻(xiàn)者的奉獻(xiàn)眯停、10000多次的代碼提交。
每次Spring Boot版本更新所帶來的新特性都是我們每個用戶特別關(guān)注的卿泽。雖然其中不少特性可能對于大部分用戶來說還不一定適用,但是作為基礎(chǔ)知識的儲備還是有一定的必要性滋觉。對于1.5.x版本的新特性列表讀者可以直接查看官方博文:《Spring Boot 1.5.1 released》來了解它們签夭,本文不做這些概要性的介紹。在后續(xù)的一段時間內(nèi)椎侠,本博客將會陸續(xù)介紹一些筆者關(guān)心且將會使用的關(guān)于Spring Boot 1.5.x中的一些新特性第租。
loggers端點
本文我們就來看看Spring Boot 1.5.x中引入的一個新的控制端點:/loggers
,該端點將為我們提供動態(tài)修改Spring Boot應(yīng)用日志級別的強(qiáng)大功能我纪。該功能的使用非常簡單慎宾,它依然延續(xù)了Spring Boot自動化配置的實現(xiàn)丐吓,所以只需要在引入了spring-boot-starter-actuator
依賴的條件下就會自動開啟該端點的功能(更多關(guān)于spring-boot-starter-actuator
模塊的詳細(xì)介紹可見:《Spring Boot Actuator監(jiān)控端點小結(jié)》一文)。
下面趟据,我們不妨通過一個實際示例來看看如何使用該功能:
構(gòu)建一個基礎(chǔ)的Spring Boot應(yīng)用券犁。如果您對于如何構(gòu)建還不熟悉,可以參考《使用Intellij中的Spring Initializr來快速構(gòu)建Spring Boot/Cloud工程》一文汹碱。
-
在
pom.xml
引入如下依賴(如果使用Intellij中的Spring Initializr的話直接在提示框中選下web和actuator模塊即可)粘衬。<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>1.5.1.RELEASE</version> <relativePath/> <!-- lookup parent from repository --> </parent> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> </dependencies>
-
在應(yīng)用主類中添加一個接口用來測試日志級別的變化,比如下面的實現(xiàn):
@RestController @SpringBootApplication public class DemoApplication { private Logger logger = LoggerFactory.getLogger(getClass()); @RequestMapping(value = "/test", method = RequestMethod.GET) public String testLogLevel() { logger.debug("Logger Level :DEBUG"); logger.info("Logger Level :INFO"); logger.error("Logger Level :ERROR"); return ""; } public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }
-
為了后續(xù)的試驗順利咳促,在
application.properties
中增加一個配置稚新,來關(guān)閉安全認(rèn)證校驗。management.security.enabled=false
不然在訪問
/loggers
端點的時候跪腹,會報如下錯誤:{ "timestamp": 1485873161065, "status": 401, "error": "Unauthorized", "message": "Full authentication is required to access this resource.", "path": "/loggers/com.didispace" }
測試驗證
在完成了上面的構(gòu)建之后褂删,我們啟動示例應(yīng)用,并訪問/test
端點冲茸,我們可以在控制臺中看到如下輸出:
2017-01-31 22:34:57.123 INFO 16372 --- [nio-8000-exec-1] ication$$EnhancerBySpringCGLIB$$d2a0b1e2 : Logger Level :INFO
2017-01-31 22:34:57.124 ERROR 16372 --- [nio-8000-exec-1] ication$$EnhancerBySpringCGLIB$$d2a0b1e2 : Logger Level :ERROR
由于默認(rèn)的日志級別為INFO
屯阀,所以并沒有輸出DEBUG
級別的內(nèi)容。下面我們可以嘗試通過/logger
端點來將日志級別調(diào)整為DEBUG
噪裕,比如蹲盘,發(fā)送POST請求到/loggers/com.didispace
端點,其中請求體Body內(nèi)容為:
{
"configuredLevel": "DEBUG"
}
重新訪問/test
端點膳音,我們將在控制臺中看到如下輸出召衔,在/test
端點中定義的DEBUG
日志內(nèi)容被打印了出來:
2017-01-31 22:37:35.252 DEBUG 16372 --- [nio-8000-exec-5] ication$$EnhancerBySpringCGLIB$$d2a0b1e2 : Logger Level :DEBUG
2017-01-31 22:37:35.252 INFO 16372 --- [nio-8000-exec-5] ication$$EnhancerBySpringCGLIB$$d2a0b1e2 : Logger Level :INFO
2017-01-31 22:37:35.252 ERROR 16372 --- [nio-8000-exec-5] ication$$EnhancerBySpringCGLIB$$d2a0b1e2 : Logger Level :ERROR
可以看到,到這里為止祭陷,我們并沒有重啟過Spring Boot應(yīng)用苍凛,而只是簡單的通過調(diào)用/loggers
端點就能控制日志級別的更新。除了POST請求之外兵志,我們也可以通過GET請求來查看當(dāng)前的日志級別設(shè)置醇蝴,比如:發(fā)送GET請求到/loggers/com.didispace
端點,我們將獲得對于com.didispace
包的日志級別設(shè)置:
{
"configuredLevel": "DEBUG",
"effectiveLevel": "DEBUG"
}
我們也可以不限定條件想罕,直接通過GET請求訪問/loggers
來獲取所有的日志級別設(shè)置悠栓,這里就不列舉具體返回,讀者可以自行嘗試按价。