# application.yml 格式
server:
  port: 8080 # 服務器端口，默認 8080
  servlet:
    context-path: /springboot3 # 項目上下文路徑，默認 /（空路徑）
  tomcat:
    uri-encoding: UTF-8 # Tomcat 編碼，SpringBoot3 默認 UTF-8

# application.properties 格式
server.port=8080
server.servlet.context-path=/springboot3
server.tomcat.uri-encoding=UTF-8

# application.yml 格式
logging:
  level:
    root: INFO # 根日志級別（DEBUG/INFO/WARN/ERROR）
    com.example: DEBUG # 自定義包的日志級別（開發(fā)環(huán)境常用 DEBUG）
  file:
    name: logs/springboot3.log # 日志輸出文件路徑
  pattern:
    console: "%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{50} - %msg%n" # 控制臺日志格式
    file: "%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{50} - %msg%n" # 文件日志格式

# application.yml 格式
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/springboot3_db?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
    username: root # 數(shù)據(jù)庫用戶名
    password: 123456 # 數(shù)據(jù)庫密碼
    driver-class-name: com.mysql.cj.jdbc.Driver # MySQL 8.0+ 驅(qū)動類（SpringBoot3 可省略，自動識別）
  jpa:
    hibernate:
      ddl-auto: update # 自動生成表結(jié)構(gòu)（開發(fā)環(huán)境可用，生產(chǎn)環(huán)境禁用）
    show-sql: true # 控制臺打印 SQL 語句

# 自定義配置項（前綴可自定義，建議與項目/模塊名一致）
demo:
  name: SpringBoot3-Config
  version: 1.0.0
  description: 這是 SpringBoot3 配置文件實戰(zhàn)示例
  enable: true # 布爾類型
  max-size: 100 # 數(shù)字類型

import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ConfigController {

    // 注入自定義屬性，${} 為占位符，指定配置項的鍵
    @Value("${demo.name}")
    private String demoName;

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

    // 布爾類型注入，無需轉(zhuǎn)換，SpringBoot 自動解析
    @Value("${demo.enable:true}") // 冒號后為默認值，若配置文件中無該屬性，使用默認值 true
    private boolean demoEnable;

    @GetMapping("/config/simple")
    public String getSimpleConfig() {
        return "demoName: " + demoName + ", demoVersion: " + demoVersion + ", demoEnable: " + demoEnable;
    }
}

import jakarta.validation.constraints.NotBlank;
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

import java.util.List;

// 綁定配置文件中前綴為 demo 的配置項
@Component // 注入到 Spring 容器中，否則無法被掃描到
@ConfigurationProperties(prefix = "demo")
@Data // Lombok 注解，簡化 getter/setter（推薦使用）
public class DemoConfig {

    @NotBlank(message = "demo.name 不能為空") // 支持 JSR380 校驗，SpringBoot3 內(nèi)置支持
    private String name;

    private String version;

    private String description;

    private boolean enable;

    private Integer maxSize;

    // 數(shù)組/集合類型配置
    private List<String> authors;

    // 嵌套對象配置（復雜層次）
    private DatabaseConfig database;

    // 嵌套對象，無需添加 @Component，會被自動綁定
    @Data
    public static class DatabaseConfig {
        private String url;
        private String username;
        private String password;
    }
}

demo:
  name: SpringBoot3-Config
  version: 1.0.0
  description: 這是 SpringBoot3 配置文件實戰(zhàn)示例
  enable: true
  max-size: 100
  authors: [張三, 李四, 王五] # 數(shù)組格式（兩種寫法均可）
  # authors:
  #  - 張三
  #  - 李四
  #  - 王五
  database: # 嵌套對象配置
    url: jdbc:mysql://localhost:3306/test_db
    username: root
    password: 123456

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ConfigController {

    @Autowired
    private DemoConfig demoConfig; // 注入綁定好的實體類

    @GetMapping("/config/complex")
    public DemoConfig getComplexConfig() {
        // 直接返回實體類，SpringBoot 自動轉(zhuǎn)為 JSON
        return demoConfig;
    }
}

demo:
  # 1. 引用當前配置文件中的其他配置項
  name: SpringBoot3
  full-name: ${demo.name}-Config-Demo

  # 2. 引用系統(tǒng)環(huán)境變量（SpringBoot3 優(yōu)化了環(huán)境變量的解析，支持更多系統(tǒng)）
  user-home: ${user.home}

  # 3. 引用命令行參數(shù)（啟動時通過 --key=value 傳入，優(yōu)先級高于配置文件）
  port: ${server.port:8080} # 冒號后為默認值，若命令行未傳入，使用 8080

spring:
  profiles:
    active: dev # 默認激活開發(fā)環(huán)境
  # 全局共用配置（所有環(huán)境都生效）
  application:
    name: springboot3-config-demo

server:
  port: 8080 # 開發(fā)環(huán)境端口 8080
logging:
  level:
    root: DEBUG # 開發(fā)環(huán)境日志級別 DEBUG，方便調(diào)試
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/dev_db # 開發(fā)環(huán)境數(shù)據(jù)庫
    username: root
    password: 123456

server:
  port: 80 # 生產(chǎn)環(huán)境端口 80
logging:
  level:
    root: ERROR # 生產(chǎn)環(huán)境日志級別 ERROR，減少日志輸出
spring:
  datasource:
    url: jdbc:mysql://192.168.1.100:3306/prod_db # 生產(chǎn)環(huán)境數(shù)據(jù)庫
    username: prod_user
    password: prod_123456 # 生產(chǎn)環(huán)境密碼加密（下文會講）

<!-- pom.xml -->
<dependency>
    <groupId>com.github.ulisesbocchio</groupId>
    <artifactId>jasypt-spring-boot-starter</artifactId>
    <version>3.0.5</version> <!-- 適配 SpringBoot3 -->
</dependency>

# application-prod.yml
jasypt:
  encryptor:
    password: ${JASYPT_ENCRYPT_PASSWORD} # 加密密鑰，從環(huán)境變量獲取
    algorithm: PBEWithMD5AndDES # 加密算法（默認，可自定義）

import org.jasypt.encryption.StringEncryptor;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;

// 項目啟動時生成加密后的密碼（僅開發(fā)時使用，生產(chǎn)時刪除）
@Component
public class JasyptTest implements CommandLineRunner {

    @Autowired
    private StringEncryptor stringEncryptor;

    @Override
    public void run(String... args) throws Exception {
        // 加密明文密碼（prod_123456）
        String encryptPassword = stringEncryptor.encrypt("prod_123456");
        System.out.println("加密后的密碼：" + encryptPassword);
        // 輸出示例：EV7k8Z7xQ+3a9B1c2D3e4F5g6H7i8J9k0L1m2N3o4P5q6R7s8T9u0V1w2X3y4Z5
    }
}

spring:
  datasource:
    password: ENC(EV7k8Z7xQ+3a9B1c2D3e4F5g6H7i8J9k0L1m2N3o4P5q6R7s8T9u0V1w2X3y4Z5)

java -jar springboot3-config.jar --spring.profiles.active=prod --jasypt.encryptor.password=你的密鑰

java -jar springboot3-config.jar -spring.config.location=/opt/config/application-prod.yml

# 錨點復用示例
common-db: &common-db # 定義錨點，名稱為 common-db
  driver-class-name: com.mysql.cj.jdbc.Driver
  username: root

demo:
  database:
    <<: *common-db # 合并錨點配置，復用 driver-class-name 和 username
    url: jdbc:mysql://localhost:3306/dev_db
    password: 123456