深度解析@Value注解，深度你真的解析解彻底了解过吗？

作者：冰河 2023-05-29 08:11:42开发 架构 进一步学习并掌握@Value注解向Bean中注入值的案例和流程，从源码级别彻底掌握@Value注解在Spring底层的彻底解执行流程。

一、深度学习指引

Spring中的解析解@Value注解，你真的彻底解彻底了解过吗？

在实际开发过程中，通常会有这样一种场景：将一些配置项写到配置文件中，深度在业务逻辑中会读取配置文件中的解析解配置项，取出对应的彻底解值进行业务逻辑处理。Spring中提供的深度@Value注解就可以读取配置文件中的值。另外@Value注解也可以向Bean中的解析解属性设置其他值。本章，彻底解就对@Value注解进行简单的深度介绍。

二、解析解注解说明

关于@Value注解的彻底解一点点说明~~

@Value注解可以向Spring的Bean的属性中注入数据。并且支持Spring的EL表达式，可以通过${ } 的方式获取配置文件中的数据。配置文件支持properties、XML、和YML文件。

1、注解源码

@Value注解的源码详见：org.springframework.beans.factory.annotation.Value。

/** * @author Juergen Hoeller * @since 3.0 * @see AutowiredAnnotationBeanPostProcessor * @see Autowired * @see org.springframework.beans.factory.config.BeanExpressionResolver * @see org.springframework.beans.factory.support.AutowireCandidateResolver#getSuggestedValue */@Target({ ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER, ElementType.ANNOTATION_TYPE})@Retention(RetentionPolicy.RUNTIME)@Documentedpublic @interface Value {  String value();}

从源码可以看出，@Value注解可以标注到字段、方法、参数和其他注解上，@Value注解中提供了一个String类型的value属性，具体含义如下所示。

• value：指定要向Bean的属性中注入的数据，数据可以是配置文件中的配置项，并且支持EL表达式。

2、使用场景

在实际开发中，项目中难免会有一些配置信息，此时，就可以将这些配置信息统一写到配置文件中。随后使用@Value注解读取配置文件的值来向Spring中Bean的属性设置值。

例如，一些系统环境变量信息，数据库配置，系统通用配置等等，都可以保存到配置文件中，此时就可以使用Spring的EL表达式读取配置文件中的值。

3、用法

本节，主要介绍不通过配置文件注入属性和通过配置文件注入属性两种情况来介绍@Value注解的用法。

不通过配置文件注入属性

通过@Value可以将外部的值动态注入到Bean中，有如下几种用法。

（1）注入普通字符串。

@Value("normalString")private String normalString;

（2）注入操作系统属性。

@Value("#{ systemProperties['os.name']}")private String osName;

（3）注入表达式的结果信息。

@Value("#{  T(java.lang.Math).random() * 100.0 }")private double randomNum;

（4）注入其他Bean属性。

@Value("#{ otherBean.name}")private String name;

（5）注入文件资源。

@Value("classpath:config.properties")private Resource resourceFile;

（6）注入URL资源。

@Value("http://www.baidu.com")private Resource url;

通过配置文件注入属性

通过@Value(“${ app.name}”)语法将属性文件的值注入到bean的属性中，

@Component@PropertySource({ "classpath:config.properties","classpath:config_${ anotherfile.configinject}.properties"})public class ConfigurationFileInject{     @Value("${ user.id}")    private String userId;     @Value("${ user.name}")    private String userName;     @Value("${ user.address}")    private String userAddress; }

@Value中#{ ...}和${ ...}的区别

这里提供一个测试属性文件：test.properties，大致的内容如下所示。

server.name=server1,server2,server3author.name=binghe

测试类Test：引入test.properties文件，作为属性的注入。

@Component@PropertySource({ "classpath:test.properties"})public class Test { }

${ ...}的用法

{ }里面的内容必须符合SpEL表达式， 通过@Value(“${ spelDefault.value}”)可以获取属性文件中对应的值，但是如果属性文件中没有这个属性，则会报错。可以通过赋予默认值解决这个问题，如下所示。

@Value("${ author.name:binghe}")

上述代码的含义表示向Bean的属性中注入配置文件中的author.name属性的值，如果配置文件中没有author.name属性，则向Bean的属性中注入默认值binghe。例如下面的代码片段。

