這篇文章給大家介紹@ConfigurationProperties注解使用姿勢是什么，內(nèi)容非常詳細(xì)，感興趣的小伙伴們可以參考借鑒，希望對大家能有所幫助。

創(chuàng)新互聯(lián)公司是一家專業(yè)提供墊江企業(yè)網(wǎng)站建設(shè),專注與成都網(wǎng)站制作、做網(wǎng)站、html5、小程序制作等業(yè)務(wù)。10年已為墊江眾多企業(yè)、政府機(jī)構(gòu)等服務(wù)。創(chuàng)新互聯(lián)專業(yè)網(wǎng)絡(luò)公司優(yōu)惠進(jìn)行中。

在編寫項(xiàng)目代碼時(shí)，我們要求更靈活的配置，更好的模塊化整合。在 Spring Boot 項(xiàng)目中，為滿足以上要求，我們將大量的參數(shù)配置在 application.properties 或 application.yml 文件中，通過 @ConfigurationProperties 注解，我們可以方便的獲取這些參數(shù)值

使用 @ConfigurationProperties 配置模塊

假設(shè)我們正在搭建一個(gè)發(fā)送郵件的模塊。在本地測試，我們不想該模塊真的發(fā)送郵件，所以我們需要一個(gè)參數(shù)來「開關(guān)」 disable 這個(gè)功能。另外，我們希望為這些郵件配置一個(gè)默認(rèn)的主題，這樣，當(dāng)我們查看郵件收件箱，通過郵件主題可以快速判斷出這是測試郵件

在 application.properties 文件中創(chuàng)建這些參數(shù):

我們可以使用 @Value 注解或著使用 Spring Environment bean 訪問這些屬性，是這種注入配置方式有時(shí)顯得很笨重。我們將使用更安全的方式(@ConfigurationProperties )來獲取這些屬性

@ConfigurationProperties 的基本用法非常簡單:我們?yōu)槊總€(gè)要捕獲的外部屬性提供一個(gè)帶有字段的類。請注意以下幾點(diǎn):

• 前綴定義了哪些外部屬性將綁定到類的字段上

• 根據(jù) Spring Boot 寬松的綁定規(guī)則，類的屬性名稱必須與外部屬性的名稱匹配

• 我們可以簡單地用一個(gè)值初始化一個(gè)字段來定義一個(gè)默認(rèn)值

• 類本身可以是包私有的

• 類的字段必須有公共 setter 方法

Spring 寬松綁定規(guī)則 (relaxed binding)

Spring使用一些寬松的綁定屬性規(guī)則。因此，以下變體都將綁定到 hostName 屬性上:

如果我們將 MailModuleProperties 類型的 bean 注入到另一個(gè) bean 中，這個(gè) bean 現(xiàn)在可以以類型安全的方式訪問那些外部配置參數(shù)的值。

但是，我們?nèi)匀恍枰?Spring 知道我們的 @ConfigurationProperties 類存在，以便將其加載到應(yīng)用程序上下文中( 面試還不知道 BeanFactory 和 ApplicationContext 的區(qū)別？)

激活 @ConfigurationProperties

對于 Spring Boot，創(chuàng)建一個(gè) MailModuleProperties 類型的 bean，我們可以通過下面幾種方式將其添加到應(yīng)用上下文中

首先，我們可以通過添加 @Component 注解讓 Component Scan 掃描到

很顯然，只有當(dāng)類所在的包被 Spring @ComponentScan 注解掃描到才會生效，默認(rèn)情況下，該注解會掃描在主應(yīng)用類下的所有包結(jié)構(gòu)

我們也可以通過 Spring 的 Java Configuration 特性實(shí)現(xiàn)同樣的效果:

只要 MailModuleConfiguration 類被 Spring Boot 應(yīng)用掃描到，我們就可以在應(yīng)用上下文中訪問 MailModuleProperties bean

我們還可以使用 @EnableConfigurationProperties 注解讓我們的類被 Spring Boot 所知道，在該注解中其實(shí)是用了@Import(EnableConfigurationPropertiesImportSelector.class) 實(shí)現(xiàn)，大家可以看一下

激活一個(gè) @ConfigurationProperties 類的最佳方式是什么？

所有上述方法都同樣有效。然而，我建議模塊化你的應(yīng)用程序，并讓每個(gè)模塊提供自己的@ConfigurationProperties 類，只提供它需要的屬性，就像我們在上面的代碼中對郵件模塊所做的那樣。這使得在不影響其他模塊的情況下重構(gòu)一個(gè)模塊中的屬性變得容易。

因此，我不建議在應(yīng)用程序類本身上使用 @EnableConfigurationProperties，如許多其他教程中所示，是在特定于模塊的 @Configuration 類上使用@EnableConfigurationProperties，該類也可以利用包私有的可見性對應(yīng)用程序的其余部分隱藏屬性。

無法轉(zhuǎn)換的屬性

