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屬性，以確保注入的屬性值符合我們的預期。