📣前言

  在Spring框架的丰富注解中，@Value以其独特的注入方式，为配置属性的注入提供了极大的灵活性。它允许开发者直接将字面量、外部配置或表达式注入到Bean的字段中。本文将深入探讨@Value注解的高级应用策略，帮助Java开发者更好地利用这一特性。

  那么，具体如何实现呢？这将又会是干货满满的一期，全程无尿点不废话只抓重点教，具有非常好的学习效果，拿好小板凳准备就坐！希望学习的过程中大家认真听好好学，学习的途中有任何不清楚或疑问的地方皆可评论区留言或私信，bug菌将第一时间给予解惑，那么废话不多说，直接开整！Fighting！！

🌊环境说明

开发工具：IDEA 2021.3
JDK版本： JDK 1.8
Spring Boot版本：2.3.1 RELEASE
Maven版本：3.8.2

🏆本文收录于《Spring Boot从入门到精通》，专门攻坚指数提升，2023 年国内最系统+最强（更新中）。

本专栏致力打造最硬核 Spring Boot 从零基础到进阶系列学习内容，🚀均为全网独家首发，打造精品专栏，专栏持续更新中…欢迎大家订阅持续学习。 如果想快速定位学习，可以看这篇【SpringBoot教程导航帖】,你想学习的都被收集在内，快速投入学习！！两不误。

🌊摘要

  本文详细介绍了Spring框架中的@Value注解，包括其基本用法、表达式支持、与Spring Environment的结合使用、源码解析、案例分析、优缺点分析，以及如何编写测试用例。通过实际代码示例，引导读者深入理解@Value注解的强大功能。

🌊正文

搭建Spring Boot应用

  首先，我们先创建个基础的Spring Boot项目，如果还不会点这里，此处就不详细赘述啦。

简介

  @Value注解是Spring提供的一种注入机制，它支持注入字面量、外部配置属性以及SpEL（Spring Expression Language）表达式的结果。这使得配置注入既灵活又强大。

源码解析

@Value注解的定义如下：