@Value("${ author.name:binghe}")private String name;

#{ …}的用法

（1）SpEL：调用字符串Hello World的concat方法

@Value("#{ 'Hello World'.concat('!')}")private String helloWorld;

（2）SpEL: 调用字符串的getBytes方法，然后调用length属性

@Value("#{ 'Hello World'.bytes.length}")private int length;

${ …}和#{ …}混合使用

${ ...}和#{ ...}可以混合使用，如下文代码执行顺序：传入一个字符串，根据 "," 切分后插入列表中， #{ }和${ }配合使用，注意单引号。

@Value("#{ '${ server.name}'.split(',')}")private List<String> servers;

注意：${ }和#{ }混合实用时，不能${ }在外面，#{ }在里面。因为Spring执行${ }的时机要早于#{ }，当Spring执行外层的${ }时，内部的#{ }为空，会执行失败。

@Value注解用法总结

• #{ …} 用于执行SpEl表达式，并将内容赋值给属性。
• ${ …} 主要用于加载外部属性文件中的值。
• #{ …} 和${ …} 可以混合使用，但是必须#{ }外面，${ }在里面。

三、使用案例

@Value的实现案例，我们一起实现吧~~

本节，就基于@Value注解实现向Bean属性中赋值的案例，具体的实现步骤如下所示。

1、新增test.properties配置文件

在spring-annotation-chapter-11工程下的resources目录下新增test.properties配置文件，内容如下所示。

db.url=jdbc:mysql://localhost:3306/test

2、新增ValueName类

ValueName类的源码详见：spring-annotation-chapter-11工程下的io.binghe.spring.annotation.chapter11.bean.ValueName。

@Componentpublic class ValueName {     private String name;    public ValueName() {         this.name = "binghe";    }    public String getName() {         return name;    }    public void setName(String name) {         this.name = name;    }}

可以看到，ValueName类上标注了@Component注解，说明当Spring的IOC容器启动时，会向IOC容器中注入ValueName类的Bean对象。

3、新增ValueConfig类

ValueConfig类的源码详见：spring-annotation-chapter-11工程下的io.binghe.spring.annotation.chapter11.config.ValueConfig。

@Configuration@ComponentScan(value = { "io.binghe.spring.annotation.chapter11"})@PropertySource(value = { "classpath:test.properties"})public class ValueConfig {     /**     * 注入普通字符串     */    @Value("normalString")    private String normalString;    /**     * 注入操作系统名称     */    @Value("#{ systemProperties['os.name']}")    private String osName;    /**     * 注入表达式的结果     */    @Value("#{  T(java.lang.Math).random() * 100.0 }")    private double randomNum;    /**     * 注入其他Bean的属性     */    @Value("#{ valueName.name}")    private String name;    /**     * 注入配置文件中的值     */    @Value("${ db.url}")    private String dbUrl;    @Override    public String toString() {         return "ValueConfig{ " +                "normalString='" + normalString + '\'' +                ", osName='" + osName + '\'' +                ", randomNum=" + randomNum +                ", name='" + name + '\'' +                ", dbUrl='" + dbUrl + '\'' +                '}';    }}

可以看到，在ValueConfig类上标注了@Configuration注解，说明ValueConfig类是Spring的配置类。使用@ComponentScan注解指定了扫描的包名是io.binghe.spring.annotation.chapter11。并且使用@PropertySource注解导入了test.properties配置文件。ValueConfig类的字段通过@Value注解注入对应的属性值，代码中有详细的注释，这里不再赘述。

4、新增ValueTest类

ValueTest类的源码详见：spring-annotation-chapter-11工程下的io.binghe.spring.annotation.chapter11.ValueTest。

public class ValueTest {     public static void main(String[] args) {         AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(ValueConfig.class);        ValueConfig valueConfig = context.getBean(ValueConfig.class);        System.out.println(valueConfig.toString());    }}

可以看到，ValueTest类是案例程序的测试类，实现的代码比较简单，这里不再赘述。

5、运行ValueTest类

运行ValueTest类的main()方法，输出的结果信息如下所示。

ValueConfig{ normalString='normalString', osName='Windows 10', randomNum=60.704013358598715, name='binghe', dbUrl='jdbc:mysql://localhost:3306/test'}

