daily commit

2022-04-26 23:31:14 +08:00
parent 3325de86ba
commit 6ef6f9e75b
1 changed files with 114 additions and 0 deletions
--- a/spring/spring
+++ b/spring/spring
@@ -0,0 +1,114 @@
+# SpringBoot 核心特性
+* ## 外部配置
+  * springboot允许通过如下方式来完成外部配置：
+    * properties文件配置
+    * yaml文件配置
+    * 环境变量配置
+    * 命令行参数配置
+  * springboot项目的外部配置顺序如下，位于后面的配置会覆盖前面的配置项
+    * 各项默认值
+    * @PropertiesSource
+      * @PropertiesSource注解用于将properties文件中的键值对加入到Environment中
+    * config data（在application.properties中定义的键值对）
+      * 如果一个键值对同时在properties文件和yaml文件中定义，那么properties文件中的定义将会覆盖yaml文件中的定义
+      * config data的覆盖顺序
+        * application properties(properties和yaml文件中的配置项)
+        * profile文件中的配置项
+        * 位于jar包之外的properties（当前目录下的properties文件或yaml文件）
+        * 位于jar包之外的profile（位于当前目录之下的profile文件）
+    * RandomPropertySource：以random开头的随机值，可以是int、long、uuid、byte[]
+    * 操作系统的环境变量
+    * Java System Properties（在命令行中通过-Dpropertyname=value指定的键值对）
+    * java:comp/env中的JND属性
+    * ServletContext中的初始化参数
+    * ServletConfig中的初始化参数
+    * Properties from SPRING_APPLICATION_JSON (inline JSON embedded in an environment variable or system property).
+    * Command line arguments.
+    * properties attribute on your tests. Available on @SpringBootTest and the test annotations for testing a particular slice of your application.
+    * @TestPropertySource annotations on your tests.
+    * Devtools global settings properties in the $HOME/.config/spring-boot directory when devtools is active.
+  * 外部配置可以通过如下方式来指定
+    * --propertyname=value形式来指定
+    ```shell
+    # 通过命令行指定server.port属性的值
+    $ java -jar --server.port=8080
+    ```
+    * -Dpropertyname=value形式指定
+    ```shell
+    # 通过-D选项来指定属性的值
+    $ java -Dserver.port=8080
+    ```
+  * 外部配置时配置文件可位于的位置
+    * 在启动应用程序时，通过会按顺序在如下位置查找properties文件和yaml文件
+      * classpath：
+        * 在classpath下的root路径
+        * classpath下的/config路径
+      * 当前目录：
+        * 当前目录下的root路径
+        * 当前目录下的/config路径
+        * 当前目录下/config目录的直接子目录
+      * 在上述顺序中，位于后面位置的配置文件会覆盖位于前面位置的配置
+    * spring.config.location设置
+      * 在spring.config.location属性下，可以为其设置多个配置文件位置，多个位置之间通过‘，’来隔开
+      * 如果将多个位置视为同一层次，可以使用‘；’来隔开位于同一位置组的所有位置，位于同一位置组的所有位置都被是为同一层次被同时加载
+    * spring.config.additional-location设置
+      * 如果只是想添加配置文件路径，而不是重新定义。可以设置spring.config.additional-location，其设置的路径将会被添加到配置文件路径
+      * 添加路径下的配置将会覆盖之前默认路径下的配置
+    * 可选路径
+      * 可以将location设置为optional，如果该路径不存在，应用并不会抛出异常而是继续启动
+      * 通配符路径无法用在classpath下
+      * 通配符路径只能包含一个*，并且
+        * 对于目录，以*/结尾
+        * 对于文件，以*/filename结尾
+  * spring.config.import配置
+    * 可以通过import来导入外部配置文件，相当于将外部文件的配置项插入到当前配置文件的末尾
+    * 被导入的配置文件将由于当前的配置文件
+    * 在spring.config.import中可以指定多个外部配置文件，配置文件将会按指定的顺序导入，后导入的配置将会覆盖前面导入的配置
+    * 可以通过指定[.yaml/.properties]来导入没有后缀名称导入配置
+    ```shell
+    spring.config.import=file:./config[.yaml]
+    ```
+  * 属性占位符
+    * 通过${palceholder}可以用占位符来引用先前已经被定义的变量值
+  * yaml格式
+    * yaml无法被@PropertySource和@TestPropertySource导入
+    * 可以通过YamlPropertiesFactoryBean导入yaml文件为Properties
+    * 可以通过YamlMapFactoryBean来导入yaml文件
+* ## 注入配置属性到spring bean中
+  * 可以通过@ConfigurationProperties注解来为bean对象中的域填充配置信息，该注解的value值为对象在配置文件中的前缀
+    * @ConfigurationProperties默认通过setter绑定，故而需要为绑定的域添加setter
+  ```
+  @ConfigurationProperties("waifu.kazusa")
+  @Component
+  class WaifuKazusa {
+      private String name;
+      private String gender;
+      private String relationship;
+  }
+  ```
+  * 如果为@ConfigurationProperties指定@ConstructorBinding注解，可以指定构造器绑定
+    * 如果为一个类指定了构造器绑定，那么该类中的嵌套成员（对象域）也会通过构造器绑定
+    * 可以通过@DefaultValue来为配置文件中没有指定的域指定默认值
+    * 通过@ConstructorBinding指定的类通常是不可变的，不向外提供setter，域赋值通过构造函数完成
+    * @ConstructorBinding指定的类无法通过@Component等注解来标记为bean，而是要显示通过指定@ConfigurationPropertiesScan或是@EnableConfigurationProperties来实现
+  * @ConfigurationProperties可以注解在@bean标签的方法上
+  * Relaxed Bidning：
+    * 通常，配置文件中的属性和bean类中的域名并不需要严格匹配，在bean类中成员变量名称通过‘firstSecond’形式定义，可以与配置文件中如下格式都匹配
+      * first-second
+      * first_second
+      * FIRST_SECOND
+      * firstSecond
+    * 如果要向properties中添加map类型的值，可以用[]来包围key值
+    ```shell
+    my.map.[key1]=value1
+    my.map.[key2]=value2
+    ```
+  * Duration绑定
+    * 默认情况下，不指定时间单位时单位是ms
+    * 通过@DurationUnit指定时间单位
+  * DataSize绑定
+    * 默认情况下，DataSize的单位是byte
+    * 可以通过@DataSizeUnit来显示指定单位
+  * @Value和@ConfigurationProperties区别：
+    * @Value只有当其value值是"first-second"形式时，才支持relaxed binding
+    * @Value支持spel