Spring Value：让属性注入更便捷

一、@Value注解

Spring Value是一个非常有用的注解，它可以为Bean的属性赋值，相当于Spring的IoC容器属性注入机制的一种补充。通过@Value注解，我们可以在运行时注入属性值，而无需通过构造函数或setter方法手动设置。

在使用@Value注解时，我们可以使用SpEL表达式，例如：

    
    public class User {
        @Value("#{new java.text.SimpleDateFormat('yyyy-MM-dd').parse('2022-12-31')}")
        private Date birthday;
        
        @Value("${user.name}")
        private String name;
        
        //getter、setter略
    }
    

上述代码中，birthday属性通过SpEL表达式指定为2022年12月31日，而name属性则从配置文件中获取。其中SpEL表达式必须使用#{ … }包裹，而$ { … }则用于从配置文件读取属性值。

二、@Value使用场景

具有什么样的场景使用@Value呢？我们整理了以下几种情况：

1、注入配置文件中的属性

我们可以使用@Value注入配置文件中的属性值。例如，我们在application.properties文件中定义了一个key-value键值对：

    
    user.name=Tom
    

那么，我们就可以在Bean中使用@Value注解获取相应的属性值：

    
    public class User {
        @Value("${user.name}")
        private String name;
        
        //getter、setter略
    }
    

2、注入内置属性

Spring提供了一些内置属性，我们可以使用@Value注入这些属性。例如：

    
    public class User {
        @Value("#{systemProperties['user.name']}")
        private String username;
        
        //getter、setter略
    }
    

上述代码使用SpEL表达式注入系统属性中的用户名。同样的，我们可以注入系统环境变量、JVM环境变量、系统时间等内置属性。

3、注入通过方法或构造函数获得的值

有时我们需要通过方法或构造函数来获取某些值，然后再把这些值注入到Bean中的属性中。这时候，我们可以使用@Value注解，例如：

    
    public class User {
        private int age;
        
        public void setAge(@Value("20") int age) {
            this.age = age;
        }
        
        //getter略
    }
    

上述代码中，我们通过方法获得一个年龄值，然后使用@Value注解将其注入到Bean的age属性中。

三、@Value的属性配置

@Value注解还支持一些属性配置。具体包括以下几种：

1、required属性

required属性表示该属性是否必须被设置。默认值为true，如果required属性设置为true并且没有设置值，那么Spring会抛出IllegalStateException异常。例如：

    
    public class User {
        @Value("${user.name}")
        private String name; //required属性默认为true
        
        //getter、setter略
    }
    

2、defaultValue属性

defaultValue属性表示该属性的默认值。如果属性没有被配置，且defaultValue属性有值，那么该值会被设置为属性的默认值。例如：

    
    public class User {
        @Value("${user.nickname:Tom}")
        private String nickname;
        
        //getter、setter略
    }
    

上述代码中，如果配置文件中没有user.nickname属性，那么nickname属性的值会设置为Tom。

3、value属性

value属性表示要注入的属性值。如果要注入的值不是SpEL表达式，或者表达式很简单，那么我们可以直接使用value属性。例如：

    
    public class User {
        @Value("13312345678")
        private String phone;
        
        //getter、setter略
    }
    

上述代码中，我们指定了要注入的属性值为13312345678。

四、总结

Spring Value是一个非常实用的注解，它可以帮助我们在运行时注入属性值，不仅让属性注入更方便，同时也使我们的代码更加简洁。在使用@Value注解时，我们需要注意必要的属性配置，比如required属性和defaultValue属性，以确保注入的属性值符合我们的预期。