如果我們在 application.properties 屬性上定義的屬性不能被正確的解析會發(fā)生什么？假如我們?yōu)樵緫?yīng)該為布爾值的屬性提供的值為 'foo':

默認(rèn)情況下，Spring Boot 將會啟動失敗，并拋出異常:

Failed to bind properties under 'myapp.mail.enabled' to java.lang.Boolean:

    Property: myapp.mail.enabled
    Value: foo
    Origin: class path resource [application.properties]:1:20
    Reason: failed to convert java.lang.String to java.lang.Boolean

當(dāng)我們?yōu)閷傩耘渲缅e(cuò)誤的值時(shí)，而又不希望 Spring Boot 應(yīng)用啟動失敗，我們可以設(shè)置 ignoreInvalidFields 屬性為 true (默認(rèn)為 false)

這樣，Spring Boot 將會設(shè)置 enabled 字段為我們在 Java 代碼里設(shè)定好的默認(rèn)值。如果我們沒有設(shè)置默認(rèn)值，enabled 將為 null，因?yàn)檫@里定義的是 boolean 的包裝類 Boolean

未知的屬性

和上面的情況有些相反，如果我們在 application.properties 文件提供了 MailModuleProperties 類不知道的屬性會發(fā)生什么？

默認(rèn)情況下，Spring Boot 會忽略那些不能綁定到 @ConfigurationProperties 類字段的屬性

然而，當(dāng)配置文件中有一個(gè)屬性實(shí)際上沒有綁定到 @ConfigurationProperties 類時(shí)，我們可能希望啟動失敗。也許我們以前使用過這個(gè)配置屬性，但是它已經(jīng)被刪除了，這種情況我們希望被觸發(fā)告知手動從 application.properties 刪除這個(gè)屬性

為了實(shí)現(xiàn)上述情況，我們僅需要將 ignoreUnknownFields 屬性設(shè)置為 false (默認(rèn)是 true)

現(xiàn)在，應(yīng)用啟動時(shí)，控制臺會反饋我們異常信息

Binding to target [Bindable@cf65451 type = com.example.configurationproperties.properties.MailModuleProperties, value = 'provided', annotations = array<Annotation>[@org.springframework.boot.context.properties.ConfigurationProperties(value=myapp.mail, prefix=myapp.mail, ignoreInvalidFields=false, ignoreUnknownFields=false)]] failed:

    Property: myapp.mail.unknown-property
    Value: foo
    Origin: class path resource [application.properties]:3:29
    Reason: The elements [myapp.mail.unknown-property] were left unbound.

棄用警告??(Deprecation Warning) ignoreUnknownFields 在未來 Spring Boot 的版本中會被標(biāo)記為 deprecated，因?yàn)槲覀兛赡苡袃蓚€(gè)帶有 @ConfigurationProperties 的類，同時(shí)綁定到了同一個(gè)命名空間 (namespace) 上，其中一個(gè)類可能知道某個(gè)屬性，另一個(gè)類卻不知道某個(gè)屬性，這樣就會導(dǎo)致啟動失敗

啟動時(shí)校驗(yàn) @ConfigurationProperties

如果我們希望配置參數(shù)在傳入到應(yīng)用中時(shí)有效的，我們可以通過在字段上添加 bean validation 注解，同時(shí)在類上添加 @Validated 注解

如果我們忘記在 application.properties 文件設(shè)置 enabled 屬性，并且設(shè)置 defaultSubject 為空

應(yīng)用啟動時(shí)，我們將會得到 BindValidationException

Binding to target org.springframework.boot.context.properties.bind.BindException: Failed to bind properties under 'myapp.mail' to com.example.configurationproperties.properties.MailModuleProperties failed:

    Property: myapp.mail.enabled
    Value: null
    Reason: must not be null

    Property: myapp.mail.defaultSubject
    Value: null
    Reason: must not be empty

當(dāng)然這些默認(rèn)的驗(yàn)證注解不能滿足你的驗(yàn)證要求，我們也可以自定義注解

如果你的驗(yàn)證邏輯很特殊，我們可以實(shí)現(xiàn)一個(gè)方法，并用 @PostConstruct 標(biāo)記，如果驗(yàn)證失敗，方法拋出異常即可, 關(guān)于 @PostConstruct，可以查看 Spring Bean 的生命周期，我從哪里來？

復(fù)雜屬性類型

多數(shù)情況，我們傳遞給應(yīng)用的參數(shù)是基本的字符串或數(shù)字。但是，有時(shí)我們需要傳遞諸如 List 的數(shù)據(jù)類型

List 和 Set

假如，我們?yōu)猷]件模塊提供了一個(gè) SMTP 服務(wù)的列表，我們可以添加該屬性到 MailModuleProperties 類中

我們有兩種方式讓 Spring Boot 自動填充該 list 屬性

application.properties

在 application.properties 文件中以數(shù)組形式書寫

application.yml

YAML 本身支持 list 類型，所以可以在 application.yml 文件中添加:

