在Spring Boot中定义和读取自定义配置是日常开发中常见的需求，它允许我们以灵活的方式管理应用的配置信息，无论是通过外部配置文件（如application.properties或application.yml）还是通过环境变量。作为高级程序员，我们需要掌握这一技能，以确保应用的可配置性和可维护性。以下是一个详细的步骤说明，包括示例代码，展示如何在Spring Boot中定义和读取自定义配置。

1. 定义自定义配置属性

首先，我们需要在应用的配置文件中定义自定义属性。这里以application.properties为例，但同样的逻辑也适用于application.yml。

# application.properties
myapp.name=My Spring Boot Application
myapp.description=This is a demo application for custom configuration.
myapp.server.port=8081

2. 创建配置类

接下来，我们需要创建一个配置类来绑定这些自定义属性。在Spring Boot中，这通常通过@ConfigurationProperties注解实现，它允许我们将配置文件中的属性绑定到JavaBean上。

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;

@Configuration
@ConfigurationProperties(prefix = "myapp")
public class MyAppConfig {

    private String name;
    private String description;
    private int serverPort;

    // 标准的getter和setter方法
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getDescription() {
        return description;
    }

    public void setDescription(String description) {
        this.description = description;
    }

    public int getServerPort() {
        return serverPort;
    }

    public void setServerPort(int serverPort) {
        this.serverPort = serverPort;
    }
}

注意，@ConfigurationProperties(prefix = "myapp")注解指定了配置属性的前缀为myapp，这样Spring Boot就能自动将application.properties中所有以myapp开头的属性绑定到MyAppConfig类的相应字段上。

3. 启用配置类

要使@ConfigurationProperties注解生效，我们还需要在Spring Boot的启动类或配置类上添加@EnableConfigurationProperties注解，并指定我们的配置类。但在Spring Boot 2.2及以上版本中，如果你将配置类放在主应用类所在的包或子包中，并且它被@ComponentScan扫描到，那么通常不需要显式启用它。不过，为了清晰起见，这里还是展示一下如何显式启用：

import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Configuration;

@Configuration
@EnableConfigurationProperties(MyAppConfig.class)
public class MyAppConfigEnabler {
    // 这个类可以保持为空，仅用于启用MyAppConfig
}

但在大多数情况下，你可以省略这一步。

4. 读取配置

最后，我们可以在应用的任何地方通过依赖注入的方式读取这些配置。例如，在一个Controller中：

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

@RestController
public class MyAppConfigController {

    private final MyAppConfig myAppConfig;

    @Autowired
    public MyAppConfigController(MyAppConfig myAppConfig) {
        this.myAppConfig = myAppConfig;
    }

    @GetMapping("/config")
    public String getConfig() {
        return "Name: " + myAppConfig.getName() + ", Description: " + myAppConfig.getDescription() + ", Server Port: " + myAppConfig.getServerPort();
    }
}

总结

通过上述步骤，我们成功地在Spring Boot中定义了自定义配置属性，并通过@ConfigurationProperties注解将它们绑定到了JavaBean上。最后，我们通过依赖注入的方式在应用中读取这些配置。这种方式不仅提高了代码的可读性和可维护性，还使得配置管理变得更加灵活和方便。在实际开发中，合理利用Spring Boot的配置管理功能，可以大大提升应用的灵活性和可扩展性。

在探索Spring Boot的更多高级特性时，不妨关注“码小课”网站，那里提供了丰富的技术教程和实战案例，帮助你更深入地理解和掌握Spring Boot及其生态系统。