如何在 Spring Boot 中定义和读取 自定义配置

前言

在Spring Boot中定义和读取自定义配置是日常开发中常见的需求,它允许我们以灵活的方式管理应用的配置信息,无论是通过外部配置文件(如application.propertiesapplication.yml)还是通过环境变量。

作为高级程序员,我们需要掌握这一技能,以确保应用的可配置性和可维护性。以下是一个详细的步骤说明,包括示例代码,展示如何在Spring Boot中定义和读取自定义配置。

在Spring Boot中,你可以通过以下步骤定义和读取自定义配置:

  • application.propertiesapplication.yml中定义自定义配置项。

例如,在application.yml中添加:

XML 复制代码
app:
  custom:
    my-property: value
  • 创建一个配置类来绑定这些属性。
java 复制代码
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;
 
@Configuration
@ConfigurationProperties(prefix = "app.custom")
public class CustomProperties {
 
    private String myProperty;
 
    public String getMyProperty() {
        return myProperty;
    }
 
    public void setMyProperty(String myProperty) {
        this.myProperty = myProperty;
    }
}
  • 在Spring Bean中注入CustomProperties类来使用配置值。
java 复制代码
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
 
@Component
public class MyComponent {
 
    private final CustomProperties customProperties;
 
    @Autowired
    public MyComponent(CustomProperties customProperties) {
        this.customProperties = customProperties;
    }
 
    public void printCustomProperty() {
        System.out.println(customProperties.getMyProperty());
    }
}

确保@ConfigurationProperties注解的prefix属性与你在配置文件中定义的前缀相匹配。Spring Boot会自动将配置属性绑定到CustomProperties类的字段上。然后你可以在应用程序的任何部分通过自动装配的方式来使用这些配置值。

或者:

定义自定义配置属性

XML 复制代码
# application.properties
myapp.name=Spring Boot Application
myapp.description=This is a demo application for custom configuration
myapp.server.port=8081

创建配置类

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

java 复制代码
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类的相应字段上。

读取配置

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

java 复制代码
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的配置管理功能,可以大大提升应用的灵活性和可扩展性。

相关推荐
再见晴天*_*7 分钟前
logback 日志不打印
java·服务器·logback
moon66sun8 分钟前
开源项目XYZ.ESB:数据库到数据库(DB->DB)集成
数据库·esb
幽络源小助理15 分钟前
SpringBoot基于JavaWeb的城乡居民基本医疗信息管理系统
java·spring boot·学习
欧阳有财18 分钟前
[java八股文][Mysql面试篇]日志
java·mysql·面试
TDengine (老段)26 分钟前
使用 StatsD 向 TDengine 写入
java·大数据·数据库·时序数据库·iot·tdengine·涛思数据
真实的菜29 分钟前
JVM类加载系统详解:深入理解Java类的生命周期
java·开发语言·jvm
DarkAthena33 分钟前
【GaussDB】深度解析:创建存储过程卡死且无法Kill会话的疑难排查
数据库·gaussdb
Gauss松鼠会38 分钟前
GaussDB权限管理:从RBAC到精细化控制的企业级安全实践
大数据·数据库·安全·database·gaussdb
时序数据说1 小时前
时序数据库IoTDB用户自定义函数(UDF)使用指南
大数据·数据库·物联网·开源·时序数据库·iotdb
N_NAN_N1 小时前
类图+案例+代码详解:软件设计模式----原型模式
java·设计模式·原型模式