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

從@Value注解的源碼中可以看出，@Value注解可以標(biāo)注在字段、方法、參數(shù)以及注解上，而且在程序運(yùn)行期間生效

2.@Value注解的用法

2.1.不通過(guò)配置文件注入屬性的情況

通過(guò)@Value注解將外部的值動(dòng)態(tài)注入到bean的屬性中，一般有如下這幾種情況

注入普通字符串

@Value("liqb")
private String name; // 注入普通字符串

注入操作系統(tǒng)屬性

@Value("#{systemProperties['os.name']}")
private String systemPropertiesName; // 注入操作系統(tǒng)屬性

注入SpEL表達(dá)式結(jié)果

@Value("#{ T(java.lang.Math).random() * 100.0 }")
private double randomNumber; //注入SpEL表達(dá)式結(jié)果

注入其他bean中屬性的值

@Value("#{person.name}")
private String username; // 注入其他bean中屬性的值，即注入person對(duì)象的name屬性中的值

注入文件資源

@Value("classpath:/config.properties")
private Resource resourceFile; // 注入文件資源

注入U(xiǎn)RL資源

@Value("http://www.baidu.com")
private Resource url; // 注入U(xiǎn)RL資源

2.2.通過(guò)配置文件注入屬性的情況

在項(xiàng)目的src/main/resources目錄下新建一個(gè)屬性文件，例如person.properties，其內(nèi)容如下：

person.nickName=liqb

新建MainConfigOfPropertyValues配置類，在該類上使用@PropertySource注解讀取外部配置文件中的key/value并保存到運(yùn)行的環(huán)境變量中

package com.tianxia.springannotation.config;

import com.tianxia.springannotation.entity.Person;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;

/**
 * 配置類
 * @author liqb
 * @date 2023-05-04 11:28
 **/
@Configuration
@PropertySource(value={"classpath:/person.properties"})
public class MainConfigOfPropertyValues {

    @Bean
    public Person person() {
        return new Person();
    }
}

加載完外部的配置文件以后，就可以使用${key}取出配置文件中key所對(duì)應(yīng)的值，并將其注入到bean的屬性中了

package com.tianxia.springannotation.entity;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.springframework.beans.factory.annotation.Value;

import java.io.Serializable;

/**
 * Person類
 * @author liqb
 * @date 2023-04-21 16:00
 **/
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Person implements Serializable {

    /**
     * 姓名
     */
    private String name;

    /**
     * 年齡
     */
    private Integer age;

    /**
     * 昵稱
     */
    @Value("${person.nickName}")
    private String nickName;

    public Person(String name, Integer age) {
        this.name = name;
        this.age = age;
    }
}

2.3.@Value中#{···}和${···}的區(qū)別

提供一個(gè)測(cè)試屬性文件，advance_value_inject.properties，內(nèi)容如下所示

server.name=server1,server2,server3
author.name=liqb

新建AdvanceValueInject類，并在該類上使用@PropertySource注解讀取外部屬性文件中的key/value并保存到運(yùn)行的環(huán)境變量中，即加載外部的advance_value_inject.properties屬性文件。

package com.tianxia.springannotation.config;

import com.tianxia.springannotation.entity.Person;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;

/**
 * 配置類
 * @author liqb
 * @date 2023-05-04 11:28
 **/
@Configuration
@PropertySource(value={"classpath:/person.properties"})
public class MainConfigOfPropertyValues {

    @Bean
    public Person person() {
        return new Person();
    }
}

2.3.1.${···}的用法

{}里面的內(nèi)容必須符合SpEL表達(dá)式，通過(guò)@Value(“${spelDefault.value}”)我們可以獲取屬性文件中對(duì)應(yīng)的值，但是如果屬性文件中沒(méi)有這個(gè)屬性，那么就會(huì)報(bào)錯(cuò)。不過(guò)，我們可以通過(guò)賦予默認(rèn)值來(lái)解決這個(gè)問(wèn)題，如下所示。

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

表示向bean的屬性中注入屬性文件中的author.name屬性所對(duì)應(yīng)的值，如果屬性文件中沒(méi)有author.name這個(gè)屬性，那么便向bean的屬性中注入默認(rèn)值liqb。

2.3.2.#{···}的用法

{}里面的內(nèi)容同樣也是必須符合SpEL表達(dá)式。例如，

// SpEL：調(diào)用字符串Hello World的concat方法
@Value("#{'Hello World'.concat('!')}")
private String helloWorld;

// SpEL：調(diào)用字符串的getBytes方法，然后再調(diào)用其length屬性
@Value("#{'Hello World'.bytes.length}")
private String helloWorldBytes;

2.3.3.${···}和#{···}的混合使用

${···}和#{···}可以混合使用，例如：

// SpEL：傳入一個(gè)字符串，根據(jù)","切分后插入列表中， #{}和${}配合使用時(shí)，注意不能反過(guò)來(lái)${}在外面，而#{}在里面
@Value("#{'${server.name}'.split(',')}")
private List<String> severs;

上面片段的代碼的執(zhí)行順序：通過(guò)**${server.name}從屬性文件中獲取值并進(jìn)行替換，然后就變成了執(zhí)行SpEL表達(dá)式{‘server1,server2,server3’.split(‘,’)}**。