可以看到，在ValueTest类中的各个字段值都输出了正确的结果数据。

说明：使用@Value注解向Bean的属性中正确设置了值。

四、源码时序图

结合时序图理解源码会事半功倍，你觉得呢？

本节，就以源码时序图的方式，直观的感受下@Value注解在Spring源码层面的执行流程。本节，会从解析并获取 @Value 修饰的属性、为 @Value 修饰属性赋值和使用@Value获取属性值三个方面分析源码时序图。

注意：本节以单例Bean为例分析源码时序图，并且基于@Value注解标注到类的字段上的源码时序图为例进行分析，@Value注解标注到类的方法上的源码时序图与标注到字段上的源码时序图基本相同，不再赘述。

1、解析并获取@Value修饰的属性

本节，就简单介绍下解析并获取@Value修饰的属性的源码时序图，整体如图11-1~11-2所示。

由图11-1~11-2可以看出，解析并获取@Value修饰的属性的流程中涉及到ValueTest类、AnnotationConfigApplicationContext类、AbstractApplicationContext类、DefaultListableBeanFactory类、AbstractBeanFactory类、AbstractAutowireCapableBeanFactory类和AutowiredAnnotationBeanPostProcessor类。具体的源码执行细节参见源码解析部分。

2、为@Value修饰的属性赋值

本节，就简单介绍下为@Value修饰的属性赋值的源码时序图，整体如图11-3~11-4所示。

由图11-3~11-4所示，为@Value修饰的属性赋值流程涉及到ValueTest类、AnnotationConfigApplicationContext类、AbstractApplicationContext类、DefaultListableBeanFactory类、AbstractBeanFactory类、AbstractAutowireCapableBeanFactory类、AutowiredAnnotationBeanPostProcessor类、InjectionMetadata类和AutowiredFieldElement类。具体的源码执行细节参见源码解析部分。

3、使用@Value获取属性的值

本节，就简单介绍下使用@Value注解获取属性的值的源码时序图，整体如图11-5~11-7所示。

由图11-5~11-7所示，使用@Value获取属性的值的流程涉及到ValueTest类、AnnotationConfigApplicationContext类、AbstractApplicationContext类、DefaultListableBeanFactory类、AbstractBeanFactory类、AbstractAutowireCapableBeanFactory类、AutowiredAnnotationBeanPostProcessor类、InjectionMetadata类、AutowiredFieldElement类、AbstractEnvironment类、AbstractPropertyResolver类、PropertyPlaceholderHelper类和PropertySourcesPropertyResolver类。具体的源码执行细节参见源码解析部分。

五、源码解析

源码时序图整清楚了，那就整源码解析呗！

本节，主要分析@Value注解在Spring源码层面的执行流程，同样的，本节也会从解析并获取 @Value 修饰的属性、为 @Value 修饰属性赋值和使用@Value获取属性值三个方面分析源码执行流程，并且结合源码执行的时序图，会理解的更加深刻。

注意：本节以单例Bean为例分析，并且基于@Value注解标注到类的字段上的源码流程为例进行分析，@Value注解标注到类的方法上的源码流程与标注到字段上的源码流程基本相同，不再赘述。

1、解析并获取@Value修饰的属性

本节主要对解析并获取 @Value 修饰属性的源码流程进行简单的分析，结合源码执行的时序图，会理解的更加深刻，本节的源码执行流程可以结合图11-1~11-2进行理解。具体分析步骤如下所示。

注意：解析并获取 @Value 修饰属性源码流程的前半部分与第7章5.3节分析源码的流程相同，这里，从AbstractBeanFactory类的doGetBean()方法开始分析。

（1）解析AbstractBeanFactory类的doGetBean(String name, ClassrequiredType, Object[] args, boolean typeCheckOnly)方法

源码详见：org.springframework.beans.factory.support.AbstractBeanFactory#doGetBean(String name, ClassrequiredType, Object[] args, boolean typeCheckOnly)。重点关注如下代码片段。

protected <T> T doGetBean( String name, @Nullable Class<T> requiredType, @Nullable Object[] args, boolean typeCheckOnly) throws BeansException {  /
(责任编辑：休闲)