微信公衆號:一個優秀的廢人。若有問題,請後臺留言,反正我也不會聽。前端
最近有跳槽的想法,因此故意複習了下 SpringBoot 的相關知識,複習得比較細。其中有些,我感受是之前忽略掉的東西,好比 @Value 和 @ConfigurationProperties 的區別 。java
定義兩個對象,一個學生對象,對應着一個老師對象,代碼以下:git
@Component
@ConfigurationProperties(prefix = "student") // 指定配置文件中的 student 屬性與這個 bean綁定
public class Student {
private String firstName;
private String lastName;
private Integer age;
private String gender;
private String city;
private Teacher teacher;
private List<String> hobbys;
private Map<String,Integer> scores;
//注意,爲了測試必須重寫 toString 和 get,set 方法
}
複製代碼
public class Teacher {
private String name;
private Integer age;
private String gender;
//注意,爲了測試必須重寫 toString 和 get,set 方法
}
複製代碼
@RunWith(SpringRunner.class)
@SpringBootTest
public class SpringbootValConproDemoApplicationTests {
@Autowired
private Student student;
@Test
public void contextLoads() {
// 這裏爲了方便,但工做中千萬不能用 System.out
System.out.println(student.toString());
}
}
複製代碼
Student{firstName='陳', lastName='一個優秀的廢人', age=24, gender='男', city='廣州', teacher=Teacher{name='eses', age=24, gender='女'}, hobbys=[籃球, 羽毛球, 兵兵球], scores={java=100, Python=99, C=99}}
複製代碼
@Value 支持三種取值方式,分別是 字面量、${key}從環境變量、配置文件中獲取值以及 #{SpEL}github
@Component
//@ConfigurationProperties(prefix = "student") // 指定配置文件中的 student 屬性與這個 bean綁定
public class Student {
/** * <bean class="Student"> * <property name="lastName" value="字面量/${key}從環境變量、配置文件中獲取值/#{SpEL}"></property> * <bean/> */
@Value("陳") // 字面量
private String firstName;
@Value("${student.lastName}") // 從環境變量、配置文件中獲取值
private String lastName;
@Value("#{12*2}") // #{SpEL}
private Integer age;
private String gender;
private String city;
private Teacher teacher;
private List<String> hobbys;
private Map<String,Integer> scores;
//注意,爲了測試必須重寫 toString 和 get,set 方法
}
複製代碼
Student{firstName='陳', lastName='一個優秀的廢人', age=24, gender='null', city='null', teacher=null, hobbys=null, scores=null}
複製代碼
兩者區別 | @ConfigurationProperties | @Value |
---|---|---|
功能 | 批量注入配置文件中的屬性 | 一個個指定 |
鬆散綁定(鬆散語法) | 支持 | 不支持 |
SpEL | 不支持 | 支持 |
JSR303數據校驗 | 支持 | 不支持 |
複雜類型封裝 | 支持 | 不支持 |
從上表能夠看見,@ConfigurationProperties 和 @Value 主要有 5 個不一樣,其中第一個功能上的不一樣,上面已經演示過。下面我來介紹下剩下的 4 個不一樣。算法
鬆散語法的意思就是一個屬性在配置文件中能夠有多個屬性名,舉個栗子:學生類當中的 firstName 屬性,在配置文件中能夠叫 firstName、first-name、first_name 以及 FIRST_NAME。 而 @ConfigurationProperties 是支持這種命名的,@Value 不支持。下面以 firstName 爲例,測試一下。以下代碼:spring
學生類的 firstName 屬性在 yml 文件中被定義爲 first_name:數據庫
student:
first_name: 陳 # 學生類的 firstName 屬性在 yml 文件中被定義爲 first_name
lastName: 一個優秀的廢人
age: 24
gender: 男
city: 廣州
teacher: {name: eses,age: 24,gender: 女}
hobbys: [籃球,羽毛球,兵兵球]
scores: {java: 100,Python: 99,C++: 99}
複製代碼
學生類:springboot
@Component
@ConfigurationProperties(prefix = "student") // 指定配置文件中的 student 屬性與這個 bean綁定
public class Student {
/** * <bean class="Student"> * <property name="lastName" value="字面量/${key}從環境變量、配置文件中獲取值/#{SpEL}"></property> * <bean/> */
//@Value("陳") // 字面量
private String firstName;
//@Value("${student.lastName}") // 從環境變量、配置文件中獲取值
private String lastName;
//@Value("#{12*2}") // #{SpEL}
private Integer age;
private String gender;
private String city;
private Teacher teacher;
private List<String> hobbys;
private Map<String,Integer> scores;
//注意,爲了測試必須重寫 toString 和 get,set 方法
}
複製代碼
測試結果:微信
Student{firstName='陳', lastName='一個優秀的廢人', age=24, gender='男', city='廣州', teacher=Teacher{name='eses', age=24, gender='女'}, hobbys=[籃球, 羽毛球, 兵兵球], scores={java=100, Python=99, C=99}}
複製代碼
學生類:app
@Component
//@ConfigurationProperties(prefix = "student") // 指定配置文件中的 student 屬性與這個 bean綁定
public class Student {
/** * <bean class="Student"> * <property name="lastName" value="字面量/${key}從環境變量、配置文件中獲取值/#{SpEL}"></property> * <bean/> */
//@Value("陳") // 字面量
@Value("${student.firstName}")
private String firstName;
//@Value("${student.lastName}") // 從環境變量、配置文件中獲取值
private String lastName;
//@Value("#{12*2}") // #{SpEL}
private Integer age;
private String gender;
private String city;
private Teacher teacher;
private List<String> hobbys;
private Map<String,Integer> scores;
//注意,爲了測試必須重寫 toString 和 get,set 方法
}
複製代碼
測試結果:啓動報錯,找不到 bean。
從上面兩個測試結果能夠看出,使用 @ConfigurationProperties 註解時,yml 中的屬性名爲 last_name 而學生類中的屬性爲 lastName 但依然能取到值,而使用 @value 時,使用 lastName 確報錯了。證實 @ConfigurationProperties 支持鬆散語法,@value 不支持。
SpEL 使用 #{...} 做爲定界符 , 全部在大括號中的字符都將被認爲是 SpEL , SpEL 爲 bean 的屬性進行動態賦值提供了便利。
如上述介紹 @Value 註解使用方法時,有這樣一段代碼:
@Value("#{12*2}") // #{SpEL}
private Integer age;
複製代碼
證實 @Value 是支持 SpEL 表達式的。
因爲 yml 中的 # 被當成註釋看不到效果。因此咱們新建一個 application.properties 文件。把 yml 文件內容註釋,咱們在 properties 文件中把 age 屬性寫成以下所示:
student.age=#{12*2}
複製代碼
把學生類中的 @ConfigurationProperties 註釋打開,註釋 @value 註解。運行報錯, age 屬性匹配異常。
說明 @ConfigurationProperties 不支持 SpEL
加入 @Length 校驗:
@Component
@Validated
//@ConfigurationProperties(prefix = "student") // 指定配置文件中的 student 屬性與這個 bean綁定
public class Student {
/** * <bean class="Student"> * <property name="lastName" value="字面量/${key}從環境變量、配置文件中獲取值/#{SpEL}"></property> * <bean/> */
//@Value("陳") // 字面量
@Value("${student.first-name}")
@Length(min=5, max=20, message="用戶名長度必須在5-20之間")
private String firstName;
//@Value("${student.lastName}") // 從環境變量、配置文件中獲取值
private String lastName;
//@Value("#{12*2}") // #{SpEL}
private Integer age;
private String gender;
private String city;
private Teacher teacher;
private List<String> hobbys;
private Map<String,Integer> scores;
}
複製代碼
yaml:
student:
first_name: 陳
複製代碼
測試結果:
Student{firstName='陳', lastName='null', age=null, gender='null', city='null', teacher=null, hobbys=null, scores=null}
複製代碼
yaml 中的 firstname 長度爲 1 。而檢驗規則規定 5-20 依然能取到屬性,說明檢驗不生效,@Value 不支持 JSR303 數據校驗
學生類:
@Component
@Validated
@ConfigurationProperties(prefix = "student") // 指定配置文件中的 student 屬性與這個 bean綁定
public class Student {
/** * <bean class="Student"> * <property name="lastName" value="字面量/${key}從環境變量、配置文件中獲取值/#{SpEL}"></property> * <bean/> */
//@Value("陳") // 字面量
//@Value("${student.first-name}")
@Length(min=5, max=20, message="用戶名長度必須在5-20之間")
private String firstName;
//@Value("${student.lastName}") // 從環境變量、配置文件中獲取值
private String lastName;
//@Value("#{12*2}") // #{SpEL}
private Integer age;
private String gender;
private String city;
private Teacher teacher;
private List<String> hobbys;
private Map<String,Integer> scores;
}
複製代碼
測試結果:報錯
[firstName],20,5]; default message [用戶名長度必須在5-20之間]
複製代碼
校驗生效,支持 JSR303 數據校驗。
複雜類型封裝指的是,在對象以及 map (如學生類中的老師類以及 scores map)等屬性中,用 @Value 取是取不到值,好比:
@Component
//@Validated
//@ConfigurationProperties(prefix = "student") // 指定配置文件中的 student 屬性與這個 bean綁定
public class Student {
/** * <bean class="Student"> * <property name="lastName" value="字面量/${key}從環境變量、配置文件中獲取值/#{SpEL}"></property> * <bean/> */
//@Value("陳") // 字面量
//@Value("${student.first-name}")
//@Length(min=5, max=20, message="用戶名長度必須在5-20之間")
private String firstName;
//@Value("${student.lastName}") // 從環境變量、配置文件中獲取值
private String lastName;
//@Value("#{12*2}") // #{SpEL}
private Integer age;
private String gender;
private String city;
@Value("${student.teacher}")
private Teacher teacher;
private List<String> hobbys;
@Value("${student.scores}")
private Map<String,Integer> scores;
}
複製代碼
這樣取是報錯的。而上文介紹 @ConfigurationProperties 和 @Value 的使用方法時已經證明 @ConfigurationProperties 是支持複雜類型封裝的。也就是說 yaml 中直接定義 teacher 以及 scores 。 @ConfigurationProperties 依然能取到值。
若是說,只是在某個業務邏輯中須要獲取一下配置文件中的某項值,使用 @Value;好比,假設如今學生類加多一個屬性叫 school 那這個屬性對於該校全部學生來講都是同樣的,但防止我這套系統到了別的學校就用不了了。那咱們能夠直接在 yml 中給定 school 屬性,用 @Value 獲取。固然上述只是舉個粗暴的例子,實際開發時,school 屬性應該是保存在數據庫中的。
若是說,專門編寫了一個 javaBean 來和配置文件進行映射,咱們就直接使用 @ConfigurationProperties。
若是以爲對你有幫助,請給個 Star 再走唄,很是感謝。
若是本文對你哪怕有一丁點幫助,請幫忙點好看。你的好看是我堅持寫做的動力。
另外,關注以後在發送 1024 可領取免費學習資料。
資料詳情請看這篇舊文:Python、C++、Java、Linux、Go、前端、算法資料分享