SpringBoot 读取配置文件属性的5种方式

本文详细介绍了在SpringBoot中读取配置文件属性的五种方法,包括使用@Value注解、Environment对象、@Component结合@ConfigurationProperties、@Component结合@Value和@PropertySource的组合使用,以及在不支持yml文件的情况下使用properties文件的方式。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

准备阶段

  • 在.yml或.properties加入属性配置
person:
  lastName: zhangsan
  email: xxx@163.com
  age: 18
  birth: 2019/1/10
  maps: {k1: v1,k2: v2}
  lists:
    - lisi
    - zhaoliu
  pets:
    name: 小狗
    age: 12

  • pom.xml添加依赖【用文件处理器,用于和配置文件进行绑定及字段提示】
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <optional>true</optional>
</dependency>

  • 启用IDEA配置
    在这里插入图片描述

方式一:@Value(“${xxx}”) 注解

  • 代码示例
@RunWith(SpringRunner.class)
@SpringBootTest
@Slf4j
public class BootPackApplicationTests {


    @Value("${person.lastName}")
    String lastName;


    @Test
    public void test01() {
       log.info("@Value注解方式 读取到数据:" + lastName);
    }
}

在这里插入图片描述

方式二: Environment对象方式

  • 代码示例

@RunWith(SpringRunner.class)
@SpringBootTest
@Slf4j
public class BootPackApplicationTests {

    @Autowired
    private Environment env;

    @Test
    public void test01() {
        log.info("Environment对象方式 读取到数据:" + env.getProperty("person.lastName"));
    }
}

在这里插入图片描述

方式三: @Component+@ConfigurationProperties(prefix = “XXX”) 组合注解

  • 代码示例

@Getter
@Setter
@ToString
@Component
@ConfigurationProperties(prefix = "person")
public class Person implements Serializable {

    private String lastName;

    private String email;

    private Integer age;

    private String birth;

    private Map<String, Object> maps;

    private List<Object> lists;

    private Pets pets;

    @Getter
    @Setter
    @ToString
    class Pets {

        private String name;

        private Integer age;
    }
}

在这里插入图片描述

方式四: @Component+@Value(“${xxx}”)+@PropertySource(value = {“classpath:XXX.properties”}) 组合注解

  • 特别注意:@PropertySource注解不支持yml配置文件
  • 新建person.properties
person.last-name=张三
person.email=xxx@163.com
person.age=${random.int}
person.birth=2020/1/10
person.maps={k1:"v1",k2:"v2"}
person.lists=a,b,c
  • 代码示例
@Getter
@Setter
@ToString
@Component
@PropertySource(value = {"classpath:person.properties"})
public class Person implements Serializable {

    @Value("${person.last-name}")
    private String lastName;

    @Value("${person.email}")
    private String email;

    @Value("${person.age}")
    private Integer age;

    @Value("${person.birth}")
    private String birth;

    @Value("#{${person.maps}}")
    private Map<String, Object> maps;

    @Value("#{'${person.lists}'.split(',')}")
    private List<Object> lists;
}

在这里插入图片描述

方式五: @Component+@ConfigurationProperties(prefix = “XXX”)+@PropertySource(value = {“classpath:XXX.properties”}) 组合注解

  • 特别注意:@PropertySource注解不支持yml配置文件
  • 新建p1.properties
person.last-name=张三
person.email=xxx@163.com
person.age=${random.int}
person.birth=2020/1/10
person.maps.k1=v1
person.maps.k2=v1
person.lists=a,b,c
  • 代码示例
@Getter
@Setter
@ToString
@Component
@PropertySource(value = {"classpath:p1.properties"})
@ConfigurationProperties(prefix = "person")
public class Person implements Serializable {

    private String lastName;

    private String email;

    private Integer age;

    private String birth;

    private Map<String, Object> maps;

    private List<Object> lists;
}

在这里插入图片描述

### Spring Boot 读取配置文件方式总结 #### 方法一:`@Value` 注解 通过 `@Value` 注解可以方便地注入单个属性到类的字段中。这种方式适用于简单场景,尤其是只需要获取少量配置项的情况。例如,在 `application.properties` 或 `application.yml` 中定义如下配置: ```properties my.property=Hello, Spring Boot! ``` 或者使用 YAML 格式: ```yaml my: property: Hello, Spring Boot! ``` 可以在 Java 类中这样读取该配置: ```java @Component public class MyConfig { @Value("${my.property}") private String myProperty; public void printProperty() { System.out.println(myProperty); } } ``` 这种方法的优点在于实现简单,缺点是不支持复杂的数据结构绑定[^2]。 --- #### 方法二:`@ConfigurationProperties` 注解 当需要处理一组具有相同前缀的配置时,推荐使用 `@ConfigurationProperties` 注解。它允许将多个相关联的配置映射到一个 POJO 对象上。例如,假设存在以下配置: ```yaml my: app: name: MyApp version: 1.0.0 list: - item1 - item2 ``` 可以通过创建对应的实体类来绑定这些配置: ```java @ConfigurationProperties(prefix = "my.app") @Data // Lombok 自动生成 getter 和 setter public class AppConfig { private String name; private String version; private List<String> list; } ``` 接着将其注册为 Bean 并启用配置加载功能: ```java @Configuration @EnableConfigurationProperties(AppConfig.class) public class Configurer {} ``` 此方法的优势是可以轻松管理复杂的嵌套数据结构并提供类型安全的支持[^1]。 --- #### 方法三:`Environment` 接口 Spring 的 `Environment` 接口提供了另一种灵活的方式来访问应用上下文中所有的属性值。无论是在开发阶段还是生产环境中都可以利用这一机制动态调整行为逻辑。比如要获取某个特定键对应的内容可以直接调用其相应的方法: ```java @Autowired private Environment environment; public void printProperty() { String value = environment.getProperty("my.property"); System.out.println(value); } ``` 相比其他两种方式而言,虽然灵活性更高但也稍微显得不够直观简洁一些。 --- #### 方法四:`@PropertySource` 自定义资源位置 如果项目中有额外的需求需要用到外部自定义 `.properties` 文件而不是默认路径下提供的那些,则可通过声明 `@PropertySource` 来引入新的资源配置源。注意此时还需要配合 `@ComponentScan` 扫描包以及确保正确设置编码格式防止乱码等问题发生。 假设有这样一个名为 `custom-config.properties` 的文件位于项目的根目录之外的地方,并且里面包含了这样的条目: ```properties external.config=value-from-external-source ``` 那么我们就可以按照下面的样子编写代码去加载这个特殊的配置文档了: ```java @Configuration @PropertySource("file:/path/to/custom-config.properties") public class ExternalConfig { @Autowired private Environment env; public void displayExternalConfig() { System.out.println(env.getProperty("external.config")); } } ``` 这里需要注意的是,对于相对路径来说可能需要考虑不同操作系统之间的差异性;而对于绝对路径则可能会带来部署上的不便之处[^3]。 --- ### 总结表格对比 | **特性/方法** | **@Value** | **@ConfigurationProperties** | **Environment** | **@PropertySource** | |-----------------------|--------------------------|----------------------------------|---------------------------|------------------------------| | **适用范围** | 单独属性 | 复杂对象 | 动态运行期 | 非标准位置 | | **优点** | 实现简单 | 支持复杂数据 | 灵活 | 可导入外部文件 | | **局限性** | 不支持复杂结构 | 需要显式开启 | 较繁琐 | 路径依赖可能导致移植困难 | ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值