set 集合也是這種方式的配置方式，不再重復(fù)書寫。另外YAML 是更好的閱讀方式，層次分明，所以在實(shí)際應(yīng)用中更推薦大家使用該種方式做數(shù)據(jù)配置

Duration

Spring Boot 內(nèi)置支持從配置參數(shù)中解析 durations (持續(xù)時(shí)間)，官網(wǎng)文檔 給出了明確的說明

我們既可以配置毫秒數(shù)數(shù)值，也可配置帶有單位的文本:

官網(wǎng)上已明確說明，配置 duration 不寫單位，默認(rèn)按照毫秒來指定，我們也可已通過 @DurationUnit 來指定單位:

常用單位如下:

• ns for nanoseconds (納秒)

• us for microseconds (微秒)

• ms for milliseconds (毫秒)

• s for seconds (秒)

• m for minutes (分)

• h for hours (時(shí))

• d for days (天)

DataSize

與 Duration 的用法一毛一樣，默認(rèn)單位是 byte (字節(jié))，可以通過 @DataSizeUnit 單位指定:

添加配置

但是，我測試的時(shí)候打印出來結(jié)果都是以 B (bytes) 來顯示

常見單位如下:

• B for bytes

• KB for kilobytes

• MB for megabytes

• GB for gigabytes

• TB for terabytes

自定義類型

有些情況，我們想解析配置參數(shù)到我們自定義的對象類型上，假設(shè)，我們我們設(shè)置最大包裹重量:

在 MailModuleProperties 中添加 Weight 屬性

我們可以模仿 DataSize 和 Duration 創(chuàng)造自己的 converter (轉(zhuǎn)換器)

將其注冊到 Spring Boot 上下文中

@ConfigurationPropertiesBinding 注解是讓 Spring Boot 知道使用該轉(zhuǎn)換器做數(shù)據(jù)綁定

使用 Spring Boot Configuration Processor 完成自動補(bǔ)全

我們向項(xiàng)目中添加依賴:

Maven

Gradle

重新 build 項(xiàng)目之后，configuration processor 會為我們創(chuàng)建一個(gè) JSON 文件:

這樣，當(dāng)我們在 application.properties 和 application.yml 中寫配置的時(shí)候會有自動提醒:

標(biāo)記配置屬性為 Deprecated

configuration processor 允許我們標(biāo)記某一個(gè)屬性為 deprecated

我們可以通過添加 @DeprecatedConfigurationProperty 注解到字段的 getter 方法上，來標(biāo)示該字段為 deprecated，重新 build 項(xiàng)目，看看 JSON 文件發(fā)生了什么？

當(dāng)我們再編寫配置文件時(shí)，已經(jīng)給出了明確 deprecated 提示:

總結(jié)

Spring Boot 的 @ConfigurationProperties 注解在綁定類型安全的 Java Bean 時(shí)是非常強(qiáng)大的，我們可以配合其注解屬性和 @DeprecatedConfigurationProperty 注解獲取到更友好的編程方式，同時(shí)這樣讓我們的配置更加模塊化。

附加說明

以為 @ConfigurationProperties 注解滿足我們的全部需要了嗎？其實(shí)不然，Spring 官網(wǎng)明確給出了該注解和 @Value 注解的對比:

如果使用 SpEL 表達(dá)式，我們只能選擇 @Value 注解

另外我之前在閱讀 RabbitMQ 源碼時(shí)，發(fā)現(xiàn) RabbitProperties 類充分的利用了 @ConfigurationProperties 注解特性:

• deprecated

• Duration

• Enum

• 嵌套屬性

感覺自己后知后覺，最近在思考，為什么小時(shí)候要閱讀和背誦古詩詞，文言文等經(jīng)典，因?yàn)檫@樣寫文章就可以輕松熟練的引用經(jīng)典。技術(shù)也一樣，各種框架的源碼就是學(xué)生時(shí)代的古詩詞和文言文，我們要多多查看閱讀，甚至背誦編程思想，這樣就可以寫出越來越優(yōu)雅的代碼

關(guān)于 @ConfigurationProperties 注解的使用，這里推薦 RabbitMQ Github 源碼，只需看這一個(gè)類就可以，知道怎樣充分利用這個(gè)注解.

關(guān)于@ConfigurationProperties注解使用姿勢是什么就分享到這里了，希望以上內(nèi)容可以對大家有一定的幫助，可以學(xué)到更多知識。如果覺得文章不錯(cuò)，可以把它分享出去讓更多的人看到。

文章名稱：@ConfigurationProperties注解使用姿勢是什么
URL標(biāo)題：http://vcdvsql.cn/article2/gghgoc.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供網(wǎng)站改版、響應(yīng)式網(wǎng)站、云服務(wù)器、營銷型網(wǎng)站建設(shè)、搜索引擎優(yōu)化、電子商務(wù)

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請盡快告知，我們將會在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場，如需處理請聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時(shí)需注明來源： 創(chuàng)新互聯(lián)