@Target({ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER, ElementType.ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Value {
    String value();
}

• @Target: 指定@Value注解可以应用于字段、方法、构造函数参数和注解类型。
• @Retention(RetentionPolicy.RUNTIME): 指定注解在运行时有效，可以通过反射读取。
• @Documented: 表示注解会被包含在JavaDoc中。

  接着我将对上述代码进行详细的一个逐句解读，希望能够帮助到同学们，能以更快的速度对其知识点掌握学习，这也是我写此文的初衷，授人以鱼不如授人以渔，只有将其原理摸透，日后应对场景使用，才能得心应手，所以如果有基础的同学，可以略过如下代码分析步骤，然而没基础的同学，还是需要加强对代码的理解，方便你深入理解并掌握其常规使用。

@Value注解是Spring框架提供的一个功能强大的注解，用于将指定的值注入到Spring管理的Bean中。下面是对该注解定义的逐行分析：

@Target({ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER, ElementType.ANNOTATION_TYPE})

• @Target注解指定了@Value注解可以应用于哪些Java元素。在这个定义中，它被指定为可以应用于字段（ElementType.FIELD）、方法（ElementType.METHOD）、方法参数（ElementType.PARAMETER）以及注解类型（ElementType.ANNOTATION_TYPE）。这意味着@Value可以在字段声明、setter方法、构造函数参数或者甚至另一个注解的定义中使用。

@Retention(RetentionPolicy.RUNTIME)

• @Retention注解定义了@Value注解的保留策略。RetentionPolicy.RUNTIME表示这个注解在编译后的字节码中会被保留，因此可以在运行时通过反射读取注解的信息。这对于Spring容器在启动时解析和处理@Value注解是必要的。

@Documented

• @Documented是一个元注解，它指示@Value注解应该被包含在JavaDoc中。这有助于生成的文档包含这些注解的信息，从而提高代码的可读性和可维护性。

public @interface Value {
    String value();
}

• 这行代码声明了Value是一个注解类型。
• String value();定义了@Value注解中的一个属性value，它返回一个String类型的值。这个属性用于指定要注入的值，可以是常量字符串、外部配置属性的占位符（如${property-name}），或者SpEL表达式（如#{expression}）。

源码分析的意义

  通过理解@Value注解的源码，我们可以知道：

• @Value注解非常灵活，可以应用于多种不同的元素。
• 由于具有运行时保留策略，Spring容器可以在启动时通过反射来处理这些注解。
• @Value注解的value属性是核心，它定义了要注入的具体值或值的来源。

实际使用示例

  通常在使用@Value注解时，我们会这样使用：

@Component
public class MyBean {
    @Value("${my.config.value}")
    private String configValue;

    @Value("default value")
    private String defaultValue;

    @Value("#{systemProperties['user.home']}")
    private String userHome;
    
    // 标准的getter和setter方法
}

  在这个示例中，MyBean类中的字段使用@Value注解来注入不同类型的值。第一个字段configValue从配置文件中注入值，第二个字段defaultValue注入了一个常量字符串，第三个字段userHome注入了系统属性的值。

  并附上部分相关注解源码截图，这里我就简单给附上，感兴趣的同学可以扒扒源码，深入去学习下开源框架的设计构思及理念，这也是掌握一个架构的核心目标，但是基础一般或者零基础的同学，建议先从使用上深入，而不是一口吃掉一个胖子，得不偿失。

  实际运用场景展示如下，这也是我日常项目开发中的实操之一，分享给大家看看，仅供参考：

案例分析

  考虑以下使用@Value注解的类：

@Component
public class MyComponent {
    @Value("${my.property}")
    private String myProperty;

    @Value("default value")
    private String defaultValue;

    @Value("#{systemProperties['user.home']}")
    private String userHome;
    
    // 标准的getter和setter方法
}

  在这个例子中，@Value用于注入不同类型的值：属性文件中的值、默认字符串值和系统属性。

  接着我将对上述代码进行详细的一个逐句解读，希望能够帮助到同学们，能以更快的速度对其知识点掌握学习，这也是我写此文的初衷，授人以鱼不如授人以渔，只有将其原理摸透，日后应对场景使用，才能得心应手，所以如果有基础的同学，可以略过如下代码分析步骤，然而没基础的同学，还是需要加强对代码的理解，方便你深入理解并掌握其常规使用。

这段Java代码演示了如何在Spring框架中使用@Value注解来注入不同类型的值到MyComponent类的字段中。以下是对这段代码的详细解析：

类定义和注解

• @Component: 这个注解表明MyComponent是一个Spring组件，Spring容器应该自动检测并注册这个类为一个Bean。

字段和@Value注解

1. @Value("${my.property}"): 这个注解用于从配置文件（如application.properties或application.yml）中注入名为my.property的属性值到myProperty字段。

2. @Value("default value"): 这个注解直接将字符串"default value"注入到defaultValue字段。这是一种硬编码的方式，不依赖外部配置。

3. @Value("#{systemProperties['user.home']}"): 这个注解使用了SpEL（Spring Expression Language）来注入Java系统属性user.home的值到userHome字段。

配置属性注入

  在application.properties文件中，可以定义如下属性：

my.property=some-value

  Spring容器在启动时会查找这个属性，并将其值注入到myProperty字段。

SpEL表达式

• #{systemProperties['user.home']}: 这是一个SpEL表达式，它访问了系统属性user.home。SpEL是Spring提供的一种强大的表达式语言，可以在运行时计算和注入复杂的值。

标准Getter和Setter方法

• 这个类应该为每个私有字段提供公共的getter和setter方法。这些方法允许其他Bean访问和修改字段的值，并且使得这个类的对象可以在需要时通过依赖注入被其他组件使用。

示例代码扩展

public class MyComponent {
    private String myProperty;
    private String defaultValue;
    private String userHome;

    public MyComponent() {
        // 构造函数
    }

    public String getMyProperty() {
        return myProperty;
    }

    public void setMyProperty(String myProperty) {
        this.myProperty = myProperty;
    }

    public String getDefaultValue() {
        return defaultValue;
    }

    public void setDefaultValue(String defaultValue) {
        this.defaultValue = defaultValue;
    }

    public String getUserHome() {
        return userHome;
    }

    public void setUserHome(String userHome) {
        this.userHome = userHome;
    }
}

注意事项

• 确保配置属性的名称和字段名称匹配，Spring将根据字段名称的驼峰式大小写来确定配置项的名称。
• 字面量值和SpEL表达式可以直接在@Value注解中指定，而不需要在配置文件中定义。
• 使用SpEL表达式时，需要确保表达式中的上下文变量（如systemProperties）是可用的。

  通过上述解析，我们可以看到@Value注解如何简化配置属性的注入过程，使得配置管理变得更加灵活和强大。

应用场景案例列举

@Value注解通常应用于以下场景：

• 属性注入：从属性文件注入配置值。
• 硬编码值：直接注入常量或硬编码的值。
• 系统属性：注入系统环境变量或Java系统属性。
• SpEL表达式：执行SpEL表达式并注入结果。

优缺点分析

使用@Value注解的优点包括：

• 灵活性：支持多种类型的值注入。
• 解耦：减少代码与配置的耦合。

缺点可能包括：

• 复杂性：过度使用可能导致配置管理复杂化。
• 性能考虑：SpEL表达式可能会影响性能。

类代码方法介绍

  使用@Value注解的类通常包含标准的JavaBean属性，以及对应的getters和setters。

测试用例

  编写测试用例以验证@Value注解的正确性：

public class MyComponentTest {
    
    public static void main(String[] args) {
        // 创建测试的配置属性源
        Map<String, Object> properties = new HashMap<>();
        properties.put("my.property", "testValue");
        properties.put("user.home", "/home/testUser");

        // 模拟Environment
        Environment environment = mock(Environment.class);
        when(environment.containsProperty("my.property")).thenReturn(true);
        when(environment.getProperty("my.property")).thenReturn("testValue");
        when(environment.getProperty("user.home")).thenReturn("/home/testUser");

        // 创建MyComponent实例并注入配置
        MyComponent myComponent = new MyComponent();
        new DefaultValueAnnotationBeanPostProcessor(environment).postProcessBeforeInstantiation(MyComponent.class, "myComponent");
        
        // 断言或其他验证逻辑
        assertEquals("testValue", myComponent.getMyProperty());
        assertEquals("/home/testUser", myComponent.getUserHome());
    }
}

  接着我将对上述代码进行详细的一个逐句解读，希望能够帮助到同学们，能以更快的速度对其知识点掌握学习，这也是我写此文的初衷，授人以鱼不如授人以渔，只有将其原理摸透，日后应对场景使用，才能得心应手，所以如果有基础的同学，可以略过如下代码分析步骤，然而没基础的同学，还是需要加强对代码的理解，方便你深入理解并掌握其常规使用。

  这段Java代码是一个使用JUnit和Mockito编写的测试用例，用于验证MyComponent类是否能够正确地通过@Value注解注入配置属性。以下是对这段代码的详细解析：

测试类定义

• public class MyComponentTest: 定义了一个名为MyComponentTest的测试类。

主函数

• public static void main(String[] args): Java程序的入口点，这里用作执行测试。

配置属性源创建

• Map<String, Object> properties = new HashMap<>();: 创建了一个HashMap来模拟配置属性源。

• properties.put("my.property", "testValue"); 和 properties.put("user.home", "/home/testUser");: 向属性源中添加模拟的配置项。

模拟Environment

• Environment environment = mock(Environment.class);: 使用Mockito库模拟Environment对象，以便在测试中控制配置属性的获取。

• when(environment.containsProperty("my.property")).thenReturn(true);: 预设Environment的containsProperty方法在询问my.property属性时返回true。

• when(environment.getProperty("my.property")).thenReturn("testValue"); 和 when(environment.getProperty("user.home")).thenReturn("/home/testUser");: 预设Environment的getProperty方法在获取属性时返回设定的值。

创建MyComponent实例并注入配置

• MyComponent myComponent = new MyComponent();: 创建了MyComponent类的实例。

• new DefaultValueAnnotationBeanPostProcessor(environment).postProcessBeforeInstantiation(MyComponent.class, "myComponent");: 使用DefaultValueAnnotationBeanPostProcessor来处理@Value注解的注入。这是Spring内部用于处理@Value注解的处理器。

断言验证

• assertEquals("testValue", myComponent.getMyProperty()); 和 assertEquals("/home/testUser", myComponent.getUserHome());: 使用JUnit的assertEquals方法验证MyComponent实例的属性是否符合预期值。

注意事项

• 测试中使用了Mockito库来模拟Environment对象，这是Spring测试中常用的技术，用于隔离测试环境和实际的Spring环境。

• 测试用例中直接调用了DefaultValueAnnotationBeanPostProcessor处理器，这通常是Spring容器自动完成的，但在这里为了测试目的，我们手动触发了这一过程。

• 测试用例中缺少了import语句和Mockito的设置，实际使用时需要导入相应的类和Mockito库。

• 测试方法应该独立于其他测试，不依赖于外部状态或数据库。

示例代码扩展

  在实际的测试中，我们可能会使用Spring的AnnotationConfigApplicationContext来创建一个测试的Spring应用上下文，并注册MyComponent Bean：

@Test
public void testMyComponent() {
    // ... 省略上述代码 ...

   AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext();
   context.register(MyComponent.class);
   context.setEnvironment(environment); // 设置模拟的Environment
   context.refresh(); // 初始化Spring应用上下文和Bean

   MyComponent myComponent = context.getBean(MyComponent.class);
   
   // 断言或其他验证逻辑
   // ... 省略上述代码 ...
}

  这个扩展示例展示了如何在测试中使用Spring的应用上下文来自动绑定配置属性，而不是手动设置属性值。这更接近于实际应用程序中@Value注解的行为。

小结

  本文的探讨和实践示例为读者提供了一个全面的视角，帮助大家深入理解并有效利用@Value注解。我们认识到了@Value注解在简化配置管理、提高开发效率方面的优势，同时也意识到了潜在的风险和挑战。通过测试用例的编写，我们确保了配置的正确性和应用的稳定性。

  随着技术的不断演进，@Value注解将继续作为Spring生态中不可或缺的一部分，助力开发者构建更加健壮、灵活和易于维护的应用程序。让我们持续关注和学习，掌握更多高效工具和最佳实践，共同推动软件行业的发展。

总结

  在深入探索Spring框架的@Value注解之后，我们发现它是一个功能强大且灵活的工具，用于简化配置属性的注入过程。@Value注解允许开发者以多种方式注入值，包括外部配置、字面量、系统属性，甚至是SpEL表达式。这种灵活性在提高配置管理效率的同时，也增加了代码的可读性和可维护性。

  通过实际案例分析，我们看到了如何将@Value注解应用于不同类型的字段注入。我们学习了如何从配置文件中注入属性，如何使用SpEL表达式动态计算值，以及如何通过模拟Environment来测试配置注入的正确性。这些知识点不仅加深了我们对@Value注解的理解，也提高了我们在实际开发中应用Spring框架的能力。

  此外，我们还讨论了@Value注解的优缺点。它的优点在于提供了一种声明式的配置注入方法，减少了硬编码，使得配置更加灵活和可维护。然而，过度依赖@Value注解可能会使配置管理变得复杂，且SpEL表达式的使用可能会影响应用的性能。因此，合理使用@Value注解，避免过度复杂化配置，是每个开发者应该考虑的。

  本文的探讨和分析旨在提供一个全面的视角，帮助开发者深入理解并有效利用@Value注解。希望每位读者都能从中获得有价值的信息和启发，将这些知识应用到实际开发中，不断提升自己的技术水平和专业能力。

… …

  ok，以上就是我这期的全部内容啦，若想学习更多，你可以持续关注我，我会把这个多线程篇系统性的更新，保证每篇都是实打实的项目实战经验所撰。只要你每天学习一个奇淫小知识，日积月累下去，你一定能成为别人眼中的大佬的！功不唐捐，久久为功！

「赠人玫瑰，手留余香」，咱们下期拜拜~~

🌊热文推荐

滴~如下推荐【Spring Boot 进阶篇】的学习大纲，请小伙伴们注意查收。

Spring Boot进阶(01)：使用Spring Boot和Redis轻松实现高性能、高可用的缓存服务。

Spring Boot进阶(02)：防止程序员疯狂 Debug：快速掌握 Validation 参数校验技巧，让你的代码健康起来！

Spring Boot进阶(03)：【实战教程】MyBatis-Plus秒级实现字段自动填充，让你的代码更优雅！

Spring Boot进阶(04)：震惊！使用MyBatis-Plus，快速实现自定义SQL分页功能！

Spring Boot进阶(05)：Spring Boot与RabbitMQ完美融合，打造高效消息队列服务！

Spring Boot进阶(06)：【超详细】Windows10搭建RabbitMQ Server服务端，让你轻松实现消息队列管理！

Spring Boot进阶(07)：如何使用EasyPoi实现Java中Excel的导入导出？完整教程请收藏，让你的Excel操作更高效！

Spring Boot进阶(08)：使用EasyPoi实现Excel/Word携带图片导出，打造精美的报表

Spring Boot进阶(09)：用EasyPoi实现Excel多sheet导入导出，轻松管理海量数据！

Spring Boot进阶(10)：「从Excel到PDF，EasyPoi助你一键完美转换！」

Spring Boot进阶(11)：实现纯文本转成.csv格式文件，Spring Boot轻松搞定！附完整代码

Spring Boot进阶(12)：如何快速获取Excel文件中的Sheet页数量？Spring Boot教程带你一步步实现

Spring Boot进阶(13)：如何优雅获取@ApiModelProperty(value = “序列号“, name = “uuid“)中的value值，附源码

Spring Boot进阶(14)：Spring Boot高级应用：手把手教你连接数据库并获取指定表结构！一文教会你

Spring Boot进阶(15)：用Spring Boot实现动态数据库分页查询表结构信息！

Spring Boot进阶(16)：使用Redis实现手机验证码功能，让你的用户注册更加便捷！

Spring Boot进阶(17)：Swagger2高级配置：定制header请求头等参数

Spring Boot进阶(18)：轻松管理定时任务！Spring Boot@Scheduled让你事半功倍

Spring Boot进阶(19)：探索ElasticSearch：如何利用Spring Boot轻松实现高效数据搜索与分析

Spring Boot进阶(20)：「打造高性能Web应用」——使用Jetty容器配置Spring Boot

Spring Boot进阶(21)：优化Spring Boot应用性能，使用Undertow容器提升响应速度

Spring Boot进阶(22)：决战容器之巅：Tomcat vs Undertow！性能对比分析揭秘最佳选择！

Spring Boot进阶(23)：终极解决方案！教你实现高效文件上传！

Spring Boot进阶(24)：秒传！快速实现高效多文件上传的最佳解决方案

Spring Boot进阶(25)：如何写出高效的文件上传单元测试？让你的测试更智能更高效！

Spring Boot进阶(26)：从小白到高手，掌握Mybatis中resultType和resultMap的秘密！

Spring Boot进阶(27)：Spring Boot进阶(27)：Kafka大显身手，快速构建消息驱动应用！(环境搭建+演示)

Spring Boot进阶(28)：如何让Spring Boot应用在Linux中以后台服务方式启动，并实现滚动日志查看及保存至实体文件？

Spring Boot进阶(29)：如何正确使用Spring Boot注解@PathVariable、@RequestParam和@RequestBody: Postman演示教程

Spring Boot进阶(30)：@RestController与@Controller的区别及使用场景详解，附带精彩实战演示

… …

  若想系统性的从0到1的入门进阶学习，可以参考这篇专栏总结《2024最新首发，全网最全 Spring Boot 学习宝典(附思维导图)》，本专栏致力打造全网最硬核 Spring Boot 学习及进阶SpringBoot 系列教学内容，🚀均为全网独家首发，致力打造精品硬核干货，专栏永持续更新。欢迎大家订阅学习。一分耕耘一份收获！

  如果想快速定位学习，可以看这篇【一站式教程导航】,你想学习的都被收录系统整理在内，以最快的速度投入并学习掌握！！你值得拥有。

  在入门及进阶之途，我必助你一臂之力，系统性学习，从入门到精通，带你不走弯路，直奔终点！投资自己，性价比永远最高，都这么说了，你还不赶紧来白嫖？？

  本文涉及所有源代码，均已上传至GitHub开源，供同学们一对一参考 GitHub传送门，同时，原创开源不易，欢迎给个star🌟，想体验下被🌟的感jio，非常感谢❗

📣文末

我是bug菌，CSDN | 掘金 | InfoQ | 51CTO | 华为云 | 阿里云 | 腾讯云 等社区博客专家，C站博客之星Top30，华为云2023年度十佳博主，掘金多年度人气作者Top40，掘金等各大社区签约作者，51CTO年度博主Top12，掘金/InfoQ/51CTO等社区优质创作者；全网粉丝合计 30w+；硬核微信公众号「猿圈奇妙屋」，欢迎你的加入！免费白嫖最新BAT互联网公司面试真题、4000G PDF电子书籍、简历模板等海量资料，你想要的我都有，关键是你不来拿哇。