在使用Spring框架的项目中,@Value是使用比较频繁的注解之一,它的作用是将配置文件中key对应的值赋值给它标注的属性。在日常使用中我们常用的功能都比较简单,本篇文章系统的带大家来了解一下@Value的使用方法。
@Value注入支持形式
@Value属性注入功能根据注入的内容来源可分为两类:通过配置文件的属性注入和通过非配置文件的属性注入。
通过配置文件的注入根据配置文件的来源又可分为两类:一类为默认的Spring Boot会自动加载的配置文件application.properties中的属性;另一类为自定义配置文件中的属性,需要先通过@PropertySource加载。
而非配置文件注入的类型又分为:
- 注入普通字符串
- 注入操作系统属性
- 注入表达式结果
- 注入其他Bean属性
- 注入文件资源
- 注入URL资源
基于配置文件注入
首先来看数据来源自配置文件的注入,无论是会被默认加载的application.properties或自定义的my.properties文件。比如,application.properties中定义属性值的形式如下:
user.name=admin
在my.properties配置文件中定义的属性如下:
user.password=pwd123
那么,@Value在Bean中的使用形式为:
@PropertySource("classpath:my.properties")@RestControllerpublic class ValueController { /** * 获取位于application.properties中配置的属性 */ @Value("${user.name}") private String name; /** * 获取位于my.properties中的配置属性 */ @Value("${user.password}") private String password; }
不同的是,在Spring Boot项目中,如果是自定义的my.properties文件,需要在某个类中通过@PropertySource引入该配置文件,而application.properties中的属性会自动被加载。
同时,不仅仅可以通过@Value注入单个属性,还可以注入数组和列表形式。比如如下配置:
tools=car,train,airplane
可以通过以下方式注入:
/** * 注入数组(自动根据","分割) */ @Value("${tools}") private String[] toolArray; /** * 注入列表形式(自动根据","分割) */ @Value("${tools}") private List<String> toolList;
Spring默认情况下会以“,”进行分割,转换成对应的数组或列表。
基于非配置文件注入
在使用实例说明基于非配置文件注入属性的实例之前,我们先了解一下SpEL。
SpEL(Spring Expression Language)即Spring表达式语言,可以在运行时查询和操作数据。使用#{...}作为定界符, 所有在大括号中的字符都将被认为是 SpEL。
下面看具体实例场景的应用:
/** * 注入普通字符串,相当于直接给属性默认值 */ @Value("程序新视界") private String wechatSubscription; /** * 注入操作系统属性 */ @Value("#{systemProperties['os.name']}") private String systemPropertiesName; /** * 注入表达式结果 */ @Value("#{ T(java.lang.Math).random() * 100.0 }") private double randomNumber; /** * 注入其他Bean属性:注入config对象的属性tool */ @Value("#{config.tool}") private String tool; /** * 注入列表形式(自动根据"|"分割) */ @Value("#{'${words}'.split('\\|')}") private List<String> numList; /** * 注入文件资源 */ @Value("classpath:config.xml") private Resource resourceFile; /** * 注入URL资源 */ @Value("http://www.choupangxia.com") private URL homePage;
在上述示例分别展示了以下场景的使用:
- 直接注入字符串,相当于实例化时直接初始化字符串。
- 通过#{}注入系统属性。
- 通过#{}注入表达式结果。
- 通过#{}注入其他Bean的属性。
- 通过#{}和${}的组合注入属性并进行分割处理。
- 注入文件资源,将对应的字符串值转换成对应的资源文件。
- 注入URL资源,将对应的URL字符串转换成URL。
其中需要注意的是:
- Resource类为org.springframework.core.io.Resource。
- 二者结合使用时(#{'${}'}),注意单引号,注意不能反过来。
默认值注入
无论使用#{}或${}进行属性的注入,当无法获取对应值时需要设置默认值,可以采用如下方式来进行设置。
/** * 如果属性中未配置ip,则使用默认值 */ @Value("${ip:127.0.0.1}") private String ip; /** * 如果系统属性中未获取到port的值,则使用8888。 */ @Value("#{systemProperties['port']?:'8888'}") private String port;
其中${}中直接使用“:”对未定义或为空的值进行默认值设置,而#{}则需要使用“?:”对未设置的属性进行默认值设置。