+````
+
+### 5 @Service
+ӦóҵͨפڷУǽʹ@Service עָʾһڸò㣺
+
+````
+@Service
+public class VehicleService {
+// ...
+}
+````
+### 6 @Controller
+@Controller һ༶ע⣬ Spring Framework Ϊ Spring MVC еĿ
+
+spring@Controller עbeanܶ飬ǻSpringMVCص
+
+````
+@Controller
+public class VehicleController {
+// ...
+}
+
+````
+## 7 @Configuration
+
+@Bean ע͵ bean 巽
+````
+@Configuration
+class VehicleFactoryConfig {
+
+ @Bean
+ Engine engine() {
+ return new Engine();
+ }
+
+}
+````
+## 8 AOPע
+ʹ Spring עʱ״һ㣬оض͵ΪĿꡣ
+
+磬 DAO 㷽ִʱ䡣 ǽ·棨ʹ AspectJ עͣ @Repository ͣ
+
+```
+@Aspect
+@Component
+public class PerformanceAspect {
+@Pointcut("within(@org.springframework.stereotype.Repository *)")
+public void repositoryClassMethods() {};
+
+ @Around("repositoryClassMethods()")
+ public Object measureMethodExecutionTime(ProceedingJoinPoint joinPoint)
+ throws Throwable {
+ long start = System.nanoTime();
+ Object returnValue = joinPoint.proceed();
+ long end = System.nanoTime();
+ String methodName = joinPoint.getSignature().getName();
+ System.out.println(
+ "Execution of " + methodName + " took " +
+ TimeUnit.NANOSECONDS.toMillis(end - start) + " ms");
+ return returnValue;
+ }
+}
+````
+
+ڴʾУǴһ㣬ƥʹ@Repository ע͵ез Ȼʹ@Around ֪ͨλǸ㣬ȷطõִʱ䡣
+
+⣬ʹַǿΪÿӦó־¼ܹƺΪ
+
+ȻˣaspectJעܶ࣬棬δҲᵥдĽܡ
+
+## 9
+
+ڱУǼ Spring עͲǸԴ͡
+
+ǻѧϰʹɨҵע͵ࡣ
+
+˽Щעε¸ɾֲԼӦóע֮ķ롣 ǻʹøСΪDzҪֶʽ bean
+
+# ο
+https://www.baeldung.com/spring-annotations
+
diff --git "a/docs/spring/Spring\346\246\202\350\277\260.md" "b/docs/spring/Spring\346\246\202\350\277\260.md"
new file mode 100644
index 0000000..1152df8
--- /dev/null
+++ "b/docs/spring/Spring\346\246\202\350\277\260.md"
@@ -0,0 +1,145 @@
+Spring Java EE һĿԴܣɱΪSpring ֮ Rod Johnson 2002 ĿҪ Java ҵӦóĿѶȺڡ
+
+Spring ԵһֱԱΪ Java ҵӦóѡʱգSpring ٲȻΪ Java EE ʣΪ˹ Java EE Ӧõʵ
+
+## Spring ĵ뷢չ
+
+ڵ J2EEJava EE ƽ̨Ƴ EJB ΪĵĿʽֿʽʵʵĿдֱˣʹøӡӷסǿڳֲѶȴȡ
+
+Rod Johnson 2004 ij顶Expert One-on-One J2EE Development without EJBУ EJB ӷĽṹһķͷֱԸӼķʽ滻
+
+ⱾУRod Johnson ͨһ 3 дĸչʾڲʹ EJB ¹һչ Java ӦóУRod Johnson длṹ룬аõ Java ӿں࣬ ApplicationContextBeanFactory ȡЩĸΪ com.interface21Ϊṩ 21 ͵һο
+
+ⱾӰԶ Rod Johnson com.interface21 Ĵ뿪Դ¿ܲΪSpringΪSpring һƴһɨƽͳ J2EE ĺ
+
+2003 2 £Spring 0.9 汾 Apache 2.0 ԴЭ飻2004 4 £Spring 1.0 汾ʽĿǰΪֹSpring Ѿ뵽˵ 5 汾Ҳdz˵ Spring 5
+
+## Spring
+
+ڲͬﾳУSpring ĺDzͬġǾͷֱӡ塱͡塱Ƕȣ Spring нܡ
+
+### SpringSpring ջ
+
+ϵ Spring ָ Spring Framework Ϊĵ Spring ջ
+
+ʮķչSpring ѾһӦÿܣչΪһɶͬĿģ飩ɵij켼 Spring FrameworkSpring MVCSpringBootSpring CloudSpring DataSpring Security ȣ Spring Framework ĿĻ
+
+ЩĿ˴ҵӦÿƼȸݣܹԱչвϲĸʵ⣬Ա˸õĿ顣
+
+| Ŀ | |
+| --- | --- |
+| Spring Data | Spring ṩݷģ飬 JDBC ORM ṩ˺ܺõ֧֡ͨԱʹһͳһķʽλڲͬݿеݡ |
+| Spring Batch | һרҵϵͳеճܣܹԱĿ׳ЧӦó |
+| Spring Security | ǰΪ Acegi Spring нϳģ֮һһԶƻ֤ͷʿƿܡ |
+| Spring Mobile | Ƕ Spring MVC չƶ Web ӦõĿ |
+| Spring Boot | Spring Ŷṩȫ¿ܣΪ Spring ԼһЩ伴õãԼ Spring ӦõĴ̡ |
+| Spring Cloud | һ Spring Boot ʵֵܡijһżһϵܵϡϳġ֤ͨ Spring Boot ˼ٷװεиӵúʵԭΪԱṩһײάķֲʽϵͳ߰ |
+
+### SpringSpring Framework
+
+ Spring ָ Spring FrameworkͨǽΪ Spring ܡ
+
+Spring һֲġ Java Ӧóһվʽ Spring ջĺĺͻΪ˽ҵӦÿĸԶġ
+
+Spring IJ֣ IoC AOP
+
+| | |
+| --- | --- |
+| IOC | Inverse of Control ļдΪƷתָѴ̽ Spring й |
+| AOP | Aspect Oriented Programming ļдΪ̡AOP װĹΪЩҵأȴΪҵģͬõװϵͳظ룬ģ϶ȡ⣬AOP һЩϵͳϵ⣬־Ȩȡ |
+
+Spring һֻ Bean ı̵̼ظı Java 硣Spring ʹü Java Bean ǰֻ EJB ɵĹʹúܶิӵĴźͼ࣬ EJB ӷסЧĿģʽķĿĺάչ
+
+ʵʿУӦóͨϵֱܹΪֲ㣨webҵ㣨service־ò㣨dao
+
+Spring Java EE ӦøĽÿһ㶼ṩ˼֧֡
+
+* ڱֲṩ˶ Spring MVCStruts2 ȿܵϣ
+* ҵṩ˹ͼ¼־Ĺܣ
+* ڳ־ò㻹 MyBatisHibernate JdbcTemplate ȼݿзʡ
+
+ֵ Spring һȫĽЩѾнϺýSpring ظ顣
+
+ϿSpring ܸ Java ԱߵɶȣҵijҲṩõĽڿԴܵ˹㷺Ļӭұֹ˾Ϊ Java Ŀѡܡ
+
+## Spring Framework ص
+
+Spring ܾ¼ص㡣
+
+### ****
+
+Spring һԽжĴϵά Spring
+
+### **㼯ɸ**
+
+Spring ųĿԴܣڲṩ˶Ըܣ Struts2HibernateMyBatis ȣֱ֧֡
+
+### ** Java EE API ʹѶ**
+
+Spring Java EE зdzõһЩ APIJDBCJavaMailԶ̵õȣṩ˷װʹЩ API ӦõѶȴ͡
+
+### **IJ**
+
+Spring ֧ JUnit4ͨעⷽز Spring
+
+### **AOP ̵֧**
+
+Spring ṩ̣ԷʵֶԳȨغмصȹܡ
+
+### **ʽ֧**
+
+ֻҪͨþͿɶĹֶ̡
+
+Spring ܻҵӦÿĸ棬 20 ͬģ顣
+
+spring-aop spring-context-indexer spring-instrument spring-orm spring-web
+spring-aspects spring-context-support spring-jcl spring-oxm spring-webflux
+spring-beans spring-core spring-jdbc spring-r2dbc spring-webmvc
+spring-context spring-expression spring-jms spring-test spring-websocket
+spring-messaging spring-tx
+
+
+ͼ1Springܹͼ
+
+ͼа Spring ܵģ飬ЩģһҵӦÿڿпԸѡԵʹҪģ顣ֱЩģýмܡ
+
+## 1\. Data Access/Integrationݷʣɣ
+
+ݷʣɲ JDBCORMOXMJMS Transactions ģ飬¡
+
+* JDBC ģ飺ṩһ JBDC ģ壬ʹЩģͳ߳ JDBC 뻹бƣܵ Spring ĺô
+* ORM ģ飺ṩеġ-ϵӳ켯ɵ API JPAJDOHibernate MyBatis ȡһʹ Spring
+* OXM ģ飺ṩһ֧ Object /XML ӳijʵ֣ JAXBCastorXMLBeansJiBX XStream Java ӳ XML ݣ߽XML ӳ Java
+* JMS ģ飺ָ Java Ϣṩһ ϢߡϢߡģڸӼʹ JMSJMS Ӧó֮䣬ֲʽϵͳзϢ첽ͨš
+* Transactions ģ飺ֱ֧̺ʽ
+
+## 2\. Web ģ
+
+Spring Web WebServletWebSocket Portlet ¡
+
+* Web ģ飺ṩ˻ Web ԣļϴܡʹõ Servlet IOC ʼԼ Web Ӧġ
+* Servlet ģ飺ṩһ Spring MVC Web ʵ֡Spring MVC ṩ˻עԴע롢ݰ֤ȼһdzõ JSP ǩȫ Spring Э
+* WebSocket ģ飺ṩ˼ĽӿڣûֻҪʵӦĽӿھͿԿٵĴ WebSocket ServerӶʵ˫ͨѶ
+* Portlet ģ飺ṩ Portlet ʹ MVC ʵ֣ Web-Servlet ģĹܡ
+
+## 3\. Core ContainerSpring ĺ
+
+Spring ĺģ齨Ļ Beans ģ顢Core ģ顢Context ģ SpEL ʽģɣûЩҲ AOPWeb ϲĹܡ¡
+
+* Beans ģ飺ṩ˿ܵĻ֣Ʒתע롣
+* Core ģ飺װ Spring ܵĵײ㲿֣ԴʡתһЩùࡣ
+* Context ģ飺 Core Beans ģĻ֮ϣ Beans ģ鹦ܲԴ֤ʻJava EE ֧֡ڡ¼ȡApplicationContext ӿģĽ㡣
+* SpEL ģ飺ṩǿıʽַ֧֣֧ʺֵãַ֧ʼ顢֧㣬ִ֧ Spring ȡ BeanҲ֧бͶӰѡһбۺϵȡ
+
+## 4\. AOPAspectsInstrumentation Messaging
+
+ Core Container ֮ AOPAspects ģ飬£
+
+* AOP ģ飺ṩʵ֣ṩ־¼ȨơͳƵͨùܺҵļ̬ܶİЩӵҪĴУ˾ְҵͨùܵϡ
+* Aspects ģ飺ṩ AspectJ ļɣһǿҳ̣AOPܡ
+* Instrumentation ģ飺ṩߵֺ֧ʵ֣ضӦ÷ʹá
+* messaging ģ飺Spring 4.0 ԺϢSpring-messagingģ飬ģṩ˶ϢϵṹЭ֧֡
+
+## 5\. Test ģ
+
+Test ģ飺Spring ֧ Junit TestNG ԿܣһṩһЩ Spring IJԹܣڲ Web ʱģ Http Ĺܡ
\ No newline at end of file
diff --git "a/docs/spring/springMVC/SpringMVC\345\270\270\350\247\201\346\263\250\350\247\243.md" "b/docs/spring/springMVC/SpringMVC\345\270\270\350\247\201\346\263\250\350\247\243.md"
new file mode 100644
index 0000000..6bd5272
--- /dev/null
+++ "b/docs/spring/springMVC/SpringMVC\345\270\270\350\247\201\346\263\250\350\247\243.md"
@@ -0,0 +1,232 @@
+## 1.
+ ڱ̳Уǽ̽ org.springframework.web.bind.annotation е Spring Web ע͡
+
+## 2. @RequestMapping
+
+˵@RequestMapping @Controller ڲ ʹã
+
+·ƺֵӳ䵽ĸ URL
+ݵ HTTP
+params HTTP Ĵڡڻֵ
+headers HTTP ͷĴڡڻֵ
+ģ÷ HTTP Щý
+produces÷ HTTP ӦЩý
+һʾ
+
+````
+@Controller
+class VehicleController {
+
+ @RequestMapping(value = "/vehicles/home", method = RequestMethod.GET)
+ String home() {
+ return "home";
+ }
+}
+````
+༶ӦôעͣǿΪ @Controller едṩĬá Ψһ Spring ʹ÷øǵḽ·ֵ URL
+
+磬úЧһģ
+
+````
+@Controller
+@RequestMapping(value = "/vehicles", method = RequestMethod.GET)
+class VehicleController {
+
+ @RequestMapping("/home")
+ String home() {
+ return "home";
+ }
+}
+````
+
+⣬@GetMapping@PostMapping@PutMapping@DeleteMapping @PatchMapping @RequestMapping IJͬ壬HTTP ѷֱΪGETPOSTPUTDELETE PATCH
+
+Щ Spring 4.3 汾ʼá
+
+## 3 @RequestBody
+
+Ǽ@RequestBody HTTP ӳ䵽һ
+
+````
+@PostMapping("/save")
+void saveVehicle(@RequestBody Vehicle vehicle) {
+// ...
+}
+````
+лԶģȡ͡
+
+## 4 @PathVariable
+˵˵@PathVariable
+
+עָʾ URI ģ ǿʹ @RequestMapping עָ URI ģ壬ʹ @PathVariable ģ岿֮һ
+
+ǿʹƻֵʵһ㣺
+
+````
+@RequestMapping("/{id}")
+Vehicle getVehicle(@PathVariable("id") long id) {
+// ...
+}
+````
+ģвֵ뷽ƥ䣬ǾͲעָ
+
+````
+@RequestMapping("/{id}")
+Vehicle getVehicle(@PathVariable long id) {
+// ...
+}
+````
+⣬ǿͨIJΪ false ·Ϊѡ
+
+````
+@RequestMapping("/{id}")
+Vehicle getVehicle(@PathVariable(required = false) long id) {
+// ...
+}
+````
+## 5. @RequestParam
+ We use @RequestParam for accessing HTTP request parameters:
+````
+@RequestMapping
+Vehicle getVehicleByParam(@RequestParam("id") long id) {
+// ...
+}
+````
+ @PathVariable עͬѡ
+
+Щ֮⣬ Spring зûֵΪֵʱǿʹ @RequestParam ָעֵ ΪˣDZ defaultValue
+
+ṩĬֵʽ required Ϊ false
+````
+@RequestMapping("/buy")
+Car buyCar(@RequestParam(defaultValue = "5") int seatCount) {
+// ...
+}
+````
+˲֮⣬ǻԷ HTTP ֣cookie ͱͷ
+
+ǿԷֱʹע@CookieValue @RequestHeader ǡ
+
+
+## 6. Response Handling Annotations
+ڽIJУǽ Spring MVC в HTTP Ӧע͡
+
+### 6.1 @ResponseBody
+@ResponseBody Spring ὫĽΪӦ
+
+````
+@ResponseBody
+@RequestMapping("/hello")
+String hello() {
+return "Hello World!";
+}
+````
+עע @Controller ࣬ʹ
+
+### 6.2 @ExceptionHandler
+
+ʹôעͣǿһԶ ׳κָ쳣ʱSpring ô˷
+
+쳣Ϊݸ
+````
+@ExceptionHandler(IllegalArgumentException.class)
+void onIllegalArgumentException(IllegalArgumentException exception) {
+// ...
+}
+````
+
+### 6.3 @ResponseStatus
+ʹôעͶעָͣӦ HTTP ״̬ ǿʹ code value ״̬롣
+
+⣬ǿʹ reason ṩԭ
+
+ҲԽ@ExceptionHandler һʹã
+
+@ExceptionHandler(IllegalArgumentException.class)
+@ResponseStatus(HttpStatus.BAD_REQUEST)
+void onIllegalArgumentException(IllegalArgumentException exception) {
+// ...
+}
+
+й HTTP Ӧ״̬ĸϢʱġ
+
+## 7 Webע
+һЩעͲֱӹ HTTP Ӧ ڽIJУǽġ
+
+### 7.1 @Controller
+ǿʹ@Controller һSpring MVC йظϢǹ Spring Bean Annotations ¡
+
+### 7.2 @RestController
+@RestController @Controller @ResponseBody
+
+ˣǵЧģ
+
+````
+@Controller
+@ResponseBody
+class VehicleRestController {
+// ...
+}
+````
+
+````
+@RestController
+class VehicleRestController {
+// ...
+}
+````
+### 7.3 @ModelAttribute
+ͨע⣬ǿͨṩģͼѾ MVC @Controller ģеԪأ
+
+````
+@PostMapping("/assemble")
+void assembleVehicle(@ModelAttribute("vehicle") Vehicle vehicleInModel) {
+// ...
+}
+````
+@PathVariable @RequestParam һͬƣDzָģͼ
+
+````
+@PostMapping("/assemble")
+void assembleVehicle(@ModelAttribute Vehicle vehicle) {
+// ...
+}
+````
+⣬@ModelAttributeһ;עһSpringԶķֵӵģУ
+
+````
+@ModelAttribute("vehicle")
+Vehicle getVehicle() {
+// ...
+}
+````
+ǰһDzָģͼSpring Ĭʹ÷ƣ
+````
+@ModelAttribute
+Vehicle vehicle() {
+// ...
+}
+````
+ Spring ֮ǰ @ModelAttribute ע͵ķ
+
+й @ModelAttribute ĸϢıġ
+
+### 7.4 @CrossOrigin
+@CrossOrigin Ϊע͵ÿͨţ
+
+````
+@CrossOrigin
+@RequestMapping("/hello")
+String hello() {
+return "Hello World!";
+}
+````
+һ࣬е
+
+ǿʹôע͵IJ CORS Ϊ
+
+йϸϢʱġ
+
+
+# ο
+https://www.baeldung.com/spring-annotations
diff --git "a/docs/spring/\347\254\254\344\270\200\344\270\252Spring\345\272\224\347\224\250.md" "b/docs/spring/\347\254\254\344\270\200\344\270\252Spring\345\272\224\347\224\250.md"
new file mode 100644
index 0000000..b40a369
--- /dev/null
+++ "b/docs/spring/\347\254\254\344\270\200\344\270\252Spring\345\272\224\347\224\250.md"
@@ -0,0 +1,70 @@
+##
+ǿȰ Spring Jar Լ Commons-loggin 뵽ĿУӣҪٵ Spring Jar
+
+````
+org.springframework.core-5.3.13.jar
+org.springframework.beans-5.3.13.jar
+spring-context-5.3.13.jar
+spring-expression-5.3.13.jar
+commons.logging-1.2.jar
+````
+ȻƼʹmaven
+
+## Java
+ HelloSpring д net.biancheng.c Ȼ´ HelloWorld.java MainApp.java ࡣ
+
+HelloWorld.java Ĵ
+````
+package net.biancheng.c;
+public class HelloWorld {
+ private String message;
+ public void setMessage(String message) {
+ this.message = message;
+ }
+ public void getMessage() {
+ System.out.println("message : " + message);
+ }
+}
+````
+MainApp.java Ĵ
+````
+package net.biancheng.c;
+import org.springframework.context.ApplicationContext;
+import org.springframework.context.support.ClassPathXmlApplicationContext;
+
+ public class MainApp {
+ public static void main(String[] args) {
+ ApplicationContext context = new ClassPathXmlApplicationContext("Beans.xml");
+ HelloWorld obj = context.getBean("helloWorld",HelloWorld.class);
+ obj.getMessage();
+ }
+ }
+````
+ϴ룬Ҫע㣺
+
+ ApplicationContext ʱʹ ClassPathXmlApplicationContext ࣬ڼ Spring ļͳʼжBean
+ApplicationContext.getBean() ȡ Bean÷ֵΪ ObjectͨǿתΪ HelloWorld ʵе getMessage()
+
+## ļ
+
+ src Ŀ¼£һ Spring ļ Beans.xml¡
+````
+
+
+
+
+
+
+````
+ҲԽļΪЧƣҪעǣļ MainApp.java жȡļһ¡
+
+Beans.xml ڸͬ Bean Ψһ IDӦ Bean Ըֵ磬ϴУǿڲӰ£ message ֵ
+## г
+
+ MainApp.javaEclipse IDE ̨ʾϢ¡
+ message : Hello World!
+
+ˣǾͳɹ˵һ Spring Ӧó
\ No newline at end of file
diff --git a/pom.xml b/pom.xml
index de1628d..a91c75e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -7,8 +7,28 @@
groupId
JavaTutorial
1.0-SNAPSHOT
+
+ org.springframework.boot
+ spring-boot-starter-parent
+ 3.0.5
+
+
+
+
+ org.springframework.boot
+ spring-boot-starter-web
+
+
+ org.springframework.boot
+ spring-boot-starter
+
+
+ org.springframework.boot
+ spring-boot-starter-test
+ test
+
com.github.houbb
markdown-toc
@@ -51,5 +71,13 @@
+
+
+
+ org.springframework.boot
+ spring-boot-maven-plugin
+
+
+
\ No newline at end of file
diff --git a/src/main/java/Test.java b/src/main/java/Test.java
new file mode 100644
index 0000000..269694c
--- /dev/null
+++ b/src/main/java/Test.java
@@ -0,0 +1,22 @@
+import org.springframework.beans.factory.annotation.Lookup;
+import org.springframework.stereotype.Service;
+
+/**
+ * @author hpl
+ * @date 2023/4/15 14:40
+ */
+@Service
+public class Test {
+
+
+
+
+ public static void main(String[] args) {
+
+ }
+
+
+ public void test(){
+
+ }
+}
From 84e1254e8691ae7e4dad0803dc17c2c8ef33b29a Mon Sep 17 00:00:00 2001
From: h2pl <362294931@qq.com>
Date: Thu, 20 Apr 2023 21:35:59 +0800
Subject: [PATCH 03/32] done
---
ReadMe.md | 69 +-
...10\346\240\270\345\277\203\357\274\211.md" | 7 +-
...\260\203\345\272\246\344\270\216@Async.md" | 240 +
...45\345\277\227\347\256\241\347\220\206.md" | 806 +++
...\210\260\345\244\226\351\203\250Tomcat.md" | 302 +
...42\203\345\267\245\345\205\267Actuator.md" | 5832 +++++++++++++++++
...232\204Starter\346\234\272\345\210\266.md" | 262 +
...72\346\234\254\344\275\277\347\224\250.md" | 122 +-
...07\344\273\266\347\256\241\347\220\206.md" | 2989 +++++++++
...50\347\275\262\345\267\245\345\205\267.md" | 345 +
...52\345\212\250\347\224\237\346\210\220.md" | 625 ++
...345\267\245\345\205\267SpringBootAdmin.md" | 294 +
...45\350\257\206\346\270\205\345\215\225.md" | 0
...05\345\214\226\345\212\237\350\203\275.md" | 179 +
...70\347\224\250\345\212\237\350\203\275.md" | 594 ++
...70\345\244\204\347\220\206\345\231\250.md" | 235 +
...04\346\213\246\346\210\252\345\231\250.md" | 88 +
...76\350\247\243\346\236\220\345\231\250.md" | 181 +
...\277\207\346\273\244\345\231\250Filter.md" | 151 +
...53\351\200\237\345\205\245\351\227\250.md" | 1153 ++++
...07\344\273\266\344\270\212\344\274\240.md" | 237 +
...70\350\247\201\346\263\250\350\247\243.md" | 0
...\243\347\241\256\347\232\204Controller.md" | 0
...67\346\261\202\350\275\254\345\217\221.md" | 0
...4\232SpringMVC\346\246\202\350\277\260.md" | 0
...43\346\236\220\345\216\237\347\220\206.md" | 0
...5\277\265\344\270\216DispatcherServlet.md" | 0
...6@ResponseBody\346\263\250\350\247\243.md" | 0
...75\347\232\204\346\224\257\346\214\201.md" | 32 +-
...57\345\242\203\345\217\230\351\207\217.md" | 15 +-
...04\347\220\206\346\234\272\345\210\266.md" | 34 +-
...54\346\225\260\346\215\256\357\274\211.md" | 20 +-
...72\346\234\254\347\224\250\346\263\225.md" | 488 +-
.../spring/Spring\346\246\202\350\277\260.md" | 36 +-
...37\347\220\206\350\257\246\350\247\243.md" | 0
...37\347\220\206\350\257\246\350\247\243.md" | 0
...4\232SpringAOP\346\246\202\350\277\260.md" | 0
...40\350\275\275\350\277\207\347\250\213.md" | 0
...13\345\212\241\346\246\202\350\277\260.md" | 0
...20\347\240\201\345\211\226\346\236\220.md" | 0
...\274\232Spring\346\246\202\350\277\260.md" | 0
...70\345\277\203\346\265\201\347\250\213.md" | 0
...07\347\250\213\345\210\206\346\236\220.md" | 0
43 files changed, 14849 insertions(+), 487 deletions(-)
create mode 100644 "docs/spring/SpringBoot/SpringBoot\344\270\255\347\232\204\344\273\273\345\212\241\350\260\203\345\272\246\344\270\216@Async.md"
create mode 100644 "docs/spring/SpringBoot/SpringBoot\344\270\255\347\232\204\346\227\245\345\277\227\347\256\241\347\220\206.md"
create mode 100644 "docs/spring/SpringBoot/SpringBoot\345\272\224\347\224\250\344\271\237\345\217\257\344\273\245\351\203\250\347\275\262\345\210\260\345\244\226\351\203\250Tomcat.md"
create mode 100644 "docs/spring/SpringBoot/SpringBoot\347\224\237\344\272\247\347\216\257\345\242\203\345\267\245\345\205\267Actuator.md"
create mode 100644 "docs/spring/SpringBoot/SpringBoot\347\232\204Starter\346\234\272\345\210\266.md"
create mode 100644 "docs/spring/SpringBoot/SpringBoot\347\232\204\351\205\215\347\275\256\346\226\207\344\273\266\347\256\241\347\220\206.md"
create mode 100644 "docs/spring/SpringBoot/SpringBoot\350\207\252\345\270\246\347\232\204\347\203\255\351\203\250\347\275\262\345\267\245\345\205\267.md"
create mode 100644 "docs/spring/SpringBoot/SpringBoot\351\233\206\346\210\220Swagger\345\256\236\347\216\260API\346\226\207\346\241\243\350\207\252\345\212\250\347\224\237\346\210\220.md"
create mode 100644 "docs/spring/SpringBoot/\345\237\272\344\272\216SpringBoot\344\270\255\347\232\204\345\274\200\346\272\220\347\233\221\346\216\247\345\267\245\345\205\267SpringBootAdmin.md"
rename "docs/spring/\347\273\231\344\275\240\344\270\200\344\273\275SpringBoot\347\237\245\350\257\206\346\270\205\345\215\225.md" => "docs/spring/SpringBoot/\347\273\231\344\275\240\344\270\200\344\273\275SpringBoot\347\237\245\350\257\206\346\270\205\345\215\225.md" (100%)
create mode 100644 "docs/spring/SpringMVC/SpringMVC\344\270\255\347\232\204\345\233\275\351\231\205\345\214\226\345\212\237\350\203\275.md"
create mode 100644 "docs/spring/SpringMVC/SpringMVC\344\270\255\347\232\204\345\270\270\347\224\250\345\212\237\350\203\275.md"
create mode 100644 "docs/spring/SpringMVC/SpringMVC\344\270\255\347\232\204\345\274\202\345\270\270\345\244\204\347\220\206\345\231\250.md"
create mode 100644 "docs/spring/SpringMVC/SpringMVC\344\270\255\347\232\204\346\213\246\346\210\252\345\231\250.md"
create mode 100644 "docs/spring/SpringMVC/SpringMVC\344\270\255\347\232\204\350\247\206\345\233\276\350\247\243\346\236\220\345\231\250.md"
create mode 100644 "docs/spring/SpringMVC/SpringMVC\344\270\255\347\232\204\350\277\207\346\273\244\345\231\250Filter.md"
create mode 100644 "docs/spring/SpringMVC/SpringMVC\345\237\272\346\234\254\344\273\213\347\273\215\344\270\216\345\277\253\351\200\237\345\205\245\351\227\250.md"
create mode 100644 "docs/spring/SpringMVC/SpringMVC\345\246\202\344\275\225\345\256\236\347\216\260\346\226\207\344\273\266\344\270\212\344\274\240.md"
rename "docs/spring/springMVC/SpringMVC\345\270\270\350\247\201\346\263\250\350\247\243.md" => "docs/spring/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220/SpringMVC\345\270\270\350\247\201\346\263\250\350\247\243.md" (100%)
rename "docs/spring/springMVC/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220\357\274\232DispatcherServlet\345\246\202\344\275\225\346\211\276\345\210\260\346\255\243\347\241\256\347\232\204Controller.md" => "docs/spring/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220\357\274\232DispatcherServlet\345\246\202\344\275\225\346\211\276\345\210\260\346\255\243\347\241\256\347\232\204Controller.md" (100%)
rename "docs/spring/springMVC/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220\357\274\232DispatcherServlet\347\232\204\345\210\235\345\247\213\345\214\226\344\270\216\350\257\267\346\261\202\350\275\254\345\217\221.md" => "docs/spring/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220\357\274\232DispatcherServlet\347\232\204\345\210\235\345\247\213\345\214\226\344\270\216\350\257\267\346\261\202\350\275\254\345\217\221.md" (100%)
rename "docs/spring/springMVC/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220\357\274\232SpringMVC\346\246\202\350\277\260.md" => "docs/spring/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220\357\274\232SpringMVC\346\246\202\350\277\260.md" (100%)
rename "docs/spring/springMVC/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220\357\274\232SpringMVC\347\232\204\350\247\206\345\233\276\350\247\243\346\236\220\345\216\237\347\220\206.md" => "docs/spring/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220\357\274\232SpringMVC\347\232\204\350\247\206\345\233\276\350\247\243\346\236\220\345\216\237\347\220\206.md" (100%)
rename "docs/spring/springMVC/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220\357\274\232SpringMVC\350\256\276\350\256\241\347\220\206\345\277\265\344\270\216DispatcherServlet.md" => "docs/spring/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220\357\274\232SpringMVC\350\256\276\350\256\241\347\220\206\345\277\265\344\270\216DispatcherServlet.md" (100%)
rename "docs/spring/springMVC/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220\357\274\232\346\266\210\346\201\257\350\275\254\346\215\242\345\231\250HttpMessageConverter\344\270\216@ResponseBody\346\263\250\350\247\243.md" => "docs/spring/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220/SpringMVC\346\272\220\347\240\201\345\210\206\346\236\220\357\274\232\346\266\210\346\201\257\350\275\254\346\215\242\345\231\250HttpMessageConverter\344\270\216@ResponseBody\346\263\250\350\247\243.md" (100%)
rename "docs/spring/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232AOP\345\256\236\347\216\260\345\216\237\347\220\206\350\257\246\350\247\243.md" => "docs/spring/Spring\346\272\220\347\240\201\345\210\206\346\236\220/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232AOP\345\256\236\347\216\260\345\216\237\347\220\206\350\257\246\350\247\243.md" (100%)
rename "docs/spring/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232JDK\345\222\214cglib\345\212\250\346\200\201\344\273\243\347\220\206\345\216\237\347\220\206\350\257\246\350\247\243.md" => "docs/spring/Spring\346\272\220\347\240\201\345\210\206\346\236\220/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232JDK\345\222\214cglib\345\212\250\346\200\201\344\273\243\347\220\206\345\216\237\347\220\206\350\257\246\350\247\243.md" (100%)
rename "docs/spring/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232SpringAOP\346\246\202\350\277\260.md" => "docs/spring/Spring\346\272\220\347\240\201\345\210\206\346\236\220/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232SpringAOP\346\246\202\350\277\260.md" (100%)
rename "docs/spring/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232SpringIOC\345\256\271\345\231\250\347\232\204\345\212\240\350\275\275\350\277\207\347\250\213.md" => "docs/spring/Spring\346\272\220\347\240\201\345\210\206\346\236\220/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232SpringIOC\345\256\271\345\231\250\347\232\204\345\212\240\350\275\275\350\277\207\347\250\213.md" (100%)
rename "docs/spring/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232Spring\344\272\213\345\212\241\346\246\202\350\277\260.md" => "docs/spring/Spring\346\272\220\347\240\201\345\210\206\346\236\220/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232Spring\344\272\213\345\212\241\346\246\202\350\277\260.md" (100%)
rename "docs/spring/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232Spring\344\272\213\345\212\241\346\272\220\347\240\201\345\211\226\346\236\220.md" => "docs/spring/Spring\346\272\220\347\240\201\345\210\206\346\236\220/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232Spring\344\272\213\345\212\241\346\272\220\347\240\201\345\211\226\346\236\220.md" (100%)
rename "docs/spring/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232Spring\346\246\202\350\277\260.md" => "docs/spring/Spring\346\272\220\347\240\201\345\210\206\346\236\220/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232Spring\346\246\202\350\277\260.md" (100%)
rename "docs/spring/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232\345\210\235\346\216\242SpringIOC\346\240\270\345\277\203\346\265\201\347\250\213.md" => "docs/spring/Spring\346\272\220\347\240\201\345\210\206\346\236\220/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232\345\210\235\346\216\242SpringIOC\346\240\270\345\277\203\346\265\201\347\250\213.md" (100%)
rename "docs/spring/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232\346\207\222\345\212\240\350\275\275\347\232\204\345\215\225\344\276\213Bean\350\216\267\345\217\226\350\277\207\347\250\213\345\210\206\346\236\220.md" => "docs/spring/Spring\346\272\220\347\240\201\345\210\206\346\236\220/Spring\346\272\220\347\240\201\345\211\226\346\236\220\357\274\232\346\207\222\345\212\240\350\275\275\347\232\204\345\215\225\344\276\213Bean\350\216\267\345\217\226\350\277\207\347\250\213\345\210\206\346\236\220.md" (100%)
diff --git a/ReadMe.md b/ReadMe.md
index c8ec78e..c73d49b 100644
--- a/ReadMe.md
+++ b/ReadMe.md
@@ -144,32 +144,67 @@
### Spring
-* [Spring常见注解.md](docs/spring/Spring常见注解.md)
+* [SpringAOP的概念与作用](docs/spring/Spring常见注解.md)
+* [SpringBean的定义与管理（核心）](docs/spring/Spring常见注解.md)
+* [Spring中对于数据库的访问](docs/spring/Spring常见注解.md)
+* [Spring中对于校验功能的支持](docs/spring/Spring常见注解.md)
+* [Spring中的Environment环境变量](docs/spring/Spring常见注解.md)
+* [Spring中的事件处理机制](docs/spring/Spring常见注解.md)
+* [Spring中的资源管理](docs/spring/Spring常见注解.md)
+* [Spring中的配置元数据（管理配置的基本数据）](docs/spring/Spring常见注解.md)
+* [Spring事务基本用法](docs/spring/Spring常见注解.md)
+* [Spring合集](docs/spring/Spring常见注解.md)
+* [Spring容器与IOC](docs/spring/Spring常见注解.md)
+* [Spring常见注解](docs/spring/Spring常见注解.md)
+* [Spring概述](docs/spring/Spring常见注解.md)
+* [第一个Spring应用](docs/spring/Spring常见注解.md)
+
+* [Spring源码剖析：Spring概述](docs/spring/Spring源码分析/Spring源码剖析：Spring概述.md)
+* [Spring源码剖析：初探SpringIOC核心流程](docs/spring/Spring源码分析/Spring源码剖析：初探SpringIOC核心流程.md)
+* [Spring源码剖析：SpringIOC容器的加载过程 ](docs/spring/Spring源码分析/Spring源码剖析：SpringIOC容器的加载过程.md)
+* [Spring源码剖析：懒加载的单例Bean获取过程分析](docs/spring/Spring源码分析/Spring源码剖析：懒加载的单例Bean获取过程分析.md)
+* [Spring源码剖析：JDK和cglib动态代理原理详解 ](docs/spring/Spring源码分析/Spring源码剖析：JDK和cglib动态代理原理详解.md)
+* [Spring源码剖析：SpringAOP概述](docs/spring/Spring源码分析/Spring源码剖析：SpringAOP概述.md)
+* [Spring源码剖析：AOP实现原理详解 ](docs/spring/Spring源码分析/Spring源码剖析：AOP实现原理详解.md)
+* [Spring源码剖析：Spring事务概述](docs/spring/Spring源码分析/Spring源码剖析：Spring事务概述.md)
+* [Spring源码剖析：Spring事务源码剖析](docs/spring/Spring源码分析/Spring源码剖析：Spring事务源码剖析.md)
+### SpringMVC
-* [Spring源码剖析：Spring概述](docs/spring/Spring源码剖析：Spring概述.md)
-* [Spring源码剖析：初探SpringIOC核心流程](docs/spring/Spring源码剖析：初探SpringIOC核心流程.md)
-* [Spring源码剖析：SpringIOC容器的加载过程 ](docs/spring/Spring源码剖析：SpringIOC容器的加载过程.md)
-* [Spring源码剖析：懒加载的单例Bean获取过程分析](docs/spring/Spring源码剖析：懒加载的单例Bean获取过程分析.md)
-* [Spring源码剖析：JDK和cglib动态代理原理详解 ](docs/spring/Spring源码剖析：JDK和cglib动态代理原理详解.md)
-* [Spring源码剖析：SpringAOP概述](docs/spring/Spring源码剖析：SpringAOP概述.md)
-* [Spring源码剖析：AOP实现原理详解 ](docs/spring/Spring源码剖析：AOP实现原理详解.md)
-* [Spring源码剖析：Spring事务概述](docs/spring/Spring源码剖析：Spring事务概述.md)
-* [Spring源码剖析：Spring事务源码剖析](docs/spring/Spring源码剖析：Spring事务源码剖析.md)
+* [SpringMVC中的国际化功能](docs/spring/SpringMVC/SpringMVC中的国际化功能.md)
+* [SpringMVC中的异常处理器](docs/spring/SpringMVC/SpringMVC中的异常处理器.md)
+* [SpringMVC中的拦截器](docs/spring/SpringMVC/SpringMVC中的拦截器.md)
+* [SpringMVC中的视图解析器](docs/spring/SpringMVC/SpringMVC中的视图解析器.md)
+* [SpringMVC中的过滤器Filter](docs/spring/SpringMVC/SpringMVC中的过滤器Filter.md)
+* [SpringMVC基本介绍与快速入门](docs/spring/SpringMVC/SpringMVC基本介绍与快速入门.md)
+* [SpringMVC如何实现文件上传](docs/spring/SpringMVC/SpringMVC如何实现文件上传.md)
+* [SpringMVC中的常用功能](docs/spring/SpringMVC/SpringMVC中的常用功能.md)
-### SpringMVC
-* [SpringMVC源码分析：SpringMVC概述](docs/spring/springMVC/SpringMVC源码分析：SpringMVC概述.md)
-* [SpringMVC源码分析：SpringMVC设计理念与DispatcherServlet](docs/spring/springMVC/SpringMVC源码分析：SpringMVC设计理念与DispatcherServlet.md)
-* [SpringMVC源码分析：DispatcherServlet的初始化与请求转发 ](docs/spring/springMVC/SpringMVC源码分析：DispatcherServlet的初始化与请求转发.md)
-* [SpringMVC源码分析：DispatcherServlet如何找到正确的Controller ](docs/spring/springMVC/SpringMVC源码分析：DispatcherServlet如何找到正确的Controller.md)
-* [SpringMVC源码剖析：消息转换器HttpMessageConverter与@ResponseBody注解](docs/spring/springMVC/SpringMVC源码剖析：消息转换器HttpMessageConverter与@ResponseBody注解.md)
-* [SpringMVC源码分析：SpringMVC的视图解析原理 ](docs/spring/springMVC/SpringMVC源码分析：SpringMVC的视图解析原理.md)
+* [SpringMVC源码分析：SpringMVC概述](docs/spring/SpringMVC源码分析/SpringMVC源码分析：SpringMVC概述.md)
+* [SpringMVC源码分析：SpringMVC设计理念与DispatcherServlet](docs/spring/SpringMVC源码分析/SpringMVC源码分析：SpringMVC设计理念与DispatcherServlet.md)
+* [SpringMVC源码分析：DispatcherServlet的初始化与请求转发 ](docs/spring/SpringMVC源码分析/SpringMVC源码分析：DispatcherServlet的初始化与请求转发.md)
+* [SpringMVC源码分析：DispatcherServlet如何找到正确的Controller ](docs/spring/SpringMVC源码分析/SpringMVC源码分析：DispatcherServlet如何找到正确的Controller.md)
+* [SpringMVC源码剖析：消息转换器HttpMessageConverter与@ResponseBody注解](docs/spring/SpringMVC/SpringMVC源码剖析：消息转换器HttpMessageConverter与@ResponseBody注解.md)
+* [SpringMVC源码分析：SpringMVC的视图解析原理 ](docs/spring/SpringMVC源码分析/SpringMVC源码分析：SpringMVC的视图解析原理.md)
### SpringBoot
* [SpringBoot系列:SpringBoot的前世今生](docs/spring/SpringBoot/SpringBoot的前世今生.md)
+* [给你一份SpringBoot知识清单.md](docs/spring/SpringBoot/给你一份SpringBoot知识清单.md)
+* [Spring常见注解使用指南(包含Spring+SpringMVC+SpringBoot)](docs/spring/SpringBoot/Spring常见注解使用指南(包含Spring+SpringMVC+SpringBoot).md)
+* [SpringBoot中的日志管理](docs/spring/SpringBoot/SpringBoot中的日志管理.md)
+* [SpringBoot常见注解](docs/spring/SpringBoot/SpringBoot常见注解.md)
+* [SpringBoot应用也可以部署到外部Tomcat](docs/spring/SpringBoot/SpringBoot应用也可以部署到外部Tomcat.md)
+* [SpringBoot生产环境工具Actuator](docs/spring/SpringBoot/SpringBoot生产环境工具Actuator.md)
+* [SpringBoot的Starter机制](docs/spring/SpringBoot/SpringBoot的Starter机制.md)
+* [SpringBoot的前世今生](docs/spring/SpringBoot/SpringBoot的前世今生.md)
+* [SpringBoot的基本使用](docs/spring/SpringBoot/SpringBoot的基本使用.md)
+* [SpringBoot的配置文件管理](docs/spring/SpringBoot/SpringBoot的配置文件管理.md)
+* [SpringBoot自带的热部署工具](docs/spring/SpringBoot/SpringBoot自带的热部署工具.md)
+* [SpringBoot中的任务调度与@Async](docs/spring/SpringBoot/SpringBoot中的任务调度与@Async.md)
+* [基于SpringBoot中的开源监控工具SpringBootAdmin](docs/spring/SpringBoot/基于SpringBoot中的开源监控工具SpringBootAdmin.md)
### SpringCloud
diff --git "a/docs/spring/SpringBean\347\232\204\345\256\232\344\271\211\344\270\216\347\256\241\347\220\206\357\274\210\346\240\270\345\277\203\357\274\211.md" "b/docs/spring/SpringBean\347\232\204\345\256\232\344\271\211\344\270\216\347\256\241\347\220\206\357\274\210\346\240\270\345\277\203\357\274\211.md"
index a684554..c4de431 100644
--- "a/docs/spring/SpringBean\347\232\204\345\256\232\344\271\211\344\270\216\347\256\241\347\220\206\357\274\210\346\240\270\345\277\203\357\274\211.md"
+++ "b/docs/spring/SpringBean\347\232\204\345\256\232\344\271\211\344\270\216\347\256\241\347\220\206\357\274\210\346\240\270\345\277\203\357\274\211.md"
@@ -133,11 +133,11 @@ Bean
һעBeanBeanͻԶÿBeanʱԶBeanĻصʱͼ
-
+
עһ㣬ʹ`BeanFactory`ΪSpringֶעBeanȡBeanʵȻֶעᡣ
- BeanPostProcessor bp = (BeanPostProcessor)beanFactory.getBean("bp"); beanFactory.addBeanPostProcessor(bp); Person p = (Person)beanFactory.getBean("person");
+BeanPostProcessor bp = (BeanPostProcessor)beanFactory.getBean("bp"); beanFactory.addBeanPostProcessor(bp); Person p = (Person)beanFactory.getBean("person");
###
@@ -158,7 +158,7 @@ Spring
SpringļãָԶɨİ
-
+
### ʹ@Resource
@@ -174,6 +174,7 @@ Spring
Springṩ`@Autowired`עָԶװ䣬`@Autowired`setterͨʵȡʹ`@Autowired`עsetterʱĬϲbyTypeԶװԡֲ£Զװ͵ĺѡBeanʵжʱͿ쳣Ϊʵ־ȷԶװ䣬Springṩ`@Qualifier`ע⣬ͨʹ`@Qualifier`BeanidִԶװ䡣
# ο
+
https://www.w3cschool.cn/wkspring
https://www.runoob.com/w3cnote/basic-knowledge-summary-of-spring.html
http://codepub.cn/2015/06/21/Basic-knowledge-summary-of-Spring
diff --git "a/docs/spring/SpringBoot/SpringBoot\344\270\255\347\232\204\344\273\273\345\212\241\350\260\203\345\272\246\344\270\216@Async.md" "b/docs/spring/SpringBoot/SpringBoot\344\270\255\347\232\204\344\273\273\345\212\241\350\260\203\345\272\246\344\270\216@Async.md"
new file mode 100644
index 0000000..c3bce06
--- /dev/null
+++ "b/docs/spring/SpringBoot/SpringBoot\344\270\255\347\232\204\344\273\273\345\212\241\350\260\203\345\272\246\344\270\216@Async.md"
@@ -0,0 +1,240 @@
+
+
+
+
+# Spring Boot
+
+ݽվѸѧϰʼǡܽоղء֤ȷԣʹöķ뱾վأ
+
+
+
+
+
+
+
+
+
+ִضʱεĹ̡Spring BootΪSpringӦóϱдȳṩ˺ܺõ֧֡
+
+## Java Cronʽ
+
+Java CronʽCronTriggerʵ`org.quartz.Trigger`ࡣ йJava cronʽĸϢĴ -
+
+* [https://docs.oracle.com/cd/E12058_01/doc/doc.1014/e12030/cron_expressions.html](https://docs.oracle.com/cd/E12058_01/doc/doc.1014/e12030/cron_expressions.html)
+
+`[@EnableScheduling](https://github.com/EnableScheduling "@EnableScheduling")`עΪӦóõȳעӵSpring BootӦóļС
+
+```
+@SpringBootApplication
+@EnableScheduling
+
+public class DemoApplication {
+ public static void main(String[] args) {
+ SpringApplication.run(DemoApplication.class, args);
+ }
+}
+
+```
+
+`[@Scheduled](https://github.com/Scheduled "@Scheduled")`עضʱڴȳ
+
+```
+@Scheduled(cron = "0 * 9 * * ?")
+public void cronJobSch() throws Exception {
+}
+
+```
+
+һʾ룬ʾÿ9:00ʼÿ9:59ִ
+
+```
+package com.yiibai.demo.scheduler;
+
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import org.springframework.scheduling.annotation.Scheduled;
+import org.springframework.stereotype.Component;
+
+@Component
+public class Scheduler {
+ @Scheduled(cron = "0 * 9 * * ?")
+ public void cronJobSch() {
+ SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss.SSS");
+ Date now = new Date();
+ String strDate = sdf.format(now);
+ System.out.println("Java cron job expression:: " + strDate);
+ }
+}
+
+```
+
+ĻͼʾӦó`09:03:23`Ҵʱÿһִһcronҵȳ
+
+
+
+## ̶
+
+̶ʵȳضʱִȴǰһɡ ֵԺΪλ ʾʾڴ˴ -
+
+```
+@Scheduled(fixedRate = 1000)
+public void fixedRateSch() {
+}
+
+```
+
+˴ʾӦóʱÿִʾ -
+
+```
+package com.yiibai.demo.scheduler;
+
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import org.springframework.scheduling.annotation.Scheduled;
+import org.springframework.stereotype.Component;
+
+@Component
+public class Scheduler {
+ @Scheduled(fixedRate = 1000)
+ public void fixedRateSch() {
+ SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss.SSS");
+
+ Date now = new Date();
+ String strDate = sdf.format(now);
+ System.out.println("Fixed Rate scheduler:: " + strDate);
+ }
+}
+
+```
+
+עĻͼʾ`09:12:00`Ӧó֮ÿһ̶ʵȳִ
+
+
+
+## ̶ӳ
+
+̶ӳٵȳضʱִ Ӧõȴһɡ ֵӦԺΪλ ˴ʾʾ -
+
+```
+@Scheduled(fixedDelay = 1000, initialDelay = 1000)
+public void fixedDelaySch() {
+}
+
+```
+
+`initialDelay`ڳʼӳֵ֮һִʱ䡣
+
+Ӧó`3`ÿִһʾʾ -
+
+```
+package com.yiibai.demo.scheduler;
+
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import org.springframework.scheduling.annotation.Scheduled;
+import org.springframework.stereotype.Component;
+
+@Component
+public class Scheduler {
+ @Scheduled(fixedDelay = 1000, initialDelay = 3000)
+ public void fixedDelaySch() {
+ SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss.SSS");
+ Date now = new Date();
+ String strDate = sdf.format(now);
+ System.out.println("Fixed Delay scheduler:: " + strDate);
+ }
+}
+
+```
+
+ִʾ`09:18:39`ʼӦóÿ`3`̶ӳټƻ(ÿִһ)
+
+
+
+
+
+//Ķhttps://www.yiibai.com/spring-boot/spring_boot_scheduling.html
+
+@EnableAsync ע
+Ҫʹ @AsyncҪʹ @EnableAsync ע Spring Boot е첽ԡ
+
+@Configuration
+@EnableAsync
+public class AppConfig {
+}
+ϸ˵ԲοAsyncConfigurer(opens new window)
+
+#@Async ע
+#ֵ֧÷
+1ֵ
+
+ @Async עη첽ʽá仰˵ڵô˷ʱأʵִзύ Spring TaskExecutor С£ԽעӦڷ void ķʾʾ
+
+@Async
+void doSomething() {
+// this will be executed asynchronously
+}
+2ֵ
+
+ʹ @Scheduled עע͵ķͬЩָΪʱɵԡʽãĵá磬´ @Async עĺϷӦã
+
+@Async
+void doSomething(String s) {
+// this will be executed asynchronously
+}
+3зֵ
+
+첽÷ֵķǣЩҪ Future ͵ķֵȻṩ첽ִеĺôԱ߿ڵ Future ϵ get() ֮ǰִʾʾڷֵķʹ@Async
+
+@Async
+Future returnSomething(int i) {
+// this will be executed asynchronously
+}
+#ֵ֧÷
+@Async ڻصһʹã @PostConstruct
+
+Ҫ첽ʼ Spring beanʹõijʼ Spring beanȻĿϵ @Async ע͵ķʾʾ
+
+public class SampleBeanImpl implements SampleBean {
+
+ @Async
+ void doSomething() {
+ // ...
+ }
+
+}
+
+public class SampleBeanInitializer {
+
+ private final SampleBean bean;
+
+ public SampleBeanInitializer(SampleBean bean) {
+ this.bean = bean;
+ }
+
+ @PostConstruct
+ public void initialize() {
+ bean.doSomething();
+ }
+
+}
+#ȷִָ
+Ĭ£ڷָ @Async ʱʹõִ첽֧ʱõִʹ XML AsyncConfigurer ʵ֣УΪ annotation-driven ԪءǣҪָʾִиʱӦʹĬִֵʹ @Async ע value ԡʾʾִд˲
+
+@Async("otherExecutor")
+void doSomething(String s) {
+// this will be executed asynchronously by "otherExecutor"
+}
+£otherExecutor Spring κ Executor bean ƣҲκ Executor ƣ磬ʹ Ԫػ Spring @Qualifier עָ
+
+# @Async 쳣
+ @Async ķֵΪ Future ʱڷִڼ׳쳣Ϊڵ get ʱ׳쳣ǣڷֵΪ void ͵ķ쳣ᱻ䡣ṩ AsyncUncaughtExceptionHandler 쳣ʾʾִд˲
+
+public class MyAsyncUncaughtExceptionHandler implements AsyncUncaughtExceptionHandler {
+
+ @Override
+ public void handleUncaughtException(Throwable ex, Method method, Object... params) {
+ // handle exception
+ }
+}
+Ĭ£¼쳣ʹ AsyncConfigurer XML ԪضԶ AsyncUncaughtExceptionHandler
\ No newline at end of file
diff --git "a/docs/spring/SpringBoot/SpringBoot\344\270\255\347\232\204\346\227\245\345\277\227\347\256\241\347\220\206.md" "b/docs/spring/SpringBoot/SpringBoot\344\270\255\347\232\204\346\227\245\345\277\227\347\256\241\347\220\206.md"
new file mode 100644
index 0000000..009576d
--- /dev/null
+++ "b/docs/spring/SpringBoot/SpringBoot\344\270\255\347\232\204\346\227\245\345\277\227\347\256\241\347\220\206.md"
@@ -0,0 +1,806 @@
+## 4\. ־
+
+
+
+
+
+Spring Bootڲ־ʹ [Commons Logging](https://commons.apache.org/logging) Եײ־ʵֱֿš Ϊ [Java Util Logging](https://docs.oracle.com/javase/17/docs/api/java/util/logging/package-summary.html) [Log4j2](https://logging.apache.org/log4j/2.x/) [Logback](https://logback.qos.ch/) ṩĬá ÿһ£¼loggerԤΪʹÿ̨Ҳѡļ
+
+
+
+
+
+Ĭ£ʹ StarterĬʹLogback ʵLogback·ҲڣȷʹJava Util LoggingCommons LoggingLog4JSLF4Jⶼȷ
+
+
+
+
+
+| | кܶJava־ܡ бܻң벻Ҫġ һ˵㲻Ҫı־Spring BootĬֵͺܺá |
+| --- | --- |
+
+
+
+
+
+| | ӦóһservletӦ÷ʱJava Util Logging APIִе־ᱻ͵Ӧó־С ԷֹѾӦóִе־Ӧó־С |
+| --- | --- |
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.logging.log-format)4.1\. ־ʽ
+
+
+
+Spring BootĬϵ־ʽӡ
+
+
+
+
+
+
+
+ 2023-03-03T21:18:18.827+08:00 INFO 19388 --- [ main] o.s.b.d.f.s.MyApplication : Starting MyApplication using Java 17 with PID 19388 (/opt/apps/myapp.jar started by myuser in /opt/apps/)
+2023-03-03T21:18:18.834+08:00 INFO 19388 --- [ main] o.s.b.d.f.s.MyApplication : No active profile set, falling back to 1 default profile: "default"
+2023-03-03T21:18:20.439+08:00 INFO 19388 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 8080 (http)
+2023-03-03T21:18:20.461+08:00 INFO 19388 --- [ main] o.apache.catalina.core.StandardService : Starting service [Tomcat]
+2023-03-03T21:18:20.461+08:00 INFO 19388 --- [ main] o.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/10.1.5]
+2023-03-03T21:18:20.600+08:00 INFO 19388 --- [ main] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext
+2023-03-03T21:18:20.602+08:00 INFO 19388 --- [ main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 1685 ms
+2023-03-03T21:18:21.078+08:00 INFO 19388 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8080 (http) with context path ''
+2023-03-03T21:18:21.093+08:00 INFO 19388 --- [ main] o.s.b.d.f.s.MyApplication : Started MyApplication in 2.998 seconds (process running for 3.601)
+
+
+
+
+
+
+
+Ŀ¡
+
+
+
+
+
+* DateʱTimeȷ룬
+
+* ־: `ERROR`, `WARN`, `INFO`, `DEBUG`, `TRACE`.
+
+* ID
+
+* һ `---` ָʵ־ϢĿʼ
+
+* ߳ƣڷУڿ̨ܻᱻضϣ
+
+* ¼ƣͨԴƣͨд
+
+* ־Ϣ
+
+
+
+
+
+| | Logbackû `FATAL` ӳ䵽 `ERROR` |
+| --- | --- |
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.logging.console-output)4.2\. ̨
+
+
+
+Ĭ£־ `ERROR``WARN` `INFO` Ϣ̨ Ҳͨ `--debug` ־Ӧó `debug` ģʽ
+
+
+
+
+
+
+
+```
+$ java -jar myapp.jar --debug
+```
+
+
+
+
+
+
+
+| | Ҳ `application.properties` ָ `debug=true` |
+| --- | --- |
+
+
+
+
+
+debugģʽʱһЩļ¼ǶʽHibernateSpring BootΪϢ debugģʽζŽӦóΪ `DEBUG` ¼Ϣ
+
+
+
+
+
+⣬ͨӦóʱʹ `--trace` ־ `application.properties` ʹ `trace=true` trace ģʽ ԶһЩļ¼ǶʽHibernate schemaɺSpringϣиټ¼
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.logging.console-output.color-coded)4.2.1\. ɫ
+
+
+
+ն֧ANSIͻʹòɫĶ Խ `spring.output.ansi.enabled` Ϊ [ֵֵ֧](https://docs.spring.io/spring-boot/docs/3.1.0-SNAPSHOT/api/org/springframework/boot/ansi/AnsiOutput.Enabled.html)ԸԶ⡣
+
+
+
+
+
+ɫͨʹ `%clr` תؼõġ ʽУת־ɫʾ
+
+
+
+
+
+
+
+```
+%clr(%5p)
+```
+
+
+
+
+
+
+
+±־ɫӳϵ
+
+
+
+
+| ־ | ɫ |
+| --- | --- |
+| `FATAL` | |
+| `ERROR` | |
+| `WARN` | |
+| `INFO` | |
+| `DEBUG` | |
+| `TRACE` | |
+
+
+
+⣬ҲͨΪתṩһѡָӦʹõɫʽ 磬ҪʹıΪɫʹá
+
+
+
+
+
+
+
+```
+%clr(%d{yyyy-MM-dd'T'HH:mm:ss.SSSXXX}){yellow}
+```
+
+
+
+
+
+
+
+֧ɫʽ
+
+
+
+
+
+* `blue`
+
+* `cyan`
+
+* `faint`
+
+* `green`
+
+* `magenta`
+
+* `red`
+
+* `yellow`
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.logging.file-output)4.3\. ļ
+
+
+
+Ĭ£Spring Bootֻ̨¼־д־ļ ڿ̨֮д־ļҪ `logging.file.name` `logging.file.path` ԣ磬 `application.properties` У
+
+
+
+
+
+±ʾ `logging.*` αһʹá
+
+
+
+Table 5\. Logging properties
+| `logging.file.name` | `logging.file.path` | Example | Description |
+| --- | --- | --- | --- |
+| _(none)_ | _(none)_ | | ֻڿ̨м¼ |
+| ָļ | _(none)_ | `my.log` | дָ־ļ ƿһȷеλãҲ뵱ǰĿ¼λá |
+| _(none)_ | ָĿ¼ | `/var/log` | `spring.log` дָĿ¼ ƿһȷеλãҲ뵱ǰĿ¼λá |
+
+
+
+־ļڴﵽ10MBʱͻֻ̨һĬ»¼ `ERROR` `WARN` `INFO` Ϣ
+
+
+
+
+
+| | ־Զʵʵ־ʩ ˣضԣLogback `logback.configurationFile` spring Boot |
+| --- | --- |
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.logging.file-rotation)4.4\. ļֻ־
+
+
+
+ʹLogbackʹ `application.properties` `application.yaml` ļ־ֻá ־ϵͳ㽫ҪԼֱֻã磬ʹLog4J2ôһ `log4j2.xml` `log4j2-spring.xml` ļ
+
+
+
+
+
+ֻ֧ԡ
+
+
+
+
+| | ˵ |
+| --- | --- |
+| `logging.logback.rollingpolicy.file-name-pattern` | ڴ־鵵ļģʽ |
+| `logging.logback.rollingpolicy.clean-history-on-start` | ӦóʱǷ־鵵 |
+| `logging.logback.rollingpolicy.max-file-size` | ־ļ鵵ǰߴ磨ļﵽͻ鵵 |
+| `logging.logback.rollingpolicy.total-size-cap` | ־ڱɾǰߴ磨鵵ļռôССᱻɾ |
+| `logging.logback.rollingpolicy.max-history` | ҪĹ鵵־ļĬΪ7 |
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.logging.log-levels)4.5\. ־
+
+
+
+ֵ֧־ϵͳͨʹ `logging.level.=` Spring `Environment`磬 `application.properties`־ `level` `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`, `FATAL`, `OFF` ֮һ `root` ¼loggerļͨ `logging.level.root` á
+
+
+
+
+
+ʾ `application.properties` DZڵ־á
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+logging.level.root=warn
+logging.level.org.springframework.web=debug
+logging.level.org.hibernate=error
+```
+
+
+
+
+
+
+
+Ҳʹû־ 磬`LOGGING_LEVEL_ORG_SPRINGFRAMEWORK_WEB=DEBUG` `org.springframework.web` Ϊ `DEBUG`
+
+
+
+
+
+| | ֻڰ־ ڿɰǽתΪСдĸԲַʽΪ־ ҪΪһ־ʹ[`SPRING_APPLICATION_JSON`](https://springdoc.cn/spring-boot/features.html#features.external-config.application-json) |
+| --- | --- |
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.logging.log-groups)4.6\. ־飨Log Groups
+
+
+
+ܹص־¼飬Աͬʱǽãͨá 磬ܾı __ Tomcatصļ¼ļ¼𣬵㲻סİ
+
+
+
+
+
+Ϊ˰⣬Spring BootSpring `Environment` ж־顣 磬ͨ `application.properties` м tomcat group
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+logging.group.tomcat=org.apache.catalina,org.apache.coyote,org.apache.tomcat
+
+```
+
+
+
+
+
+
+
+һúͿһдıloggerļ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+logging.level.tomcat=trace
+
+```
+
+
+
+
+
+
+
+Spring BootԤ־飬Կ伴á
+
+
+
+
+| | еlogger |
+| --- | --- |
+| web | `org.springframework.core.codec`, `org.springframework.http`, `org.springframework.web`, `org.springframework.boot.actuate.endpoint.web`, `org.springframework.boot.web.servlet.ServletContextInitializerBeans` |
+| sql | `org.springframework.jdbc.core`, `org.hibernate.SQL`, `org.jooq.tools.LoggerListener` |
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.logging.shutdown-hook)4.7\. ʹ־ Shutdown Hook
+
+
+
+ΪӦóֹʱͷ־ԴṩһShutdown HookJVM˳ʱ־ϵͳ ӦówarļʽģShutdown HookԶעᡣ ӦóиӵIJνṹShutdown Hook ܣùػӣоײ־ϵͳֱṩѡ 磬Logbackṩ [context selectors](https://logback.qos.ch/manual/loggingSeparation.html)ÿ¼Լб ʹ `logging.register-shutdown-hook` Shutdown Hook Ϊ `false` עᡣ `application.properties` `application.yaml` ļøԡ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+logging.register-shutdown-hook=false
+
+```
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.logging.custom-log-configuration)4.8\. Զ־
+
+
+
+־ϵͳͨclasspathϰʵĿҿͨclasspathĸĿ¼» Spring `Environment` ָλṩһʵļһƣ `logging.config`
+
+
+
+
+
+ͨʹ `org.springframework.boot.logging.LoggingSystem` ϵͳԣǿSpring Bootʹض־ϵͳ ֵӦ `LoggingSystem` ʵֵȫ Ҳͨʹ `none` ֵȫSpring Boot־á
+
+
+
+
+
+| | S־ڴ `ApplicationContext` ֮ǰʼģԲܴSpring `@Configuration` ļе `@PropertySources` ־ ı־ϵͳȫͣΨһͨSystem properties |
+| --- | --- |
+
+
+
+
+
+־ϵͳļ
+
+
+
+
+| ־ϵͳ | ļ |
+| --- | --- |
+| Logback | `logback-spring.xml`, `logback-spring.groovy`, `logback.xml` `logback.groovy` |
+| Log4j2 | `log4j2-spring.xml` `log4j2.xml` |
+| JDK (Java Util Logging) | `logging.properties` |
+
+
+
+| | ڿܵ£ǽʹ `-spring` ־ã磬 `logback-spring.xml` `logback.xml` ʹñλãSpringȫ־ʼ |
+| --- | --- |
+
+
+
+
+
+| | "ִеjar "ʱJava Util LoggingһЩ֪⣬ᵼ⡣ ܵĻǽڴ "ִеjar" ʱʹ |
+| --- | --- |
+
+
+
+
+
+Ϊ˰ƣһЩԴSpring `Environment` תƵSystem properties±ʾ
+
+
+
+| Spring Environment | System Property | ע |
+| --- | --- | --- |
+| `logging.exception-conversion-word` | `LOG_EXCEPTION_CONVERSION_WORD` | ¼쳣ʱʹõתʡ |
+| `logging.file.name` | `LOG_FILE` | ˣĬϵ־С |
+| `logging.file.path` | `LOG_PATH` | ˣĬϵ־С |
+| `logging.pattern.console` | `CONSOLE_LOG_PATTERN` | ڿ̨stdoutʹõ־ģʽ |
+| `logging.pattern.dateformat` | `LOG_DATEFORMAT_PATTERN` | date ʽ. |
+| `logging.charset.console` | `CONSOLE_LOG_CHARSET` | ̨־ַ롣 |
+| `logging.threshold.console` | `CONSOLE_LOG_THRESHOLD` | ڿ̨־¼־ |
+| `logging.pattern.file` | `FILE_LOG_PATTERN` | Ҫļʹõ־ģʽ `LOG_FILE` ã |
+| `logging.charset.file` | `FILE_LOG_CHARSET` | ļ־ַ루 `LOG_FILE` ã |
+| `logging.threshold.file` | `FILE_LOG_THRESHOLD` | ļ־¼־ |
+| `logging.pattern.level` | `LOG_LEVEL_PATTERN` | Ⱦ־ʱʹõĸʽĬΪ `%5p` |
+| `PID` | `PID` | ǰĽID |
+
+
+
+ʹLogbackҲᱻתơ
+
+
+
+| Spring Environment | System Property | ע |
+| --- | --- | --- |
+| `logging.logback.rollingpolicy.file-name-pattern` | `LOGBACK_ROLLINGPOLICY_FILE_NAME_PATTERN` | ־ļģʽĬΪ `${LOG_FILE}.%d{yyyy-MM-dd}.%i.gz` |
+| `logging.logback.rollingpolicy.clean-history-on-start` | `LOGBACK_ROLLINGPOLICY_CLEAN_HISTORY_ON_START` | Ƿʱ鵵־ļ |
+| `logging.logback.rollingpolicy.max-file-size` | `LOGBACK_ROLLINGPOLICY_MAX_FILE_SIZE` | ־ļС |
+| `logging.logback.rollingpolicy.total-size-cap` | `LOGBACK_ROLLINGPOLICY_TOTAL_SIZE_CAP` | Ҫ־ݵܴС |
+| `logging.logback.rollingpolicy.max-history` | `LOGBACK_ROLLINGPOLICY_MAX_HISTORY` | Ҫ鵵־ļ |
+
+
+
+ֵ֧־ϵͳڽļʱԴ System properties лȡԡ Ӽ `spring-boot.jar` еĬá
+
+
+
+
+
+* [Logback](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot/src/main/resources/org/springframework/boot/logging/logback/defaults.xml)
+
+* [Log4j 2](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot/src/main/resources/org/springframework/boot/logging/log4j2/log4j2.xml)
+
+* [Java Util logging](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot/src/main/resources/org/springframework/boot/logging/java/logging-file.properties)
+
+
+
+
+
+| | ־ʹռλӦʹ[Spring Boot](https://springdoc.cn/spring-boot/features.html#features.external-config.files.property-placeholders)ǵײܵ ֵעǣʹLogbackӦʹ `:` ΪĬֵ֮ķָʹ `:-` |
+| --- | --- |
+
+
+
+
+
+| | ֻͨ `LOG_LEVEL_PATTERN` ʹLogback `logging.pattern.level` ־MDCʱݡ 磬ʹ `logging.pattern.level=user:%X{user} %5p` ôĬϵ־ʽһ "user" MDCĿڵĻʾ 2019-08-30 12:30:04.031 user:someone INFO 22174 --- [ nio-8080-exec-0] demo.ControllerHandling authenticated request |
+| --- | --- |
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.logging.logback-extensions)4.9\. Logback չ
+
+
+
+Spring BootһЩLogbackչиá `logback-spring.xml` ļʹЩչ
+
+
+
+
+
+| | Ϊ `logback.xml` ļأ㲻ʹչ Ҫʹ `logback-spring.xml` ߶һ `logging.config` ԡ |
+| --- | --- |
+
+
+
+
+
+| | չ [Logbackɨ](https://logback.qos.ch/manual/configuration.html#autoScan) һʹá ͼļĻᵼµĴ¼ |
+| --- | --- |
+
+
+
+
+
+
+
+ ERROR in ch.qos.logback.core.joran.spi.Interpreter@4:71 - no applicable action for [springProperty], current ElementPath is [[configuration][springProperty]]
+ERROR in ch.qos.logback.core.joran.spi.Interpreter@4:71 - no applicable action for [springProfile], current ElementPath is [[configuration][springProfile]]
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.logging.logback-extensions.profile-specific)4.9.1\. ضļ
+
+
+
+`` ǩԸݻSpringļѡԵذųõIJ֣ ֧ `` Ԫصκεط ʹ `name` ָõļ `` ǩһļƣ `staging` һļʽ ļʽӵļ `production & (eu-central | eu-west)` 鿴 [Spring ܲοָ](https://docs.spring.io/spring-framework/docs/6.0.5/reference/html/core.html#beans-definition-profiles-java) ˽ϸڡ бʾļ
+
+
+
+
+
+
+
+```
+
+
+
+
+
+
+
+
+
+
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.logging.logback-extensions.environment-properties)4.9.2\. ԣEnvironment Properties
+
+
+
+`` ǩԷ Spring `Environment` еԣԱLogbackʹá Logbackз `application.properties` ļеֵá ñǩĹʽLogbackı `` ǩơ Ȼ㲻ֱָһ `value` ָԵ `source` `Environment` Ҫ `local` Χĵط洢ԣʹ `scope` ԡ ҪһֵĬֵһû `Environment` ãʹ `defaultValue` ԡ ʾιԱLogbackʹá
+
+
+
+
+
+
+
+```
+
+
+ ${fluentHost}
+ ...
+
+```
+
+
+
+
+
+
+
+| | `source` kebabָ `my.property-name` ȻԿͨʹÿɵĹӵ `Environment` С |
+| --- | --- |
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.logging.log4j2-extensions)4.10\. Log4j2 չ
+
+
+
+Spring BootһЩLog4j2չиáκ `log4j2-spring.xml` ļʹЩչ
+
+
+
+
+
+| | Ϊ `log4j2.xml` ļأ㲻ʹչҪʹ `log4j2-spring.xml` ߶һ ``logging.config`` ԡ |
+| --- | --- |
+
+
+
+
+
+| | ЩչȡLog4Jṩ [Spring Boot֧](https://logging.apache.org/log4j/2.x/log4j-spring-boot/index.html) ӦȷĹв `org.apache.logging.log4j:log4j-spring-boot` ģ顣 |
+| --- | --- |
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.logging.log4j2-extensions.profile-specific)4.10.1\. ضļ
+
+
+
+`` ǩԸݻSpringļѡԵذųõIJ֡ļֱ֧ `` Ԫصκεطʹ `name` ָĸļá `` ǩһļƣ `staging`һļʽ ļʽӵļ `production & (eu-central | eu-west)`鿴 [Springܲοָ](https://docs.spring.io/spring-framework/docs/6.0.5/reference/html/core.html#beans-definition-profiles-java) ˽ϸڡ бʾļ
+
+
+
+
+
+
+
+```
+
+
+
+
+
+
+
+
+
+
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.logging.log4j2-extensions.environment-properties-lookup)4.10.2\. EnvironmentԲ
+
+
+
+Log4j2Spring `Environment` еԣʹ `spring:` ǰ [](https://logging.apache.org/log4j/2.x/manual/lookups.html)Log4j2з `application.properties` ļеֵá
+
+
+
+
+
+ʾһΪ `applicationName` Log4j2ԣSpring `Environment` жȡ `spring.application.name`
+
+
+
+
+
+
+
+```
+
+ ${spring:spring.application.name}
+
+```
+
+
+
+
+
+
+
+| | ѯkeyӦkebabfָ `my.property-name` |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.logging.log4j2-extensions.environment-property-source)4.10.3\. Log4j2 ϵͳԣSystem Properties
+
+
+
+Log4j2֧һЩ [System Properties](https://logging.apache.org/log4j/2.x/manual/configuration.html#SystemProperties)øĿ磬`log4j2.skipJansi` ϵͳԿ `ConsoleAppender` ǷWindowsϳʹ [Jansi](https://github.com/fusesource/jansi)
+
+
+
+
+
+Log4j2 ʼصϵͳԶԴSpring `Environment` лá磬 `application.properties` ļ `log4j2.skipJansi=false` `ConsoleAppender` WindowsʹJansi
+
+
+
+
+
+| | ֻеϵͳԣsystem propertiesͲϵͳڼصֵʱŻῼSpring `Environment` |
+| --- | --- |
+
+
+
+
+
+| | Log4j2ʼڼصϵͳԲSpring `Environment`磬Log4j2ѡĬLog4j2ʵֵ Spring Environment ֮ǰʹõġ |
+| --- | --- |
+
+
+
+
+
+
+
diff --git "a/docs/spring/SpringBoot/SpringBoot\345\272\224\347\224\250\344\271\237\345\217\257\344\273\245\351\203\250\347\275\262\345\210\260\345\244\226\351\203\250Tomcat.md" "b/docs/spring/SpringBoot/SpringBoot\345\272\224\347\224\250\344\271\237\345\217\257\344\273\245\351\203\250\347\275\262\345\210\260\345\244\226\351\203\250Tomcat.md"
new file mode 100644
index 0000000..e22fa00
--- /dev/null
+++ "b/docs/spring/SpringBoot/SpringBoot\345\272\224\347\224\250\344\271\237\345\217\257\344\273\245\351\203\250\347\275\262\345\210\260\345\244\226\351\203\250Tomcat.md"
@@ -0,0 +1,302 @@
+
+
+
+
+# Spring Boot Tomcat
+
+ݽվѸѧϰʼǡܽоղء֤ȷԣʹöķ뱾վأ
+
+
+
+
+
+
+
+
+
+ͨʹSpring BootӦóԴһwarļԲWebСڱУѧϰδWARļTomcat WebвSpring BootӦó
+
+## Spring Boot Servletʼ
+
+ͳIJʽʹSpring BootӦó`[@SpringBootApplication](https://github.com/SpringBootApplication "@SpringBootApplication")`չ`SpringBootServletInitializer`ࡣ `SpringBootServletInitializer`ļʹServletʱӦó
+
+JARļSpring BootӦóļĴ -
+
+```
+package com.yiibai.demo;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class DemoApplication {
+ public static void main(String[] args) {
+ SpringApplication.run(DemoApplication.class, args);
+ }
+}
+
+```
+
+Ҫչ`SpringBootServletInitializer`֧WARļ Spring BootӦóļĴ -
+
+```
+package com.yiibai.demo;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.boot.builder.SpringApplicationBuilder;
+import org.springframework.boot.web.support.SpringBootServletInitializer;
+
+@SpringBootApplication
+public class DemoApplication extends SpringBootServletInitializer {
+ @Override
+ protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
+ return application.sources(DemoApplication.class);
+ }
+ public static void main(String[] args) {
+ SpringApplication.run(DemoApplication.class, args);
+ }
+}
+
+```
+
+## Main
+
+Spring BootУҪڹļָࡣ
+Maven`pom.xml``start`࣬ʾ -
+
+```
+com.yiibai.demo.DemoApplication
+
+```
+
+Gradle`build.gradle`ʾ -
+
+```
+mainClassName="com.yiibai.demo.DemoApplication"
+
+```
+
+## JARΪWAR
+
+ʹ´뽫װJARΪWAR
+
+Maven_pom.xml_ нװΪWARʾ -
+
+```
+war
+
+```
+
+Gradle_build.gradle_ Ӧówarʾ -
+
+```
+apply plugin: 'war'
+apply plugin: 'application'
+
+```
+
+GradlNowдһRest˵ַ:`"Hello World from Tomcat"` ҪдRest˵㣬ҪSpring Boot Web starterӵļС
+
+MavenʹʾĴ_pom.xml_ Spring Boot -
+
+```
+
+ org.springframework.boot
+ spring-boot-starter-web
+
+
+```
+
+GradleʹʾĴ_build.gradle_ Spring Boot starter -
+
+```
+dependencies {
+ compile('org.springframework.boot:spring-boot-starter-web')
+}
+
+```
+
+ڣʹʾĴSpring Boot ApplicationļбдһRest˵ -
+
+```
+package com.yiibai.demo;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.boot.builder.SpringApplicationBuilder;
+import org.springframework.boot.web.support.SpringBootServletInitializer;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@SpringBootApplication
+@RestController
+public class DemoApplication extends SpringBootServletInitializer {
+ @Override
+ protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
+ return application.sources(DemoApplication.class);
+ }
+ public static void main(String[] args) {
+ SpringApplication.run(DemoApplication.class, args);
+ }
+
+ @RequestMapping(value = "/")
+ public String hello() {
+ return "Hello World from Tomcat";
+ }
+}
+
+```
+
+## Ӧó
+
+ڣʹMavenGradleһWARļԲTomcatУԴӦóʾ
+
+Mavenʹ`mvn package`Ӧó ȻWARļĿĿ¼ҵĻͼʾ -
+
+
+
+Gradleʹ`gradle clean build`Ӧó ȻWARļ`build/libs`Ŀ¼ҵ۲˴ĻͼԱõ -
+
+
+
+## Tomcat
+
+ڣTomcatwebappsĿ¼²WARļ۲˴ʾĻͼԱõ -
+
+
+
+ɹҳеURL => `http://localhost:8080/demo-0.0.1-SNAPSHOT/`۲ͼʾ -
+
+
+
+£
+
+ļ_pom.xml_ -
+
+```
+
+
+4.0.0
+
+ com.yiibai
+ demo
+ 0.0.1-SNAPSHOT
+ war
+ demo
+ Demo project for Spring Boot
+
+
+ org.springframework.boot
+ spring-boot-starter-parent
+ 1.5.8.RELEASE
+
+
+
+
+ UTF-8
+ UTF-8
+ 1.8
+ com.yiibai.demo.DemoApplication
+
+
+
+
+ org.springframework.boot
+ spring-boot-starter-web
+
+
+ org.springframework.boot
+ spring-boot-starter-test
+ test
+
+
+
+
+
+
+ org.springframework.boot
+ spring-boot-maven-plugin
+
+
+
+
+
+
+```
+
+ļ_build.gradle_
+
+```
+buildscript {
+ ext {
+ springBootVersion = '1.5.8.RELEASE'
+ }
+ repositories {
+ mavenCentral()
+ }
+dependencies {
+ classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
+ }
+}
+
+apply plugin: 'java'
+apply plugin: 'eclipse'
+apply plugin: 'org.springframework.boot'
+apply plugin: 'war'
+apply plugin: 'application'
+
+group = 'com.yiibai'
+version = '0.0.1-SNAPSHOT'
+sourceCompatibility = 1.8
+mainClassName = "com.yiibai.demo.DemoApplication"
+
+repositories {
+ mavenCentral()
+}
+dependencies {
+ compile('org.springframework.boot:spring-boot-starter-web')
+ testCompile('org.springframework.boot:spring-boot-starter-test')
+}
+
+```
+
+Spring BootӦóļĴ -
+
+```
+package com.yiibai.demo;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.boot.builder.SpringApplicationBuilder;
+import org.springframework.boot.web.support.SpringBootServletInitializer;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@SpringBootApplication
+@RestController
+public class DemoApplication extends SpringBootServletInitializer {
+ @Override
+ protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
+ return application.sources(DemoApplication.class);
+ }
+ public static void main(String[] args) {
+ SpringApplication.run(DemoApplication.class, args);
+ }
+
+ @RequestMapping(value = "/")
+ public String hello() {
+ return "Hello World from Tomcat";
+ }
+}
+```
+
+
+
+
+
+//Ķhttps://www.yiibai.com/spring-boot/spring_boot_tomcat_deployment.html
+
diff --git "a/docs/spring/SpringBoot/SpringBoot\347\224\237\344\272\247\347\216\257\345\242\203\345\267\245\345\205\267Actuator.md" "b/docs/spring/SpringBoot/SpringBoot\347\224\237\344\272\247\347\216\257\345\242\203\345\267\245\345\205\267Actuator.md"
new file mode 100644
index 0000000..e0eeb3e
--- /dev/null
+++ "b/docs/spring/SpringBoot/SpringBoot\347\224\237\344\272\247\347\216\257\345\242\203\345\267\245\345\205\267Actuator.md"
@@ -0,0 +1,5832 @@
+
+
+#
+
+[Back to index](https://springdoc.cn/spring-boot/index.html)
+
+* [1\. Ĺ](https://springdoc.cn/spring-boot/actuator.html#actuator.enabling)
+* [2\. ˵㣨Endpoint](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints)
+* [3\. ͨHTTPмغ](https://springdoc.cn/spring-boot/actuator.html#actuator.monitoring)
+* [4\. ͨJMXмغ](https://springdoc.cn/spring-boot/actuator.html#actuator.jmx)
+* [5\. ɹ۲ԣObservability](https://springdoc.cn/spring-boot/actuator.html#actuator.observability)
+* [6\. ־¼Logger](https://springdoc.cn/spring-boot/actuator.html#actuator.loggers)
+* [7\. ָ꣨Metrics](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics)
+* [8\. ٣Tracing](https://springdoc.cn/spring-boot/actuator.html#actuator.micrometer-tracing)
+* [9\. ](https://springdoc.cn/spring-boot/actuator.html#actuator.auditing)
+* [10\. ¼ HTTP Exchange](https://springdoc.cn/spring-boot/actuator.html#actuator.http-exchanges)
+* [11\. ̼](https://springdoc.cn/spring-boot/actuator.html#actuator.process-monitoring)
+* [12\. Cloud Foundry ֧](https://springdoc.cn/spring-boot/actuator.html#actuator.cloud-foundry)
+* [13\. ʲô](https://springdoc.cn/spring-boot/actuator.html#actuator.whats-next)
+
+
+
+
+
+
+
+
+
+
+
+
+
+| | վ([springdoc.cn](https://springdoc.cn/))еԴ [spring.io](https://spring.io/) ԭʼȨ [spring.io](https://spring.io/) [springboot.io - Spring Boot](https://springboot.io/) з룬ɹѧϰоδɣýκתءû֮صΪ ̱Spring Pivotal Software, Inc. Լҵ̱ꡣ |
+| --- | --- |
+
+
+
+
+
+Spring BootһЩĹܣڽӦóʱغӦó ѡͨʹHTTP˵ʹJMXͼӦó ơָռҲԶӦӦó
+
+
+
+
+
+
+
+
+
+## [](https://springdoc.cn/spring-boot/actuator.html#actuator.enabling)1\. Ĺ
+
+
+
+
+
+[`spring-boot-actuator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator) ģṩSpring Bootܡ ЩܵƼӶ `spring-boot-starter-actuator` Starter
+
+
+
+
+
+
+
+ActuatorĶ
+
+
+
+actuatorִ һָƶijĻеװáactuator ԴһСı仯в˶
+
+
+
+
+
+
+
+
+
+ҪڻMavenĿactuator Starter
+
+
+
+
+
+
+
+```
+
+
+ org.springframework.boot
+ spring-boot-starter-actuator
+
+
+```
+
+
+
+
+
+
+
+Gradleʹ
+
+
+
+
+
+
+
+```
+dependencies {
+ implementation 'org.springframework.boot:spring-boot-starter-actuator'
+}
+```
+
+
+
+
+
+
+
+
+
+
+
+## [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints)2\. ˵㣨Endpoint
+
+
+
+
+
+Actuator ˵㣨endpointԼزӦó Spring BootһЩõĶ˵㣬ԼĶ˵㡣 磬`health` ˵ṩӦóϢ
+
+
+
+
+
+[û](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.enabling)ÿĶ˵㣬[ͨHTTPJMXǣʹǿԶ̷ʣ](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.exposing)һ˵㱻úͱ¶ʱΪǿõġõĶ˵ֻǿʱŻᱻԶáӦóѡͨHTTP¶ж˵ID `/actuator` ǰӳ䵽һURL磬Ĭ£`health` ˵㱻ӳ䵽 `/actuator/health`
+
+
+
+
+
+| | Ҫ˽actuatorĶ˵ԼǵӦʽ뿴APIĵ [HTML](https://docs.spring.io/spring-boot/docs/3.1.0-SNAPSHOT/actuator-api/htmlsingle) [PDF](https://docs.spring.io/spring-boot/docs/3.1.0-SNAPSHOT/actuator-api/pdf/spring-boot-actuator-web-api.pdf) |
+| --- | --- |
+
+
+
+
+
+Ǽصնˡ
+
+
+
+
+| ID | ˵ |
+| --- | --- |
+| `auditevents` | ǰӦó¼Ϣ Ҫһ `AuditEventRepository` bean |
+| `beans` | ʾӦóSpring Beanб |
+| `caches` | ʾõĻ档 |
+| `conditions` | ʾúԶԼǷϻϵԭ |
+| `configprops` | ʾ `@ConfigurationProperties` б |
+| `env` | ¶Spring `ConfigurableEnvironment` еԡ |
+| `flyway` | ʾκѾӦõFlywayݿǨơ Ҫһ `Flyway` bean |
+| `health` | ʾӦóĽϢ |
+| `httpexchanges` | ʾ HTTP exchange ϢĬ£ 100 HTTP request/response exchange Ҫһ `HttpExchangeRepository` bean |
+| `info` | ʾӦóϢ |
+| `integrationgraph` | ʾSpringͼ Ҫ `spring-integration-core` |
+| `loggers` | ʾӦóloggerá |
+| `liquibase` | ʾκѾӦõLiquibaseݿǨơ Ҫһ `Liquibase` Bean |
+| `metrics` | ʾǰӦó metrics Ϣ |
+| `mappings` | ʾ `@RequestMapping` ·б |
+| `quartz` | ʾйQuartz Scheduler JobϢ |
+| `scheduledtasks` | ʾӦóеļƻ |
+| `sessions` | Spring Sessionֵ֧ĻỰ洢мɾûỰ ҪһʹSpring SessionĻServletWebӦó |
+| `shutdown` | ӦóŵعرաֻʹjarʱЧĬǽõġ |
+| `startup` | ʾ `ApplicationStartup` ռ[](https://springdoc.cn/spring-boot/features.html#features.spring-application.startup-tracking)Ҫ `SpringApplication` Ϊ `BufferingApplicationStartup` |
+| `threaddump` | Performs a thread dump. |
+
+
+
+ӦóһWebӦóSpring MVCSpring WebFluxJerseyʹ¶Ķ˵㡣
+
+
+
+
+| ID | ˵ |
+| --- | --- |
+| `heapdump` | һdumpļ HotSpot JVMϣһ `HPROF` ʽļ OpenJ9 JVMϣһ `PHD` ʽļ |
+| `logfile` | ־ļݣ `logging.file.name` `logging.file.path` ѱã ֧ʹHTTP `Range` ͷ־ļIJݡ |
+| `prometheus` | Կɱ Prometheus ץȡĸʽչʾmetric `micrometer-registry-prometheus` |
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.enabling)2.1\. ö˵
+
+
+
+Ĭ£ `shutdown` ж˵㶼á Ҫһ˵ãʹ `management.endpoint..enabled` ԡ `shutdown` ˵㡣
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoint.shutdown.enabled=true
+
+```
+
+
+
+
+
+
+
+ϣ˵ǡѡáǡѡá뽫 `management.endpoints.enabled-by-default` Ϊ `false`ʹõ˵ `enabled` ѡá `info` ˵㣬˵㡣
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoints.enabled-by-default=false
+management.endpoint.info.enabled=true
+
+```
+
+
+
+
+
+
+
+| | õĶ˵Ӧóȫɾֻı䱩¶˵ļʹ [`include` `exclude` ](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.exposing)档 |
+| --- | --- |
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.exposing)2.2\. ¶˵
+
+
+
+Ĭ£ֻhealth˵ͨHTTPJMX¶ġ ڶ˵ܰϢӦϸǺʱ¶ǡ
+
+
+
+
+
+ҪıЩ˵㱻¶ʹض `include` `exclude` ԡ
+
+
+
+
+| | Ĭ |
+| --- | --- |
+| `management.endpoints.jmx.exposure.exclude` | |
+| `management.endpoints.jmx.exposure.include` | `health` |
+| `management.endpoints.web.exposure.exclude` | |
+| `management.endpoints.web.exposure.include` | `health` |
+
+
+
+`include` г˱¶Ķ˵ID `exclude` г˲ӦñĶ˵ID `exclude` `include` ԡ һ˵IDб `include` `exclude` ԡ
+
+
+
+
+
+磬ҪͨJMXֻ `health` `info` ˵㣬ʹԡ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoints.jmx.exposure.include=health,info
+
+```
+
+
+
+
+
+
+
+`*` ѡж˵㡣 磬ҪͨHTTPеĶ `env` `beans` ˵㣬ʹԡ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoints.web.exposure.include=*
+management.endpoints.web.exposure.exclude=env,beans
+
+```
+
+
+
+
+
+
+
+| | `*` YAMLо⺬壬ųеĶ˵㣬һҪš |
+| --- | --- |
+
+
+
+
+
+| | Ӧóǹ¶ģǿҽҲ[Ķ˵](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.security) |
+| --- | --- |
+
+
+
+
+
+| | ڶ˵㱩¶ʱʵʩԼIJԣעһ `EndpointFilter` bean |
+| --- | --- |
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.security)2.3\. ȫSecurity
+
+
+
+Ϊ˰ȫĬֻ `/health` ˵ͨHTTP ʹ `management.endpoints.web.exposure.include` ñ¶Ķ˵㡣
+
+
+
+
+
+| | `management.endpoints.web.exposure.include` ֮ǰȷ¶ִϢڷǽ֮Spring Security֮Ķ֤ȫ |
+| --- | --- |
+
+
+
+
+
+Spring Securityclasspathϣû `SecurityFilterChain` beanô `/health` ִ֮actuatorSpring BootԶ֤ȫ 㶨һԶ `SecurityFilterChain` beanSpring BootԶþͻȫִķʹ
+
+
+
+
+
+ΪHTTP˵Զ尲ȫ磬ֻijֽɫûʣSpring BootṩһЩ `RequestMatcher` Spring Securityʹá
+
+
+
+
+
+һ͵Spring Securityÿܿӡ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Configuration(proxyBeanMethods = false)
+public class MySecurityConfiguration {
+
+ @Bean
+ public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
+ http.securityMatcher(EndpointRequest.toAnyEndpoint());
+ http.authorizeHttpRequests((requests) -> requests.anyRequest().hasRole("ENDPOINT_ADMIN"));
+ http.httpBasic(withDefaults());
+ return http.build();
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+ǰʹ `EndpointRequest.toAnyEndpoint()` ƥһκζ˵㣬ȻȷеĶ˵㶼 `ENDPOINT_ADMIN` Ľɫ `EndpointRequest` ϻƥ APIĵ [HTML](https://docs.spring.io/spring-boot/docs/3.1.0-SNAPSHOT/actuator-api/htmlsingle) [PDF](https://docs.spring.io/spring-boot/docs/3.1.0-SNAPSHOT/actuator-api/pdf/spring-boot-actuator-web-api.pdf)
+
+
+
+
+
+ڷǽ沿Ӧóϣִ˵㶼ܱʣҪ֤ ͨı `management.endpoints.web.exposure.include` һ㣬ʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoints.web.exposure.include=*
+
+```
+
+
+
+
+
+
+
+⣬Spring SecurityҪԶ尲ȫãδ֤ķʶ˵㣬ʾ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Configuration(proxyBeanMethods = false)
+public class MySecurityConfiguration {
+
+ @Bean
+ public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
+ http.securityMatcher(EndpointRequest.toAnyEndpoint());
+ http.authorizeHttpRequests((requests) -> requests.anyRequest().permitAll());
+ return http.build();
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+| | ǰУֻactuator˵㡣 Spring Bootİȫκ `SecurityFilterChain` bean¶ȫ˳Ҫһ `SecurityFilterChain` beanӦó֡ |
+| --- | --- |
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.security.csrf)2.3.1\. վα챣CSRF
+
+
+
+Spring BootSpring SecurityĬֵCSRFĬ± ζʹĬϰȫʱҪ `POST`shutdownloggers˵㣩`PUT` `DELETE` actuator˵403ֹĴ
+
+
+
+
+
+| | ǽֻ㴴ķͻʹʱȫCSRF |
+| --- | --- |
+
+
+
+
+
+ [Springȫοָ](https://docs.spring.io/spring-security/reference/6.1.0-M1/features/exploits/csrf.html) ҵCSRFϢ
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.caching)2.4\. ö˵
+
+
+
+˵Զ治ҪκβĶȡӦ Ҫö˵㻺Ӧʱ䣬ʹ `cache.time-to-live` ԡ ӽ `beans` ˵ĻʱΪ10롣
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoint.beans.cache.time-to-live=10s
+
+```
+
+
+
+
+
+
+
+| | `management.endpoint.` ǰΨһرʶõĶ˵㡣 |
+| --- | --- |
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.hypermedia)2.5\. Actuator Web ˵ijý壨Hypermedia
+
+
+
+һ discovery page ӵж˵С Ĭ£discovery page `/actuator` ǿõġ
+
+
+
+
+
+Ҫ discovery pageӦóԡ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoints.web.discovery.enabled=false
+
+```
+
+
+
+
+
+
+
+һԶĹ·ʱdiscovery page Զ `/actuator` Ƶĵĸ 磬· `/management`discovery pageԴ `/management` á ·Ϊ `/` ʱҳãԷֹmappingͻĿԡ
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.cors)2.6\. CORS֧
+
+
+
+[ԴԴ](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing)CORS [W3Cһ淶](https://www.w3.org/TR/cors/)ķʽָֿȨʹSpring MVCSpring WebFluxActuatorWeb˵֧
+
+
+
+
+
+CORS֧Ĭǽõģֻ `management.endpoints.web.cors.allowed-origins` ԺŻá `example.com` е `GET` `POST`
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoints.web.cors.allowed-origins=https://example.com
+management.endpoints.web.cors.allowed-methods=GET,POST
+
+```
+
+
+
+
+
+
+
+| | μ [`CorsEndpointProperties`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/endpoint/web/CorsEndpointProperties.java) Իѡб |
+| --- | --- |
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.implementing-custom)2.7\. ʵԶ˵
+
+
+
+һ `@Endpoint` ע `@Bean`κδ `@ReadOperation``@WriteOperation` `@DeleteOperation` ע͵ķԶͨJMXWebӦóҲͨHTTP ͨʹJerseySpring MVCSpring WebFlux˵ͨHTTP¶ JerseySpring MVCãʹSpring MVC
+
+
+
+
+
+ӱ¶һһԶ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@ReadOperation
+public CustomData getData() {
+ return new CustomData("test", 5);
+}
+
+```
+
+
+
+
+
+
+
+Ҳͨʹ `@JmxEndpoint` `@WebEndpoint` дضĶ˵㡣 Щ˵㱻ǸԵļϡ 磬`@WebEndpoint` ֻͨHTTP¶ͨJMX
+
+
+
+
+
+ͨʹ `@EndpointWebExtension` `@EndpointJmxExtension` дضļչ ЩעṩضIJǿеĶ˵㡣
+
+
+
+
+
+ҪWebܵضܣʵservletSpring `@Controller` `@RestController` ˵㣬DzͨJMXʹòͬWebʱá
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.implementing-custom.input)2.7.1\.
+
+
+
+˵ϵIJͨ롣 ͨwebʱЩֵURLIJѯJSON塣 ͨJMXʱӳ䵽MBeanIJС Ĭ£DZġ ǿͨʹ `@javax.annotation.Nullable` `@org.springframework.lang.Nullable` עΪѡ
+
+
+
+
+
+ԽJSONеÿӳ䵽˵һ һJSON塣
+
+
+
+
+
+
+
+```
+{
+ "name": "test",
+ "counter": 42
+}
+```
+
+
+
+
+
+
+
+һдòҪ `String name` `int counter` ʾ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@WriteOperation
+public void updateData(String name, int counter) {
+ // injects "test" and 42
+}
+
+```
+
+
+
+
+
+
+
+| | Ϊ˵Ǽ֪ģڷǩָֻ͡ رǣ֧ `CustomData` һ `name` `counter` Եĵһ |
+| --- | --- |
+
+
+
+
+
+| | Ϊӳ䵽IJʵֶ˵JavaӦ `-parameters` 룬ʵֶ˵KotlinӦ `-java-parameters` 롣 ʹSpring BootGradleʹMaven `spring-boot-starter-parent`⽫Զ |
+| --- | --- |
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.implementing-custom.input.conversion)ת
+
+
+
+бҪݸ˵IJԶתΪ͡ ڵò֮ǰͨJMXHTTPյ뱻תΪͣʹ `ApplicationConversionService` ʵԼκ `Converter` `GenericConverter` Bean `@EndpointConverter`
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.implementing-custom.web)2.7.2\. ԶWEB˵
+
+
+
+ `@Endpoint``@WebEndpoint` `@EndpointWebExtension` ԶʹJerseySpring MVCSpring WebFluxͨHTTP JerseySpring MVCãʹSpring MVC
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.implementing-custom.web.request-predicates)WEB˵νʣPredicates
+
+
+
+һνʻΪweb¶Ķ˵ϵÿoperationԶɡ
+
+
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.implementing-custom.web.path-predicates)Path
+
+
+
+pathνɶ˵ID籩¶Ķ˵Ļ· ĬϵĻ· `/actuator` 磬һIDΪ `sessions` Ķ˵νʹ `/actuator/sessions` Ϊ·
+
+
+
+
+
+ͨ `@Selector` עһһ· IJΪһ·ӵ·νС ڵö˵ʱñֵᱻ 벶ʣ·Ԫأһ `@Selector(Match=ALL_REMAINING)`ʹΪһ `String[]` תݵ͡
+
+
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.implementing-custom.web.method-predicates)HTTP method
+
+
+
+HTTP methodνɲ;ģ±ʾ
+
+
+
+
+| Operation | HTTP method |
+| --- | --- |
+| `@ReadOperation` | `GET` |
+| `@WriteOperation` | `POST` |
+| `@DeleteOperation` | `DELETE` |
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.implementing-custom.web.consumes-predicates)Consumes
+
+
+
+ʹrequest body `@WriteOperation`HTTP `POST`νʵ `consumes` Ӿ `application/vnd.spring-boot.actuator.v2+json, application/json` `consumes` Ӿǿյġ
+
+
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.implementing-custom.web.produces-predicates)Produces
+
+
+
+νʵ `produces` Ӿ `@DeleteOperation``@ReadOperation` `@WriteOperation` ע͵ `produces` Ծ ǿѡġ ʹ`produces` ӾԶȷ
+
+
+
+
+
+ `void` `Void` `produces` ӾΪա `org.springframework.core.io.Resource``produces` Ӿ `application/octet-stream` `produces` Ӿ `application/vnd.spring-boot.actuator.v2+json, application/json`
+
+
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.implementing-custom.web.response-status)WEB˵Ӧ״̬
+
+
+
+˵ĬӦ״̬ȡڲͣдɾͲصݣеĻ
+
+
+
+
+
+ `@ReadOperation` һֵӦ״̬200(Ok) ûзһֵӦ״̬404(Not Found)
+
+
+
+
+
+ `@WriteOperation` `@DeleteOperation` һֵӦ״̬200OK ûзһֵӦ״̬204No Content
+
+
+
+
+
+һڵʱûIJ߲ܱתΪͣͲᱻãӦ״̬400Bad Request
+
+
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.implementing-custom.web.range-requests)WEB˵ Range
+
+
+
+ʹHTTP rangeһHTTPԴһ֡ ʹSpring MVCSpring Web Fluxʱ `org.springframework.core.io.Resource` IJԶַ֧Χ
+
+
+
+
+
+| | ʹJerseyʱ֧ Range |
+| --- | --- |
+
+
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.implementing-custom.web.security)Web˵İȫ
+
+
+
+web˵webض˵չϵIJԽյǰ `java.security.Principal` `org.springframework.boot.actuate.endpoint.SecurityContext` Ϊ ǰͨ `@Nullable` һʹãΪ֤δ֤ûṩͬΪ ͨͨʹ `isUserInRole(String)` ִȨ顣
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.implementing-custom.servlet)2.7.3\. Servlet ˵
+
+
+
+һServletΪһ˵㱩¶ʵһ `@ServletEndpoint` ע࣬ͬʱʵ `Supplier` Servlet˵ṩservletĸεϣȴ˿ֲԡ ǵĿеServletΪһ˵ µĶ˵㣬Ӧѡ `@Endpoint` `@WebEndpoint` ע⡣
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.implementing-custom.controller)2.7.4\. Controller ˵
+
+
+
+ʹ `@ControllerEndpoint` `@RestControllerEndpoint` ʵһSpring MVCSpring WebFluxĶ˵㡣 ͨʹSpring MVCSpring WebFluxıעӳ䣬 `@RequestMapping` `@GetMapping`˵ID·ǰ ˵ṩSpringWebܸļɣȴ˿ֲԡ Ӧѡ `@Endpoint` `@WebEndpoint` ע⡣
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.health)2.8\. Ϣ
+
+
+
+ʹýϢеӦó״̬ ϵͳʱѱˡ `health` ˵㱩¶Ϣȡ `management.endpoint.health.show-details` `management.endpoint.health.show-components` ԣǿΪֵ֮һ
+
+
+
+
+| ֵ | ˵ |
+| --- | --- |
+| `never` | ϸڴӲʾ |
+| `when-authorized` | ϸֻʾȨû ȨĽɫͨʹ `management.endpoint.health.roles` á |
+| `always` | ʾû |
+
+
+
+Ĭֵ `never` ûڶ˵һɫʱDZΪDZȨġ ˵ûýɫĬֵ֤ûΪȨġ ͨʹ `management.endpoint.health.roles` ýɫ
+
+
+
+
+
+| | ѾӦóϣʹ `always`İȫãsecurity configuration֤ͷ֤ûhealth˵㡣 |
+| --- | --- |
+
+
+
+
+
+ϢǴ [`HealthContributorRegistry`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/health/HealthContributorRegistry.java) ռģĬ£ [`HealthContributor`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/health/HealthContributor.java) ʵ `ApplicationContext` У Spring BootһЩԶõ `HealthContributor`ҲԱдԼġ
+
+
+
+
+
+һ `HealthContributor` һ `HealthIndicator` һ `CompositeHealthContributor` һ `HealthIndicator` ṩʵʵĽϢ `Status` һ `CompositeHealthContributor` ṩ `HealthContributors` ϡ ۺcontributorγһ״ṹʾϵͳĽ״
+
+
+
+
+
+Ĭ£յϵͳ״һ `StatusAggregator` óģһ״̬бÿ `HealthIndicator` ״̬ беĵһ״̬彡״̬ û `HealthIndicator` ص״̬ `StatusAggregator` ֪ģͻʹ `UNKNOWN` ״̬
+
+
+
+
+
+| | ʹ `HealthContributorRegistry` ʱעȡעὡָꡣ |
+| --- | --- |
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.health.auto-configured-health-indicators)2.8.1\. ԶõHealthIndicators
+
+
+
+ʵʱSpring BootԶ±г `HealthIndicators` Ҳͨ `management.health.key.enabled` ûͣѡָꡣ ±г `key`
+
+
+
+
+| Key | Name | ˵ |
+| --- | --- | --- |
+| `cassandra` | [`CassandraDriverHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/cassandra/CassandraDriverHealthIndicator.java) | CassandraݿǷѾ |
+| `couchbase` | [`CouchbaseHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/couchbase/CouchbaseHealthIndicator.java) | CouchbaseȺǷѾ |
+| `db` | [`DataSourceHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/jdbc/DataSourceHealthIndicator.java) | ǷԻ`DataSource`ӡ |
+| `diskspace` | [`DiskSpaceHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/system/DiskSpaceHealthIndicator.java) | ̿ռǷ㡣 |
+| `elasticsearch` | [`ElasticsearchRestHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/elasticsearch/ElasticsearchRestHealthIndicator.java) | ElasticsearchȺǷѾ |
+| `hazelcast` | [`HazelcastHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/hazelcast/HazelcastHealthIndicator.java) | HazelcastǷѾ |
+| `influxdb` | [`InfluxDbHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/influx/InfluxDbHealthIndicator.java) | InfluxDBǷѾ |
+| `jms` | [`JmsHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/jms/JmsHealthIndicator.java) | һJMSǷѾ |
+| `ldap` | [`LdapHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/ldap/LdapHealthIndicator.java) | һLDAPǷ |
+| `mail` | [`MailHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/mail/MailHealthIndicator.java) | һʼǷ |
+| `mongo` | [`MongoHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/data/mongo/MongoHealthIndicator.java) | MongoݿǷѾ |
+| `neo4j` | [`Neo4jHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/neo4j/Neo4jHealthIndicator.java) | Neo4jݿǷѾ |
+| `ping` | [`PingHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/health/PingHealthIndicator.java) | Ӧ `UP` |
+| `rabbit` | [`RabbitHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/amqp/RabbitHealthIndicator.java) | һRabbitǷѾ |
+| `redis` | [`RedisHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/data/redis/RedisHealthIndicator.java) | RedisǷѾ |
+
+
+
+| | ͨ `management.health.defaults.enabled` ǡ |
+| --- | --- |
+
+
+
+
+
+ `HealthIndicators` ǿõģĬ²á
+
+
+
+
+| Key | Name | ˵ |
+| --- | --- | --- |
+| `livenessstate` | [`LivenessStateHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/availability/LivenessStateHealthIndicator.java) | ʾ Liveness ӦóĿ״̬ |
+| `readinessstate` | [`ReadinessStateHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/availability/ReadinessStateHealthIndicator.java) | ¶ Readiness ӦóĿ״̬ |
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.health.writing-custom-health-indicators)2.8.2\. дԶHealthIndicators
+
+
+
+ΪṩԶĽϢעʵ [`HealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/health/HealthIndicator.java) ӿڵSpring Bean Ҫṩһ `health()` ʵ֣һ `Health` Ӧ `Health` ӦӦðһstatusѡҪʾϸڡ Ĵʾһ `HealthIndicator` ʵ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Component
+public class MyHealthIndicator implements HealthIndicator {
+
+ @Override
+ public Health health() {
+ int errorCode = check();
+ if (errorCode != 0) {
+ return Health.down().withDetail("Error Code", errorCode).build();
+ }
+ return Health.up().build();
+ }
+
+ private int check() {
+ // perform some specific health check
+ return ...
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+| | һ `HealthIndicator` ıʶIDû `HealthIndicator` Bean֣ڵĻ ǰУϢһΪ `my` Ŀҵ |
+| --- | --- |
+
+
+
+
+
+| | ָͨͨHTTPõģҪκӳʱ֮ǰӦ κνָӦʱ䳬10룬Spring Boot¼һϢ ֵʹ `management.endpoint.health.logging.slow-indicator-threshold` ԡ |
+| --- | --- |
+
+
+
+
+
+Spring BootԤ [`Status`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/health/Status.java) ⣬`Health` Էشϵͳ״̬Զ `Status` £㻹Ҫṩ `StatusAggregator` ӿڵԶʵ֣ͨʹ `management.endpoint.health.status.order` Ĭʵ֡
+
+
+
+
+
+磬һ `HealthIndicator` ʵʹһΪ `FATAL` `Status` Ϊ˳Ӧóԡ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoint.health.status.order=fatal,down,out-of-service,unknown,up
+
+```
+
+
+
+
+
+
+
+ӦеHTTP״̬뷴ӳ彡״̬ Ĭ£`OUT_OF_SERVICE` `DOWN` ӳ䵽503 κδӳĽ״̬ `UP`ӳΪ200 ͨHTTPʽ˵㣬ܻעԶ״̬ӳ䡣 Զӳ `DOWN` `OUT_OF_SERVICE` Ĭӳ䡣 뱣Ĭӳ䣬ȷǣԼκԶӳ䡣 磬Խ `FATAL` ӳΪ503ã `DOWN` `OUT_OF_SERVICE` Ĭӳ䡣
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoint.health.status.http-mapping.down=503
+management.endpoint.health.status.http-mapping.fatal=503
+management.endpoint.health.status.http-mapping.out-of-service=503
+
+```
+
+
+
+
+
+
+
+| | ҪĿƣԶԼ `HttpCodeStatusMapper` bean |
+| --- | --- |
+
+
+
+
+
+±ʾ״̬Ĭ״̬ӳ䡣
+
+
+
+
+| Status | Mapping |
+| --- | --- |
+| `DOWN` | `SERVICE_UNAVAILABLE` (`503`) |
+| `OUT_OF_SERVICE` | `SERVICE_UNAVAILABLE` (`503`) |
+| `UP` | Ĭûӳ䣬HTTP״̬Ϊ `200` |
+| `UNKNOWN` | Ĭûӳ䣬HTTP״̬Ϊ `200` |
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.health.reactive-health-indicators)2.8.3\. Ӧʽָ
+
+
+
+ӦʽӦóЩʹSpring WebFluxӦó`ReactiveHealthContributor` ṩһԼȡӦóĽ״ 봫ͳ `HealthContributor` ƣϢ [`ReactiveHealthContributorRegistry`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/health/ReactiveHealthContributorRegistry.java) ռĬ£ [`HealthContributor`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/health/HealthContributor.java) [`ReactiveHealthContributor`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/health/ReactiveHealthContributor.java) ʵ `ApplicationContext`
+
+
+
+
+
+ӦʽAPIмij `HealthContributors` ڵԵִС
+
+
+
+
+
+| | һӦʽӦóУӦʹ `ReactiveHealthContributorRegistry` ʱעȡעὡָꡣ Ҫעһͨ `HealthContributor`Ӧ `ReactiveHealthContributor#adapt` װ |
+| --- | --- |
+
+
+
+
+
+Ϊ˴ӦʽAPIṩԶĽϢעʵ [`ReactiveHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/health/ReactiveHealthIndicator.java) ӿڵSpring Bean Ĵʾһ `ReactiveHealthIndicator` ʾʵ֡
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Component
+public class MyReactiveHealthIndicator implements ReactiveHealthIndicator {
+
+ @Override
+ public Mono health() {
+ return doHealthCheck().onErrorResume((exception) ->
+ Mono.just(new Health.Builder().down(exception).build()));
+ }
+
+ private Mono doHealthCheck() {
+ // perform some specific health check
+ return ...
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+| | ΪԶԿǴ `AbstractReactiveHealthIndicator` չ |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.health.auto-configured-reactive-health-indicators)2.8.4\. Զõ ReactiveHealthIndicators
+
+
+
+ʵʱSpring BootԶµ `ReactiveHealthIndicators`
+
+
+
+
+| Key | Name | ˵ |
+| --- | --- | --- |
+| `cassandra` | [`CassandraDriverReactiveHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/cassandra/CassandraDriverReactiveHealthIndicator.java) | CassandraݿǷѾ |
+| `couchbase` | [`CouchbaseReactiveHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/couchbase/CouchbaseReactiveHealthIndicator.java) | CouchbaseȺǷѾ |
+| `elasticsearch` | [`ElasticsearchReactiveHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/data/elasticsearch/ElasticsearchReactiveHealthIndicator.java) | ElasticsearchȺǷѾ |
+| `mongo` | [`MongoReactiveHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/data/mongo/MongoReactiveHealthIndicator.java) | MongoݿǷѾ |
+| `neo4j` | [`Neo4jReactiveHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/neo4j/Neo4jReactiveHealthIndicator.java) | Neo4jݿǷѾ |
+| `redis` | [`RedisReactiveHealthIndicator`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/data/redis/RedisReactiveHealthIndicator.java) | RedisǷѾ |
+
+
+
+| | бҪӦʽָȡָꡣ ⣬κûбȷ `HealthIndicator` ᱻԶװ |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.health.groups)2.8.5\. Health飨Health Groups
+
+
+
+ʱָ֯ɿڲͬĿĵǺõġ
+
+
+
+
+
+Ҫһָ飬ʹ `management.endpoint.health.group.` ԣָһָIDб `include` `exclude` 磬Ҫһֻݿָ飬Զ¡
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoint.health.group.custom.include=db
+
+```
+
+
+
+
+
+
+
+Ȼͨ `[localhost:8080/actuator/health/custom](http://localhost:8080/actuator/health/custom)`
+
+
+
+
+
+ͬҪһ飬ݿָųڸ֮⣬ָ꣬Զ¡
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoint.health.group.custom.exclude=db
+
+```
+
+
+
+
+
+
+
+Ĭ£̳ϵͳͬ `StatusAggregator` `HttpCodeStatusMapper` á ȻҲÿĻ϶Щ ҪҲԸ `show-details` `roles` ԡ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoint.health.group.custom.show-details=when-authorized
+management.endpoint.health.group.custom.roles=admin
+management.endpoint.health.group.custom.status.order=fatal,up
+management.endpoint.health.group.custom.status.http-mapping.fatal=500
+management.endpoint.health.group.custom.status.http-mapping.out-of-service=500
+
+```
+
+
+
+
+
+
+
+| | ҪעԶ `StatusAggregator` `HttpCodeStatusMapper` Bean飬ʹ `@Qualifier("groupname")` |
+| --- | --- |
+
+
+
+
+
+һҲ/ųһ `CompositeHealthContributor` Ҳֻ/ųһ `CompositeHealthContributor` ij ʹȫɣʾ
+
+
+
+
+
+
+
+```
+management.endpoint.health.group.custom.include="test/primary"
+management.endpoint.health.group.custom.exclude="test/primary/b"
+```
+
+
+
+
+
+
+
+У`custom` 齫Ϊ `primary` `HealthContributor`Ǹ `test` һɲ֡ `primary` һ壬Ϊ `b` `HealthContributor` ų `custom` ֮⡣
+
+
+
+
+
+˿ڻ˿ڵĶ·ṩ KubernetesƻкãЩУڰȫǣΪִ˵ʹһĹ˿Ǻܳġ һĶ˿ڿܵ²ɿĽ飬ΪʹɹӦóҲ һ·ãʾ
+
+
+
+
+
+
+
+```
+management.endpoint.health.group.live.additional-path="server:/healthz"
+```
+
+
+
+
+
+
+
+⽫ʹ `live` ˿ `/healthz` Ͽá ǰǿԵģ `server:`˿ڣ `management:`˿ڣã ·һһ·Ρ
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.health.datasource)2.8.6\. Դ
+
+
+
+`DataSource` ָʾԴ·ԴBeanĽ״ ·ԴĽ״ÿĿԴĽ״ ڽ˵ӦУ·ԴÿĿ궼ͨʹ·ɼġ 㲻ϣָа·Դ뽫 `management.health.db.ignore-routing-data-sources` Ϊ `true`
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.kubernetes-probes)2.9\. Kubernetes ̽
+
+
+
+KubernetesϵӦóͨ [̽](https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#container-probes) ṩйڲ״̬Ϣ [Kubernetes](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/)kubeletЩ̽벢ԽӦ
+
+
+
+
+
+Ĭ£Spring Boot[Ӧÿ״̬](https://springdoc.cn/spring-boot/features.html#features.spring-application.application-availability) KubernetesУactuator `ApplicationAvailability` ӿռ Liveness Readiness Ϣר[ָ](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.health.auto-configured-health-indicators)ʹЩϢ`LivenessStateHealthIndicator` `ReadinessStateHealthIndicator` Щָʾȫֽ˵㣨`"/actuator/health"` Ҳͨʹ[](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.health.groups)ΪHTTP̽룺`"/actuator/health/liveness"` `"/actuator/health/readiness"`
+
+
+
+
+
+Ȼ¶˵ϢKubernetesʩ
+
+
+
+
+
+
+
+```
+livenessProbe:
+ httpGet:
+ path: "/actuator/health/liveness"
+ port:
+ failureThreshold: ...
+ periodSeconds: ...
+
+readinessProbe:
+ httpGet:
+ path: "/actuator/health/readiness"
+ port:
+ failureThreshold: ...
+ periodSeconds: ...
+```
+
+
+
+
+
+
+
+| | `` ӦñΪִ˵õĶ˿ڡ WebĶ˿ڣҲһĹ˿ڣ `"management.server.port"` Ѿá |
+| --- | --- |
+
+
+
+
+
+ֻеӦó[Kubernetesʱ](https://springdoc.cn/spring-boot/deployment.html#deployment.cloud.kubernetes)ЩŻԶá ͨʹ `management.endpoint.health.probes.enabled` κλǡ
+
+
+
+
+
+| | һӦóʱ䳬õЧڣKubernetes ᵽ `"startupProbe"` ΪһܵĽһ˵ﲻһҪ `"startupProbe"`Ϊ `"readinessProbe"` ֮ǰʧЧζӦó֮ǰյȻӦóҪܳʱԿʹ `"startupProbe"` ȷKubernetesӦóɱ[̽ӦóеΪ](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.kubernetes-probes.lifecycle)IJ֡ |
+| --- | --- |
+
+
+
+
+
+Actuator˵㱻һĹУôЩ˵Ͳʹͬʩ˿ڡӳء £ʹ磬ܽµӣ̽Ҳܳɹ ԭ˿ `liveness` `readiness` Ǹ⡣ ͨʵ֡
+
+
+
+
+
+
+
+```
+management.endpoint.health.probes.add-additional-paths=true
+```
+
+
+
+
+
+
+
+⽫ʹ `liveness` `/livez` ã`readiness` `readyz` ˿ڿá
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.kubernetes-probes.external-state)2.9.1\. Kubernetes̽ⲿ״̬
+
+
+
+ִ liveness readiness ̽Ϊ顣ζе[Ĺ](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.health.groups)Ƕǿõġ磬öĽָꡣ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoint.health.group.readiness.include=readinessState,customCheck
+
+```
+
+
+
+
+
+
+
+Ĭ£Spring BootЩָꡣ
+
+
+
+
+
+liveness ̽벻ӦⲿϵͳĽ顣[ӦóЧ״̬](https://springdoc.cn/spring-boot/features.html#features.spring-application.application-availability.liveness)ƻKubernetes᳢ͨӦóʵ⡣ζţһⲿϵͳݿ⡢Web APIⲿ棩ֹϣKubernetesܻӦóʵϡ
+
+
+
+
+
+ readiness ̽⣬ⲿϵͳѡӦóԱԭSpring Boot״̬̽вκζĽ顣[Ӧóʵreadiness stateunready](https://springdoc.cn/spring-boot/features.html#features.spring-application.application-availability.readiness)KubernetesͲὫ·ɵʵһЩⲿϵͳܲӦʵ£ǿԱ״̬̽СⲿϵͳܲӦóĹؼӦóж·ͻˣ£ǾԲӦñڡҵǣһӦʵⲿϵͳܳжϡ̽УⲿʱӦóᱻֹ߲ͣջи߲εĹϣҲͨڵʹö·
+
+
+
+
+
+| | һӦóʵûã`type=ClusterIP` `NodePort` KubernetesκδӡûHTTPӦ503ȣΪûӡ`type=LoadBalancer` ķܽҲܲӣȡṩߡһȷ [ingress](https://kubernetes.io/docs/concepts/services-networking/ingress/) ķҲһȡʵֵķʽӦ?ڷδε connection refusedڸؾڵ£HTTP 503Ǻпܵġ |
+| --- | --- |
+
+
+
+
+
+⣬һӦóʹ Kubernetes [autoscaling](https://kubernetes.io/docs/tasks/run-application/horizontal-pod-autoscale/)ܻӦóӸƽȡͬķӦȡautoscalerá
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.kubernetes-probes.lifecycle)2.9.2\. Ӧóں̽״̬
+
+
+
+Kubernetes Probesֵ֧һҪӦóڵһԡ `AvailabilityState`Ӧóڴڲ״̬ʵʵ̽루¶״̬֮ ʵʵ̽루¶˸״̬֮кܴ ӦóڵIJͬΣ̽ʹá
+
+
+
+
+
+Spring Boot[رڼ䷢application event](https://springdoc.cn/spring-boot/features.html#features.spring-application.application-events-and-listeners)̽ԼЩ¼¶ `AvailabilityState` Ϣ
+
+
+
+
+
+±ʾ˲ͬε `AvailabilityState` HTTP connector״̬
+
+
+
+
+
+һSpring BootӦóʱ
+
+
+
+
+| | LivenessState | ReadinessState | HTTP server | ע |
+| --- | --- | --- | --- | --- |
+| Starting | `BROKEN` | `REFUSING_TRAFFIC` | δ | Kubernetes "liveness" ̽룬ʱӦó |
+| Started | `CORRECT` | `REFUSING_TRAFFIC` | ܾ | Ӧóıˢ¡Ӧóִûյ |
+| Ready | `CORRECT` | `ACCEPTING_TRAFFIC` | | ѾɡӦóڽ |
+
+
+
+һSpring BootӦóرʱ
+
+
+
+
+| ͣ | Liveness State | Readiness State | HTTP server | ע |
+| --- | --- | --- | --- | --- |
+| Running | `CORRECT` | `ACCEPTING_TRAFFIC` | | Ҫرա |
+| Graceful shutdown | `CORRECT` | `REFUSING_TRAFFIC` | µܾ | ã [ŹػᴦС](https://springdoc.cn/spring-boot/web.html#web.graceful-shutdown) |
+| Shutdown complete | N/A | N/A | ر | ӦóıرգӦóرա |
+
+
+
+| | KubernetesĸϢμ[Kubernetes](https://springdoc.cn/spring-boot/deployment.html#deployment.cloud.kubernetes.container-lifecycle)֡ |
+| --- | --- |
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.info)2.10\. ӦϢ
+
+
+
+ӦóϢ˴ `ApplicationContext` ж [`InfoContributor`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/info/InfoContributor.java) BeanռĸϢ Spring BootһЩԶõ `InfoContributor` BeanҲԱдԼġ
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.info.auto-configured-info-contributors)2.10.1\. Զõ InfoContributor
+
+
+
+ʵʱSpringԶ `InfoContributor` Bean
+
+
+
+
+| ID | Name | ˵ | ǰ |
+| --- | --- | --- | --- |
+| `build` | [`BuildInfoContributor`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/info/BuildInfoContributor.java) | ¶˹Ϣ | һ `META-INF/build-info.properties` Դ |
+| `env` | [`EnvironmentInfoContributor`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/info/EnvironmentInfoContributor.java) | ¶ `Environment` `info.` ͷκԡ | None. |
+| `git` | [`GitInfoContributor`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/info/GitInfoContributor.java) | ¶gitϢ | һ `git.properties` Դ |
+| `java` | [`JavaInfoContributor`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/info/JavaInfoContributor.java) | ¶JavaʱRuntimeϢ | None. |
+| `os` | [`OsInfoContributor`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/info/OsInfoContributor.java) | ¶ϵͳϢ | None. |
+
+
+
+˹ߣcontributorǷ `management.info..enabled` Կơ ͬcontributorвͬĬֵȡǵȾ¶Ϣʡ
+
+
+
+
+
+ûȾӦñã`env``java` `os` contributor Ĭǽõġ ͨ `management.info..enabled` Ϊ `true` ǡ
+
+
+
+
+
+`build` `git` ϢcontributorĬõġ ͨ `management.info..enabled` Ϊ `false` á ⣬ҪÿһĬõcontributor뽫 `management.info.defaults.enabled` Ϊ `false`
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.info.custom-application-information)2.10.2\. ԶӦϢApplication Information
+
+
+
+ `env` contributor ʱͨ `info.*` Spring `info` ˵¶ݡ `info` keyµ `Environment` ԶԶ¶ 磬 `application.properties` ļá
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+info.app.encoding=UTF-8
+info.app.java.source=17
+info.app.java.target=17
+
+```
+
+
+
+
+
+
+
+| | ӲЩֵ㻹 [ڹʱչϢ](https://springdoc.cn/spring-boot/howto.html#howto.properties-and-configuration.expand-properties)ʹMavenԽǰӸд¡PropertiesYaml```info.app.encoding=@project.build.sourceEncoding@info.app.java.source=@java.version@info.app.java.target=@java.version@``` |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.info.git-commit-information)2.10.3\. Git Commit Ϣ
+
+
+
+`info` ˵һõĹܹ `git` ԴĿʱ״̬Ϣ һ `GitProperties` beanʹ `info` ˵Щԡ
+
+
+
+
+
+| | classpathĸ `git.properties` ļ`GitProperties` BeanͻᱻԶáϸڼ "[gitϢ](https://springdoc.cn/spring-boot/howto.html#howto.build.generate-git-info)" |
+| --- | --- |
+
+
+
+
+
+Ĭ£˵ᱩ¶ `git.branch``git.commit.id` `git.commit.time` ԣڣ 㲻ЩԳڶ˵ӦУҪ `git.properties` ļųǡ ʾgitϢ `git.properties` ȫݣʹ `management.info.git.mode` ԣʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.info.git.mode=full
+
+```
+
+
+
+
+
+
+
+Ҫ `info` ˵ȫgitύϢ `management.info.git.enabled` Ϊ `false`ʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.info.git.enabled=false
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.info.build-information)2.10.4\. Ϣ
+
+
+
+ `BuildProperties` Beanǿõģ`info` ˵ҲԷĹϢclasspathе `META-INF/build-info.properties` ļãͻᷢ
+
+
+
+
+
+| | MavenGradleɸļ "[ɹϢ](https://springdoc.cn/spring-boot/howto.html#howto.build.generate-info)" |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.info.java-information)2.10.5\. JavaϢ
+
+
+
+`info` ˵㷢˹JavaлϢϸڼ [`JavaInfo`](https://docs.spring.io/spring-boot/docs/3.1.0-SNAPSHOT/api/org/springframework/boot/info/JavaInfo.html)
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.info.os-information)2.10.6\. ϵͳOSϢ
+
+
+
+`info` ˵㷢IJϵͳϢϸڼ [`OsInfo`](https://docs.spring.io/spring-boot/docs/3.1.0-SNAPSHOT/api/org/springframework/boot/info/OsInfo.html)`
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.info.writing-custom-info-contributors)2.10.7\. дԶ InfoContributor
+
+
+
+ΪṩԶӦóϢעʵ [`InfoContributor`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/info/InfoContributor.java) ӿڵSpring Bean
+
+
+
+
+
+ӹһֻһֵ `example` Ŀ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Component
+public class MyInfoContributor implements InfoContributor {
+
+ @Override
+ public void contribute(Info.Builder builder) {
+ builder.withDetail("example", Collections.singletonMap("key", "value"));
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+ `info` ˵㣬Ӧÿһ¶ĿӦ
+
+
+
+
+
+
+
+```
+{
+ "example": {
+ "key" : "value"
+ }
+}
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## [](https://springdoc.cn/spring-boot/actuator.html#actuator.monitoring)3\. ͨHTTPмغ
+
+
+
+
+
+ڿһWebӦóSpring Boot ActuatorԶõĶ˵㣬ʹͨHTTP ĬϵĹʹö˵ `id` `/actuator` ǰΪURL· 磬`health` `/actuator/health` ʽ
+
+
+
+
+
+| | Actuator ֧ Spring MVCSpring WebFluxJersey JerseySpring MVCãʹSpring MVC |
+| --- | --- |
+
+
+
+
+
+| | Ϊ˻APIĵ [HTML](https://docs.spring.io/spring-boot/docs/3.1.0-SNAPSHOT/actuator-api/htmlsingle) [PDF](https://docs.spring.io/spring-boot/docs/3.1.0-SNAPSHOT/actuator-api/pdf/spring-boot-actuator-web-api.pdf) мصȷJSONӦJacksonһҪ |
+| --- | --- |
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.monitoring.customizing-management-server-context-path)3.1\. ƹ˵·
+
+
+
+ʱΪ˵㶨ǰǺõġ 磬ӦóѾ `/actuator` Ŀġ ʹ `management.endpoints.web.base-path` ı˵ǰʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoints.web.base-path=/manage
+
+```
+
+
+
+
+
+
+
+ǰ `application.properties` ӽ˵ `/actuator/{id}` Ϊ `/manage/{id}` 磬`/manage/info`
+
+
+
+
+
+| | ǹ˿ڱΪ[ʹòͬHTTP˿](https://springdoc.cn/spring-boot/actuator.html#actuator.monitoring.customizing-management-server-port)¶˵㣬 `management.endpoints.web.base-path` `server.servlet.context-path` Servlet WebӦã `spring.webflux.base-path` reactive WebӦã `management.server.port` `management.endpoints.web.base-path` `management.server.base-path` ġ |
+| --- | --- |
+
+
+
+
+
+Ѷ˵ӳ䵽ͬ·ʹ `management.endpoints.web.path-mapping` ԡ
+
+
+
+
+
+ӽ `/actuator/health` ӳΪ `/healthcheck`
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoints.web.base-path=/
+management.endpoints.web.path-mapping.health=healthcheck
+
+```
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.monitoring.customizing-management-server-port)3.2\. ƹ˿
+
+
+
+ڻƵIJ˵ͨʹĬϵHTTP˿¶˵һǵѡ ȻӦóԼУܸϲʹòͬHTTP˿¶˵㡣
+
+
+
+
+
+ `management.server.port` ıHTTP˿ڣʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.server.port=8081
+
+```
+
+
+
+
+
+
+
+| | Cloud Foundry ϣĬ£Ӧóڶ˿ 8080 Ͻ HTTP TCP ·ɵ Cloud Foundry ʹԶ˿ڣҪȷӦó·ԽתԶ˿ڡ |
+| --- | --- |
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.monitoring.management-specific-ssl)3.3\. ManagementSSL
+
+
+
+ΪʹԶ˿ʱҲͨʹø `management.server.ssl.*` ùSSL 磬ùͨHTTPṩӦóʹHTTPSʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+server.port=8443
+server.ssl.enabled=true
+server.ssl.key-store=classpath:store.jks
+server.ssl.key-password=secret
+management.server.port=8080
+management.server.ssl.enabled=false
+
+```
+
+
+
+
+
+
+
+ߣʹSSLʹòͬԿ洢ʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+server.port=8443
+server.ssl.enabled=true
+server.ssl.key-store=classpath:main.jks
+server.ssl.key-password=secret
+management.server.port=8080
+management.server.ssl.enabled=true
+management.server.ssl.key-store=classpath:management.jks
+management.server.ssl.key-password=secret
+
+```
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.monitoring.customizing-management-server-address)3.4\. Managementַ
+
+
+
+ͨ `management.server.address` ƹ˵Ŀõַ ֻڲάϼֻ `localhost` ӣá
+
+
+
+
+
+| | ֻе˿˿ڲͬʱڲͬĵַϽм |
+| --- | --- |
+
+
+
+
+
+ `application.properties` Զ̹ӡ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.server.port=8081
+management.server.address=127.0.0.1
+
+```
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.monitoring.disabling-http-endpoints)3.5\. HTTP˵
+
+
+
+㲻ͨHTTP¶˵㣬ѹ˿Ϊ `-1`ʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.server.port=-1
+
+```
+
+
+
+
+
+
+
+Ҳͨʹ `management.endpoints.web.exposure.exclude` ʵ֣ʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoints.web.exposure.exclude=*
+
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+## [](https://springdoc.cn/spring-boot/actuator.html#actuator.jmx)4\. ͨJMXмغ
+
+
+
+
+
+JavaչJMXṩһĻغӦó Ĭ£ùδá ͨ `spring.jmx.enabled` Ϊ `true` Spring Bootʵ `MBeanServer` ΪIDΪ `mbeanServer` Bean κδSpring JMXעBean`@ManagedResource``@ManagedAttribute` `@ManagedOperation`ᱩ¶
+
+
+
+
+
+ƽ̨ṩһ `MBeanServer` Spring BootʹڱҪʱĬΪVM `MBeanServer` Щʧˣͻᴴһµ `MBeanServer`
+
+
+
+
+
+ϸڼ [`JmxAutoConfiguration`](https://github.com/spring-projects/spring-boot/tree/main/spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/jmx/JmxAutoConfiguration.java) ࡣ
+
+
+
+
+
+Ĭ£Spring BootҲ˵ΪJMX MBeans `org.springframework.boot` ¹ ҪȫJMXеĶ˵עᣬԿעԼ `EndpointObjectNameFactory` ʵ֡
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.jmx.custom-mbean-names)4.1\. ԶMBean
+
+
+
+MBeanͨɶ˵ `id` ɡ 磬 `health` ˵㱻¶Ϊ `org.springframework.boot:type=Endpoint,name=Health`
+
+
+
+
+
+ӦóһϵSpring `ApplicationContext`ַܻᷢͻ Ϊ˽⣬Խ `spring.jmx.unique-names` Ϊ `true`MBean־Ψһġ
+
+
+
+
+
+㻹Զ屩¶˵JMX ʾ `application.properties` һӡ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+spring.jmx.unique-names=true
+management.endpoints.jmx.domain=com.example.myapp
+
+```
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.jmx.disable-jmx-endpoints)4.2\. JMX˵
+
+
+
+㲻ͨJMX¶˵㣬 `management.endpoints.jmx.exposure.exclude` Ϊ `*`ʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.endpoints.jmx.exposure.exclude=*
+
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+## [](https://springdoc.cn/spring-boot/actuator.html#actuator.observability)5\. ɹ۲ԣObservability
+
+
+
+
+
+ɹ۲ָⲿ۲һеϵͳڲ״̬֧ɣ־١
+
+
+
+
+
+ڶ٣Spring Bootʹ [Micrometer Observation](https://micrometer.io/docs/observation)ҪԼĹ۲죨⽫¶٣עһ `ObservationRegistry`
+
+
+
+
+
+
+
+```
+@Component
+public class MyCustomObservation {
+
+ private final ObservationRegistry observationRegistry;
+
+ public MyCustomObservation(ObservationRegistry observationRegistry) {
+ this.observationRegistry = observationRegistry;
+ }
+
+ public void doSomething() {
+ Observation.createNotStarted("doSomething", this.observationRegistry)
+ .lowCardinalityKeyValue("locale", "en-US")
+ .highCardinalityKeyValue("userId", "42")
+ .observe(() -> {
+ // Execute business logic here
+ });
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+| | ͿȵıǩӵָУ߿ȵıǩֻӵС |
+| --- | --- |
+
+
+
+
+
+`ObservationPredicate``GlobalObservationConvention` `ObservationHandler` ͵ Bean Զעᵽ `ObservationRegistry` ϡע `ObservationRegistryCustomizer` Beanһע
+
+
+
+
+
+ϸ [Micrometer Observation ĵ](https://micrometer.io/docs/observation)
+
+
+
+
+
+| | JDBCR2DBCĿɹ۲ԣObservabilityʹõĿá JDBC [Datasource Micrometer Ŀ](https://github.com/jdbc-observations/datasource-micrometer) ṩһ Spring Boot StarterڵJDBCʱԶ۲졣 [οĵ](https://jdbc-observations.github.io/datasource-micrometer/docs/current/docs/html/)ĶϢR2DBC [R2DBC۲Spring BootԶ](https://github.com/spring-projects-experimental/r2dbc-micrometer-spring-boot) ΪR2DBCѯô۲졣 |
+| --- | --- |
+
+
+
+
+
+½ڽṩ־ָٵĸϸڡ
+
+
+
+
+
+
+
+
+
+## [](https://springdoc.cn/spring-boot/actuator.html#actuator.loggers)6\. ־¼Logger
+
+
+
+
+
+Spring Boot Actuatorʱ鿴Ӧó־Ĺܡ Բ鿴б־¼ãȷõ־Լ־ܸЧ־ɡ Щ֮һ
+
+
+
+
+
+* `TRACE`
+
+* `DEBUG`
+
+* `INFO`
+
+* `WARN`
+
+* `ERROR`
+
+* `FATAL`
+
+* `OFF`
+
+* `null`
+
+
+
+
+
+`null` ʾûȷá
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.loggers.configure)6.1\. һ Logger
+
+
+
+Ҫһļ¼`POST` һʵ嵽ԴURIʾ
+
+
+
+
+
+
+
+```
+{
+ "configuredLevel": "DEBUG"
+}
+```
+
+
+
+
+
+
+
+| | Ҫ reset ã¼ض𣨲ʹĬãԴһ `null` ֵΪ `configuredLevel` |
+| --- | --- |
+
+
+
+
+
+
+
+
+
+
+
+## [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics)7\. ָ꣨Metrics
+
+
+
+
+
+Spring Boot ActuatorΪ [Micrometer](https://micrometer.io/) ṩԶãMicrometerһ֧ [ڶϵͳ](https://micrometer.io/docs) Ӧóָӿڣ
+
+
+
+
+
+* [AppOptics](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.appoptics)
+
+* [Atlas](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.atlas)
+
+* [Datadog](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.datadog)
+
+* [Dynatrace](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.dynatrace)
+
+* [Elastic](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.elastic)
+
+* [Ganglia](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.ganglia)
+
+* [Graphite](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.graphite)
+
+* [Humio](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.humio)
+
+* [Influx](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.influx)
+
+* [JMX](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.jmx)
+
+* [KairosDB](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.kairos)
+
+* [New Relic](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.newrelic)
+
+* [OpenTelemetry](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.otlp)
+
+* [Prometheus](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.prometheus)
+
+* [SignalFx](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.signalfx)
+
+* [Simple (in-memory)](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.simple)
+
+* [Stackdriver](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.stackdriver)
+
+* [StatsD](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.statsd)
+
+* [Wavefront](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.wavefront)
+
+
+
+
+
+| | Ҫ˽MicrometerĹܣμ [οĵ](https://micrometer.io/docs)ر [](https://micrometer.io/docs/concepts) |
+| --- | --- |
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.getting-started)7.1\.
+
+
+
+Spring BootԶһϵ `MeterRegistry`ΪclasspathϷֵÿֵ֧ʵһע ʱclasspathж `micrometer-registry-{system}` Spring Bootעˡ
+
+
+
+
+
+עйͬص㡣 磬ʹ Micrometer עʵclasspathϣҲԽһضע ӽDatadog
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.datadog.metrics.export.enabled=false
+
+```
+
+
+
+
+
+
+
+ҲԽеעעض˵ʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.defaults.metrics.export.enabled=false
+
+```
+
+
+
+
+
+
+
+Spring BootκԶõעӵ `Metrics` ϵȫ־̬עȷҪ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.metrics.use-global-registry=false
+
+```
+
+
+
+
+
+
+
+ע `MeterRegistryCustomizer` Beanһעκαע֮ǰӦͨǩ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Configuration(proxyBeanMethods = false)
+public class MyMeterRegistryConfiguration {
+
+ @Bean
+ public MeterRegistryCustomizer metricsCommonTags() {
+ return (registry) -> registry.config().commonTags("region", "us-east-1");
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+ͨķͽӦضעʵ֡
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Configuration(proxyBeanMethods = false)
+public class MyMeterRegistryConfiguration {
+
+ @Bean
+ public MeterRegistryCustomizer graphiteMetricsNamingConvention() {
+ return (registry) -> registry.config().namingConvention(this::name);
+ }
+
+ private String name(String name, Meter.Type type, String baseUnit) {
+ return ...
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+Spring Boot [ instrumentation](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported)ͨûרעơ
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export)7.2\. ֵ֧ļϵͳ
+
+
+
+ڼҪÿֵ֧ļϵͳ
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.appoptics)7.2.1\. AppOptics
+
+
+
+Ĭ£AppOpticsעĻᶨڽָ͵ `[api.appoptics.com/v1/measurements](https://api.appoptics.com/v1/measurements)`Ҫָ굼 SaaS [AppOptics](https://micrometer.io/docs/registry/appOptics)ṩAPIơ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.appoptics.metrics.export.api-token=YOUR_TOKEN
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.atlas)7.2.2\. Atlas
+
+
+
+Ĭ£ָᱻ㱾ػϵ [Atlas](https://micrometer.io/docs/registry/atlas)ṩ [Atlas server](https://github.com/Netflix/atlas) λá
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.atlas.metrics.export.uri=https://atlas.example.com:7101/api/v1/publish
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.datadog)7.2.3\. Datadog
+
+
+
+һDatadogעĻᶨڽָ͵ [datadoghq](https://www.datadoghq.com/) Ҫָ굽 [Datadog](https://micrometer.io/docs/registry/datadog)ṩAPIԿ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.datadog.metrics.export.api-key=YOUR_KEY
+
+```
+
+
+
+
+
+
+
+ṩһӦԿѡôԪݣDZͺͻλҲ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.datadog.metrics.export.api-key=YOUR_API_KEY
+management.datadog.metrics.export.application-key=YOUR_APPLICATION_KEY
+
+```
+
+
+
+
+
+
+
+Ĭ£ָ걻͵Datadog [site](https://docs.datadoghq.com/getting_started/site) `[api.datadoghq.com](https://api.datadoghq.com/)` DatadogĿйվϣҪָͨ꣬ӦURI
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.datadog.metrics.export.uri=https://api.datadoghq.eu
+
+```
+
+
+
+
+
+
+
+㻹ԸıDatadogָʱ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.datadog.metrics.export.step=30s
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.dynatrace)7.2.4\. Dynatrace
+
+
+
+DynatraceṩָȡAPIΪ [Micrometer](https://micrometer.io/docs/registry/dynatrace) ʵֵġ [](https://www.dynatrace.com/support/help/how-to-use-dynatrace/metrics/metric-ingestion/ingestion-methods/micrometer) ҵDynatraceMicrometerָĵ`v1` ռеֻڵ [Timeseries v1 API](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v1/) ʱ`v2` ռеֻڵ [Metrics v2 API](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/post-ingest-metrics/) ʱע⣬üÿֻܵAPI `v1` `v2` 汾`v2` 汾ѡ `device-id`v1Ҫv2вʹã `v1` ռбãômetric `v1` ˵㡣ͼٶ `v2` 汾
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.dynatrace.v2-api)v2 API
+
+
+
+ַͨʽʹv2 API
+
+
+
+
+
+###### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.dynatrace.v2-api.auto-config)Զ
+
+
+
+DynatraceԶOneAgentDynatrace Operator for Kubernetesص
+
+
+
+
+
+**OneAgent**OneAgentָԶ [local OneAgent ingest endpoint](https://www.dynatrace.com/support/help/how-to-use-dynatrace/metrics/metric-ingestion/ingestion-methods/local-api/) ȡ˵㽫ָתDynatraceˡ
+
+
+
+
+
+**Dynatrace Kubernetes Operator**ڰװDynatrace OperatorKubernetesʱעԶӲԱȡĶ˵URIAPIơ
+
+
+
+
+
+ĬΪ `io.micrometer:micrometer-registry-dynatrace` ֮⣬Ҫرá
+
+
+
+
+
+
+
+###### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.dynatrace.v2-api.manual-config)ֶ
+
+
+
+ûԶãҪ [Metrics v2 API](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/post-ingest-metrics/) Ķ˵һ API ơAPIƱ Ingest metrics `metrics.ingest`Ȩáǽ齫ƵķΧһȨϡȷ˵URI·磬`/api/v2/metrics/ingest`
+
+
+
+
+
+Metrics API v2ȡ˵URLIJѡͬ
+
+
+
+
+
+* SaaS: `https://{your-environment-id}.live.dynatrace.com/api/v2/metrics/ingest`
+
+* Managed deployments: `https://{your-domain}/e/{your-environment-id}/api/v2/metrics/ingest`
+
+
+
+
+
+ `example` environment id öֵ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.dynatrace.metrics.export.uri=https://example.live.dynatrace.com/api/v2/metrics/ingest
+management.dynatrace.metrics.export.api-token=YOUR_TOKEN
+
+```
+
+
+
+
+
+
+
+ʹDynatrace v2 APIʱʹ¿ѡܣϸڿ [Dynatraceĵ](https://www.dynatrace.com/support/help/how-to-use-dynatrace/metrics/metric-ingestion/ingestion-methods/micrometer#dt-configuration-properties) ҵ
+
+
+
+
+
+* Metric key ǰһǰǰӵеmetric keyС
+
+* DynatraceԪʵOneAgentDynatraceԱУöԪݣ磬̻Podḻָꡣ
+
+* Ĭάȡָӵеļֵԡ Micrometerָ˾ͬıǩǽĬdimension
+
+* ʹDynatrace Summary instrumentijЩ£Micrometer Dynatraceעָ걻ܾ Micrometer 1.9.xУͨDynatraceضժҪ⡣ Ϊ `false` ʹMicrometerص1.9.x֮ǰĬΪ ֻڴMicrometer 1.8.xǨƵ1.9.xʱʱſʹá
+
+
+
+
+
+ԲָURIAPIƣʾ £ʹԶõĶ˵㡣
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.dynatrace.metrics.export.v2.metric-key-prefix=your.key.prefix
+management.dynatrace.metrics.export.v2.enrich-with-dynatrace-metadata=true
+management.dynatrace.metrics.export.v2.default-dimensions.key1=value1
+management.dynatrace.metrics.export.v2.default-dimensions.key2=value2
+management.dynatrace.metrics.export.v2.use-dynatrace-summary-instruments=true
+
+```
+
+
+
+
+
+
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.dynatrace.v1-api)v1 API (Legacy)
+
+
+
+Dynatrace v1 APIָעͨʹ [Timeseries v1 API](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v1/) ڽָ͵õURI Ϊеã `device-id` ʱv1Ҫv2вʹãָ걻Timeseries v1˵㡣 Ҫ [Dynatrace](https://micrometer.io/docs/registry/dynatrace) ָ꣬ṩAPIơ豸IDURI
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.dynatrace.metrics.export.uri=https://{your-environment-id}.live.dynatrace.com
+management.dynatrace.metrics.export.api-token=YOUR_TOKEN
+management.dynatrace.metrics.export.v1.device-id=YOUR_DEVICE_ID
+
+```
+
+
+
+
+
+
+
+v1APIָURIָ·Ϊv1Ķ˵·Զӡ
+
+
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.dynatrace.version-independent-settings)汾ص
+
+
+
+API˵⣬㻹ԸıDynatraceָļʱ䡣 Ĭϵĵʱ `60s` ӽʱΪ30롣
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.dynatrace.metrics.export.step=30s
+
+```
+
+
+
+
+
+
+
+ [Micrometerĵ](https://micrometer.io/docs/registry/dynatrace) [Dynatraceĵ](https://www.dynatrace.com/support/help/how-to-use-dynatrace/metrics/metric-ingestion/ingestion-methods/micrometer) ҵΪMicrometerDynatrace exporterĸϢ
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.elastic)7.2.5\. Elastic
+
+
+
+Ĭ£ָ걻㱾ػϵ [Elastic](https://micrometer.io/docs/registry/elastic) ͨʹṩҪʹõElasticλá
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.elastic.metrics.export.host=https://elastic.example.com:8086
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.ganglia)7.2.6\. Ganglia
+
+
+
+Ĭ£ָ걻㱾ػϵ [Ganglia](https://micrometer.io/docs/registry/ganglia) ṩ [Ganglia server](http://ganglia.sourceforge.net/) Ͷ˿ڣʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.ganglia.metrics.export.host=ganglia.example.com
+management.ganglia.metrics.export.port=9649
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.graphite)7.2.7\. Graphite
+
+
+
+Ĭ£ָᱻ㱾ػϵ [Graphite](https://micrometer.io/docs/registry/graphite) ṩ [Graphite server](https://graphiteapp.org/) Ͷ˿ڣʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.graphite.metrics.export.host=graphite.example.com
+management.graphite.metrics.export.port=9004
+
+```
+
+
+
+
+
+
+
+MicrometerṩһĬϵ `HierarchicalNameMapper`dimensional meter IDhttps://micrometer.io/docs/registry/graphite#_hierarchical_name_mapping[ӳ䵽 flat hierarchical name]
+
+
+
+
+
+| | ҪΪ붨 `GraphiteMeterRegistry` ṩԼ `HierarchicalNameMapper` Լ壬ṩһԶõ `GraphiteConfig` `Clock` BeanJavaKotlin```@Configuration(proxyBeanMethods = false)public class MyGraphiteConfiguration { @Bean public GraphiteMeterRegistry graphiteMeterRegistry(GraphiteConfig config, Clock clock) { return new GraphiteMeterRegistry(config, clock, this::toHierarchicalName); } private String toHierarchicalName(Meter.Id id, NamingConvention convention) { return ... }}``` |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.humio)7.2.8\. Humio
+
+
+
+Ĭ£HumioעĻᶨڽָ͵ [cloud.humio.com](https://cloud.humio.com/) Ҫָ굼SaaS [Humio](https://micrometer.io/docs/registry/humio)ṩAPIơ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.humio.metrics.export.api-token=YOUR_TOKEN
+
+```
+
+
+
+
+
+
+
+㻹ӦһǩȷָԴ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.humio.metrics.export.tags.alpha=a
+management.humio.metrics.export.tags.bravo=b
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.influx)7.2.9\. Influx
+
+
+
+Ĭ£ָᱻڱػϵ [Influx](https://micrometer.io/docs/registry/influx) v1ʵĬáҪָ굽InfluxDB v2 `org``bucket` дָauthentication `token`ͨ·ʽṩҪʹõ [Influx server](https://www.influxdata.com/) λá
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.influx.metrics.export.uri=https://influx.example.com:8086
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.jmx)7.2.10\. JMX
+
+
+
+Micrometerṩ˶ [JMX](https://micrometer.io/docs/registry/jmx) ķֲӳ䣬ҪΪһۺͿֲķʽ鿴صĶ Ĭ£ָ걻 `metrics` JMX ͨ·ʽṩҪʹõ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.jmx.metrics.export.domain=com.example.app.metrics
+
+```
+
+
+
+
+
+
+
+MicrometerṩһĬϵ `HierarchicalNameMapper`dimensional meter ID [ӳ䵽 flat hierarchical name](https://micrometer.io/docs/registry/jmx#_hierarchical_name_mapping)
+
+
+
+
+
+| | ҪΪ붨 `JmxMeterRegistry` ṩԼ `HierarchicalNameMapper` Լ壬ṩһԶõ `JmxConfig` `Clock` BeanJavaKotlin```@Configuration(proxyBeanMethods = false)public class MyJmxConfiguration { @Bean public JmxMeterRegistry jmxMeterRegistry(JmxConfig config, Clock clock) { return new JmxMeterRegistry(config, clock, this::toHierarchicalName); } private String toHierarchicalName(Meter.Id id, NamingConvention convention) { return ... }}``` |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.kairos)7.2.11\. KairosDB
+
+
+
+Ĭ£ָ걻㱾ػϵ [KairosDB](https://micrometer.io/docs/registry/kairos) ͨ·ʽṩҪʹõ [KairosDB server](https://kairosdb.github.io/) λá
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.kairos.metrics.export.uri=https://kairosdb.example.com:8080/api/v1/datapoints
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.newrelic)7.2.12\. New Relic
+
+
+
+New RelicעĻᶨڽָ͵ [New Relic](https://micrometer.io/docs/registry/new-relic)Ҫָ굽 [New Relic](https://newrelic.com/)ṩAPIԿ˻ID
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.newrelic.metrics.export.api-key=YOUR_KEY
+management.newrelic.metrics.export.account-id=YOUR_ACCOUNT_ID
+
+```
+
+
+
+
+
+
+
+㻹ԸıNew Relicָʱ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.newrelic.metrics.export.step=30s
+
+```
+
+
+
+
+
+
+
+Ĭ£ָͨREST÷ģclasspathJava Agent APIҲʹ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.newrelic.metrics.export.client-provider-type=insights-agent
+
+```
+
+
+
+
+
+
+
+ͨԼ `NewRelicClientProvider` ȫơ
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.otlp)7.2.13\. OpenTelemetry
+
+
+
+Ĭ£ָ걻㱾ػϵ [OpenTelemetry](https://micrometer.io/docs/registry/otlp) ͨ·ʽṩҪʹõ [OpenTelemtry metric endpoint](https://opentelemetry.io/) λá
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.otlp.metrics.export.url=https://otlp.example.com:4318/v1/metrics
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.prometheus)7.2.14\. Prometheus
+
+
+
+[Prometheus](https://micrometer.io/docs/registry/prometheus) ϣscrapeѯӦóʵָꡣSpring Boot `/actuator/prometheus` ṩһactuator˵㣬Աʵĸʽ [Prometheus scrape](https://prometheus.io/)
+
+
+
+
+
+| | Ĭ£ö˵Dzõģ뱻¶ϸμ[¶˵](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.exposing) |
+| --- | --- |
+
+
+
+
+
+ `scrape_config` ӵ `prometheus.yml`
+
+
+
+
+
+
+
+```
+scrape_configs:
+ - job_name: "spring"
+ metrics_path: "/actuator/prometheus"
+ static_configs:
+ - targets: ["HOST:PORT"]
+```
+
+
+
+
+
+
+
+Ҳ֧ [Prometheus Exemplars](https://prometheus.io/docs/prometheus/latest/feature_flags/#exemplars-storage)ҪܣӦһ `SpanContextSupplier` Beanʹ [Micrometer Tracing](https://micrometer.io/docs/tracing)⽫ΪԶã룬ǿԴԼġ鿴 [Prometheus ĵ](https://prometheus.io/docs/prometheus/latest/feature_flags/#exemplars-storage) ΪҪPrometheusȷãֻ֧ʹ [OpenMetrics](https://github.com/OpenObservability/OpenMetrics/blob/v1.0.0/specification/OpenMetrics.md#exemplars) ʽ
+
+
+
+
+
+ڶݵĻҵܴڵʱ䲻ȡʹ [Prometheus Pushgateway](https://github.com/prometheus/pushgateway) ָ֧֣걩¶PrometheusҪPrometheus Pushgateway֧֣Ŀ
+
+
+
+
+
+
+
+```
+
+ io.prometheus
+ simpleclient_pushgateway
+
+```
+
+
+
+
+
+
+
+Prometheus Pushgatewayclasspathϣ `management.prometheus.metrics.export.pushgateway.enabled` ԱΪ `true` ʱһ `PrometheusPushGatewayManager` beanͱԶˡ Prometheus PushgatewayָĹ
+
+
+
+
+
+ͨʹ `management.prometheus.metrics.export.pushgateway` µ `PrometheusPushGatewayManager` ڸãҲṩԼ `PrometheusPushGatewayManager` bean
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.signalfx)7.2.15\. SignalFx
+
+
+
+SignalFxעĻᶨڽָ͵ [SignalFx](https://micrometer.io/docs/registry/signalFx)Ҫָ굽 [SignalFx](https://www.signalfx.com/)ṩaccess token
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.signalfx.metrics.export.access-token=YOUR_ACCESS_TOKEN
+
+```
+
+
+
+
+
+
+
+ҲԸıSignalFxָʱ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.signalfx.metrics.export.step=30s
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.simple)7.2.16\. Simple
+
+
+
+Micrometerṩһġڴеĺˣûעú˻ԶΪá㿴 [metrics endpoint](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.endpoint) ռЩ
+
+
+
+
+
+һʹκõĺˣڴеĺ˾ͻԶرաҲȷؽ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.simple.metrics.export.enabled=false
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.stackdriver)7.2.17\. Stackdriver
+
+
+
+StackdriverעĻᶨ [Stackdriver](https://cloud.google.com/stackdriver/) ָꡣҪָ굽SaaS [Stackdriver](https://micrometer.io/docs/registry/stackdriver)ṩGoogle Cloud project ID
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.stackdriver.metrics.export.project-id=my-project
+
+```
+
+
+
+
+
+
+
+㻹ԸıStackdriverָʱ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.stackdriver.metrics.export.step=30s
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.statsd)7.2.18\. StatsD
+
+
+
+StatsDעеؽָͨUDPStatsD agentĬ£ָ걻㱾ػϵ [StatsD](https://micrometer.io/docs/registry/statsD) agentͨ·ʽṩStatsD˿ںЭ飬Աʹá
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.statsd.metrics.export.host=statsd.example.com
+management.statsd.metrics.export.port=9125
+management.statsd.metrics.export.protocol=udp
+
+```
+
+
+
+
+
+
+
+㻹ԸıҪʹõStatsD·Э飨ĬΪDatadog
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.statsd.metrics.export.flavor=etsy
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.export.wavefront)7.2.19\. Wavefront
+
+
+
+Wavefrontעڽָ͵ [Wavefront](https://micrometer.io/docs/registry/wavefront)ֱӽָ굼 [Wavefront](https://www.wavefront.com/)ṩAPI token
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.wavefront.api-token=YOUR_API_TOKEN
+
+```
+
+
+
+
+
+
+
+⣬ĻʹWavefront sidecarڲתָݵWavefront API
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.wavefront.uri=proxy://localhost:2878
+
+```
+
+
+
+
+
+
+
+ָ귢Wavefront [Wavefrontĵ](https://docs.wavefront.com/proxies_installing.html) `proxy://HOST:PORT` ʽ
+
+
+
+
+
+ҲԸıWavefrontָʱ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.wavefront.metrics.export.step=30s
+
+```
+
+
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported)7.3\. ֵָ֧ MetricͶMeter
+
+
+
+Spring BootΪָļṩԶעᡣ ڴ£Ĭֵṩ˺ָ꣬Էκֵ֧ļϵͳС
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.jvm)7.3.1\. JVMָ
+
+
+
+Զͨʹú Micrometer JVM JVMָ `jvm.` meter name ·
+
+
+
+
+
+ṩJVMָꡣ
+
+
+
+
+
+* ڴͻϸ
+
+* ռйصͳ
+
+* ߳
+
+* غжص
+
+* JVMİ汾Ϣ
+
+* JIT ʱ
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.system)7.3.2\. ϵͳָ
+
+
+
+ԶͨʹúMicrometerʵϵͳ ϵͳָ `system.``process.` `disk.` meter ·
+
+
+
+
+
+ṩϵͳָꡣ
+
+
+
+
+
+* CPUָ
+
+* ļָ
+
+* ʱָ꣨ӦóѾеʱ;ʱĹ̶
+
+* õĴ̿ռ
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.application-startup)7.3.3\. Ӧóָ
+
+
+
+Զñ¶Ӧóʱָꡣ
+
+
+
+
+
+* `application.started.time`: Ӧóʱ䡣
+
+* `application.ready.time`ӦóΪṩʱ䡣
+
+
+
+
+
+ָӦȫǵġ
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.logger)7.3.4\. ־¼ָ
+
+
+
+ԶLogbackLog4J2¼ ϸ `log4j2.events.` `logback.events.` meter¹
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.tasks)7.3.5\. ִк͵ָ
+
+
+
+Զʹпõ `ThreadPoolTaskExecutor` `ThreadPoolTaskScheduler` BeanֻܱҪײ `ThreadPoolExecutor` á ָexecutorǣexecutorBeanơ
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.spring-mvc)7.3.6\. Spring MVC ָ
+
+
+
+Զܹ Spring MVC Controllerͱʽhandlerж Ĭ£ָ `http.server.requests` Ϊɵġ ͨ `management.observations.http.server.requests.name` Ƹơ
+
+
+
+
+
+ڲĹ۲observationĸϢμ [Spring Framework οĵ](https://docs.spring.io/spring-framework/docs/6.0.5/reference/html/integration.html#integration.observability.http-server.servlet)
+
+
+
+
+
+ҪӵĬϱǩУṩһ̳ `org.springframework.http.server.observation` е `DefaultServerRequestObservationConvention` `@Bean`Ҫ滻Ĭϱǩṩһʵ `ServerRequestObservationConvention` `@Bean`
+
+
+
+
+
+| | ijЩ£Webд쳣ᱻ¼ΪǩӦóѡ벢ͨ[handled exception Ϊ request attribute](https://springdoc.cn/spring-boot/web.html#web.servlet.spring-mvc.error-handling)¼쳣 |
+| --- | --- |
+
+
+
+
+
+Ĭ£ ҪԶṩһʵ `FilterRegistrationBean` `@Bean`
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.spring-webflux)7.3.7\. Spring WebFlux ָ
+
+
+
+ԶܹSpring WebFlux controllerͱʽhandlerж Ĭ£ָ `http.server.requests` Ϊɵġ ͨ `management.observations.http.server.requests.name` Ƹơ
+
+
+
+
+
+ڲĹ۲observationĸϢμ [Spring Framework οĵ](https://docs.spring.io/spring-framework/docs/6.0.5/reference/html/integration.html#integration.observability.http-server.reactive)
+
+
+
+
+
+ҪӵĬϱǩУṩ̳ `org.springframework.http.server.reactive.observation` е `DefaultServerRequestObservationConvention` `@Bean`Ҫ滻Ĭϱǩṩһʵ `ServerRequestObservationConvention` `@Bean`
+
+
+
+
+
+| | ijЩ£ʹд쳣ᱻ¼ΪǩӦóѡ벢ͨ[handled exceptionΪrequest attribute](https://springdoc.cn/spring-boot/web.html#web.reactive.webflux.error-handling)¼쳣 |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.jersey)7.3.8\. Jersey Server ָ
+
+
+
+ԶʹJersey JAX-RSʵܱ Ĭ£ָ `http.server.requests` Ϊɵġ ͨ `management.observations.http.server.requests.name` ơ
+
+
+
+
+
+Ĭ£Jerseyָ걻ΪϢ
+
+
+
+
+| Tag | ˵ |
+| --- | --- |
+| `exception` | ʱ׳κ쳣ļ |
+| `method` | ķ磬`GET` `POST` |
+| `outcome` | ĽӦ״̬롣 1xx `INFORMATIONAL`2xx `SUCCESS`3xx `REDIRECTION`4xx `CLIENT_ERROR`5xx `SERVER_ERROR` |
+| `status` | ӦHTTP״̬루磬`200` `500` |
+| `uri` | ܵĻڽб滻֮ǰURIģ壨磺`/api/person/{id}` |
+
+
+
+ҪƱǩṩһʵ `JerseyTagsProvider` `@Bean`
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.http-clients)7.3.9\. HTTP Client ָ
+
+
+
+Spring Boot Actuator `RestTemplate` `WebClient` ĹߡΪˣעԶõĹʹʵ
+
+
+
+
+
+* `RestTemplateBuilder` `RestTemplate`
+
+* `WebClient.Builder` `WebClient`
+
+
+
+
+
+ҲֶӦøߵcustomizer `ObservationRestTemplateCustomizer` `ObservationWebClientCustomizer`
+
+
+
+
+
+Ĭ£ָ `http.client.requests` ɵġ
+
+
+
+
+
+ͨ `management.observations.http.client.requests.name` ֡
+
+
+
+
+
+ڲĹ۲observationĸϢμ [Spring Framework οĵ](https://docs.spring.io/spring-framework/docs/6.0.5/reference/html/integration.html#integration.observability.http-client)
+
+
+
+
+
+Ҫʹ `RestTemplate` ʱƱǩṩһʵ `org.springframework.http.client.observation` `ClientRequestObservationConvention` `@Bean`Ҫʹ `WebClient` ʱԶǩṩһʵ `org.springframework.web.reactive.function.client` `ClientRequestObservationConvention` `@Bean`
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.tomcat)7.3.10\. Tomcat ָ
+
+
+
+Զý `MBeanRegistry` ʱŻTomcat Ĭ£`MBeanRegistry` ǽõģͨ `server.tomcat.mbeanregistry.enabled` Ϊ `true`
+
+
+
+
+
+Tomcatָ `tomcat.` meter ·
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.cache)7.3.11\. Cache ָ
+
+
+
+Զÿʱпõ `Cache` ʵм⣬ָ `cache` Ϊǰ
+
+
+
+
+
+DZDZĻָ꼯
+
+
+
+
+
+ҲʹöġԻָꡣ
+
+
+
+
+
+֧»⡣
+
+
+
+
+
+* Cache2k
+
+* Caffeine
+
+* Hazelcast
+
+* κμݵJCacheJSR-107ʵ
+
+* Redis
+
+
+
+
+
+ָɻƺ `CacheManager` ǣ`CacheManager` Beanġ
+
+
+
+
+
+| | ֻʱõĻ汻ע ûڻжĻ棬κʱĻԱ̷ʽĻ棬Ҫȷעᡣ һ `CacheMetricsRegistrar` Beanʹ̸ס |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.spring-graphql)7.3.12\. Spring GraphQL ָ
+
+
+
+μ [Spring GraphQL οĵ](https://docs.spring.io/spring-graphql/docs/1.1.2/reference/html/)
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.jdbc)7.3.13\. DataSource ָ
+
+
+
+Զʹпõ `DataSource` ָǰΪ `jdbc.connections` ԴĽDZʾеǰġеġĺСDZ
+
+
+
+
+
+ҲɻbeanƼ `DataSource` ǡ
+
+
+
+
+
+| | Ĭ£Spring BootΪֵ֧ԴṩԪݡ ϲԴ֧֣Ӷ `DataSourcePoolMetadataProvider` Bean `DataSourcePoolMetadataProvidersConfiguration` ˽ʵ |
+| --- | --- |
+
+
+
+
+
+⣬Hikariضָ `hikaricp` ǰ¶ ÿָ궼poolǣ `spring.datasource.name` ƣ
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.hibernate)7.3.14\. Hibernate ָ
+
+
+
+ `org.hibernate.orm:hibernate-micrometer` classpathϣͳƹܵHibernate `EntityManagerFactory` ʵᱻһΪ `hibernate` ָ⡣
+
+
+
+
+
+Ҳ `EntityManagerFactory` ǣBeanġ
+
+
+
+
+
+ҪͳƣJPA `hibernate.generate_statistics` Ϊ `true` Զõ `EntityManagerFactory` á
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+spring.jpa.properties[hibernate.generate_statistics]=true
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.spring-data-repository)7.3.15\. Spring Data Repository ָ
+
+
+
+ԶܹSpring Data `Repository` ĵýж Ĭ£ָ `spring.data.repository.invocations` Ϊɡ ͨ `management.metrics.data.repository.metric-name` Զơ
+
+
+
+
+
+`io.micrometer.core.annotation` е `@Timed` ע֧ `Repository` ӿںͷ㲻¼ `Repository` õĶmetricԽ `management.metrics.data.repository.autotime.enabled` Ϊ `false`רʹ `@Timed` ע⡣
+
+
+
+
+
+| | һ `longTask = true` `@Timed` עΪ÷һʱʱҪһ metric nameҿʱtask timerӡ |
+| --- | --- |
+
+
+
+
+
+Ĭ£repositoryصĶΪϢ
+
+
+
+
+| Tag | ˵ |
+| --- | --- |
+| `repository` | Դ `Repository` ļ |
+| `method` | õ `Repository` ơ |
+| `state` | ״̬`SUCCESS`, `ERROR`, `CANCELED`, `RUNNING` |
+| `exception` | ׳κ쳣ļ |
+
+
+
+Ҫ滻ĬϱǩҪṩһʵ `RepositoryTagsProvider` `@Bean`
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.rabbitmq)7.3.16\. RabbitMQ ָ
+
+
+
+Զʹпõ RabbitMQ ӹָΪ `rabbitmq`
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.spring-integration)7.3.17\. Spring Integration ָ
+
+
+
+ֻҪ `MeterRegistry` beanSpring IntegrationͻԶṩ [Micrometer support](https://docs.spring.io/spring-integration/docs/6.1.0-M1/reference/html/system-management.html#micrometer-integration) `spring.integration.` meter ·
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.kafka)7.3.18\. Kafka ָ
+
+
+
+ԶΪԶõ߹߹ֱעһ `MicrometerConsumerListener` `MicrometerProducerListener` Ϊ `StreamsBuilderFactoryBean` עһ `KafkaStreamsMicrometerListener` ϸڣSpring Kafkaĵе [Micrometer Native Metrics](https://docs.spring.io/spring-kafka/docs/3.0.3/reference/html/#micrometer-native) ֡
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.mongodb)7.3.19\. MongoDB ָ
+
+
+
+ڼҪMongoDBĿö
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.mongodb.command)MongoDBָ
+
+
+
+Զý `MongoMetricsCommandListener` Զõ `MongoClient` עᡣ
+
+
+
+
+
+һΪ `mongodb.driver.commands` timerָ걻ײMongoDB driverÿ Ĭ£ÿָ궼ΪϢ
+
+
+
+
+| Tag | ˵ |
+| --- | --- |
+| `command` | ơ |
+| `cluster.id` | ļȺıʶ |
+| `server.address` | ķĵַ |
+| `status` | Ľ`SUCCESS` `FAILED |
+
+
+
+Ϊ滻ĬϵĶǩһ `MongoCommandTagsProvider` beanʾ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Configuration(proxyBeanMethods = false)
+public class MyCommandTagsProviderConfiguration {
+
+ @Bean
+ public MongoCommandTagsProvider customCommandTagsProvider() {
+ return new CustomCommandTagsProvider();
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+ҪԶõԡ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.metrics.mongo.command.enabled=false
+
+```
+
+
+
+
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.mongodb.connection-pool)MongoDB ӳָ
+
+
+
+Զý `MongoMetricsConnectionPoolListener` Զõ `MongoClient` עᡣ
+
+
+
+
+
+ΪӳشIJָꡣ
+
+
+
+
+
+* `mongodb.driver.pool.size` ӳصĵǰСкʹõijԱ
+
+* `mongodb.driver.pool.checkedout` 浱ǰʹе
+
+* `mongodb.driver.pool.waitqueuesize` ӵĵȴеĵǰС
+
+
+
+
+
+Ĭ£ÿָ궼ΪϢ
+
+
+
+
+| Tag | ˵ |
+| --- | --- |
+| `cluster.id` | ӳӦļȺıʶ |
+| `server.address` | ӳӦķĵַ |
+
+
+
+ҪȡĬϵĶǩ붨һ `MongoConnectionPoolTagsProvider` bean
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Configuration(proxyBeanMethods = false)
+public class MyConnectionPoolTagsProviderConfiguration {
+
+ @Bean
+ public MongoConnectionPoolTagsProvider customConnectionPoolTagsProvider() {
+ return new CustomConnectionPoolTagsProvider();
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+ҪԶõӳضԡ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.metrics.mongo.connectionpool.enabled=false
+
+```
+
+
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.jetty)7.3.20\. Jetty ָ
+
+
+
+ԶͨʹMicrometer `JettyServerThreadPoolMetrics` ΪJetty `ThreadPool` ָꡣ Jetty `Connector` ʵָͨʹMicrometer `JettyConnectionMetrics` `server.ssl.enabled` Ϊ `true` ʱMicrometer `JettySslHandshakeMetrics`
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.timed-annotation)7.3.21\. @Timed ע֧
+
+
+
+ҪSpring Bootֱֵ֧ĵطʹ `@Timed`ο [Micrometer ĵ](https://micrometer.io/docs/concepts#_the_timed_annotation)
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.supported.redis)7.3.22\. Redis ָ
+
+
+
+ԶΪԶõ `LettuceConnectionFactory` עһ `MicrometerCommandLatencyRecorder` ϸڣLettuceĵ [Micrometer Metrics](https://lettuce.io/core/6.2.3.RELEASE/reference/index.html#command.latency.metrics.micrometer)
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.registering-custom)7.4\. עԶָ
+
+
+
+ҪעԶ뽫 `MeterRegistry` עС
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Component
+public class MyBean {
+
+ private final Dictionary dictionary;
+
+ public MyBean(MeterRegistry registry) {
+ this.dictionary = Dictionary.load();
+ registry.gauge("dictionary.size", Tags.empty(), this.dictionary.getWords().size());
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+ĶBeanǽʹ `MeterBinder` עǡ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+public class MyMeterBinderConfiguration {
+
+ @Bean
+ public MeterBinder queueSize(Queue queue) {
+ return (registry) -> Gauge.builder("queueSize", queue::size).register(registry);
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+ʹ `MeterBinder` ȷȷϵڼֵʱBeanǿõġ 㷢Ӧóظһָ꣬ô `MeterBinder` ʵҲá
+
+
+
+
+
+| | Ĭ£ `MeterBinder` Beanָ궼ԶSpring `MeterRegistry` |
+| --- | --- |
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.customizing)7.5\. Ƹָ
+
+
+
+Ҫض `Meter` ʵԶ壬ʹ `io.micrometer.core.instrument.config.MeterFilter` ӿڡ
+
+
+
+
+
+磬 `com.example` ͷDZID `mytag.region` ǩΪ `mytag.area`¹
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Configuration(proxyBeanMethods = false)
+public class MyMetricsFilterConfiguration {
+
+ @Bean
+ public MeterFilter renameRegionTagMeterFilter() {
+ return MeterFilter.renameTag("com.example", "mytag.region", "mytag.area");
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+| | Ĭ£е `MeterFilter` BeanԶSpring `MeterRegistry` ȷʹSpring `MeterRegistry` עָ꣬ʹ `Metrics` κξ̬ ЩʹõDzSpringȫע |
+| --- | --- |
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.customizing.common-tags)7.5.1\. ǩTag
+
+
+
+ͨñǩһڶлά꣬ʵջȡ ñǩDZԽãʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.metrics.tags.region=us-east-1
+management.metrics.tags.stack=prod
+
+```
+
+
+
+
+
+
+
+ǰΪֵΪ `us-east-1` `prod` DZ `region` `stack` ǩ
+
+
+
+
+
+| | ʹGraphiteͨǩ˳ǺҪġ ʹַܱ֤ǩ˳GraphiteûһԶ `MeterFilter` 档 |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.customizing.per-meter-properties)7.5.2\. Per-meter Properties
+
+
+
+ `MeterFilter` Bean㻹ʹÿĻӦһԶ幦ܡ ʹSpring Boot `PropertiesMeterFilter`ÿĶƱӦԸƿͷκαID ӹ˵κID `example.remote` ͷDZ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.metrics.enable.example.remote=false
+
+```
+
+
+
+
+
+
+
+per-meterĶơ
+
+
+
+Table 1\. Per-meter customizations
+| Property | ˵ |
+| --- | --- |
+| `management.metrics.enable` | ǷܾضIDMeter ܵMeter `MeterRegistry` й˵ |
+| `management.metrics.distribution.percentiles-histogram` | Ƿʺϼɾۼάȣİٷλֱֵͼ |
+| `management.metrics.distribution.minimum-expected-value`, `management.metrics.distribution.maximum-expected-value` | ͨǯԤֵķΧٵֱͼͰ |
+| `management.metrics.distribution.percentiles` | Ӧóмİٷλֵ |
+| `management.metrics.distribution.expiry`, `management.metrics.distribution.buffer-length` | ͨڻλлǸȨأλڿõĹںתΪ õĻȡ |
+| `management.metrics.distribution.slo` | һۻֱͼеͰķˮƽĿ궨塣 |
+
+
+
+ `percentiles-histogram` ٷ-ֱͼ`percentiles`ٷ `slo` ĸĸϸڣμMicrometerĵе [Histograms and percentiles ֱͼͰٷ](https://micrometer.io/docs/concepts#_histograms_and_percentiles)
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.endpoint)7.6\. ָ˵
+
+
+
+Spring Bootṩһ `metrics` ˵㣬ԵʹӦóռָꡣö˵ĬDzõģ빫ϸμ [¶˵](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints.exposing)
+
+
+
+
+
+ `/actuator/metrics` ʾһõDZб ͨṩΪѡ鿴ijضDZϢ磬`/actuator/metrics/jvm.memory.max`
+
+
+
+
+
+| | ʹõӦʹõһ£ļϵͳо淶֡ 仰˵ `jvm.memory.max` PrometheusʾΪ `jvm_memory_max`ΪȻӦʹ `jvm.memory.max` Ϊѡ `metrics` ˵мDZ |
+| --- | --- |
+
+
+
+
+
+ҲURLĩβ `tag=KEY:VALUE` ѯԶDZά??磬`/actuator/metrics/jvm.memory.max?tag=area:nonheap`
+
+
+
+
+
+| | IJֵDZƥDZκӦõıǩͳ _ܺ_ ǰУص `Value` ͳǶѵ Code CacheCompressed Class Space Metaspace ڴ桰㼣֮͡ ֻ Metaspace ߴ磬һ `tag=id:Metaspace` -- `/actuator/metrics/jvm.memory.max?tag=area:nonheap&tag=id:Metaspace` |
+| --- | --- |
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.metrics.micrometer-observation)7.7\. Micrometer Observation
+
+
+
+һ `DefaultMeterObservationHandler` Զע `ObservationRegistry` ϣΪÿɵĹ۲죨completed observationmetric
+
+
+
+
+
+
+
+
+
+
+
+## [](https://springdoc.cn/spring-boot/actuator.html#actuator.micrometer-tracing)8\. ٣Tracing
+
+
+
+
+
+Spring Boot Actuator Ϊ Micrometer Tracing ṩԹԶã [Micrometer Tracing](https://micrometer.io/docs/tracing) еtracerһӿڣfacade
+
+
+
+
+
+| | Ҫ˽ Micrometer Tracing ܵϢ [οĵ](https://micrometer.io/docs/tracing) |
+| --- | --- |
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.micrometer-tracing.tracers)8.1\. ֵ֧
+
+
+
+Spring BootΪṩԶá
+
+
+
+
+
+* ʹ [Zipkin](https://zipkin.io/) [Wavefront](https://docs.wavefront.com/) [OpenTelemetry](https://opentelemetry.io/)
+
+* ʹ [Zipkin](https://zipkin.io/) [Wavefront](https://docs.wavefront.com/) [OpenZipkin Brave](https://github.com/openzipkin/brave)
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.micrometer-tracing.getting-started)8.2\.
+
+
+
+ҪһʼٵʾӦóǵĿĶԣ[getting-started.html](https://springdoc.cn/spring-boot/getting-started.html#getting-started.first-application) 漰ļ Hello World! web㹻ˡǽʹ `OpenTelemetry` `Zipkin` Ϊٺˡ
+
+
+
+
+
+عһ£ǵҪӦô뿴ġ
+
+
+
+
+
+
+
+```
+@RestController
+@SpringBootApplication
+public class MyApplication {
+
+ private static final Log logger = LogFactory.getLog(MyApplication.class);
+
+ @RequestMapping("/")
+ String home() {
+ logger.info("home() has been called");
+ return "Hello World!";
+ }
+
+ public static void main(String[] args) {
+ SpringApplication.run(MyApplication.class, args);
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+| | `home()` Уһӵlogger䣬ںҪ |
+| --- | --- |
+
+
+
+
+
+ڣDZ
+
+
+
+
+
+* `org.springframework.boot:spring-boot-starter-actuator`
+
+* `io.micrometer:micrometer-tracing-bridge-otel` - Micrometer Observation API OpenTelemetry ıҪ
+
+* `io.opentelemetry:opentelemetry-exporter-zipkin` - Zipkin [traces](https://micrometer.io/docs/tracing#_glossary) Ҫġ
+
+
+
+
+
+µ application properties:
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.tracing.sampling.probability=1.0
+
+```
+
+
+
+
+
+
+
+Ĭ£Spring Bootֻ10%вԷֹٺ˲ظԽлΪ100%ÿᱻ͵ٺˡ
+
+
+
+
+
+ΪռͿӻ٣ҪһиٵĺˡʹZipkinΪǵĸٺˡ [Zipkinָ](https://zipkin.io/pages/quickstart) ṩڱZipkin˵
+
+
+
+
+
+ZipkinкӦó
+
+
+
+
+
+web `[localhost:8080](http://localhost:8080/)`Ӧÿ
+
+
+
+
+
+
+
+ Hello World!
+
+
+
+
+
+
+
+ĻѾΪHTTPһ observationŽӵ `OpenTelemetry`Zipkinһµĸ٣trace
+
+
+
+
+
+ڣ `[localhost:9411](http://localhost:9411/)` Zipkinû棬 "Run Query" ťгռĸϢӦÿһ١ "Show" ť鿴ٵϸڡ
+
+
+
+
+
+| | ͨ `logging.pattern.level` Ϊ `%5p [${spring.application.name:},%X{traceId:-},%X{spanId:-}]`־аǰĸ٣trace span id |
+| --- | --- |
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.micrometer-tracing.tracer-implementations)8.3\. Tracerʵ
+
+
+
+Micrometer Tracerֶ֧ʾʵ֣Spring Bootжϡ
+
+
+
+
+
+ʵֶҪ `org.springframework.boot:spring-boot-starter-actuator`
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.micrometer-tracing.tracer-implementations.otel-zipkin)8.3.1\. ʹ Zipkin OpenTelemetry
+
+
+
+* `io.micrometer:micrometer-tracing-bridge-otel` - Micrometer Observation API OpenTelemetry ıҪ
+
+* `io.opentelemetry:opentelemetry-exporter-zipkin` - ZipkintraceҪġ
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.micrometer-tracing.tracer-implementations.otel-wavefront)8.3.2\. ʹ Wavefront OpenTelemetry
+
+
+
+* `io.micrometer:micrometer-tracing-bridge-otel` - Micrometer Observation API OpenTelemetry ıҪ
+
+* `io.micrometer:micrometer-tracing-reporter-wavefront` - WavefronttraceҪġ
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.micrometer-tracing.tracer-implementations.brave-zipkin)8.3.3\. ʹ Zipkin OpenZipkin Brave
+
+
+
+* `io.micrometer:micrometer-tracing-bridge-brave` - Micrometer Observation API Brave ıҪ
+
+* `io.zipkin.reporter2:zipkin-reporter-brave` - Zipkin trace Ҫġ
+
+
+
+
+
+| | ĿûʹSpring MVCSpring WebFluxҲҪʹ `io.zipkin.reporter2:zipkin-sender-urlconnection` |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/actuator.html#actuator.micrometer-tracing.tracer-implementations.brave-wavefront)8.3.4\. ʹWavefrontOpenZipkin Brave
+
+
+
+* `io.micrometer:micrometer-tracing-bridge-brave` - ӲMicrometer Observation APIBraveıҪ
+
+* `io.micrometer:micrometer-tracing-reporter-wavefront` - WavefronttraceҪġ
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.micrometer-tracing.creating-spans)8.4\. Զȣspan
+
+
+
+ͨһ observation ԼspanΪˣ `ObservationRegistry` ע뵽С
+
+
+
+
+
+
+
+```
+@Component
+class CustomObservation {
+
+ private final ObservationRegistry observationRegistry;
+
+ CustomObservation(ObservationRegistry observationRegistry) {
+ this.observationRegistry = observationRegistry;
+ }
+
+ void someOperation() {
+ Observation observation = Observation.createNotStarted("some-operation", this.observationRegistry);
+ observation.lowCardinalityKeyValue("some-tag", "some-value");
+ observation.observe(() -> {
+ // Business logic ...
+ });
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+⽫һΪ "some-operation" observationǩΪǩΪ "some-tag=some-value"
+
+
+
+
+
+| | ڲmetric´һspanҪʹ Micrometer [ͼTracer API](https://micrometer.io/docs/tracing#_using_micrometer_tracing_directly) |
+| --- | --- |
+
+
+
+
+
+
+
+
+
+
+
+## [](https://springdoc.cn/spring-boot/actuator.html#actuator.auditing)9\.
+
+
+
+
+
+һSpring SecurityãSpring Boot ActuatorһƿܣԷ¼ĬΪ authentication success, failure access denied 쳣 һܶڱʵʩ֤ʧܵԷdzá
+
+
+
+
+
+ͨӦóṩһ `AuditEventRepository` ͵beanơ Ϊ˷㣬Spring Bootṩһ `InMemoryAuditEventRepository` `InMemoryAuditEventRepository` Ĺޣǽֻڿʹ 뿼ǴԼ `AuditEventRepository` ʵ֡
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.auditing.custom)9.1\.
+
+
+
+Ϊ˶Ʒİȫ¼ṩԼ `AbstractAuthenticationAuditListener` `AbstractAuthorizationAuditListener` ʵ֡
+
+
+
+
+
+ҲΪԼҵ¼ʹƷ Ҫһ㣬Ҫô `AuditEventRepository` beanעԼֱʹҪôSpring `ApplicationEventPublisher` `AuditApplicationEvent`ͨʵ `ApplicationEventPublisherAware`
+
+
+
+
+
+
+
+
+
+
+
+## [](https://springdoc.cn/spring-boot/actuator.html#actuator.http-exchanges)10\. ¼ HTTP Exchange
+
+
+
+
+
+ͨӦóṩһ `HttpExchangeRepository` ͵ bean HTTP exchange ļ¼Ϊ˷Spring Boot ṩ `InMemoryHttpExchangeRepository`Ĭ£洢100 request/response exchangeٽtracing solutionsȣ`InMemoryHttpExchangeRepository` ģǽֻڿʹǽʹһĸٻ۲ `Zipkin` `OpenTelemetry`⣬ҲԴԼ `HttpExchangeRepository`
+
+
+
+
+
+ʹ `httpexchanges` ˵ȡ洢 `HttpExchangeRepository` е request/response exchange Ϣ
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.http-exchanges.custom)10.1\. Զ HTTP Exchange ¼
+
+
+
+ҪԶÿ¼ exchange Ŀʹ `management.httpexchanges.recording.include` ԡ
+
+
+
+
+
+Ҫȫֹ±룬뽫 `management.httpexchanges.recording.enabled` Ϊ `false`
+
+
+
+
+
+
+
+
+
+
+
+## [](https://springdoc.cn/spring-boot/actuator.html#actuator.process-monitoring)11\. ̼
+
+
+
+
+
+ `spring-boot` ģУҵļ࣬Щļڽ̼ͨá
+
+
+
+
+
+* `ApplicationPidFileWriter` һӦóPIDļĬ£ӦóĿ¼£ļΪ `application.pid`
+
+* `WebServerPortFileWriter` һļеWebĶ˿ڣĬ£ӦóĿ¼£ļΪ `application.port`
+
+
+
+
+
+Ĭ£Щдûбǡ
+
+
+
+
+
+* [ͨչ](https://springdoc.cn/spring-boot/actuator.html#actuator.process-monitoring.configuration)
+
+* [Ա̷ʽʵֽ̼](https://springdoc.cn/spring-boot/actuator.html#actuator.process-monitoring.programmatically)
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.process-monitoring.configuration)11.1\. չ
+
+
+
+ `META-INF/spring.factories` ļУԼдPIDļlistenerһ߶
+
+
+
+
+
+
+
+ org.springframework.context.ApplicationListener=\
+org.springframework.boot.context.ApplicationPidFileWriter,\
+org.springframework.boot.web.context.WebServerPortFileWriter
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.process-monitoring.programmatically)11.2\. Ա̷ʽʵֽ̼
+
+
+
+Ҳͨ `SpringApplication.addListeners(?)` ʵ `Writer` һ `Writer` 캯Զļ·
+
+
+
+
+
+
+
+
+
+
+
+## [](https://springdoc.cn/spring-boot/actuator.html#actuator.cloud-foundry)12\. Cloud Foundry ֧
+
+
+
+
+
+Spring Boot actuatorģ֧֣ݵ Cloud Foundry ʵʱֽ֧ `/cloudfoundryapplication` ·Ϊ `@Endpoint` Beanṩһȫ·ߡ
+
+
+
+
+
+չ֧ʹ Cloud Foundry UI鿴ѲӦó Web Ӧóõ Spring Boot ִϢǿ 磬Ӧó״̬ҳĽϢǵ͵ running stopped ״̬
+
+
+
+
+
+| | ͨûֱӷ `/cloudfoundryapplication` · Ҫʹøö˵㣬дһЧ UAA ơ |
+| --- | --- |
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.cloud-foundry.disable)12.1\. չ Cloud Foundry Actuator ֧
+
+
+
+ȫ `/cloudfoundryapplication` ˵㣬 `application.properties` ļá
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.cloudfoundry.enabled=false
+
+```
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.cloud-foundry.ssl)12.2\. Cloud Foundryǩ֤
+
+
+
+Ĭ£`/cloudfoundryapplication` ˵İȫ֤Ը Cloud Foundry SSL á Cloud Foundry UAA Cloud Controller ʹǩ֤飬Ҫԡ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+management.cloudfoundry.skip-ssl-validation=true
+
+```
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/actuator.html#actuator.cloud-foundry.custom-context-path)12.3\. Զ Context Path
+
+
+
+ context-path Ϊ `/` κݣ Cloud Foundry ˵Ӧóĸá 磬 `server.servlet.context-path=/app` Cloud Foundry ˵ `/app/cloudfoundryapplication/*` á
+
+
+
+
+
+ϣ Cloud Foundry ˵ʼ `/cloudfoundryapplication/*` ã۷·ΣҪӦóȷá ʹõ Web ͬͬ Tomcatá
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Configuration(proxyBeanMethods = false)
+public class MyCloudFoundryConfiguration {
+
+ @Bean
+ public TomcatServletWebServerFactory servletWebServerFactory() {
+ return new TomcatServletWebServerFactory() {
+
+ @Override
+ protected void prepareContext(Host host, ServletContextInitializer[] initializers) {
+ super.prepareContext(host, initializers);
+ StandardContext child = new StandardContext();
+ child.addLifecycleListener(new Tomcat.FixContextListener());
+ child.setPath("/cloudfoundryapplication");
+ ServletContainerInitializer initializer = getServletContextInitializer(getContextPath());
+ child.addServletContainerInitializer(initializer, Collections.emptySet());
+ child.setCrossContext(true);
+ host.addChild(child);
+ }
+
+ };
+ }
+
+ private ServletContainerInitializer getServletContextInitializer(String contextPath) {
+ return (classes, context) -> {
+ Servlet servlet = new GenericServlet() {
+
+ @Override
+ public void service(ServletRequest req, ServletResponse res) throws ServletException, IOException {
+ ServletContext context = req.getServletContext().getContext(contextPath);
+ context.getRequestDispatcher("/cloudfoundryapplication").forward(req, res);
+ }
+
+ };
+ context.addServlet("cloudfoundry", servlet).addMapping("/*");
+ };
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+## [](https://springdoc.cn/spring-boot/actuator.html#actuator.whats-next)13\. ʲô
+
+
+
+
+
+һ [Graphite](https://graphiteapp.org/) ͼιߡ
+
+
+
+
+
+ԼĶ [ѡ](https://springdoc.cn/spring-boot/deployment.html#deployment) ǰȥ˽йSpring Boot [߲](https://springdoc.cn/spring-boot/build-tool-plugins.html#build-tool-plugins)һЩϢ
+
+
+
+
+
+
+
diff --git "a/docs/spring/SpringBoot/SpringBoot\347\232\204Starter\346\234\272\345\210\266.md" "b/docs/spring/SpringBoot/SpringBoot\347\232\204Starter\346\234\272\345\210\266.md"
new file mode 100644
index 0000000..0318193
--- /dev/null
+++ "b/docs/spring/SpringBoot/SpringBoot\347\232\204Starter\346\234\272\345\210\266.md"
@@ -0,0 +1,262 @@
+starterSpringBootеһ·ЧĽĿ̵ĸӳ̶ȣڼŷdzõЧתһƬ£ϸspring boot staterʲôʲô
+
+Spring Boot StarterSpringBootбһָstackoverflowѾ˸starterʲô뿴Ļش[](https://stackoverflow.com/a/28273660)https://stackoverflow.com/questions/28273543/what-are-spring-boot-starter-jars/28273660#28273660
+
+
+
+˼˵starterһֶsynthesizeϳɣʲô˼أҿԾٸ˵
+
+### ? ͳ
+
+ûstarter֮ǰҪSpringʹjpaҿҪ²
+
+1. MavenʹõݿJDBCjar
+2. jpa
+3. xxx.xmlһЩϢ
+4. ĵֱ
+
+Ҫעǣ**_ÿ½һҪõjpaĿʱҪظһ_**ҲڵһԼĿʱGoogleԼһ˰ʱ˸ֵ֮jpaˡЩо˻OneNoteνĿĹ̸¼IJԼҪõļݣһٴjpaĿʱͲҪٴȥGoogleˣֻҪűʼٰ֮еļcopy&pasteͿˡ
+
+IJҲ㲻Уʵûstarter֮ǰôɵģм⣺
+
+1. ̱ȽϷһӳĿ
+2. ͣcopy&paste[Dont repeat yourself](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself)
+3. ڵһõʱ߱ȽСףҪѵʱ
+
+### ʹSpring Boot StarterЧ
+
+starterҪĿľΪ˽Щ⡣
+
+starterstarterõ˿Լȥ鷳ҪעDzͬstarterΪ˽ͬڲʵֿܻкܴIJ죬jpastarterRedisstarterʵ־ͲһΪstarterısynthesizeһijҲеDockerΪǶһװIJ֪DockerΪ˽ʲôģҲDockerstarterһȡ
+
+starterʵ֣Ȼͬstarterʵв죬ǻ϶ʹõͬݣConfigurationPropertiesAutoConfigurationΪSpring BootšԼáһʹConfigurationPropertiesǵãЩöһĬֵûдԭʼõ£ĬֵͻЧںܶǷdzõġ֮⣬starterConfigurationPropertiesʹеԱۼһļУһresourcesĿ¼µapplication.propertiesǾSpringĿXML
+
+starter
+
+
+
+starterjarԼֶõʱjarûʲôͬǿΪstarterʵǰһЩòԼѼû˰ûȥ˷ĹڡԼá£ConfigurationPropertiesûνòΪ?`application.properties`?ļĴڣʹҪԶãеҲֻҪһļнУʹdz㡣
+
+˽starterʵǰûõIJ֮Ҫstarterͱstarter֮䲢ǾϵǸϵǿԸһһstarterûʹʱӵļ㡣ǿԸһеһstarterñʹʱӵļ㣬ʵSpring BootŶѾдֵеǵstarter[](https://github.com/spring-projects/spring-boot/tree/v1.5.7.RELEASE/spring-boot-starters)鿴Щstarterб
+
+springboot ô˾ȻûԶstarter붼Խһ¡
+
+
+
+# SpringBoot starter
+
+SpringBootеstarterһַdzҪĻƣܹǰӵãͳһɽstarterӦֻҪmavenstarterSpringBootԶɨ赽ҪصϢӦĬástarterǰ˸ĴҪøϢšSpringBootԶͨclasspath·µҪBeanעIOCSpringBootṩճҵӦзֳspring-boot-starterģ顣Щģ鶼ѭԼĬãǵЩãѭԼá
+
+# Զstarter
+
+ճʱһЩҵ֮Ĺܻģ飬ĿãһĿҲҪãÿζ¼ɵĻͻ鷳ʱֻҪЩܻģװһstarterĻʹõʱȥͺܷˡ
+
+## Զstarter
+
+ʵԶstarterܼҪ5
+
+1. ½ģ飬淶 springbootԴstarter淶Ϊspring-boot-starter-xxx Զstarter淶Ϊxxx-spring-boot-starter
+
+ xxx-spring-boot-autoconfigureԶúĴ
+ xxx-spring-boot-starter
+ҪԶô뿪ԽϵһģСֻspringbootٷ齫ģֿ
+2\. spring-boot-autoconfigure
+3\. ԶXXXProperties : ԸҪҪļеġ
+4\. ԶXXXAutoConfigurationࣺҪԶʱһЩͬʱҲҪXXXProperties Ч
+5\. Զspring.factoriesļresources/META-INFһspring.factoriesļspring-configuration-metadata.jsonspring-configuration-metadata.jsonļдļʱʾҪɲҪеĻʾѺáspring.factoriesڵԶ࣬Ҫ
+
+## ʵ
+
+Ϊ˷ֻһģˣ
+
+1. һģ飬Ϊspring-boot-starter-my-starterӦpomļ
+
+```
+ com.example
+ spring-boot-starter-my-starter
+ 1.0
+ my-starter
+ƴ
+```
+
+1. spring-boot-autoconfigure ʹõspring-boot-autoconfigure汾2.6.2
+
+```
+
+
+ org.springframework.boot
+ spring-boot-autoconfigure
+ 2.6.2
+
+
+ƴ
+```
+
+1. ԶXXXProperties
+
+```
+@ConfigurationProperties(prefix = "com.arron")
+public class MyStarterProperties {
+
+ private String name;
+
+ public String getName() {
+ return name;
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+}
+ƴ
+```
+
+ٴһMyStarterConfigڶȡMyStarterProperties
+
+```
+public class MyStarterConfig {
+
+ private MyStarterProperties myStarterProperties;
+
+ private String name;
+
+ public MyStarterConfig(MyStarterProperties myStarterProperties) {
+ this.myStarterProperties = myStarterProperties;
+ }
+
+ public String getName() {
+ return myStarterProperties.getName();
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+}
+ƴ
+```
+
+1. ԶXXXAutoConfiguration
+
+```
+@Configuration
+// EnableConfigurationProperties valueе
+@EnableConfigurationProperties(value = {MyStarterProperties.class})
+public class MyStarterAutoConfiguration {
+
+ @Autowired
+ private MyStarterProperties myStarterProperties;
+
+ @Bean
+ @ConditionalOnMissingBean(MyStarterConfig.class)
+ public MyStarterConfig myStarterConfig(){
+ return new MyStarterConfig(myStarterProperties);
+ }
+
+}
+ƴ
+```
+
+1. resources/META-INFһspring.factoriesļ
+
+spring.factories
+
+```
+org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.example.myStarter.MyStarterAutoConfiguration
+ƴ
+```
+
+spring-configuration-metadata.json
+
+```
+{
+ "group": [
+ {
+ "name": "com.arron",
+ "type": "com.example.myStarter.MyStarterProperties",
+ "sourceType": "com.example.myStarter.MyStarterProperties"
+ }
+ ],
+ "properties": [
+ {
+ "name": "com.arron.name",
+ "type": "java.lang.String",
+ "description": "my start name",
+ "sourceType": "com.example.myStarter.MyStarterProperties",
+ "defaultValue": "MyStarterProperties name"
+ }
+ ]
+}
+ƴ
+```
+
+##
+
+ҵͼmaveninstallװ 
+
+Ȼ½һĿвԣĿ̾Ͳˡ
+
+1.
+
+```
+
+ com.example
+ spring-boot-starter-my-starter
+ 1.0
+
+ƴ
+```
+
+1. ļԣ
+
+```
+com:
+ arron:
+ name: myname
+ƴ
+```
+
+1. Ԫԣ
+
+```
+@RunWith(SpringRunner.class)
+@SpringBootTest
+class RabbitmqApplicationTests {
+ @Autowired
+ private MyStarterConfig myStarterConfig;
+
+ @Test
+ public void testMyStarter(){
+ String name = myStarterConfig.getName();
+ System.out.println(name);
+ }
+}
+ƴ
+```
+
+̨
+
+```
+myname
+ƴ
+```
+
+ˣһԶspringboot starterˡ
+
+# ע
+
+ЩעԶstarterǿܻõ
+
+* @Conditionalһжϣעbean
+* @ConditionalOnMissingBeanbeanʱ,ʵǰBean
+* @ConditionalOnPropertyļ㶨bean
+* @ConditionalOnBeanbeanʱ,ʵǰBean
+* @ConditionalOnClass ·ϴڣʵǰBean
+* @ConditionalOnMissingClass ·ϲڣʵǰBean
+
+
+
+ߣ
+ӣhttps://juejin.cn/post/7127468724046528525
+Դϡ
+ȨСҵתϵȨҵתע
+
diff --git "a/docs/spring/SpringBoot/SpringBoot\347\232\204\345\237\272\346\234\254\344\275\277\347\224\250.md" "b/docs/spring/SpringBoot/SpringBoot\347\232\204\345\237\272\346\234\254\344\275\277\347\224\250.md"
index 36a2500..247e419 100644
--- "a/docs/spring/SpringBoot/SpringBoot\347\232\204\345\237\272\346\234\254\344\275\277\347\224\250.md"
+++ "b/docs/spring/SpringBoot/SpringBoot\347\232\204\345\237\272\346\234\254\344\275\277\347\224\250.md"
@@ -20,55 +20,20 @@
ɡť zip ļѹϵһļС
-
+
[start.spring.io](http://start.spring.io/)Ŀ[Spring Boot](https://spring.io/projects/spring-boot)һSpringӦóڲҪ̫á Spring Boot Spring Ŀеķʽ
ѡʹmavenΪߣĿpomļpomļӵ
-````
-
-
- 4.0.0
-
- org.springframework.boot
- spring-boot-starter-parent
- 3.0.5
-
-
- com.example
- demo
- 0.0.1-SNAPSHOT
- demo
- Demo project for Spring Boot
-
- 17
-
-
-
- org.springframework.boot
- spring-boot-starter-web
-
-
-
- org.springframework.boot
- spring-boot-starter-test
- test
-
-
-
-
-
-
- org.springframework.boot
- spring-boot-maven-plugin
-
-
-
-
-
-````
+````
+
+ 4.0.0 org.springframework.boot spring-boot-starter-parent 3.0.5 com.example demo 0.0.1-SNAPSHOT demo Demo project for Spring Boot 17 org.springframework.boot spring-boot-starter-web
+ org.springframework.boot spring-boot-starter-test test
+ org.springframework.boot spring-boot-maven-plugin
+
+````
## ڶĴ
@@ -76,27 +41,20 @@
IDE дĿ `src/main/java/com/example/demo` ļҵ `DemoApplication.java` ļ
ͨʾĶⷽעļݡԸƲճֱӼ롣
-```
-package com.example.demo;
-import org.springframework.boot.SpringApplication;
-import org.springframework.boot.autoconfigure.SpringBootApplication;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.RequestParam;
-import org.springframework.web.bind.annotation.RestController;
-
-@SpringBootApplication
-@RestController
-public class DemoApplication {
- public static void main(String[] args) {
- SpringApplication.run(DemoApplication.class, args);
- }
- @GetMapping("/hello")
- public String hello(@RequestParam(value = "name", defaultValue = "World") String name) {
- return String.format("Hello %s!", name);
- }
-}
-
-```
+```
+package com.example.demo;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+@SpringBootApplication
+@RestController
+public class DemoApplication {
+ public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } @GetMapping("/hello") public String hello(@RequestParam(value = "name", defaultValue = "World") String name) { return String.format("Hello %s!", name); }}
+
+```
Spring Boot дһġHello World Web д롣
@@ -104,8 +62,7 @@ public class DemoApplication {
ζнΪAmyӦǡHello Amy
-`@RestController` ע Spring˴һ˵㣬ö˵Ӧ Web Ͽá
-
+`@RestController` ע Spring˴һ˵㣬ö˵Ӧ Web Ͽá
@GetMapping(/hello) Spring ʹǵ hello() Ӧ͵ http://localhost:8080/hello ַ
@RequestParam Spring һֵڣĬʹõʡWorld
@@ -118,34 +75,33 @@ public class DemoApplication {
**MacOS/Linux:**
-```
-COPY./gradlew bootRun
-
-```
+```
+COPY./gradlew bootRun
+
+```
**Windows:**
-```
-COPY.\gradlew.bat bootRun
-
-```
+```
+COPY.\gradlew.bat bootRun
+
+```
-ӦûῴһЩ˷dzƵ
-
+ӦûῴһЩ˷dzƵ
+
-иǣSpringӦѾʼˡ
-Spring Boot Ƕʽ Apache Tomcat 䵱ڼlocalhost˿ڡ8080ϵ
+иǣSpringӦѾʼˡ Spring Boot Ƕʽ Apache Tomcat 䵱ڼlocalhost˿ڡ8080ϵ
ڶĵַ`http://localhost:8080/hello`
-ӦõõһѺõĻӦ
-
+ӦõõһѺõĻӦ
+
# ܽ
-˼һSpringBootӦþôˣ㲻ҪļǶķ
+˼һSpringBootӦþôˣ㲻ҪļǶķ
ֻҪһ࣬ͿʵһSpringBootӦá
-ҲΪʲôspringbootٹһΪʵ̫ˡ
+ҲΪʲôspringbootٹһΪʵ̫ˡ
ȻʵʿҪõspringbootĹܺԣǽڽ½չܡ
# ο
diff --git "a/docs/spring/SpringBoot/SpringBoot\347\232\204\351\205\215\347\275\256\346\226\207\344\273\266\347\256\241\347\220\206.md" "b/docs/spring/SpringBoot/SpringBoot\347\232\204\351\205\215\347\275\256\346\226\207\344\273\266\347\256\241\347\220\206.md"
new file mode 100644
index 0000000..46c6771
--- /dev/null
+++ "b/docs/spring/SpringBoot/SpringBoot\347\232\204\351\205\215\347\275\256\346\226\207\344\273\266\347\256\241\347\220\206.md"
@@ -0,0 +1,2989 @@
+## 1.SpringBootùı
+
+ΪʵֿٴͿĿSpringbootܴspringbootĿԽĿֱӴjarУԼװTomcatһַݵIJʽ
+
+Ŀķʽһjar𣬼ļ͵jarͻ
+
+һĿйУҪĶļĻҪ´
+
+ĿҪͬһ̨ʱԵjarͬĵĿjar100Mܾռ99M˷Դ˷ԼĿЧʡ
+
+ĿļȡjarͳһĿЧֽԼ˷ĴģͬʱĿάҲǷdzģĶļ·Ϳˣ¹
+
+Ǿʵַ
+
+### 1.1 **ļͳһ**
+
+```
+ - springbootļ
+ - Springbootȡļapplication.propertiesȼΪ
+ - JarͬĿ¼configĿ¼
+ - JarͬĿ¼
+ - classPath(resourcesĿ¼)configĿ¼
+ - classpathĿ¼
+
+```
+
+springbootĬȥԼĺļȼһȼķʽĿʱͨķʽָĿغļ
+java Cjar -Dspring.config.location=xxx/xxx/xxxx.properties xxxx.jar
+
+Spring Bootȼߵλҵãôȼ͵
+
+### 1.2 **Դļ**
+
+SpringbootļѾܹȡjarйˣǻһЩҵϵļԴļԴļFTPϢȣquartzʱ־ļȥȡȷڴõ
+
+֪SpringbootĿͨעⷽʽȡļҲͨעⷽʽĿܹõjarⲿļģͼ
+
+
+@PropertySourcevalueֵһclasspathconfigĿ¼µԴļڶǸspring.profiles.path̬ȡĿ¼spring.profiles.pathںļԶһֵļͳһļ·ignoreResourceNotFound=true趨ǰһ·ûҵļݵڶ·ȥҡ
+
+ǻֱӸ·FileSystemResourceȥһļʵͼ
+
+
+ԭƣںļԶͳһĿ¼·ļ
+
+logback־ļطʽ£
+
+
+һʵַ˼·
+
+```
+ - springbootļﶨһspring.profiles.pathֵָļͳһõĿ¼ļҲǷ
+
+ - ļļĵطҲӦûȡspring.profiles.path̬ظ·µļ
+
+ - Pom.xmlļĴģ飬ļųǴjarDzļģοĵڵ3
+
+ - jarʱָͨصĺļΪspring.profiles.pathµĺļ
+
+```
+**ͳһ**
+
+ͨjarԴjarҲԷĿjarͬĿ¼µlibĿ¼ǿԸpom.xmlʵ֣οĵڵ3
+
+****
+
+```
+
+
+
+ src/main/java
+
+ **/*.properties
+ **/*.xml
+
+ true
+
+
+ src/main/resources
+
+
+ **/*.properties
+ **/*.xml
+ **/*.yml
+
+ false
+
+
+
+
+ org.apache.maven.plugins
+ maven-compiler-plugin
+
+ 1.8
+ 1.8
+ true
+ true
+
+ C:/Program Files/Java/jdk1.8.0_161/bin/javac.exe
+
+
+
+
+ maven-jar-plugin
+
+
+
+ true
+ lib/
+ false
+ com.xrq.demo.Application
+
+
+ ./
+
+
+
+ *.properties
+ *.yml
+ *.xml
+ config/**
+
+
+
+
+ org.apache.maven.plugins
+ maven-dependency-plugin
+
+
+ copy
+ package
+
+ copy-dependencies
+
+
+
+ ${project.build.directory}/lib
+
+
+
+
+
+
+
+
+```
+
+ĺpom.xmlbuildģͿͨmvn package mvn installǵjar
+
+1. **Ŀshellűд**
+ ԶshellűʵĿֹͣ״̬
+
+```
+#!/bin/bash
+#滻ΪԼִг,
+APP_NAME=demo1-0.0.1-SNAPSHOT.jar
+JVM="-server -Xms512m -Xmx512m -XX:PermSize=64M -XX:MaxNewSize=128m -XX:MaxPermSize=128m -Djava.awt.headless=true -XX:+CMSClassUnloadingEnabled -XX:+CMSPermGenSweepingEnabled"
+APPFILE_PATH="-Dspring.config.location=/usr/local/demo/config/application-demo1.properties"
+#ʹ˵,ʾ
+usage() {
+echo "Usage: sh ִнű.sh [start|stop|restart|status]"
+exit 1
+}
+#Ƿ
+is_exist(){
+pid=`ps -ef|grep $APP_NAME|grep -v grep|awk '{print $2}' `
+#ڷ1,ڷ0
+if [ -z "${pid}" ]; then
+return 1
+else
+return 0
+fi
+}
+#
+start(){
+is_exist
+if [ $? -eq "0" ]; then
+echo "${APP_NAME} is already running. pid=${pid} ."
+else
+nohup java $JVM -jar $APPFILE_PATH $APP_NAME > /dev/null 2>&1
+fi
+}
+#ֹͣ
+stop(){
+is_exist
+if [ $? -eq "0" ]; then
+kill -9 $pid
+else
+echo "${APP_NAME} is not running"
+fi
+}
+#״̬
+status(){
+is_exist
+if [ $? -eq "0" ]; then
+echo "${APP_NAME} is running. Pid is ${pid}"
+else
+echo "${APP_NAME} is NOT running."
+fi
+}
+#
+restart(){
+stop
+start
+}
+#,ѡִжӦ,ִʹ˵
+case "$1" in
+"start")
+start
+;;
+"stop")
+stop
+;;
+"status")
+status
+;;
+"restart")
+restart
+;;
+*)
+usage
+;;
+esac
+
+```
+
+****
+
+linux½ļУǴõĿjarȥjarͬĿ¼½configlibļУֱļ͵ȥṹͼ*.shΪԼдĿshellű
+
+
+
+configڵspringbootļapplication-demo1.propertiesļ
+
+spring.profiles.pathijɵǰļڵĿ¼Ϊ/usr/local/demo/config
+
+*.shűAPPFILE_PATHֵ
+
+APPFILE_PATH="-Dspring.config.location=/usr/local/demo/config/application-demo1.properties"
+
+**Ŀ**
+
+jarĿ¼ִ
+
+sh [demo1.sh](http://demo1.sh/) start Ŀ
+
+sh [demo1.sh](http://demo1.sh/) stop ֹͣĿ
+
+sh [demo1.sh](http://demo1.sh/) restartĿ
+
+sh [demo1.sh](http://demo1.sh/) statusĿ״̬
+
+## 2\. ⲿ
+
+
+
+
+
+Spring Boot㽫ⲿͿڲͬĻʹͬӦó롣 ʹøⲿԴJava properties ļYAMLļв
+
+
+
+
+
+ֵͨʹ `@Value` עֱעBeanҲͨSpring `Environment` ʣͨ `@ConfigurationProperties` [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties)
+
+
+
+
+
+Spring Boot ʹһdzر `PropertySource` ˳ּдֵ property source ԸǰԴжֵ ˳ǡ
+
+
+
+
+
+1. Ĭԣͨ `SpringApplication.setDefaultProperties` ָ
+
+2. @Configuration ϵ [`@PropertySource`](https://docs.spring.io/spring-framework/docs/6.0.5/javadoc-api/org/springframework/context/annotation/PropertySource.html) ע⡣ע⣬Դֱapplication contextˢʱŻᱻӵСijЩ˵Ѿ̫ˣ `logging.*` `spring.main.*` ˢ¿ʼǰѾȡˡ
+
+3. ݣ `application.properties` ļ
+
+4. `RandomValuePropertySource`ֻ `random.*` ԡ
+
+5. ϵͳ
+
+6. Java System properties (`System.getProperties()`).
+
+7. `java:comp/env` е JNDI ԡ
+
+8. `ServletContext` init parameters.
+
+9. `ServletConfig` init parameters.
+
+10. `SPRING_APPLICATION_JSON` ԣǶ뻷ϵͳеJSON
+
+11. в
+
+12. ڲе `properties` ԡ [`@SpringBootTest`](https://docs.spring.io/spring-boot/docs/3.1.0-SNAPSHOT/api/org/springframework/boot/test/context/SpringBootTest.html) Ͳעпã[ڲӦóһضƬ](https://springdoc.cn/spring-boot/features.html#features.testing.spring-boot-applications.autoconfigured-tests)
+
+13. еhttps://docs.spring.io/spring-framework/docs/6.0.5/javadoc-api/org/springframework/test/context/TestPropertySource.html[`@TestPropertySource`] ע.
+
+14. devtoolsڻ״̬ʱ`$HOME/.config/spring-boot` Ŀ¼µ[Devtoolsȫ](https://springdoc.cn/spring-boot/using.html#using.devtools.globalsettings)
+
+
+
+
+
+ļ˳ǡ
+
+
+
+
+
+1. jarд[Application properties](https://springdoc.cn/spring-boot/features.html#features.external-config.files)application.properties YAML
+
+2. jarд [ض Profile application properties](https://springdoc.cn/spring-boot/features.html#features.external-config.files.profile-specific)`application-{profile}.properties` YAML
+
+3. jar֮[Application properties](https://springdoc.cn/spring-boot/features.html#features.external-config.files)ԣapplication.propertiesYAML
+
+4. jar֮[ض Profile application properties](https://springdoc.cn/spring-boot/features.html#features.external-config.files.profile-specific) `application-{profile}.properties` YAML
+
+
+
+
+
+| | Ӧóмʹһָʽ ͬһط `.properties` `.yml` ʽļ`.properties` ȡ |
+| --- | --- |
+
+
+
+
+
+Ϊṩһӣ㿪һ `@Component`ʹһ `name` ԣʾ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Component
+public class MyBean {
+
+ @Value("${name}")
+ private String name;
+
+ // ...
+
+}
+
+```
+
+
+
+
+
+
+
+Ӧóclasspath磬jarУһ `application.properties` ļΪ `name` ṩһĬֵһµĻʱjar֮ṩһ `application.properties` ļ `name` һԵIJԣһضв磬`java -jar app.jar --name="Spring"`
+
+
+
+
+
+| | `env` `configprops` ˵ȷһΪʲôһضֵʱdzáʹ˵ֵ "[](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints)" ֡ |
+| --- | --- |
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.external-config.command-line-args)2.1\.
+
+
+
+Ĭ£`SpringApplication` Ὣκѡ `--` ͷIJ `--server.port=9000` תΪ `property` ӵSpring `Environment` С ǰڻļԴ
+
+
+
+
+
+㲻ϣԱӵ `Environment` Уͨ `SpringApplication.setAddCommandLineProperties(false)` ǡ
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.external-config.application-json)2.2\. JSON Application Properties
+
+
+
+ϵͳƣζЩƲʹá Ϊ˰⣬Spring Boot㽫һԿΪһһJSONṹ
+
+
+
+
+
+Ӧóʱκ `spring.application.json` `SPRING_APPLICATION_JSON` Խӵ `Environment` С
+
+
+
+
+
+磬`SPRING_APPLICATION_JSON` Կ UN*X shell Ϊṩ
+
+
+
+
+
+
+
+```
+$ SPRING_APPLICATION_JSON='{"my":{"name":"test"}}' java -jar myapp.jar
+```
+
+
+
+
+
+
+
+ǰУSpring `Environment` յõ `my.name=test`
+
+
+
+
+
+ͬJSONҲΪһϵͳṩ
+
+
+
+
+
+
+
+```
+$ java -Dspring.application.json='{"my":{"name":"test"}}' -jar myapp.jar
+```
+
+
+
+
+
+
+
+ͨʹһвṩJSON
+
+
+
+
+
+
+
+```
+$ java -jar myapp.jar --spring.application.json='{"my":{"name":"test"}}'
+```
+
+
+
+
+
+
+
+ҪһӦ÷УҲʹһΪ `java:comp/env/spring.application.json` JNDI
+
+
+
+
+
+| | JSONе `null` ֵӵɵԴУ `PropertySourcesPropertyResolver` `null` Ϊȱʧֵ ζJSON `null` ֵԵͽԴԡ |
+| --- | --- |
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.external-config.files)2.3\. ⲿ Application Properties
+
+
+
+ӦóʱSpring BootԶλҵ `application.properties` `application.yaml` ļ
+
+
+
+
+
+1. classpath
+
+
+
+ 1. classpath ·
+
+ 2. classpath µ `/config`
+
+
+
+2. ǰĿ¼
+
+
+
+ 1. ǰĿ¼
+
+ 2. ǰĿ¼µ `config/` Ŀ¼
+
+ 3. `config/` Ŀ¼ֱĿ¼
+
+
+
+
+
+
+
+бȼϵĿֵǽĿֵ صļΪ `PropertySources` ӵSpring `Environment` С
+
+
+
+
+
+㲻ϲ `application` Ϊļƣָͨ `spring.config.name` лһļơ 磬ΪѰ `myproject.properties` `myproject.yaml` ļ·ʽӦó
+
+
+
+
+
+
+
+```
+$ java -jar myproject.jar --spring.config.name=myproject
+```
+
+
+
+
+
+
+
+Ҳͨʹ `spring.config.location` һȷλá ԽһŷָбаһҪλá
+
+
+
+
+
+ʾָͬļ
+
+
+
+
+
+
+
+```
+$ java -jar myproject.jar --spring.config.location=\
+ optional:classpath:/default.properties,\
+ optional:classpath:/override.properties
+```
+
+
+
+
+
+
+
+| | [ļǿѡ](https://springdoc.cn/spring-boot/features.html#features.external-config.files.optional-prefix)ҿDzڵģôʹ `optional:` ǰ |
+| --- | --- |
+
+
+
+
+
+| | `spring.config.name`, `spring.config.location`, `spring.config.extra-location` ȷЩļ뱻ء DZ뱻ΪԣͨDzϵͳϵͳԣв |
+| --- | --- |
+
+
+
+
+
+ `spring.config.location` Ŀ¼ļӦ `/` β ʱǽ `spring.config.name` ɵƣȻء `spring.config.location` ָļֱӵ롣
+
+
+
+
+
+| | Ŀ¼ļλֵҲչԼ[ضļ](https://springdoc.cn/spring-boot/features.html#features.external-config.files.profile-specific)磬 `spring.config.location` `classpath:myconfig.properties`Ҳᷢʵ `classpath:myconfig-.properties` ļء |
+| --- | --- |
+
+
+
+
+
+ڴ£ӵÿ `spring.config.location` һļĿ¼ λǰDZ˳ģλÿԸǰλõֵ
+
+
+
+
+
+һӵλãʹضļҪṩһʾԱSpring Boot֪Ӧη顣һλһλõļϣЩλöΪͬһ磬classpathλ÷飬ȻⲿλáһλڵĿӦ `;` ָϸڼ [ָ profile](https://springdoc.cn/spring-boot/features.html#features.external-config.files.profile-specific) ֵӡ
+
+
+
+
+
+ͨʹ `spring.config.location` õλȡĬλá 磬 `spring.config.location` Ϊ `optional:classpath:/custom-config/,optional:file:./custom-config/` ǵλü¡
+
+
+
+
+
+1. `optional:classpath:custom-config/`
+
+2. `optional:file:./custom-config/`
+
+
+
+
+
+ϲӶλã滻ǣʹ `spring.config.extra-location` ӸλüصԿԸĬλõԡ 磬 `spring.config.extra-location` Ϊ `optional:classpath:/custom-config/,optional:file:./custom-config/` ǵλü¡
+
+
+
+
+
+1. `optional:classpath:/;optional:classpath:/config/`
+
+2. `optional:file:./;optional:file:./config/;optional:file:./config/*/`
+
+3. `optional:classpath:custom-config/`
+
+4. `optional:file:./custom-config/`
+
+
+
+
+
+һļָĬֵȻһļѡԵظЩֵ һĬλõ `application.properties` `spring.config.name` ѡbasenameΪӦóṩĬֵ ȻЩĬֵʱλһԶλõIJͬļǡ
+
+
+
+
+
+| | ʹûϵͳԣϵͳʹþָļʹ»ߴ棨磬 `SPRING_CONFIG_NAME` `spring.config.name` μ[ӻ](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.relaxed-binding.environment-variables) ˽顣 |
+| --- | --- |
+
+
+
+
+
+| | ӦóservletӦ÷УôJNDIԣ `java:comp/env` УservletijʼԴ滷ϵͳԣ֮һ |
+| --- | --- |
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.files.optional-prefix)2.3.1\. ѡλ(Optional Locations)
+
+
+
+Ĭ£ָλòʱSpring Boot׳һ `ConfigDataLocationNotFoundException` Ӧó
+
+
+
+
+
+ָһλã㲻Ǵڣʹ `optional:` ǰ `spring.config.locationspring.config.extra-location` ʹǰҲ [`spring.config.import`](https://springdoc.cn/spring-boot/features.html#features.external-config.files.importing) ʹá
+
+
+
+
+
+磬`spring.config.import` ֵΪ `optional:file:./myconfig.properties` Ӧóʹ `myconfig.properties` ļʧ
+
+
+
+
+
+е `ConfigDataLocationNotFoundExceptions` ʼռӦóʹ `spring.config.on-not-found` ԡ ʹ `SpringApplication.setDefaultProperties(..)` ʹϵͳ/ֵΪ `ignore`
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.files.wildcard-locations)2.3.2\. ַͨ
+
+
+
+һļλһ·а `*` ַͱΪһͨλá ͨڼʱչˣֱӵĿ¼Ҳ顣 ͨλKubernetesжԵԴĻرá
+
+
+
+
+
+磬һЩRedisúһЩMySQLã÷ֿͬʱҪֶһ `application.properties` ļС
+
+
+
+
+
+ܻᵼ `application.properties` ļڲͬλã `/config/redis/application.properties` `/config/mysql/application.properties` £һͨλ `config/*/` ļ
+
+
+
+
+
+Ĭ£Spring Boot `config/*/` Ĭλá ζjar֮ `/config` Ŀ¼Ŀ¼ᱻ
+
+
+
+
+
+ `spring.config.location` `spring.config.extra-location` ʹͨλá
+
+
+
+
+
+| | ͨλñֻһ `*` `*/` βĿ¼λã `*/` ļλá ͨλýļľ·ĸ˳ |
+| --- | --- |
+
+
+
+
+
+| | ͨλֻⲿĿ¼á 㲻 `classpath:` λʹͨ |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.files.profile-specific)2.3.3\. ضļProfile Specific Files
+
+
+
+ `application` ļSpring Bootʹ `application-{profile}` profileضļ 磬ӦóΪ `prod` ļ`spring.profiles.active=prod`ʹYAMLļô `application.yml` `application-prod.yml` ǡ
+
+
+
+
+
+ضļ(`profiles`) `application.properties` λͬضļڷضļ ָ˼ļʤIJԡ 磬ļ `prod,live` `spring.profiles.active` ָģ`application-prod.properties` еֵԱ `application-live.properties` еֵǡ
+
+
+
+
+
+| | ʤIJ[location group](https://springdoc.cn/spring-boot/features.html#features.external-config.files.location-groups) `spring.config.location` `classpath:/cfg/,classpath:/ext/` `classpath:/cfg/;classpath:/ext/` ͬĸǹ磬 `prod,live` ˵ǿļ /cfg application-live.properties/ext application-live.properties application-prod.properties һ `spring.config.location` Ϊ `classpath:/cfg/,classpath:/ext/` ʱǻ `/ext` ļ֮ǰ `/cfg` ļ1. `/cfg/application-live.properties` 2. `/ext/application-prod.properties` 3. `/ext/application-live.properties` `classpath:/cfg/;classpath:/ext/` ʱ `;` ָͬһ `/cfg` `/ext` 1. `/ext/application-prod.properties` 2. `/cfg/application-live.properties` 3. `/ext/application-live.properties` |
+| --- | --- |
+
+
+
+
+
+`Environment` һĬϵļĬΪ `[default]` ûûļͻʹЩļ 仰˵ûȷļôͻῼ `application-default` ԡ
+
+
+
+
+
+| | ļֻһΡ Ѿֱ[](https://springdoc.cn/spring-boot/features.html#features.external-config.files.importing)һļضļôᱻڶε롣 |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.files.importing)2.3.4\.
+
+
+
+application properties пʹ `spring.config.import` Դطݡ ڱʱΪļĶļ
+
+
+
+
+
+磬 classpath `application.properties` ļݡ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+spring.application.name=myapp
+spring.config.import=optional:file:./dev.properties
+
+```
+
+
+
+
+
+
+
+⽫뵱ǰĿ¼µ `dev.properties` ļļ `dev.properties` еֵڴļ У`dev.properties` Խ `spring.application.name` ¶Ϊһֵͬ
+
+
+
+
+
+һֻᱻһΣٴΡ һproperties/yamlļڵĵļб˳Ҫ 磬ӲͬĽ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+spring.config.import=my.properties
+my.property=value
+
+```
+
+
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+my.property=value
+spring.config.import=my.properties
+
+```
+
+
+
+
+
+
+
+У`my.properties` ļֵڴ䵼ļ
+
+
+
+
+
+һһ `spring.config.import` ¿ָλá λýDZ˳ĵ뽫ȴ
+
+
+
+
+
+| | ʵʱ[ضļı](https://springdoc.cn/spring-boot/features.html#features.external-config.files.profile-specific)Ҳǵ롣 ӽ `my.properties` Լκ `my-.properties` 塣 |
+| --- | --- |
+
+
+
+
+
+| | Spring Boot ṩ˿ɲεAPIֲָ֧ͬλõַ Ĭ£ԵJava PropertiesYAML [](https://springdoc.cn/spring-boot/features.html#features.external-config.files.configtree) jarṩ֧֣ҪDZļ 磬ⲿ洢ConsulApache ZooKeeperNetflix ArchaiusNacos֧ԼλãʵԼüأ `org.springframework.boot.context.config` е `ConfigDataLocationResolver` `ConfigDataLoader` ࡣ |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.files.importing-extensionless)2.3.5\. չļ
+
+
+
+Щƽ̨Ϊװļvolume mounted filesļչ ҪЩչļҪSpring BootһʾԱ֪μǡ ͨչʾڷһ㡣
+
+
+
+
+
+磬һ `/etc/config/myconfig` ļϣyamlʽ롣 ķ `application.properties` е
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+spring.config.import=file:/etc/config/myconfig[.yaml]
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.files.configtree)2.3.6\. ʹConfiguration Trees
+
+
+
+ƽ̨KubernetesӦóʱ㾭Ҫȡƽ̨ṩֵ ڴĿIJټȱ㣬رֵ secret ġ
+
+
+
+
+
+Ϊƽ̨㽫ӳ䵽صݾ 磬Kubernetes Ծ [`ConfigMaps`](https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/#populate-a-volume-with-data-stored-in-a-configmap) [`Secrets`](https://kubernetes.io/docs/concepts/configuration/secret/#using-secrets-as-files-from-a-pod)
+
+
+
+
+
+ʹֳ volume ģʽ
+
+
+
+
+
+1. һļһԣͨдYAML
+
+2. ļдһĿ¼УļΪ keyݳΪ value
+
+
+
+
+
+ڵһʹ `spring.config.import` ֱӵYAMLļ[](https://springdoc.cn/spring-boot/features.html#features.external-config.files.importing) ڵڶҪʹ `configtree:` ǰԱSpring Boot֪ҪļΪԹ
+
+
+
+
+
+ٸӣһ£KubernetesѾvolume
+
+
+
+
+
+
+
+ etc/
+ config/
+ myapp/
+ username
+ password
+
+
+
+
+
+
+
+`username` ļݽһֵ `password` ݽһ secret
+
+
+
+
+
+ҪЩԣ `application.properties` `application.yaml` ļݡ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+spring.config.import=optional:configtree:/etc/config/
+
+```
+
+
+
+
+
+
+
+ȻԴ `Environment` Գ淽ʽʻע `myapp.username` `myapp.password` ԡ
+
+
+
+
+
+| | µļйơ УΪ˷Ϊ `username` `password`Խ `spring.config.import` Ϊ `optional:configtree:/etc/config/myapp` |
+| --- | --- |
+
+
+
+
+
+| | еŵļҲᱻȷӳ䡣 磬У`/etc/config` Ϊ `myapp.username` ļ `Environment` е `myapp.username` |
+| --- | --- |
+
+
+
+
+
+| | ֵԱַ `String` `byte[]` ͣȡԤڵݡ |
+| --- | --- |
+
+
+
+
+
+жҪͬһļе룬ʹͨݷʽ κ `/*/` β `configtree:` λýֱӵļΪ
+
+
+
+
+
+磬volume
+
+
+
+
+
+
+
+ etc/
+ config/
+ dbconfig/
+ db/
+ username
+ password
+ mqconfig/
+ mq/
+ username
+ password
+
+
+
+
+
+
+
+ʹ `configtree:/etc/config/*/` Ϊλá
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+spring.config.import=optional:configtree:/etc/config/*/
+
+```
+
+
+
+
+
+
+
+⽫ `db.username``db.password``mq.username` `mq.password` ԡ
+
+
+
+
+
+| | ʹͨصĿ¼ǰĸ˳еġ Ҫһͬ˳ôӦðÿλΪһĵг |
+| --- | --- |
+
+
+
+
+
+ҲDocker secret Docker swarmsecretķȨʱsecretᱻװصС 磬һΪ `db.password` secret `/run/secrets/` λã· `db.password` Springá
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+spring.config.import=optional:configtree:/run/secrets/
+
+```
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.files.property-placeholders)2.3.7\. ռλ
+
+
+
+`application.properties` `application.yml` еֵʹʱͨе `Environment` ˣԲοǰֵ磬ϵͳԻ `${name}` ռλһֵκεط ռλҲָһĬֵʹ `:` ָĬֵƣ `${name:default}`
+
+
+
+
+
+ʾ˴ĬֵͲĬֵռλʹ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+app.name=MyApp
+app.description=${app.name} is a Spring Boot application written by ${username:Unknown}
+
+```
+
+
+
+
+
+
+
+ `username` ûطã`app.description` ֵ `MyApp is a Spring Boot application written by Unknown`
+
+
+
+
+
+| | ӦʼʹռλеƵĹ淶ʽʹСдĸkebab-caseǡ ⽫Spring Bootʹ[ɰ](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.relaxed-binding) `@ConfigurationProperties` ʱͬ磬`${demo.item-price}` `application.properties` ļлȡ `demo.item-price` `demo.itemPrice` ʽԣԼϵͳлȡ `DEMO_ITEMPRICE` `${demo.itemPrice}` Ļ `demo.item-price` `DEMO_ITEMPRICE` Ͳᱻǡ |
+| --- | --- |
+
+
+
+
+
+| | ҲʹּSpring BootԵ short 塣 μ_[howto.html](https://springdoc.cn/spring-boot/howto.html#howto.properties-and-configuration.short-command-line-arguments)_ķ |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.files.multi-document)2.3.8\. ʹöĵļWorking with Multi-Document Files
+
+
+
+Spring Boot㽫һļֳɶļÿļǶӵġ ļǰ˳ģϵ¡ ļԸǰļжԡ
+
+
+
+
+
+ `application.yml` ļʹñYAMLĵ ַ`---`һļĽһļĿʼ
+
+
+
+
+
+磬ļĵ
+
+
+
+
+
+
+
+```
+spring:
+ application:
+ name: "MyApp"
+---
+spring:
+ application:
+ name: "MyCloudApp"
+ config:
+ activate:
+ on-cloud-platform: "kubernetes"
+```
+
+
+
+
+
+
+
+ `application.properties` ļһ `#---` `!---` עͱļķָ
+
+
+
+
+
+
+
+```
+spring.application.name=MyApp
+#---
+spring.application.name=MyCloudApp
+spring.config.activate.on-cloud-platform=kubernetes
+```
+
+
+
+
+
+
+
+| | properties ļķָκǰհףұַ ָǰвͬעǰ |
+| --- | --- |
+
+
+
+
+
+| | ĵļͨ뼤һʹã `spring.config.activated.on-profile` [һ](https://springdoc.cn/spring-boot/features.html#features.external-config.files.activation-properties) |
+| --- | --- |
+
+
+
+
+
+| | ĵļͨʹ `@PropertySource` `@TestPropertySource` עء |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.files.activation-properties)2.3.9\. ԣActivation Properties
+
+
+
+ʱֻijЩʱһضǺõġ 磬һЩֻضļʱء
+
+
+
+
+
+ʹ `spring.config.activation.*` ؼһļ
+
+
+
+
+
+¡
+
+
+
+Table 2\. activation properties
+| | ˵ |
+| --- | --- |
+| `on-profile` | һ֮ƥļʽʹļڻ״ָ̬ļʱЧ |
+| `on-cloud-platform` | `CloudPlatform`ʹļڻ״̬ƽ̨״̬Ч |
+
+
+
+磬ָڶļֻKubernetesʱЧֻ prod staging ļڻ״̬ʱЧ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+myprop=always-set
+#---
+spring.config.activate.on-cloud-platform=kubernetes
+spring.config.activate.on-profile=prod | staging
+myotherprop=sometimes-set
+
+```
+
+
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.external-config.encrypting)2.4\. ԣEncrypting Properties
+
+
+
+Spring BootûΪֵṩκ֧֣ṩHookmSpring `Environment` аֵ `EnvironmentPostProcessor` ӿӦóǰ `Environment` μ[howto.html](https://springdoc.cn/spring-boot/howto.html#howto.application.customize-the-environment-or-application-context)˽顣
+
+
+
+
+
+Ҫһְȫķʽ洢ƾ֤룬 [Spring Cloud Vault](https://cloud.spring.io/spring-cloud-vault/) Ŀṩ˶ [HashiCorp Vault](https://www.vaultproject.io/)д洢ⲿõ֧֡
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.external-config.yaml)2.5\. ʹ YAML
+
+
+
+[YAML](https://yaml.org/) JSONijֲָݵķʽ ֻҪclasspath [SnakeYAML](https://github.com/snakeyaml/snakeyaml) ⣬`SpringApplication` ͻԶ֧YAMLΪpropertiesƷ
+
+
+
+
+
+| | ʹ StarterSnakeYAML `spring-boot-starter` Զṩ |
+| --- | --- |
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.yaml.mapping-to-properties)2.5.1\. YAMLӳ䵽Properties
+
+
+
+YAML ĵҪֲʽתΪ Spring `Environment` һʹõıƽṹ 磬YAMLĵ
+
+
+
+
+
+
+
+```
+environments:
+ dev:
+ url: "https://dev.example.com"
+ name: "Developer Setup"
+ prod:
+ url: "https://another.example.com"
+ name: "My Cool App"
+```
+
+
+
+
+
+
+
+Ϊ˴ `Environment` зЩԣǽƽʾ
+
+
+
+
+
+
+
+```
+environments.dev.url=https://dev.example.com
+environments.dev.name=Developer Setup
+environments.prod.url=https://another.example.com
+environments.prod.name=My Cool App
+```
+
+
+
+
+
+
+
+ͬأYAMLебҲҪбƽ DZʾΪ `[index]` key 磬YAML
+
+
+
+
+
+
+
+```
+my:
+ servers:
+ - "dev.example.com"
+ - "another.example.com"
+```
+
+
+
+
+
+
+
+ǰӽתΪԡ
+
+
+
+
+
+
+
+```
+my.servers[0]=dev.example.com
+my.servers[1]=another.example.com
+```
+
+
+
+
+
+
+
+| | ʹ `[index]` ŵԿʹSpring Boot `Binder` Java `List` `Set` ϸڼ [Ͱȫ](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties) ֡ |
+| --- | --- |
+
+
+
+
+
+| | YAMLļͨʹ `@PropertySource` `@TestPropertySource` עء ԣҪַʽֵ£Ҫʹһ properties ļ |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.yaml.directly-loading)2.5.2\. ֱӼYAML
+
+
+
+Spring Frameworkṩ࣬YAMLĵ `YamlPropertiesFactoryBean` YAMLΪ `Properties` أ`YamlMapFactoryBean` YAMLΪ `Map` ء
+
+
+
+
+
+YAMLΪSpring `PropertySource` Ҳʹ `YamlPropertySourceLoader` ࡣ
+
+
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.external-config.random-values)2.6\. ֵ
+
+
+
+The `RandomValuePropertySource` is useful for injecting random values (for example, into secrets or test cases). It can produce integers, longs, uuids, or strings, as shown in the following example:
+
+
+
+
+
+`RandomValuePropertySource` עֵã磬ע ԲIntegerLongUUIDStringʾ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+my.secret=${random.value}
+my.number=${random.int}
+my.bignumber=${random.long}
+my.uuid=${random.uuid}
+my.number-less-than-ten=${random.int(10)}
+my.number-in-range=${random.int[1024,65536]}
+
+```
+
+
+
+
+
+
+
+`random.int*` `OPEN value (,max) CLOSE` `OPEN,CLOSE` κַ `value,max` ṩ `max`ô `value` Сֵ `max` ֵռ
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.external-config.system-environment)2.7\. ϵͳ
+
+
+
+Spring Boot֧Ϊһǰ ϵͳвͬҪSpring BootӦóͺá ϵͳԵǰֱ `SpringApplication` á
+
+
+
+
+
+磬㽫ǰΪ `input` `remote.timeout` ϵͳҲΪ `input.remote.timeout`
+
+
+
+
+
+
+
+### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties)2.8\. Ͱȫ
+
+
+
+ʹ `@Value("${property}")` עעʱ鷳رǵҪԻǷֲġ Spring BootṩһִԵǿ͵Bean֤Ӧóá
+
+
+
+
+
+| | μ[`@Value` Ͱȫ֮](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.vs-value-annotation) |
+| --- | --- |
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.java-bean-binding)2.8.1\. JavaBean
+
+
+
+ʾһ˱JavaBeanԵbean
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@ConfigurationProperties("my.service")
+public class MyProperties {
+
+ private boolean enabled;
+
+ private InetAddress remoteAddress;
+
+ private final Security security = new Security();
+
+ // getters / setters...
+
+ public static class Security {
+
+ private String username;
+
+ private String password;
+
+ private List roles = new ArrayList<>(Collections.singleton("USER"));
+
+ // getters / setters...
+
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+ǰPOJOԡ
+
+
+
+
+
+* `my.service.enabled`ĬֵΪ`false`
+
+* `my.service.remote-address`Ϳ`String`ǿṩ
+
+* `my.service.security.username`һǶ `security` ɸԵƾ رǣȫûʹͣ `SecurityProperties`
+
+* `my.service.security.password`.
+
+* `my.service.security.role`һ `String` ļϣĬΪ `USER`
+
+
+
+
+
+| | ӳ䵽Spring Bootпõ `@ConfigurationProperties` ԣͨpropertiesļYAMLļƽãЩǹAPI౾ getters/setters ζſֱʹãһ仰SpringҲͨgetter/setterЩpublicֵģã |
+| --- | --- |
+
+
+
+
+
+| | һĬϵι캯gettersetterͨDZģΪͨJava Beans property descriptorJavaʡʵֵģSpring MVCһ £ʡsetter* Map, ֻҪDZʼҪһgetterһҪһsetterΪǿԱͻ䡣 * Collectionarray ͨͨYAMLʹõŷֵָԣʡ ںһ£һsetterDZġ ǽΪһsetter ʼһϣȷDzɱģǰӣ * ǶPOJOԱʼǰе `Security` ֶΣͲҪsetter ðͨʹĬϹ캯ʱʵҪһsetter ЩʹProject LombokԶgettersetter ȷLombokΪκضĹ캯ΪԶʵֻDZJava Beanԣֶ֧Ծ̬Եİ |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.constructor-binding)2.8.2\. 캯
+
+
+
+һڵӿòɱķʽдʾ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@ConfigurationProperties("my.service")
+public class MyProperties {
+
+ // fields...
+
+ public MyProperties(boolean enabled, InetAddress remoteAddress, Security security) {
+ this.enabled = enabled;
+ this.remoteAddress = remoteAddress;
+ this.security = security;
+ }
+
+ // getters...
+
+ public static class Security {
+
+ // fields...
+
+ public Security(String username, String password, @DefaultValue("USER") List roles) {
+ this.username = username;
+ this.password = password;
+ this.roles = roles;
+ }
+
+ // getters...
+
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+УΨһġ캯ĴζӦʹøù캯а ζŰҵһϣIJĹ캯 ж캯ʹ `@ConstructorBinding` עָʹĸ캯й캯 ҪΪһֻһ캯ѡ캯ù캯 `@Autowired` ע⡣ 캯 `Record` һʹá ļ¼ж캯ûбҪʹ `@ConstructorBinding`
+
+
+
+
+
+캯Ƕ׳Աе `Security`Ҳͨ乹캯
+
+
+
+
+
+Ĭֵڹ캯Recordʹ `@DefaultValue` ָ תӦڽע `String` ֵǿתΪȱʧԵĿ͡
+
+
+
+
+
+οǰӣû `Security` `MyProperties` ʵһ `security` ͵ `null` ֵ Ϊʹһ null `Security` ʵʹû֮ʹKotlinʱ⽫Ҫ `Security` `username` `password` Ϊ nullableΪûĬֵʹһյ `@DefaultValue` ע⡣
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+public MyProperties(boolean enabled, InetAddress remoteAddress, @DefaultValue Security security) {
+ this.enabled = enabled;
+ this.remoteAddress = remoteAddress;
+ this.security = security;
+}
+
+```
+
+
+
+
+
+
+
+| | Ҫʹù캯ʹ `@EnableConfigurationProperties` ɨá 㲻ܶͨSpringƴBeanʹù캯 `@Component` Beanͨʹ `@Bean` Beanͨʹ `@Import` صBean |
+| --- | --- |
+
+
+
+
+
+| | Ҫԭʹù캯 `-parameters` ࡣʹ Spring Boot Gradle ʹ Maven `spring-boot-starter-parent`⽫Զá |
+| --- | --- |
+
+
+
+
+
+| | 齫 `java.util.Optional` `@ConfigurationProperties` һʹãΪҪΪһʹá ˣʺע롣 Ϊ͵Աһ£ȷʵһ `Optional` ԣûֵ`null` һյ `Optional` |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.enabling-annotated-types)2.8.3\. @ConfigurationProperties
+
+
+
+Spring Bootṩ˰ `@ConfigurationProperties` ͲעΪBeanĻʩ Ļԣɨ裬乤ʽɨơ
+
+
+
+
+
+ʱ `@ConfigurationProperties` עܲʺɨ裬磬ڿԼԶûǡ Щ£ʹ `@EnableConfigurationProperties` עָҪб עκ `@Configuration` ϣʾ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Configuration(proxyBeanMethods = false)
+@EnableConfigurationProperties(SomeProperties.class)
+public class MyConfiguration {
+
+}
+
+```
+
+
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@ConfigurationProperties("some.properties")
+public class SomeProperties {
+
+}
+
+```
+
+
+
+
+
+
+
+Ҫʹɨ裬application `@ConfigurationPropertiesScan` ע⡣ ͨӵ `@SpringBootApplication` עmainУҲԱӵκ `@Configuration` ϡ Ĭ£ɨעڵİʼԶɨԲο¡
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@SpringBootApplication
+@ConfigurationPropertiesScan({ "com.example.app", "com.example.another" })
+public class MyApplication {
+
+}
+
+```
+
+
+
+
+
+
+
+| | `@ConfigurationProperties` Beanʹɨͨ `@EnableConfigurationProperties` עʱBeanһƣ`-` `` `@ConfigurationProperties` עָĻǰ `` Beanȫơ עûṩκǰֻʹBeanȫơ `com.example.app` У `SomeProperties` ӵ bean `some.properties-com.example.app.SomeProperties` |
+| --- | --- |
+
+
+
+
+
+ǽ `@ConfigurationProperties` ֻ environmentرDzעBean ڱ߽ǰʹ setter עṩκ `*Aware` ӿڣ `EnvironmentAware` Ҫ `Environment` ȻʹùעBeanBean `@Component` ע⣬ʹûJavaBean
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.using-annotated-types)2.8.4\. ʹ @ConfigurationProperties
+
+
+
+÷ʽ `SpringApplication` ⲿYAMLϵرãʾ
+
+
+
+
+
+
+
+```
+my:
+ service:
+ remote-address: 192.168.1.1
+ security:
+ username: "admin"
+ roles:
+ - "USER"
+ - "ADMIN"
+```
+
+
+
+
+
+
+
+Ҫʹ `@ConfigurationProperties` BeanBeanͬķʽעǣʾ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Service
+public class MyService {
+
+ private final MyProperties properties;
+
+ public MyService(MyProperties properties) {
+ this.properties = properties;
+ }
+
+ public void openConnection() {
+ Server server = new Server(this.properties.getRemoteAddress());
+ server.start();
+ // ...
+ }
+
+ // ...
+
+}
+
+```
+
+
+
+
+
+
+
+| | ʹ `@ConfigurationProperties` ԪļЩļԱIDEԵġԶȫܡ [¼](https://springdoc.cn/spring-boot/configuration-metadata.html#appendix.configuration-metadata) |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.third-party-configuration)2.8.5\.
+
+
+
+ʹ `@ConfigurationProperties` עһ֮⣬㻹ڹ `@Bean` ʹ ֮ĵʱرá
+
+
+
+
+
+Ҫ `Environment` һBeanBeanע `@ConfigurationProperties` ʾ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@Configuration(proxyBeanMethods = false)
+public class ThirdPartyConfiguration {
+
+ @Bean
+ @ConfigurationProperties(prefix = "another")
+ public AnotherComponent anotherComponent() {
+ return new AnotherComponent();
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+κ `another` ǰJavaBeanԶᱻӳ䵽 `AnotherComponent` Beanϣ䷽ʽǰ `SomeProperties` ӡ
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.relaxed-binding)2.8.6\. ɵİ
+
+
+
+Spring Bootڽ `Environment` `@ConfigurationProperties` beanʱʹһЩɵĹ `Environment` ƺbean֮䲻Ҫȫƥ䡣 ãӰۺŷָƣ磬 `context-path` `contextPath` ʹдƣ磬`PORT` `port`
+
+
+
+
+
+ʾһӣ `@ConfigurationProperties` ࡣ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@ConfigurationProperties(prefix = "my.main-project.person")
+public class MyPersonProperties {
+
+ private String firstName;
+
+ public String getFirstName() {
+ return this.firstName;
+ }
+
+ public void setFirstName(String firstName) {
+ this.firstName = firstName;
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+ϵĴ˵µƶʹá
+
+
+
+Table 3\. relaxed binding
+| Property | Note |
+| --- | --- |
+| `my.main-project.person.first-name` | Kebab ̺߸ `.properties` `.yml` ļʹá |
+| `my.main-project.person.firstName` | շ |
+| `my.main-project.person.first_name` | »ߣһ `.properties` `.yml` ļʽ |
+| `MY_MAINPROJECT_PERSON_FIRSTNAME` | дʽʹϵͳʱʹôдʽ |
+
+
+
+| | ע `prefix` ֵ __ kebabСд `-` ָ `my.main-project.person` |
+| --- | --- |
+
+
+
+Table 4\. ÿԴĿɰ
+| Դ | | б |
+| --- | --- | --- |
+| Properties ļ | շ, kebab , » | ʹ `[ ]` ŷֵָıб |
+| YAML ļ | շ, kebab , » | YAMLбŷֵָ |
+| | д»Ϊָ( [ӻ](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.relaxed-binding.environment-variables)). | Numeric values surrounded by underscores (see [ӻ](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.relaxed-binding.environment-variables)) |
+| ϵͳԣSystem properties | շ, kebab , » | ʹ `[ ]` ŷֵָıб |
+
+
+
+| | ǽ飬ڿܵ£ӦСдkebabʽ洢 `my.person.first-name=Rod` |
+| --- | --- |
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.relaxed-binding.maps)Map
+
+
+
+ `Map` ʱҪʹһŷţԱ㱣ԭʼ `key` ֵ keyûб `[ ]` κηĸ֡`-` `.` ַɾ
+
+
+
+
+
+磬ǽһ `Map`
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+my.map.[/key1]=value1
+my.map.[/key2]=value2
+my.map./key3=value3
+```
+
+
+
+
+
+
+
+| | YAMLļҪŰʹkeyȷ |
+| --- | --- |
+
+
+
+
+
+Խһ `Map` `/key1``/key2` `key3` Ϊmapkey бѾ `key3` ɾΪûбŰ
+
+
+
+
+
+ֵʱ `.` ļҪ `[]` ֵöٺ `java.lang` еͣ `Object` `a.b=c` `Map` е `.` һ `{"a.b"="c"}` EntryMap κͣ `key` `.` Ҫʹŷš 磬 `a.b=c` `Map` һ `{"a"={"b"="c"}` entryMap `[a.b]=c` һ `{"a.b"="c"}` entry Map
+
+
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.relaxed-binding.environment-variables)ӻ
+
+
+
+磬Linux shellֻܰĸ`a` `z` `A` `Z` ֣ `0` `9` »ַ `_` չUnix shellҲôдĸ
+
+
+
+
+
+Spring BootɵİΪܵЩƼݡ
+
+
+
+
+
+Ҫ淶ʽתΪƣѭЩ
+
+
+
+
+
+* »ߣ`_`滻㣨`.`
+
+* ɾκۺţ`-`
+
+* תΪдĸ
+
+
+
+
+
+磬 `spring.main.log-startup-info` һΪ `SPRING_MAIN_LOGSTARTUPINFO` Ļ
+
+
+
+
+
+ҲڰбListʱʹá Ҫһ `List`ڱУԪرţӦ»߰
+
+
+
+
+
+磬 `my.service[0].other` ʹһΪ `MY_SERVICE_0_OTHER` Ļ
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.merging-complex-types)2.8.7\. ϲӵ
+
+
+
+Listڶطʱǵ滻list
+
+
+
+
+
+磬һ `MyPojo` `name` `description` ĬΪ `null` Ӵ `MyProperties` б¶һ `MyPojo` б
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@ConfigurationProperties("my")
+public class MyProperties {
+
+ private final List list = new ArrayList<>();
+
+ public List getList() {
+ return this.list;
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+á
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+my.list[0].name=my name
+my.list[0].description=my description
+#---
+spring.config.activate.on-profile=dev
+my.list[0].name=my another name
+
+```
+
+
+
+
+
+
+
+ `dev` ļδ`MyProperties.list` һ `MyPojo` Ŀ֮ǰ Ȼ `dev` ļ`list` ȻֻһĿname Ϊ `my another name`descriptionΪ `null` òбӵڶ `MyPojo` ʵҲϲĿ
+
+
+
+
+
+һ `List` ڶļбָʱʹþȼǸֻǸ ӡ
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+my.list[0].name=my name
+my.list[0].description=my description
+my.list[1].name=another name
+my.list[1].description=another description
+#---
+spring.config.activate.on-profile=dev
+my.list[0].name=my another name
+
+```
+
+
+
+
+
+
+
+ǰУ `dev` ļǼģ`MyProperties.list` _һ_ `MyPojo` Ŀname `my another name`description `null` YAMLŷָбYAMLбȫбݡ
+
+
+
+
+
+ `Map` ԣôӶԴȡֵа ȻڶԴеͬһԣʹþȼǸ Ӵ `MyProperties` ¶һ `Map`
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@ConfigurationProperties("my")
+public class MyProperties {
+
+ private final Map map = new LinkedHashMap<>();
+
+ public Map getMap() {
+ return this.map;
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+á
+
+
+
+
+
+
+
+Properties
+
+Yaml
+
+
+
+
+
+```
+my.map.key1.name=my name 1
+my.map.key1.description=my description 1
+#---
+spring.config.activate.on-profile=dev
+my.map.key1.name=dev name 1
+my.map.key2.name=dev name 2
+my.map.key2.description=dev description 2
+
+```
+
+
+
+
+
+
+
+ `dev` ļûм`MyProperties.map` һkeyΪ `key1` ĿnameΪ `my name 1` descriptionΪ `my description 1` Ȼ `dev` ļ`map` ĿkeyΪ `key1` nameΪ `dev name 1`descriptionΪ `my description 1` `key2`nameΪ `dev name 2`descriptionΪ `dev description 2`
+
+
+
+
+
+| | ǰĺϲԴԣļ |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.conversion)2.8.8\. ԣPropertiesת
+
+
+
+Spring Boot `@ConfigurationProperties` Beanʱͼⲿapplication propertiesǿƸΪȷ͡ ҪԶתṩһ `ConversionService` beanBeanΪ `conversionService` ԶԱ༭ͨ `CustomEditorConfigurer` beanԶ `Converters` Beanʹ `@ConfigurationPropertiesBinding` ע⣩
+
+
+
+
+
+| | BeanӦóڵڱģȷ `ConversionService` ʹõϵ ͨ£Ҫκϵڴʱûȫʼ Զ `ConversionService` Ҫkeys coercionֻ `@ConfigurationPropertiesBinding` Զת |
+| --- | --- |
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.conversion.durations)תΪ Duration
+
+
+
+Spring BootԱʱרŵ֧֡ 㹫һ `java.time.Duration` ԣapplication propertiesе¸ʽͿá
+
+
+
+
+
+* ͨ `long` ʹúΪĬϵλָ `@DurationUnit`
+
+* ISO-8601ʽ [ `java.time.Duration` ʹ](https://docs.oracle.com/javase/17/docs/api/java/time/Duration.html#parse-java.lang.CharSequence-)
+
+* һĸʽֵ͵λϵģ`10s` ʾ10룩
+
+
+
+
+
+뿼ӡ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@ConfigurationProperties("my")
+public class MyProperties {
+
+ @DurationUnit(ChronoUnit.SECONDS)
+ private Duration sessionTimeout = Duration.ofSeconds(30);
+
+ private Duration readTimeout = Duration.ofMillis(1000);
+
+ // getters / setters...
+
+}
+
+```
+
+
+
+
+
+
+
+Ҫָһ30ĻỰʱ `30` `PT30S` `30s` ǵȼ۵ġ ȡʱΪ500msκһʽָ `500`, `PT0.5S` `500ms`.
+
+
+
+
+
+Ҳʹֵ֧ʱ䵥λ
+
+
+
+
+
+* `ns`
+
+* `us`
+
+* `ms`
+
+* `s`
+
+* `m`
+
+* `h` Сʱ
+
+* `d`
+
+
+
+
+
+ĬϵλǺ룬ʹ `@DurationUnit` дʾ
+
+
+
+
+
+ϲʹù캯ͬԿԱ¶ʾ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@ConfigurationProperties("my")
+public class MyProperties {
+
+ // fields...
+
+ public MyProperties(@DurationUnit(ChronoUnit.SECONDS) @DefaultValue("30s") Duration sessionTimeout,
+ @DefaultValue("1000ms") Duration readTimeout) {
+ this.sessionTimeout = sessionTimeout;
+ this.readTimeout = readTimeout;
+ }
+
+ // getters...
+
+}
+
+```
+
+
+
+
+
+
+
+| | Ҫһ `Long` ԣǺ룬ȷ嵥λʹ `@DurationUnit` ṩһ·ͬʱָ֧ḻĸʽ |
+| --- | --- |
+
+
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.conversion.periods)תΪڼ䣨Period
+
+
+
+durationSpring Bootʹ `java.time.Period` ͡ ¸ʽapplication propertiesʹá
+
+
+
+
+
+* һ `int` ʾʹΪĬϵλָ `@PeriodUnit`
+
+* ISO-8601ʽ [ `java.time.Period` ʹ](https://docs.oracle.com/javase/17/docs/api/java/time/Period.html#parse-java.lang.CharSequence-)
+
+* һĸʽֵ͵λϵģ `1y3d` ʾ13죩
+
+
+
+
+
+֧мĵλʽ
+
+
+
+
+
+* `y`
+
+* `m`
+
+* `w`
+
+* `d`
+
+
+
+
+
+| | `java.time.Period` ʵϴδ洢һݷʽζ 7족 |
+| --- | --- |
+
+
+
+
+
+
+
+##### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.conversion.data-sizes)תΪݴСData Sizes
+
+
+
+Spring Frameworkһ `DataSize` ֵֽͣΪλС 㹫һ `DataSize` ԣapplication propertiesе¸ʽͿá
+
+
+
+
+
+* һ `long` ʾʹֽΪĬϵλָ `@DataSizeUnit`
+
+* һĸʽֵ͵λϵģ`10MB` ζ10ֽڣ
+
+
+
+
+
+ӡ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@ConfigurationProperties("my")
+public class MyProperties {
+
+ @DataSizeUnit(DataUnit.MEGABYTES)
+ private DataSize bufferSize = DataSize.ofMegabytes(2);
+
+ private DataSize sizeThreshold = DataSize.ofBytes(512);
+
+ // getters/setters...
+
+}
+
+```
+
+
+
+
+
+
+
+Ҫָһ10ֽڣMbĻС `10` `10MB` ǵȼ۵ġ 256ֽڵĴСֵָΪ `256` `256B`
+
+
+
+
+
+ҲʹЩֵ֧ĵλ
+
+
+
+
+
+* `B` ֽ
+
+* `KB` KB
+
+* `MB` MB
+
+* `GB` GB
+
+* `TB` TB
+
+
+
+
+
+Ĭϵλֽڣʹ `@DataSizeUnit` дʾ
+
+
+
+
+
+ϲʹù캯ͬԿԱ¶ʾ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@ConfigurationProperties("my")
+public class MyProperties {
+
+ // fields...
+
+ public MyProperties(@DataSizeUnit(DataUnit.MEGABYTES) @DefaultValue("2MB") DataSize bufferSize,
+ @DefaultValue("512B") DataSize sizeThreshold) {
+ this.bufferSize = bufferSize;
+ this.sizeThreshold = sizeThreshold;
+ }
+
+ // getters...
+
+}
+
+```
+
+
+
+
+
+
+
+| | һ `Long` ԣȷ嵥λʹ `@DataSizeUnit`ֽڡ ṩһ·ͬʱָ֧ḻĸʽ |
+| --- | --- |
+
+
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.validation)2.8.9\. @ConfigurationProperties У
+
+
+
+ֻҪʹSpring `@Validated` ע⣬Spring Bootͻ᳢֤ `@ConfigurationProperties` ࡣ ֱʹJSR-303 `jakarta.validation` Լע⡣ Ҫһ㣬ȷclasspathһݵJSR-303ʵ֣ȻԼעӵֶУʾ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@ConfigurationProperties("my.service")
+@Validated
+public class MyProperties {
+
+ @NotNull
+ private InetAddress remoteAddress;
+
+ // getters/setters...
+
+}
+
+```
+
+
+
+
+
+
+
+| | Ҳͨ configuration properties `@Bean` ע `@Validated` ֤ |
+| --- | --- |
+
+
+
+
+
+ΪȷΪǶԴ֤ʹûҵԣصֶα `@Valid` ע͡ ӽǰ `MyProperties` Ļϡ
+
+
+
+
+
+
+
+Java
+
+Kotlin
+
+
+
+
+
+```
+@ConfigurationProperties("my.service")
+@Validated
+public class MyProperties {
+
+ @NotNull
+ private InetAddress remoteAddress;
+
+ @Valid
+ private final Security security = new Security();
+
+ // getters/setters...
+
+ public static class Security {
+
+ @NotEmpty
+ private String username;
+
+ // getters/setters...
+
+ }
+
+}
+
+```
+
+
+
+
+
+
+
+ҲͨһΪ `configurationPropertiesValidator` beanһԶSpring `Validator` `@Bean` ӦñΪ `static` ֤Ӧóڵڴģ `@Bean` Ϊ̬BeanĴҪʵ `@Configuration` ࡣ Աʵκ⡣
+
+
+
+
+
+| | `spring-boot-actuator` ģһ¶ `@ConfigurationProperties` Bean Ķ˵㡣 ͨ `/actuator/configprops` ʹӦJMX˵㡣 "[](https://springdoc.cn/spring-boot/actuator.html#actuator.endpoints)"֡ |
+| --- | --- |
+
+
+
+
+
+
+
+#### [](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.vs-value-annotation)2.8.10\. @ConfigurationProperties vs. @Value
+
+
+
+`@Value` עһĵܣṩͰȫͬĹܡ ±ܽ `@ConfigurationProperties` `@Value` ֵ֧Ĺܡ
+
+
+
+
+| | `@ConfigurationProperties` | `@Value` |
+| --- | --- | --- |
+| [ɰ](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.relaxed-binding) | Yes | ( [ע](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.vs-value-annotation.note)) |
+| [֧ Meta-data](https://springdoc.cn/spring-boot/configuration-metadata.html#appendix.configuration-metadata) | Yes | No |
+| `SpEL` ʽ | No | Yes |
+
+
+
+| | ȷʵʹ `@Value`ǽʹƵĹ淶ʽʹСдĸkebab-caseơ ⽫Spring Bootʹ [ɰ](https://springdoc.cn/spring-boot/features.html#features.external-config.typesafe-configuration-properties.relaxed-binding) `@ConfigurationProperties` ʱͬ磬`@Value("${demo.item-price}")` `application.properties` ļлȡ `demo.item-price` `demo.itemPrice` ʽԼϵͳлȡ `DEMO_ITEMPRICE` `@Value("${demo.itemPrice}")` 棬`demo.item-price` `DEMO_ITEMPRICE` ᱻǡ |
+| --- | --- |
+
+
+
+
+
+ΪԼһüǽ㽫Ƿһ `@ConfigurationProperties` עPOJOС ΪṩṹġͰȫĶԽע뵽ԼbeanС
+
+
+
+
+
+Ӧ[application property](https://springdoc.cn/spring-boot/features.html#features.external-config.files) ļ `SpEL` ʽڽЩļenvironmentʱᱻ Ȼ `@Value` дһ `SpEL` ʽ Ӧóļֵһ `SpEL` ʽڱ `@Value` ʱ
+
+
+
+
+
+
+
+
+
+
+
+
+
+## [](https://springdoc.cn/spring-boot/features.html#features.profiles)
+
diff --git "a/docs/spring/SpringBoot/SpringBoot\350\207\252\345\270\246\347\232\204\347\203\255\351\203\250\347\275\262\345\267\245\345\205\267.md" "b/docs/spring/SpringBoot/SpringBoot\350\207\252\345\270\246\347\232\204\347\203\255\351\203\250\347\275\262\345\267\245\345\205\267.md"
new file mode 100644
index 0000000..477370a
--- /dev/null
+++ "b/docs/spring/SpringBoot/SpringBoot\350\207\252\345\270\246\347\232\204\347\203\255\351\203\250\347\275\262\345\267\245\345\205\267.md"
@@ -0,0 +1,345 @@
+# SpringBoot - Ȳdevtools
+
+> SpringBootУÿдĶҪٵԣܱȽϷʱ䣻SpringBootŶԴṩspring-boot-devtoolsdevtoolsͼԵЧʡ@pdai
+
+* [SpringBoot - Ȳdevtools](#springboot%E5%85%A5%E9%97%A8---%E9%85%8D%E7%BD%AE%E7%83%AD%E9%83%A8%E7%BD%B2devtools%E5%B7%A5%E5%85%B7)
+ * [֪ʶ](#%E5%87%86%E5%A4%87%E7%9F%A5%E8%AF%86%E7%82%B9)
+ * [ʲôȲȼأ](#%E4%BB%80%E4%B9%88%E6%98%AF%E7%83%AD%E9%83%A8%E7%BD%B2%E5%92%8C%E7%83%AD%E5%8A%A0%E8%BD%BD)
+ * [ʲôLiveLoad](#%E4%BB%80%E4%B9%88%E6%98%AFliveload)
+ * [devtoolsʵȲ](#%E9%85%8D%E7%BD%AEdevtools%E5%AE%9E%E7%8E%B0%E7%83%AD%E9%83%A8%E7%BD%B2)
+ * [POM](#pom%E9%85%8D%E7%BD%AE)
+ * [IDEA](#idea%E9%85%8D%E7%BD%AE)
+ * [application.yml](#applicationyml%E9%85%8D%E7%BD%AE)
+ * [ʹLiveLoad](#%E4%BD%BF%E7%94%A8liveload)
+ * [һ](#%E8%BF%9B%E4%B8%80%E6%AD%A5%E7%90%86%E8%A7%A3)
+ * [devtoolԭΪλԶ](#devtool%E7%9A%84%E5%8E%9F%E7%90%86%E4%B8%BA%E4%BD%95%E4%BC%9A%E8%87%AA%E5%8A%A8%E9%87%8D%E5%90%AF)
+ * [devtoolǷᱻJar](#devtool%E6%98%AF%E5%90%A6%E4%BC%9A%E8%A2%AB%E6%89%93%E5%8C%85%E8%BF%9Bjar)
+ * [devtoolΪλĬϽûѡ](#devtool%E4%B8%BA%E4%BD%95%E4%BC%9A%E9%BB%98%E8%AE%A4%E7%A6%81%E7%94%A8%E7%BC%93%E5%AD%98%E9%80%89%E9%A1%B9)
+ * [devtoolǷԸSpringbootӦȫֵã](#devtool%E6%98%AF%E5%90%A6%E5%8F%AF%E4%BB%A5%E7%BB%99%E6%89%80%E6%9C%89springboot%E5%BA%94%E7%94%A8%E5%81%9A%E5%85%A8%E5%B1%80%E7%9A%84%E9%85%8D%E7%BD%AE)
+ * [Ҳdevtoolʲôѡ](#%E5%A6%82%E6%9E%9C%E6%88%91%E4%B8%8D%E7%94%A8devtool%E8%BF%98%E6%9C%89%E4%BB%80%E4%B9%88%E9%80%89%E6%8B%A9)
+ * [ʾԴ](#%E7%A4%BA%E4%BE%8B%E6%BA%90%E7%A0%81)
+ * [ο](#%E5%8F%82%E8%80%83%E6%96%87%E7%AB%A0)
+
+## [#](#֪ʶ) ֪ʶ
+
+### [#](#ʲôȲȼ) ʲôȲȼأ
+
+> ȲȼӦеʱԶ£¼ػ滻classȣӦõһPSspring-boot-devtoolsṩķҲҪģֶֻʵԶضѡ
+
+ϸϣҪȲȼ, JavaĿԣ
+
+* **Ȳ**
+
+ * ڷʱ²Ŀ
+ * ֱ¼Ӧãַʽͷڴ棬ȼظӸɾףͬʱҲʱ䡣
+* **ȼ**
+
+ * ʱ¼classӶӦá
+ * ȼصʵԭҪ[javaػ](/md/java/jvm/java-jvm-classload.html)ʵַʽԸΪʱһ̨̣߳ʱļļʱ仯ʱˣ롣
+ * ԱȷƣʱȡϢ̬ͨĵıΪ ȼʱͨ¼ظıϢֱӸıΪ
+
+### [#](#ʲôliveload) ʲôLiveLoad
+
+LiveLoadṩͻԶظµĹߣΪLiveLoadLiveload֣ devtoolsѾLiveLoadǿwebӦãԶˢ£ ʱԿLiveLoad.
+
+
+
+ͬһʱֻһLiveReload ʼӦó֮ǰȷûLiveReloadСIDEӦóֻеһӦó֧LiveReload
+
+## [#](#devtoolsʵȲ) devtoolsʵȲ
+
+> ͨʵԶʽȲ
+
+### [#](#pom) POM
+
+spring-boot-devtools
+
+
+
+```
+
+
+ org.springframework.boot
+ spring-boot-devtools
+ true
+
+
+
+```
+
+
+
+### [#](#idea) IDEA
+
+> ʹIDEAߣַͨʽ
+
+* ʽһ **κʱֶ£Ctrl+F9**
+
+
+Ҳ`mvn compile`봥£
+
+* ʽ **IDEA迪ʱ룬Զ**
+
+**1**
+
+File->Setting->Build,Execution,Deployment->Compile
+
+ѡMake project automatically
+
+
+
+**2**
+
+ݼctrl+alt+shift+/
+
+ѡRegistry
+
+ѡcompiler.automake.allow.when.app.running
+
+°汾IDEAFile->setting->Advanced Setttingsĵһã
+
+
+### [#](#application-yml) application.yml
+
+
+
+```
+spring:
+ devtools:
+ restart:
+ enabled: true #ÿȲ
+ additional-paths: src/main/java #Ŀ¼
+ exclude: WEB-INF/**
+ thymeleaf:
+ cache: false #ʹThymeleafģ棬رջ
+
+```
+
+
+
+### [#](#ʹliveload) ʹLiveLoad
+
+spring-boot-devtoolsģ**ǶʽLiveReload**Դʱڴˢ¡ LiveReloadչ֧ChromeFirefoxSafariԴlivereload.comء
+
+
+ߴأfirefox:
+
+
+
+װ֮ͨͼ
+
+
+
+㲻ӦóʱLiveReloadԽspring.devtools.livereload.enabledΪfalse
+
+ͬһʱֻһLiveReload ʼӦó֮ǰȷûLiveReloadСIDEӦóֻеһӦó֧LiveReload
+
+## [#](#һ) һ
+
+> ȻһЩʹdevtoolߣǺܹģ¼⣬һ⡣@pdai
+
+### [#](#devtoolԭ-ΪλԶ) devtoolԭΪλԶ
+
+> ΪʲôͬӦãΪʲôֶǽʹspring-boot-devtoolsȲ
+
+spring-boot-devtoolsʹClassLoaderһClassLoaderزᷢĵࣨjarһClassLoaderrestart ClassLoaderػĵࣨԶࣩ
+
+̨һ**ļ̣߳File Watcher****Ŀ¼еļ䶯ʱ ԭrestart ClassLoader¼µrestart ClassLoader**
+
+Ϊļ䶯jar¼أֻԶ࣬صȽ٣ȽϿ졣
+
+ҲΪʲôͬӦãΪʲôֶʹspring-boot-devtoolsȲ
+
+ԶмҪע:
+
+* **Զ¼־**
+
+¼ʲô־
+
+ͨ¹ر
+
+
+
+```
+spring:
+ devtools:
+ restart:
+ log-condition-evaluation-delta: false
+
+```
+
+
+
+* **ųһЩҪԶԴ**
+
+ijЩԴڸʱһҪĬ£ıԴ/META-INF/maven/META-INF/resources/resources/static/public/templatesȷᴥֳװҪԶЩųʹøspring.devtools.restart.excludeԡ磬Ҫų/static/public㽫ԣ
+
+
+
+```
+spring:
+ devtools:
+ restart:
+ exclude: "static/**,public/**"
+
+```
+
+
+
+ҪЩĬֵųøspring.devtools.restart.additional-excludeԡ
+
+* **Զ**
+
+ͨʹʵֵġڴӦóַЧܺáǣʱᵼ⡣
+
+Ĭ£IDE еκδĿʹáأκγ.jarļʹáء㴦һģĿҲÿģ鶼뵽 IDE УҪԶһЩΪˣԴһMETA-INF/spring-devtools.propertiesļ
+
+spring-devtools.propertiesļrestart.excludeΪǰrestart.includeincludeԪӦñߵĿԼexcludeҪӦ롰BaseĿԵֵӦ·ʽģʽʾʾ
+
+
+
+```
+restart:
+ exclude:
+ companycommonlibs: "/mycorp-common-[\\w\\d-\\.]+\\.jar"
+ include:
+ projectcommon: "/mycorp-myproj-[\\w\\d-\\.]+\\.jar"
+
+```
+
+
+
+صϢ[´ڴ](https://docs.spring.io/spring-boot/docs/current/reference/html/using.html#using.devtools)鿴
+
+### [#](#devtoolǷᱻjar) devtoolǷᱻJar
+
+> devtoolԭ˵ӦֻڿԵʱʹãjarʱDzҪģSpringJAR
+
+* **Ĭ£ᱻJAR**
+
+дӦóʱԱ**Զ**ͨ java -jarʱᱻΪǡӦá
+
+* **Զ̵Ӧ**
+
+_ãֻεлʹ SSL бʱӦ_
+
+£devtoolҲ߱Զ̵ԵԶ̿ͻӦóּڴ IDE СҪorg.springframework.boot.devtools.RemoteSpringApplicationʹӵԶĿͬ·СӦóΨһӵԶ URL
+
+磬ʹ Eclipse Spring Toolsһmy-appѲ Cloud Foundry ΪĿִ²
+
+1. ѡRun Configurations?Run˵
+2. һµJava Applicationá
+3. my-appĿ
+4. ʹorg.springframework.boot.devtools.RemoteSpringApplicationΪࡣ
+5. https://myapp.cfapps.ioProgram argumentsκԶ URL
+
+еԶ̿ͻ˿б
+
+
+
+```
+ . ____ _ __ _ _
+ /\\ / ___'_ __ _ _(_)_ __ __ _ ___ _ \ \ \ \
+( ( )\___ | '_ | '_| | '_ \/ _` | | _ \___ _ __ ___| |_ ___ \ \ \ \
+ \\/ ___)| |_)| | | | | || (_| []::::::[] / -_) ' \/ _ \ _/ -_) ) ) ) )
+ ' |____| .__|_| |_|_| |_\__, | |_|_\___|_|_|_\___/\__\___|/ / / /
+ =========|_|==============|___/===================================/_/_/_/
+ :: Spring Boot Remote :: 2.5.4
+
+2015-06-10 18:25:06.632 INFO 14938 --- [ main] o.s.b.devtools.RemoteSpringApplication : Starting RemoteSpringApplication on pwmbp with PID 14938 (/Users/pwebb/projects/spring-boot/code/spring-boot-project/spring-boot-devtools/target/classes started by pwebb in /Users/pwebb/projects/spring-boot/code)
+2015-06-10 18:25:06.671 INFO 14938 --- [ main] s.c.a.AnnotationConfigApplicationContext : Refreshing org.springframework.context.annotation.AnnotationConfigApplicationContext@2a17b7b6: startup date [Wed Jun 10 18:25:06 PDT 2015]; root of context hierarchy
+2015-06-10 18:25:07.043 WARN 14938 --- [ main] o.s.b.d.r.c.RemoteClientConfiguration : The connection to http://localhost:8080 is insecure. You should use a URL starting with 'https://'.
+2015-06-10 18:25:07.074 INFO 14938 --- [ main] o.s.b.d.a.OptionalLiveReloadServer : LiveReload server is running on port 35729
+2015-06-10 18:25:07.130 INFO 14938 --- [ main] o.s.b.devtools.RemoteSpringApplication : Started RemoteSpringApplication in 0.74 seconds (JVM running for 1.105)
+
+```
+
+
+
+### [#](#devtoolΪλĬϽûѡ) devtoolΪλĬϽûѡ
+
+> Spring Boot ֵ֧һЩ**ʹû**磬ģ滺ѱģԱظģļ⣬Spring MVC ṩ̬ԴʱӦ HTTP ͷ
+
+Ȼ**зdz棬ڿпܻʵ䷴**ʹոӦóĸġԭ spring-boot-devtools ĬϽûѡ
+
+Thymeleaf ṩspring.thymeleaf.cacheģĻ棬ʹspring-boot-devtoolsģʱDzҪֶЩԵģΪspring-boot-devtoolsԶá
+
+ôԶЩأDevToolsPropertyDefaultsPostProcessorҵӦĬá
+
+
+
+```
+public class DevToolsPropertyDefaultsPostProcessor implements EnvironmentPostProcessor {
+
+ static {
+ Map properties = new HashMap<>();
+ properties.put("spring.thymeleaf.cache", "false");
+ properties.put("spring.freemarker.cache", "false");
+ properties.put("spring.groovy.template.cache", "false");
+ properties.put("spring.mustache.cache", "false");
+ properties.put("server.servlet.session.persistent", "true");
+ properties.put("spring.h2.console.enabled", "true");
+ properties.put("spring.web.resources.cache.period", "0");
+ properties.put("spring.web.resources.chain.cache", "false");
+ properties.put("spring.template.provider.cache", "false");
+ properties.put("spring.mvc.log-resolved-exception", "true");
+ properties.put("server.error.include-binding-errors", "ALWAYS");
+ properties.put("server.error.include-message", "ALWAYS");
+ properties.put("server.error.include-stacktrace", "ALWAYS");
+ properties.put("server.servlet.jsp.init-parameters.development", "true");
+ properties.put("spring.reactor.debug", "true");
+ PROPERTIES = Collections.unmodifiableMap(properties);
+ }
+
+```
+
+
+
+Ȼ㲻뱻ӦԱspring-boot-devtoolsĬã ͨspring.devtools.add-propertiesfalseapplication.ymlС
+
+### [#](#devtoolǷԸspringbootӦȫֵ) devtoolǷԸSpringbootӦȫֵã
+
+> ͨspring-boot-devtools.ymlļӵ$HOME/.config/spring-bootĿ¼**ȫ devtools **
+
+ӵЩļκԶʹ devtools Spring Boot Ӧó磬ҪΪʼʹôļҪӵspring-boot-devtoolsļУ
+
+
+
+```
+spring:
+ devtools:
+ restart:
+ trigger-file: ".reloadtrigger"
+
+```
+
+
+
+### [#](#Ҳdevtool-ʲôѡ) Ҳdevtoolʲôѡ
+
+> Ҳdevtoolʲôѡ
+
+**ʵʵĿУҲȥʹdevtool**, Ϊ
+
+* devtoolʽȻ滻JRebelǣշѵģ
+* ҪĻһȨ
+ * ԶĿֶûʲô̫ôֶ
+ * £**ڲĻ߾̬Դ**IDEAǿͨRebuildCtrl + Shift + F9ȸ
+
+
+
+* һspring loaded ʵļȲ𣬾ɿ[githubַ´ڴ](https://github.com/spring-projects/spring-loaded)ϵ˵
+
+## [#](#ʾԴ) ʾԴ
+
+https://github.com/realpdai/tech-pdai-spring-demos
+
+## [#](#ο) ο
+
+https://docs.spring.io/spring-boot/docs/current/reference/html/using.html#using.devtools
+
+https://liayun.blog.csdn.net/article/details/116541775
+
+* * *
+
+Ȩ@pdai ԭӣhttps://pdai.tech/md/spring/springboot/springboot-x-hello-devtool.html
\ No newline at end of file
diff --git "a/docs/spring/SpringBoot/SpringBoot\351\233\206\346\210\220Swagger\345\256\236\347\216\260API\346\226\207\346\241\243\350\207\252\345\212\250\347\224\237\346\210\220.md" "b/docs/spring/SpringBoot/SpringBoot\351\233\206\346\210\220Swagger\345\256\236\347\216\260API\346\226\207\346\241\243\350\207\252\345\212\250\347\224\237\346\210\220.md"
new file mode 100644
index 0000000..e225d74
--- /dev/null
+++ "b/docs/spring/SpringBoot/SpringBoot\351\233\206\346\210\220Swagger\345\256\236\347\216\260API\346\226\207\346\241\243\350\207\252\345\212\250\347\224\237\346\210\220.md"
@@ -0,0 +1,625 @@
+
+
+Ŀ¼
+
+* [SwaggerĽ](https://www.cnblogs.com/progor/p/13297904.html#swagger%E7%9A%84%E4%BB%8B%E7%BB%8D)
+ * [ŵȱ](https://www.cnblogs.com/progor/p/13297904.html#%E4%BC%98%E7%82%B9%E4%B8%8E%E7%BC%BA%E7%82%B9)
+* [swagger](https://www.cnblogs.com/progor/p/13297904.html#%E6%B7%BB%E5%8A%A0swagger)
+ * [1.](https://www.cnblogs.com/progor/p/13297904.html#1%E6%B7%BB%E5%8A%A0%E4%BE%9D%E8%B5%96%E5%8C%85)
+ * [2.Swagger:](https://www.cnblogs.com/progor/p/13297904.html#2%E9%85%8D%E7%BD%AEswagger)
+ * [3.](https://www.cnblogs.com/progor/p/13297904.html#3%E6%B5%8B%E8%AF%95)
+* [](https://www.cnblogs.com/progor/p/13297904.html#%E5%9C%BA%E6%99%AF)
+ * [ӿ](https://www.cnblogs.com/progor/p/13297904.html#%E5%AE%9A%E4%B9%89%E6%8E%A5%E5%8F%A3%E7%BB%84)
+ * [ӿ](https://www.cnblogs.com/progor/p/13297904.html#%E5%AE%9A%E4%B9%89%E6%8E%A5%E5%8F%A3)
+ * [ӿ](https://www.cnblogs.com/progor/p/13297904.html#%E5%AE%9A%E4%B9%89%E6%8E%A5%E5%8F%A3%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0)
+ * [һʵࡣ](https://www.cnblogs.com/progor/p/13297904.html#%E5%9C%BA%E6%99%AF%E4%B8%80%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0%E6%98%AF%E5%AE%9E%E4%BD%93%E7%B1%BB)
+ * [Ƿʵࡣ](https://www.cnblogs.com/progor/p/13297904.html#%E5%9C%BA%E6%99%AF%E4%BA%8C%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0%E6%98%AF%E9%9D%9E%E5%AE%9E%E4%BD%93%E7%B1%BB)
+ * [ӿӦ](https://www.cnblogs.com/progor/p/13297904.html#%E5%AE%9A%E4%B9%89%E6%8E%A5%E5%8F%A3%E5%93%8D%E5%BA%94)
+ * [Ӧʵࣺ](https://www.cnblogs.com/progor/p/13297904.html#%E5%93%8D%E5%BA%94%E6%98%AF%E5%AE%9E%E4%BD%93%E7%B1%BB)
+ * [ӦǷʵࣺ](https://www.cnblogs.com/progor/p/13297904.html#%E5%93%8D%E5%BA%94%E6%98%AF%E9%9D%9E%E5%AE%9E%E4%BD%93%E7%B1%BB)
+* [Swagger UIǿ](https://www.cnblogs.com/progor/p/13297904.html#swagger-ui%E5%A2%9E%E5%BC%BA)
+ * [UIԱȣ](https://www.cnblogs.com/progor/p/13297904.html#ui%E5%AF%B9%E6%AF%94)
+ * [ʹ](https://www.cnblogs.com/progor/p/13297904.html#%E4%BD%BF%E7%94%A8)
+ * [ŵ](https://www.cnblogs.com/progor/p/13297904.html#%E4%BC%98%E7%82%B9)
+* [Spring Securityע](https://www.cnblogs.com/progor/p/13297904.html#%E6%95%B4%E5%90%88spring-security%E6%B3%A8%E6%84%8F)
+* [tokenĴ](https://www.cnblogs.com/progor/p/13297904.html#%E5%AF%B9%E4%BA%8Etoken%E7%9A%84%E5%A4%84%E7%90%86)
+* [Swaggerİȫ](https://www.cnblogs.com/progor/p/13297904.html#swagger%E7%9A%84%E5%AE%89%E5%85%A8%E7%AE%A1%E7%90%86)
+
+
+
+* * *
+
+# SwaggerĽ
+
+?ܳԹдһӿںԼȥӿĵĽӿںĽӿĵ֮϶ᷢһǾĵߴĵǹ˾ѽӿĵдӿҪúܽ?дĵͿ۹ʣĹп©ģswaggerһдӿڵʱԶɽӿĵĶֻҪѭĹ淶дһЩӿڵ˵ע⼴ɡ
+
+## ŵȱ
+
+?ŵ㣺
+
+* ԶĵֻҪڽӿʹעбעɶӦĽӿĵ
+* ԶĵǶ̬ɵģ˽ӿڣĵҲԶӦģҲעĻͲᷢ˽ӿڣȴǸ½ӿĵ
+* ֧ߵԣswaggerṩߵýӿڵĹܡ
+
+?ȱ㣺
+
+* ܴʱܰ㴦е顣ֻṩһߵԣ洢IJʹPostmanYAPIִ֧ûĹܡ
+* ҪѭһЩ淶淶ġ˵ܻ᷵һjsonݣݿһMapʽģôǴʱܱעMapʽķݵÿֶε˵һʵĻǿͨעֶμ˵Ҳ˵swaggerƼʹGETʽύݵʱʹBodyƼʹqueryheader·Ȼֻߵԡ
+* ûнӿĵ¹Ȼһӿڸ֮ܲľɰĽӿϢ㡰ܡ뿴ɰĽӿϢЩҶȸ·ʱܻľɰĽӿڡôʱֻɺȥûעˣԿԿǽӿĵµʱע;ɰģȻд°ġȻͨӿĵԱȡ
+* ȻJavaʵвģͣpo,dto,voȣģ͵ΪһЩһû¼ʱֻҪusername,passwordȨʱҪȨޱϢʹUserʵĻĵоͻԶ˶ϢҪģʵ࣬¼ʱһLoginFormҪû-ȨϢʱʹUserࡣȻˣswagger֮ʹžͻôˡ
+
+?ȱдеܻ࣬swaggerеʵҪǹ淶⣬淶ʱֻĴ淶ԣͼʼˣǰʲôӿڵIJʹһ࣬swaggerҪֿijֲĴ淶ԡ
+
+?ע´ʾSpring BootԲο[swagger-demo](https://github.com/alprogor/swagger-demo)
+
+* * *
+
+# swagger
+
+?ȽswaggerҲϽôʹãġٽ⡣
+
+## 1.
+
+?ע⣬ǰѾspring bootweb
+
+ƴ
+
+```
+
+ io.springfox
+ springfox-swagger2
+ 2.9.2
+
+
+ io.springfox
+ springfox-swagger-ui
+ 2.9.2
+
+
+```
+
+## 2.Swagger:
+
+ҪʹswaggerDZswaggerãҪһswagger࣬ΪSwaggerConfig.java
+
+ƴ
+
+```
+package com.example.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import springfox.documentation.builders.ApiInfoBuilder;
+import springfox.documentation.builders.PathSelectors;
+import springfox.documentation.builders.RequestHandlerSelectors;
+import springfox.documentation.service.ApiInfo;
+import springfox.documentation.spi.DocumentationType;
+import springfox.documentation.spring.web.plugins.Docket;
+import springfox.documentation.swagger2.annotations.EnableSwagger2;
+
+@Configuration //
+@EnableSwagger2 //swagger
+public class SwaggerConfig {
+ @Bean
+ public Docket createRestApi() {
+ return new Docket(DocumentationType.SWAGGER_2) // DocumentationType.SWAGGER_2 ̶ģswagger2
+// .groupName("ֲʽϵͳ") // öĵʱôҪgroupNameʶ
+ .apiInfo(apiInfo()) // APIϢ
+ .select() // select()һApiSelectorBuilderʵ,ƽӿڱswaggerĵ
+ .apis(RequestHandlerSelectors.basePackage("com.example.controller")) // ָɨĸµĽӿ
+ .paths(PathSelectors.any())// ѡеAPI,ֻΪAPIĵ
+ .build();
+ }
+
+ /**
+ * ڶAPIϢеAPIܱ⡢汾
+ * @return
+ */
+ private ApiInfo apiInfo() {
+ return new ApiInfoBuilder()
+ .title("XXĿAPI") // ԶAPI
+ .description("XXĿSwaggerAPI") // API
+ .termsOfServiceUrl("") // ڶ
+ .version("1.0") // 汾
+ .build(); //
+ }
+}
+
+```
+
+## 3.
+
+ǵSpring BootĿĬ8080˿ڣ㲻һעĺurl`http://localhost:8080/swagger-ui.html`
+ȻͿԿһµĽ棬ʱûýӿݣʾ`No operations defined in spec!`
+
+
+
+?ǽζӿڣԼswagger UIеݡ
+
+* * *
+
+#
+
+## ӿ
+
+ӿʱӦǷģҴֶһcontrollerеģûصĽӿӦöUserControllerУôͬҵʱӦö/ֲͬĽӿ顣ӿʹ`@Api`֡
+磺
+
+ƴ
+
+```
+@Api(tags = "ɫ") // tagsԵ֡
+@RestController
+public class RoleController {
+}
+
+```
+
+
+
+ƴ
+
+```
+@Api(tags = "û") // tagsԵ֡
+@RestController
+public class UserController {
+}
+
+```
+
+?Ҳɻtags飬ͺһЩıǩһʹñǩࡣ
+?Controller£ӿ飩ûнӿڣôswagger uiDzʾģеĻͻʾ
+
+
+## ӿ
+
+ʹ`@Api`עһController֮нӿڣôͻĬĵûԶ˵
+
+ƴ
+
+```
+@Api(tags = "û")
+@RestController
+public class UserController {
+ // ע⣬swaggerҪʹ@RequestMapping
+ // Ϊ@RequestMapping֧ʽswaggerΪӿ7ʽĽӿĵ
+ @GetMapping("/info")
+ public String info(String id){
+ return "aaa";
+ }
+}
+
+```
+
+
+
+
+
+ǿʹ`@ApiOperation`ӿڣ磺
+
+ƴ
+
+```
+ @ApiOperation(value = "û",notes = "ûnotes")
+ @GetMapping("/test")
+ public String test(String id){
+ return "test";
+ }
+
+```
+
+
+
+
+* valueԵǽӿڵļ
+* notesӿڵ
+* tagsԶⶨӿ飬ӿѾ`@Api(tags = "û")`ӿڻֵˡûУԶʹtags`tags = "ɫ"`ýɫҲӿĵ
+
+## ӿ
+
+ʹ`@ApiOperation`ӿڣʵȱٽӿ˵Ƿֳ
+?עһ£**GETʽswaggerƼʹbodyʽ**ҲDzϣGETʽʱʹjsonform-dataȷʽݣʱʹ·url(?ȻPOSTMANֵ֧)ӿڴݵjsonform-dataʽģʹPOSTʽá
+
+### һʵࡣ
+
+ʱҪʹ`@ApiModel`עʵ࣬ȻڽӿжΪʵ༴ɣ
+
+* @ApiModel
+ *
+ * valueʵ
+ * descriptionʵ˵
+* @ApiModelPropertyֶε塣
+ *
+ * valueֶ˵
+ * exampleʾExample ValueĬֵãֶΪstringʱʱʾĬֵΪ"".
+ * nameµֶɵֶ
+ * allowableValuesֵ÷Χ`{1,2,3}`ֻȡֵ`[1,5]`ȡ15ֵ`(1,5)`15ֵ15ʹinfinity-infinityֵ`[1, infinity]`СֵΪ1ֵ
+ * requiredֶǷĬfalse,
+ * hiddenֶΣĬfalseҪҪʹtrueΪֶĬ϶ʾû`@ApiModelProperty`
+
+ƴ
+
+```
+// ʹ@ApiModelע
+@ApiModel(value="û¼",description="û¼")
+public class LoginForm {
+ // ʹApiModelPropertyעֶԡ
+ @ApiModelProperty(value = "û",required = true,example = "root")
+ private String username;
+ @ApiModelProperty(value = "",required = true,example = "123456")
+ private String password;
+
+ // ˴ʡθֵʱҪgetter,setter,swaggerҲҪ
+}
+
+```
+
+Σ
+
+ƴ
+
+```
+ @ApiOperation(value = "¼ӿ",notes = "¼ӿڵ˵")
+ @PostMapping("/login")
+ public LoginForm login(@RequestBody LoginForm loginForm){
+ return loginForm;
+ }
+
+```
+
+Ч
+
+
+
+### Ƿʵࡣ
+
+**˵һΣGETʽswaggerƼʹbodyʽݣȻSpring MVCԶװGETDzҪʹform-datajsonȷʽݲʹPostmanԽӿڣswagger߲Dz֧**
+ڷʵʹ`@ApiImplicitParams``@ApiImplicitParam`
+`@ApiImplicitParams`ڷͷϣ`@ApiImplicitParam``@ApiImplicitParams`棬һ`@ApiImplicitParam`Ӧһ
+`@ApiImplicitParam`
+
+* name֣Ҳֶε,ӿڵӦ**ӦҲɣԿ**
+* value
+* requiredעǷ
+* paramTypepath,query,body,form,headerȷʽڶڷʵʱõֻpath,query,headerbodyformDzõġbodyڶɢֻjsonĽӿ`form-data`,`x-www-form-urlencoded`ʱܲʹswaggerҳAPIԣں潲BootstrapUIswaggerǿеԣBootstrapUIswaggerָ֧`form-data``x-www-form-urlencoded`
+
+ʾһURL
+
+ƴ
+
+```
+ // ʹURL query
+ @ApiOperation(value = "¼ӿ2",notes = "¼ӿڵ˵2")
+ @ApiImplicitParams({
+ @ApiImplicitParam(name = "username",//
+ value = "û",//
+ required = true,//Ƿ봫
+ //paramTypeͣpath,query,body,form,header
+ paramType = "query"
+ )
+ ,
+ @ApiImplicitParam(name = "password",//
+ value = "",//
+ required = true,//Ƿ봫
+ paramType = "query"
+ )
+ })
+ @PostMapping(value = "/login2")
+ public LoginForm login2(String username,String password){
+ System.out.println(username+":"+password);
+ LoginForm loginForm = new LoginForm();
+ loginForm.setUsername(username);
+ loginForm.setPassword(password);
+ return loginForm;
+ }
+
+```
+
+ʾURL·
+
+ƴ
+
+```
+ // ʹ·
+ @PostMapping("/login3/{id1}/{id2}")
+ @ApiOperation(value = "¼ӿ3",notes = "¼ӿڵ˵3")
+ @ApiImplicitParams({
+ @ApiImplicitParam(name = "id1",//
+ value = "û",//
+ required = true,//Ƿ봫
+ //paramTypeͣpath,query,body,form,header
+ paramType = "path"
+ )
+ ,
+ @ApiImplicitParam(name = "id2",//
+ value = "",//
+ required = true,//Ƿ봫
+ paramType = "path"
+ )
+ })
+ public String login3(@PathVariable Integer id1,@PathVariable Integer id2){
+ return id1+":"+id2;
+ }
+
+```
+
+ʾheader
+
+ƴ
+
+```
+ // headerݲ
+ @PostMapping("/login4")
+ @ApiOperation(value = "¼ӿ4",notes = "¼ӿڵ˵4")
+ @ApiImplicitParams({
+ @ApiImplicitParam(name = "username",//
+ value = "û",//
+ required = true,//Ƿ봫
+ //paramTypeͣpath,query,body,form,header
+ paramType = "header"
+ )
+ ,
+ @ApiImplicitParam(name = "password",//
+ value = "",//
+ required = true,//Ƿ봫
+ paramType = "header"
+ )
+ })
+ public String login4( @RequestHeader String username,
+ @RequestHeader String password){
+ return username+":"+password;
+ }
+
+```
+
+ʾģļϴ
+
+ƴ
+
+```
+ // ļϴʱҪ@ApiParam÷@ApiImplicitParamһ@ApiParamڲ
+ // ҲԲע⣬swaggerԶ˵
+ @ApiOperation(value = "ϴļ",notes = "ϴļ")
+ @PostMapping(value = "/upload")
+ public String upload(@ApiParam(value = "ͼƬļ", required = true)MultipartFile uploadFile){
+ String originalFilename = uploadFile.getOriginalFilename();
+
+ return originalFilename;
+ }
+
+ // ļϴʱ**swaggerֻܲԵļϴ**
+ @ApiOperation(value = "ϴļ",notes = "ϴļ")
+ @PostMapping(value = "/upload2",consumes = "multipart/*", headers = "content-type=multipart/form-data")
+ public String upload2(@ApiParam(value = "ͼƬļ", required = true,allowMultiple = true)MultipartFile[] uploadFile){
+ StringBuffer sb = new StringBuffer();
+ for (int i = 0; i < uploadFile.length; i++) {
+ System.out.println(uploadFile[i].getOriginalFilename());
+ sb.append(uploadFile[i].getOriginalFilename());
+ sb.append(",");
+ }
+ return sb.toString();
+ }
+
+ // ļв
+ @ApiOperation(value = "ļв",notes = "ļв")
+ @PostMapping(value = "/upload3")
+ @ApiImplicitParams({
+ @ApiImplicitParam(name = "name",
+ value = "ͼƬ",
+ required = true
+ )
+ })
+ public String upload3(@ApiParam(value = "ͼƬļ", required = true)MultipartFile uploadFile,
+ String name){
+ String originalFilename = uploadFile.getOriginalFilename();
+
+ return originalFilename+":"+name;
+ }
+
+```
+
+## ӿӦ
+
+ӿӦǷ鿴ӿĵܹ֪ӿڷصݵ塣
+
+### Ӧʵࣺ
+
+ǰڶӿʱᵽʹ`@ApiModel`ע࣬ӿڷ࣬ôϵ˵ҲΪӦ˵
+
+ƴ
+
+```
+ // ر@ApiModelע
+ @ApiOperation(value = "ʵӦ",notes = "ΪʵĽӿ")
+ @PostMapping("/role1")
+ public LoginForm role1(@RequestBody LoginForm loginForm){
+ return loginForm;
+ }
+
+```
+
+
+
+### ӦǷʵࣺ
+
+swaggerԷʵӦϸ˵ֻܱעӦϢͨ`@ApiResponses``@ApiResponse`ʵֵġ
+`@ApiResponses``@ApiResponse``@ApiModel`һʹá
+
+ƴ
+
+```
+ // ͵,ʱֶעͣʵswaggerƼʹʵ
+ @ApiOperation(value = "ʵ",notes = "ʵ")
+ @ApiResponses({
+ @ApiResponse(code=200,message = "óɹ"),
+ @ApiResponse(code=401,message = "Ȩ" )
+ }
+ )
+ @PostMapping("/role2")
+ public String role2(){
+ return " {\n" +
+ " name:\"㶫\",\n" +
+ " citys:{\n" +
+ " city:[\"\",\"\",\"麣\"]\n" +
+ " }\n" +
+ " }";
+ }
+
+```
+
+
+
+* * *
+
+# Swagger UIǿ
+
+ܻUIǺܺÿһЩṩһЩSwagger UIǿȽе`swagger-bootstrap-ui``swagger-bootstrap-ui`Ϊ
+
+## UIԱȣ
+
+
+
+
+
+## ʹ
+
+1.
+
+ƴ
+
+```
+
+
+ io.springfox
+ springfox-swagger2
+ 2.9.2
+
+
+ io.springfox
+ springfox-swagger-ui
+ 2.9.2
+
+
+
+ com.github.xiaoymin
+ swagger-bootstrap-ui
+ 1.8.7
+
+
+```
+
+2.swaggerע`@EnableSwaggerBootstrapUI`:
+
+ƴ
+
+```
+@Configuration //
+@EnableSwagger2 //swagger
+@EnableSwaggerBootstrapUI // SwaggerBootstrapUI
+public class SwaggerConfig {
+ // ʡ
+}
+
+```
+
+3.API`http://localhost:8080/doc.html`ԤbootstarpSwagger UI档
+
+## ŵ
+
+1.?ÿһ
+
+2.˵ˣBootstrapUIswaggerָ֧`form-data``x-www-form-urlencoded`
+
+
+3.ָ֧ƵAPIĵ͵ȫAPIĵ
+
+
+
+
+* * *
+
+# Spring Securityע
+
+Spring BootSpring SecuritySwaggerʱҪص·ͷе·עǷ¼·
+
+ƴ
+
+```
+.antMatchers("/swagger**/**").permitAll()
+.antMatchers("/webjars/**").permitAll()
+.antMatchers("/v2/**").permitAll()
+.antMatchers("/doc.html").permitAll() // bootstarpSwagger UI棬һ
+
+```
+
+* * *
+
+# tokenĴ
+
+swaggerֻ֧˼ĵԣһЩӿڣDzԵʱҪtokenϢдheaderУĿǰûԶͷĵط
+?һ
+ʹSwagger BootstrapUIôڡĵȫֲheader
+
+?swaggerȫֲã
+
+ƴ
+
+```
+ //жȫֲ˵ͷ
+ ParameterBuilder parameterBuilder = new ParameterBuilder();
+ List parameters = new ArrayList();
+ parameterBuilder.name("authorization").description("")
+ .modelRef(new ModelRef("string")).parameterType("header").required(false).build();
+ parameters.add(parameterBuilder.build());
+ return new Docket(DocumentationType.SWAGGER_2) // DocumentationType.SWAGGER_2 ̶ģswagger2
+ .apiInfo(apiInfo()) // APIϢ
+ .select() // select()һApiSelectorBuilderʵ,ƽӿڱswaggerĵ
+ .apis(RequestHandlerSelectors.basePackage("com.example.controller")) // ָɨĸµĽӿ
+ .paths(PathSelectors.any())// ѡеAPI,ֻΪAPIĵ
+ .build().globalOperationParameters(parameters);
+
+```
+
+?ʹ`@ApiImplicitParams`עһͷ磺
+
+ƴ
+
+```
+ // ҪIJDZõҪ,Ȩtoken
+ @PostMapping("/login6")
+ @ApiOperation(value = "tokenĽӿ",notes = "tokenĽӿ")
+ @ApiImplicitParams({
+ @ApiImplicitParam(name = "authorization",//
+ value = "Ȩtoken",//
+ required = true,//Ƿ봫
+ paramType = "header"
+ )
+ ,
+ @ApiImplicitParam(name = "username",//
+ value = "û",//
+ required = true,//Ƿ봫
+ paramType = "query"
+ )
+ })
+ public String login6(String username){
+ return username;
+ }
+
+```
+
+* * *
+
+# Swaggerİȫ
+
+1.ȨԸswaggerȨҪswaggerҳû룬Щspring securityshiroˣﲻ
+
+2.DzʽпԷʣʽйرSwaggerԶãͲswaggerҳˡʹ`@Profile({"dev","test"})`עֻdevtestSwaggerԶá
+ȻSpring Bootļĵǰprofile`spring.profiles.active=release`֮ʱ`http://localhost:8080/swagger-ui.html`
+
+* * *
+
+
+
+ߣ[progor](https://www.cnblogs.com/progor/)
+Ϊԭתע
+
diff --git "a/docs/spring/SpringBoot/\345\237\272\344\272\216SpringBoot\344\270\255\347\232\204\345\274\200\346\272\220\347\233\221\346\216\247\345\267\245\345\205\267SpringBootAdmin.md" "b/docs/spring/SpringBoot/\345\237\272\344\272\216SpringBoot\344\270\255\347\232\204\345\274\200\346\272\220\347\233\221\346\216\247\345\267\245\345\205\267SpringBootAdmin.md"
new file mode 100644
index 0000000..fc25a2c
--- /dev/null
+++ "b/docs/spring/SpringBoot/\345\237\272\344\272\216SpringBoot\344\270\255\347\232\204\345\274\200\346\272\220\347\233\221\346\216\247\345\267\245\345\205\267SpringBootAdmin.md"
@@ -0,0 +1,294 @@
+Spring Boot Admin(SBA)һԴĿڹͼ Spring Boot ӦóӦóͨ http ķʽ Spring Cloud ֻעᵽ SBA УȻͿʵֶ Spring Boot ĿĿӻͲ鿴ˡ
+
+Spring Boot Admin Լ Spring Boot ȺĿṩϸĽ (Health)ϢڴϢJVM ϵͳͻԡϢ־úͲ鿴ʱ鿴Spring Boot 鿴ȹܡһʹðɡ
+
+յչʾЧ£
+
+[](https://s5.51cto.com/oss/202201/14/5d142e8c6b544f7b981b3eff8099b3d8.png)
+
+## 1.SBAض
+
+Ҫһ Spring Boot Admin Ŀغǵ Spring Boot Ŀķʽʹͨ Spring Boot Ŀƣ岽¡ʹ Idea һ Spring Boot Ŀ
+
+[](https://s5.51cto.com/oss/202201/14/d97c492785db6ff2ded49175184ceda9.png)
+
+[](https://s3.51cto.com/oss/202201/14/8bb1f0389b95e174b56ac01ba313ec7b.png)
+
+Ҫע⣬Ҫ Spring Boot Admin(Server)˿֧֣ܵͼʾ
+
+[](https://s4.51cto.com/oss/202201/14/122e9f0726fde8ac0c8936c79ef12f5f.png)
+
+ҲǴ Spring Boot ĿҪҪĿ֧֣
+
+
+
+
+
+```
+
+ org.springframework.boot
+ spring-boot-starter-web
+
+
+ de.codecentric
+ spring-boot-admin-starter-server
+
+
+```
+
+
+
+
+
+
+
+### 1.1 SBA
+
+Ŀ֮ҪϿ SBA
+
+
+
+
+
+```
+import de.codecentric.boot.admin.server.config.EnableAdminServer;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@EnableAdminServer // Ӵд
+@SpringBootApplication
+public class SbaserverApplication {
+ public static void main(String[] args) {
+ SpringApplication.run(SbaserverApplication.class, args);
+ }
+}
+
+```
+
+
+
+
+
+### 1.2 SBA˿ں
+
+ application.properties һĿĶ˿ںžͿֱˣõĶ˿ں 9001
+
+
+
+
+
+```
+server.port=9001
+
+```
+
+
+
+
+
+PSö˿ںŵҪĿΪ˲ Spring Boot Ŀͻ SBA ǵ˲Ժԡ
+
+Ŀ֮ͿԿ SBA ҳˣͼʾ
+
+[](https://s5.51cto.com/oss/202201/14/20418ce88230b20b234f9e9c15e07f47.png)
+
+ʱ SBA лûκҪصĿٴһ Spring Boot Ŀ뵽 SBA мغɡ
+
+## 2.һͨSpringBootĿ
+
+ȣҪһͨ Spring Boot ĿĴͲʾˡ Spring Boot Ŀ֮Ҫ Spring Boot ĿҪ SBA ͻ˿֧֣ܵҲ pom.xml ݣ
+
+
+
+
+
+
+
+```
+
+ de.codecentric
+ spring-boot-admin-starter-client
+
+
+```
+
+
+
+
+
+Ȼ application.properties ļ SBA ˵ַҲǵһ SBA Ŀĵַ£
+
+
+
+
+
+```
+# ǰĿ˿ں
+server.port=8080
+# Spring Boot Admin ط˵ַ
+spring.boot.admin.client.url=http://localhost:9001
+
+```
+
+
+
+
+
+Сspring.boot.admin.client.urlΪ SBA صַ
+
+## 3.SpringBootAdmin
+
+Ϣ֮ʱ鿴 Spring Boot Admin ҳобص Spring Boot Ŀˣͼʾ
+
+[](https://s5.51cto.com/oss/202201/14/c010770a5cdfe5fad0ad1e8f0c3b07dc.png)
+
+ҲԵӦǽ鿴 Spring Boot Admin бص Spring Boot Ŀͼʾ
+
+[](https://s4.51cto.com/oss/202201/14/d88e33f87e116000f9717e8c19c43cc4.png)
+
+Ӧýҳ棬ͼʾ
+
+[](https://s2.51cto.com/oss/202201/14/4c3609840ea5cb45779eafbc2b260324.png)
+
+[](https://s4.51cto.com/oss/202201/14/2912ed434d97f8dd49c27ce73252d34c.png)
+
+¼־а Spring Boot ״̬չʾ(UP ΪOFFLINE Ϊ쳣)ͷʱ䣬ͼʾ
+
+[](https://s5.51cto.com/oss/202201/14/5792a62fbcafe6978bfe3bd26cf1e3ab.png)
+
+## 4.SpringBoot쳣
+
+ֶѱص Spring Boot Ŀֹ֮ͣ Spring Boot Admin оͿԲ鿴һӦѾͣˣͼʾ
+
+[](https://s5.51cto.com/oss/202201/14/47569a3fe09e62b2364c26bdbd7da4bc.png)
+
+Ҳͨ¼־鿴 Spring Boot 崻ľʱ䣬ͼʾ
+
+[](https://s2.51cto.com/oss/202201/14/b63f631561fa646f85ccf3e1e4321939.png)
+
+## 5.ò鿴
+
+ͨǿԿص Spring Boot ѡDZȽٵģôܲ鿴ļ?Ҫ⣬Ҫڱص Spring Boot Ŀ spring-boot-starter-actuator ֧֣ܵ鿴мòУչʾЧ£
+
+[](https://s4.51cto.com/oss/202201/14/03938ac0bded4487b6720fc4657f9e99.png)
+
+һЩ
+
+### 5.1 actuator֧
+
+ڱص Spring Boot Ŀ actuator ֧֣Ҳ pom.xml ã
+
+
+
+
+
+
+
+```
+
+ org.springframework.boot
+ spring-boot-starter-actuator
+
+
+```
+
+
+
+
+
+ֶ Maven (Զ룬˲ɺ)
+
+### 5.2 ÿм
+
+ڱص Spring Boot Ŀã
+
+
+
+
+
+```
+#
+management.endpoints.web.exposure.include=*
+
+```
+
+
+
+
+
+ϵǿżѡ֮ Spring Boot ĿȻˢ Spring Boot Admin ļչʾˣͼʾ
+
+[](https://s6.51cto.com/oss/202201/14/2cc24e05bc6185ba1869872db5a864a5.png)
+
+### 5.3 ĿԤ
+
+ Spring Boot м֮ͨ SBA ͿԲ鿴ˣ
+
+* ʱ䡢ۼʱ;
+* ̺߳ռõ CPU Դ;
+* Ϣմͻʱ;
+* JVM ߳תڴתͶӦļ;
+* Բ鿴 Spring Boot Ŀе־;
+* 鿴 Spring Boot Ŀܼ;
+* 鿴 Spring Boot лϢ;
+* 鿴 Spring Boot Ϣ;
+* 鿴 Spring Boot еĶʱ;
+* 鿴 Spring Boot Ŀел档
+
+ǼҪҳĽͼһ
+
+### 5.3.1 鿴л
+
+[](https://s5.51cto.com/oss/202201/14/a9db77b1b0e378450086edd1ab438df5.png)
+
+[](https://s2.51cto.com/oss/202201/14/17604f4f5eb388a2a6c08f55e1e050ac.png)
+
+### 5.3.2 鿴ʱ
+
+[](https://s5.51cto.com/oss/202201/14/113d94b9bd488e239967915aededc89c.png)
+
+### 5.3.3 Ŀ־
+
+[](https://s3.51cto.com/oss/202201/14/8da60846eecbdbd9472ae6dbf17d951f.png)
+
+ǿͨ Spring Boot Admin ̬Ŀе־
+
+### 5.3.4 JVM̺߳ڴ鿴
+
+[](https://s2.51cto.com/oss/202201/14/d3f98228a8b19675475c863457821034.png)
+
+### 5.3.5 鿴SpringBootл
+
+[](https://s5.51cto.com/oss/202201/14/ae811102080c26b11135be50cd889710.png)
+
+ȻǻԶЩɾ
+
+## 6.鿴Ŀʵʱ־
+
+Ҫ鿴Ŀе־Ϣһǰǰ㱻ص Spring Boot Ŀ־ı·־ļֻеһ Spring Boot ĿŻὫ־浽ϣͨ SBA 鿴õ־· Spring Boot application.properties ļã
+
+
+
+
+
+```
+# ־·
+logging.file.path=C:\\work\\log
+
+```
+
+
+
+
+
+֮ Spring Boot ĿȻˢ SBA ҳ棬չʾЧ£
+
+[](https://s6.51cto.com/oss/202201/14/3f03c6402cc8a2532ed45ab43be156ac.png)
+
+ʱǾͿԲ鿴ʵʱ־ϢˣȻҲʱ־ҪĻ
+
+## ܽ
+
+Spring Boot Admin(SBA)һԴĿڹͼ Spring Boot ӦóṩϸĽ (Health)ϢڴϢJVM ϵͳͻԡϢ־úͲ鿴ʱ鿴Spring Boot 鿴ȹܡ
+
+Ҫһ SBA һ Spring Boot Ŀص Spring Boot ĿҪ SBA Client ֧֣ܵ actuator ܺӦãͿʵֶ Spring Boot Ŀˡ
\ No newline at end of file
diff --git "a/docs/spring/\347\273\231\344\275\240\344\270\200\344\273\275SpringBoot\347\237\245\350\257\206\346\270\205\345\215\225.md" "b/docs/spring/SpringBoot/\347\273\231\344\275\240\344\270\200\344\273\275SpringBoot\347\237\245\350\257\206\346\270\205\345\215\225.md"
similarity index 100%
rename from "docs/spring/\347\273\231\344\275\240\344\270\200\344\273\275SpringBoot\347\237\245\350\257\206\346\270\205\345\215\225.md"
rename to "docs/spring/SpringBoot/\347\273\231\344\275\240\344\270\200\344\273\275SpringBoot\347\237\245\350\257\206\346\270\205\345\215\225.md"
diff --git "a/docs/spring/SpringMVC/SpringMVC\344\270\255\347\232\204\345\233\275\351\231\205\345\214\226\345\212\237\350\203\275.md" "b/docs/spring/SpringMVC/SpringMVC\344\270\255\347\232\204\345\233\275\351\231\205\345\214\226\345\212\237\350\203\275.md"
new file mode 100644
index 0000000..374388b
--- /dev/null
+++ "b/docs/spring/SpringMVC/SpringMVC\344\270\255\347\232\204\345\233\275\351\231\205\345\214\226\345\212\237\350\203\275.md"
@@ -0,0 +1,179 @@
+#### ʻ
+
+* * *
+
+ڿӦóʱֶ֧Եֶ֧ԵĹ֮ܳΪʻӢinternationalizationдΪi18nΪĸiĩĸnм18ĸ
+
+ضıػܣӢlocalizationдΪL10nػָݵڵʾȡ
+
+ҲаߺϳΪȫӢglobalizationдΪg11n
+
+JavaУֶ֧Ժͱػͨ`MessageFormat``Locale`ʵֵģ
+
+
+WebӦóҪʵֹʻܣҪȾViewʱҪѸԵԴļͬûͬһҳʱʾԾDzͬġ
+
+Spring MVCӦóʵֹʻ
+
+### ȡLocale
+
+ʵֹʻĵһǻȡû`Locale`WebӦóУHTTP淶涨Я`Accept-Language`ͷָʾû趨˳磺
+
+```
+Accept-Language: zh-CN,zh;q=0.8,en;q=0.2
+
+```
+
+HTTPͷʾѡģѡģѡӢġ`q`ʾȨأǿɻһȼбתΪJava`Locale`û`Locale`ֻͨȨߵ`Locale`
+
+Spring MVCͨ`LocaleResolver`Զ`HttpServletRequest`лȡ`Locale`ж`LocaleResolver`ʵ࣬õ`CookieLocaleResolver`
+
+```
+@Primary
+@Bean
+LocaleResolver createLocaleResolver() {
+ var clr = new CookieLocaleResolver(); clr.setDefaultLocale(Locale.ENGLISH); clr.setDefaultTimeZone(TimeZone.getDefault()); return clr;}
+
+```
+
+`CookieLocaleResolver``HttpServletRequest`лȡ`Locale`ʱȸһضCookieжǷָ`Locale`ûУʹHTTPͷȡûУͷĬϵ`Locale`
+
+ûһηվʱ`CookieLocaleResolver`ֻܴHTTPͷȡ`Locale`ʹĬԡͨվҲûԼѡԣʱ`CookieLocaleResolver`ͻûѡԴŵCookieУһηʱͻ᷵ûϴѡԶĬԡ
+
+### ȡԴļ
+
+ڶǰдģеַԴļķʽ洢ⲿڶԣļΪ`messages`ôԴļ밴·ʽclasspathУ
+
+* ĬԣļΪ`messages.properties`
+* ģLocale`zh_CN`ļΪ`messages_zh_CN.properties`
+* ģLocale`ja_JP`ļΪ`messages_ja_JP.properties`
+* ԡ
+
+ÿԴļͬkey磬ĬӢģļ`messages.properties`£
+
+```
+language.select=Language
+home=Home
+signin=Sign In
+copyright=Copyright?{0,number,#}
+
+```
+
+ļ`messages_zh_CN.properties`£
+
+```
+language.select=
+home=ҳ
+signin=¼
+copyright=Ȩ?{0,number,#}
+
+```
+
+### MessageSource
+
+ǴһSpringṩ`MessageSource`ʵԶȡе`.properties`ļṩһͳһӿʵ֡롱
+
+```
+// code, arguments, locale:
+String text = messageSource.getMessage("signin", null, locale);
+
+```
+
+У`signin``.properties`ļжkeyڶ`Object[]`ΪʽʱIJһǻȡû`Locale`ʵ
+
+`MessageSource`£
+
+```
+@Bean("i18n")
+MessageSource createMessageSource() {
+ var messageSource = new ResourceBundleMessageSource(); // ָļUTF-8:
+ messageSource.setDefaultEncoding("UTF-8"); // ָļ:
+ messageSource.setBasename("messages"); return messageSource;}
+
+```
+
+ע`ResourceBundleMessageSource`ԶļԶԵԴļ
+
+עSpringᴴֻһ`MessageSource`ʵԼ`MessageSource`רŸҳʻʹõģΪ`i18n``MessageSource`ʵͻ
+
+### ʵֶ
+
+ҪViewʹ`MessageSource``Locale`ԣͨдһ`MvcInterceptor`Դע뵽`ModelAndView`У
+
+```
+@Component
+public class MvcInterceptor implements HandlerInterceptor {
+ @Autowired LocaleResolver localeResolver;
+ // עעMessageSourcei18n:
+ @Autowired @Qualifier("i18n") MessageSource messageSource;
+ public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception { if (modelAndView != null) { // ûLocale:
+ Locale locale = localeResolver.resolveLocale(request); // Model:
+ modelAndView.addObject("__messageSource__", messageSource); modelAndView.addObject("__locale__", locale); } }}
+
+```
+
+Ҫ`WebMvcConfigurer`ע`MvcInterceptor`ڣͿViewе`MessageSource.getMessage()`ʵֶԣ
+
+```
+{{ __messageSource__.getMessage('signin', null, __locale__) }}
+
+```
+
+дȻУʽ̫ˡʹViewʱҪÿضView涨ƹʻPebbleУǿԷװһʻƾ»`_`һ´`ViewResolver`Ĵ룺
+
+```
+@Bean
+ViewResolver createViewResolver(@Autowired ServletContext servletContext, @Autowired @Qualifier("i18n") MessageSource messageSource) {
+ var engine = new PebbleEngine.Builder() .autoEscaping(true) .cacheActive(false) .loader(new Servlet5Loader(servletContext)) // չ:
+ .extension(createExtension(messageSource)) .build(); var viewResolver = new PebbleViewResolver(); viewResolver.setPrefix("/WEB-INF/templates/"); viewResolver.setSuffix(""); viewResolver.setPebbleEngine(engine); return viewResolver;}
+
+private Extension createExtension(MessageSource messageSource) {
+ return new AbstractExtension() { @Override public Map getFunctions() { return Map.of("_", new Function() { public Object execute(Map args, PebbleTemplate self, EvaluationContext context, int lineNumber) { String key = (String) args.get("0"); List