Spring Boot 配置檔案總結

god23bin發表於2023-05-18
Spring Boot

前言

Spring Boot 中提供一個全域性的配置檔案：application.properties，這個配置檔案的作用就是，允許我們透過這個配置檔案去修改 Spring Boot 自動配置的預設值。

Spring Boot 支援兩種格式的配置檔案：application.properties 和 application.yml。

yml 等同於 yaml，寫法看個人喜歡，我喜歡寫成 application.yml

不同字尾不同寫法

application.properties 和 application.yml ，它們的區別在於語法不同，但本質上是一樣的。application.properties 使用鍵值對的方式來配置，而 application.yml 使用縮排和冒號的方式來配置。

properties

properties 作為字尾的配置檔案，語法是這樣的：key = value，如果有多級配置項，則是 first.second.third = value。

key=value
first.second.third=value

示例：

  1. 定義屬性：
key=value
game.name=GTA5

這裡的 key 和 game.name 都是屬性名稱，而 value 和 GTA5 是屬性的值。

  1. 定義 List：
game.list=GTA5,NBA2K,AC

這裡的 game.list 這個列表包含了 3 個元素。

  1. 定義 Map：
game.map.key1=value1
game.map.key2=value2

這裡的 game.map 是一個 Map，這個 Map 包含了兩個元素，key1 對映到 value1，key2 對映到 value2

  1. 引用已定義的屬性：
game.name=GTA5
# 引用上面已定義的屬性
great.game=${game.name}

yml (yaml)

yml 作為字尾的配置檔案，語法是這樣的：key: value。使用冒號代替等號，同時冒號後面需要跟上一個空格符，不可省略。

key: value
first:
  second:
    third: value

示例：

  1. 定義屬性：
key: value
game:
  name: GTA5
  1. 定義 List：
game:
  list:
    - GTA5
    - NBA2K
    - AC
  1. 定義 Map：
game:
  map:
    key1: value1
    key2: value2
  1. 引用已定義的屬性：
game:
  name: GTA5
great:
  game: @{game.name}

不同環境下切換不同的配置檔案

一般專案中在不同環境下都有不同的配置，還是以這個 Tomcat 的埠號為例：

目前有 3 個環境，分別是開發環境、測試環境、生產環境。在開發環境下，埠號是 4790；測試環境下，埠號是 4791；生產環境下是 4792。

application-dev.yml

server:
  port: 4790

application-test.yml

server:
  port: 4791

application-prod.yml

server:
  port: 4792

spring.profiles.active

現在，透過 spring.profiles.active 這個配置項，在 application.yml 中指定我們想要切換的配置檔案，現在指定使用開發環境的配置檔案：

# 指定使用 application-dev.yml 這個配置檔案
spring:
  profiles:
    active: dev

啟動 Spring Boot 應用，控制檯輸出：

2023-03-16 15:41:48.122  INFO 3356 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 4790 (http) with context path ''

指定使用測試環境下的配置檔案：

# 指定使用 application-test.yml 這個配置檔案
spring:
  profiles:
    active: test

啟動 Spring Boot 應用，控制檯輸出：

2023-03-16 15:42:21.462  INFO 24548 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 4791 (http) with context path ''

同理，指定使用生產環境的配置檔案也是一樣的做法。

自定義的配置

在 Spring Boot 專案中，自定義配置是經常用到的，我目前體會到的自定義的配置的作用有一點：配置與程式碼解耦

下面，我們看看如何自定義配置，並使用自己自定義配置的值：

server:
  port: 4790

# 自定義的配置
demo:
  author: god23bin
  description: 點個免費的贊，我能開心好久！

上面自定義了兩個配置項，分別是 demo.author 和 demo.description，接著，如何在程式碼中使用這些配置好的值呢？

目前使用這些配置好的值（讀取這些值），有以下幾種方式：

  • 使用 @Value
  • 使用 @ConfigurationProperties

@Value

我們寫一個普通的 Java 類，使用 Spring 提供的 @Value 來讀取這兩個值：

@Data
@Component
public class DemoCustomConfig {

    /**
     * 透過 @Value 註解讀取配置檔案中的自定義配置項的值，使用 ${} 進行讀取
     **/
    @Value("${demo.author}")
    private String author;

    @Value("${demo.description}")
    private String description;

}

上面的程式碼中，我在類上使用了 @Data 和 @Component，@Data 是來自 Lombok 的，用於生成 getter 和 setter 方法，@Component 則將該類的例項物件交給 Spring 管理，接著在該類的兩個屬性上分別使用了 @Value 註解，透過 ${} 指定了我們要讀取的配置項。

進行測試，我們寫一個 Controller 判斷我們的讀取是否成功：

@RequestMapping("/demo")
@RestController
public class DemoController {

    @Autowired
    private DemoCustomConfig demoCustomConfig;

    @GetMapping("/getCustomValue")
    public ResponseEntity<String> getCustomValue() {
        return ResponseEntity.ok(demoCustomConfig.getAuthor() + "說：" + demoCustomConfig.getDescription());
    }
}

訪問該介面：localhost:4790/demo/getCustomValue

image-20230321233256647

@ConfigurationProperties

