【spring】@PropertySource 注解学习

@PropertySource介绍

@PropertySource是Spring框架中的一个注解，主要用于Java配置类中，用于引入额外的属性文件，以便在Spring应用上下文中使用这些属性。

在Spring 3.1引入Java配置后，我们可以通过@Configuration注解的类和@Bean注解的方法来进行组件扫描和依赖注入配置。但是，对于一些外部化配置（如数据库连接信息、邮件服务器配置等），我们通常会放在properties或yml文件中，这时就可以使用@PropertySource来加载这些属性文件。

使用示例

@Configuration
@PropertySource("classpath:application.properties")
public class AppConfig {@Autowiredprivate Environment env;@Beanpublic DataSource dataSource() {DriverManagerDataSource dataSource = new DriverManagerDataSource();dataSource.setDriverClassName(env.getProperty("jdbc.driverClassName"));dataSource.setUrl(env.getProperty("jdbc.url"));dataSource.setUsername(env.getProperty("jdbc.username"));dataSource.setPassword(env.getProperty("jdbc.password"));return dataSource;}
}

@PropertySource源码

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Repeatable(PropertySources.class)
public @interface PropertySource {String name() default "";String[] value();boolean ignoreResourceNotFound() default false;String encoding() default "";Class<? extends PropertySourceFactory> factory() default PropertySourceFactory.class;
}

源代码截图

@PropertySource属性介绍

name：表示加载的资源的名称，如果为空，则会根据加载的配置文件自动生成一个名称。
value：表示加载的资源的路径，这个路径可以是类路径，也可以是文件路径。
ignoreResourceNotFound：表示当配置文件未找到时，是否忽略文件未找到的错误。默认值为false，也就是说当未找到配置文件时，Spring启动就会报错。
encoding：表示解析配置文件使用的字符集编码。
factory：表示读取对应配置文件的工厂类，默认的工厂类是PropertySourceFactory。

@PropertySource使用场景

配置文件的加载：在 Spring 应用程序中，通常需要加载一些配置文件，如数据库连接信息、服务器端口等。使用 @PropertySource 注解可以方便地加载这些配置文件，并将它们注入到 Spring 应用程序上下文中。
多环境配置：在开发和部署应用程序时，可能需要针对不同的环境（如开发环境、测试环境、生产环境等）进行不同的配置。使用 @PropertySource 注解可以方便地加载不同环境的配置文件，并根据环境变量或配置文件名来选择加载哪个配置文件。
动态配置：在某些情况下，可能需要在运行时动态地更改配置信息。使用 @PropertySource 注解可以方便地加载动态配置文件，并将它们注入到 Spring 应用程序上下文中。
属性文件的组织：在属性文件中，可能需要使用前缀来组织属性。使用 @PropertySource 注解的 prefix 属性可以指定属性文件中的前缀，以便在属性文件中使用前缀来组织属性。

@PropertySource测试示例代码

PropertySource配置类

package com.yang.SpringTest.annotation.propertySourceLearn;import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;/*** <p> PropertySource配置类</p>** @author By: chengxuyuanshitang* Package com.yang.SpringTest.annotation.propertySourceLearn* Ceate Time 2024-03-15 17:04*/
@Configuration
@PropertySource(value = "classpath:propertySourceDemo.properties")
public class PropertySourceConfig {}

propertySourceDemo.properties

who=chengxuyuanshitangdo=Learn spring

PropertySourceTest测试类

package com.yang.SpringTest.annotation.propertySourceLearn;import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.core.env.ConfigurableEnvironment;/*** <p>PropertySource测试类</p>** @author By: chengxuyuanshitang* Package com.yang.SpringTest.annotation.propertySourceLearn* Ceate Time 2024-03-15 17:07*/public class PropertySourceTest {public static void main(String[] args) {AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(PropertySourceConfig.class);ConfigurableEnvironment environment = context.getEnvironment();System.out.println("who is ? =: " + environment.getProperty("who"));System.out.println("do something ? = :" + environment.getProperty("do"));}
}