@ConfigurationProperties 註解，它可以將配置檔案中的的值繫結到 Java Bean 中，也就是透過這個 Bean 可以讀取到配置檔案中配置的值，我們看看如何操作。

我們自定義一個用於讀取配置檔案中配置項的類：

@Data
@Component
@ConfigurationProperties("system.demo")
public class SystemCustomConfig {

    private String name;

    private String version;

}

上面的程式碼，主要使用了 @ConfigurationProperties 這個註解，並指定了字首 system.demo，同時這個類有兩個屬性，name 和 version， 這樣就相當於我們自定義了 system.demo.name 和 system.demo.version 這兩個屬性。

接著，我們就能在配置檔案中寫這兩個我們自定義的配置項了：

server:
  port: 4790

# 自定義的配置
system:
  demo:
    name: 超級系統
    version: 1.0

寫完這裡的配置項，並不需要使用 @Value 去讀取，因為使用了 @ConfigurationProperties 註解，Spring 已經幫我們搞定了配置的值的讀取，至於它的實現原理，這裡先不深究。

進行測試，依然透過寫一個介面來測試我們透過：

@RequestMapping("/demo")
@RestController
public class DemoController {

    @Autowired
    private SystemCustomConfig systemCustomConfig;

    @GetMapping("/getSystemVersion")
    public ResponseEntity<String> getSystemVersion() {
        return ResponseEntity.ok(systemCustomConfig.getName() + "版本：" + systemCustomConfig.getVersion());
    }
}

訪問該介面：localhost:4790/demo/getSystemVersion

image-20230321233317428

關於自動提示

不過，目前有個問題就是，我們自己寫了個 Java Bean 後，在配置檔案中寫配置項的時候並沒有相關提示，這個就比較不友好，如果當我們自己寫的配置想要給其他人用的話，別人都不知道有什麼配置可以配。所以想要能像 Spring Boot 提供的配置提示一樣的話，就需要引入下面的依賴：

<!-- 配置檔案處理器，配置檔案進行繫結就會有提示 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <optional>true</optional>
</dependency>
spring-boot-configuration-processor 是一個用於生成配置後設資料的註解處理器。它會掃描使用 @ConfigurationProperties 註解的類和方法，來獲取配置引數並生成配置後設資料。生成的配置後設資料可以用於 IDE 的自動補全和提示功能。

image-20230322233941391

如果你引入了這個依賴並且重啟該 Spring Boot 專案後，依舊沒有提示的話，嘗試開啟 IDEA 中的 annotaion processing。

image-20230322234341016

關於 Cannot resolve configuration property

對於我們自定義的配置，會出現這樣的提示：Cannot resolve configuration property（無法處理自定義的配置屬性），如下：

image-20230322235035717

解決方式就是定義一下後設資料，用後設資料來描述這個屬性。當我們移動到這個配置項上時，出現提示，我們直接點選 Define configuration key xxx 就可以幫我們生成一個關於配置的後設資料檔案。

additional-spring-configuration-metadata.json：

{
  "properties": [
    {
      "name": "demo.author",
      "type": "java.lang.String",
      "description": "Demo的作者"
    },
    {
      "name": "demo.description",
      "type": "java.lang.String",
      "description": "Demo的描述"
    }
  ]
}

此時，還是一樣，重啟專案，如果黃色提示還是沒有去除的話，這裡建議重新用 Maven 進行一次 clean，接著重新編譯整個專案，就可以了。於此同時，也具有了自動提示功能。

image-20230322235958525

自定義配置檔案

上面說的是自定義的配置，現在這裡說自定義的配置檔案，我們知道 Spring Boot 預設提供 application.properties 這個配置檔案。那現在我們想自己寫一個配置檔案，並且能在應用中讀取這個配置檔案的資訊，該如何做呢？這裡就涉及到 @PropertySource 這個註解了。

自定義的配置檔案：

custom.yml：

# 自定義的配置檔案
version: 2.0
description: 求關注！

讀取該配置檔案的配置類：

@Data
@Configuration
@PropertySource("classpath:custom.yml")
public class DemoPropertiesSourceConfig {

    @Value("${version}")
    private String version;

    @Value("${description}")
    private String description;

}

這樣，就能讀取到自己編寫的配置檔案的配置資訊了。

如果有多個自定義的配置檔案，那麼可以使用 @PropertySources 註解，可以看到最後面多加了一個 s ，說明這個單詞是複數，通俗易懂。

@Configuration
@PropertySources({
    @PropertySource("classpath:custom1.yml"),
    @PropertySource("classpath:custom2.properties")
})
public class MyConfig {
    // ...
}

總結

  1. 配置檔案的兩種寫法：properties 和 yml
  2. 專案中存在多個配置檔案，可以使用 spring.profiles.active 屬性來切換使用哪個配置檔案。
  3. 自定義的一些配置屬性（配置項），如何讀取呢？可以在程式中透過 @Value 或者@ConfigurationProperties 來讀取。
  4. 自定義的配置檔案，可以透過 @PropertySource 來指定獲取該自定義配置檔案的資訊。

最後的最後

希望各位螢幕前的靚仔靚女們給個三連！你輕輕地點了個贊，那將在我的心裡世界增添一顆明亮而耀眼的星！

我們們下期再見！

相關文章