快捷導(dǎo)航

關(guān)于SpringBoot的@ConfigurationProperties注解和松散綁定、數(shù)據(jù)校驗(yàn)

更新時間：2023年05月12日 11:29:25 作者：Java筆記蝦

這篇文章主要介紹了關(guān)于SpringBoot的@ConfigurationProperties注解和松散綁定、數(shù)據(jù)校驗(yàn)，@ConfigurationProperties主要作用就是將prefix屬性指定的前綴配置項(xiàng)的值綁定到這個JavaBean上?，通過指定的前綴，來綁定配置文件中的配置,需要的朋友可以參考下

@ConfigurationProperties

源碼分析

@ConfigurationProperties主要作用就是將prefix屬性指定的前綴配置項(xiàng)的值綁定到這個JavaBean上，通過指定的前綴，來綁定配置文件中的配置，通過如下源碼可以看出，如果你想綁定和驗(yàn)證一些外部屬性，可以將它添加到類定義或@Configuration類中的@Bean方法上。

標(biāo)注在類上

@Data   //使用該注解需要導(dǎo)入Lombok依賴
@Component
@ConfigurationProperties(prefix = "userinfo")
public class UserInfo {
    private String userId;
    private String name;
}

application.yml文件配置內(nèi)容

userInfo:
  userId: 1001
  name: lucy

接下來通過控制器方法來返回這個對象，查看數(shù)據(jù)是否綁定

@RestController
public class HelloController {
    @Autowired
    private UserInfo userInfo;
    @GetMapping("/user")
    public UserInfo getUserInfo(){
        return userInfo;
    }
}

標(biāo)注在方法上

上面源碼中說到可以將它添加到@Configuration類中的@Bean方法上，所以下面來看看標(biāo)注在方法上是如何使用的！

比如我們用到druid數(shù)據(jù)源的操作，這個數(shù)據(jù)源是屬于第三方的，所以我們不能操作源碼，不能再源碼里面找到它的對象來給他添加注解，但我們可以在yml文件中給他配置，來拿到它的屬性。

首先添加所需的依賴

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid-spring-boot-starter</artifactId>
    <version>1.2.11</version>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>

接著在yml文件中配置數(shù)據(jù)源

spring:
  datasource:
    druid:
      driver-class-name: com.mysql.jdbc.Driver
      url: jdbc:mysql://localhost:3306/test?serverTimezone=UTC
      username: root
      password: root

創(chuàng)建一個配置類，然后在類方法上添加注解，并通過prefix綁定數(shù)據(jù)

@SpringBootConfiguration
public class DatasourceConfig {
    @Bean
    @ConfigurationProperties(prefix = "spring.database.druid")
    public DataSource database(){
        return new DruidDataSource();
    }
}

通過控制器方法來檢驗(yàn)綁定效果

@RestController
public class HelloController {
    @Autowired
    private DataSource dataSource;
    @GetMapping("/datasource")
    public void getDataSource(){
        System.out.println(dataSource);
    }
}

訪問//localhost/datasource，查看控制臺輸出！??！

松散綁定

我們在使用 @ConfigurationProperties注解的時候，@ConfigurationProperties(prefix = “userinfo”)，這里給prefix的屬性值與yml文件中的屬性名稱不一致，但是依舊綁定成功了！原因是什么呢？

這就需要提到Spring的松散綁定屬性規(guī)則。因此使用以下方式書寫都能與類的屬性名稱匹配。

userInfo:
  userId: 1001 # 駝峰命名方式
  #user_id: 1002 #下劃線方式
  #user-id: 1003 #烤肉串方式
  #USER_ID: 1004 # 常量方式
  name: lucycd

需要注意的是，prefix的屬性值必須全部為小寫，就像下圖所示，就會報(bào)錯：前綴必須是規(guī)范形式。

運(yùn)行程序，也會在控制臺提示你：配置屬性名稱“userInfo”無效；無效字符：“I”

數(shù)據(jù)校驗(yàn)

Spring Boot中有很多配置文件，配置文件中我們可以自定義一些對應(yīng)的屬性值。那么這些屬性值是否合法呢？我們?nèi)绾蝸硇ｒ?yàn)？在Java中有一種JSR303規(guī)范，我們可以針對一些對應(yīng)的數(shù)值來進(jìn)行校驗(yàn)。按照規(guī)范來進(jìn)行書寫，如果不符合要求就說明校驗(yàn)失敗，反之，則成功！

SpringBoot也給出了強(qiáng)大的數(shù)據(jù)校驗(yàn)功能，可以有效的避免此類問題的發(fā)生。在JAVA EE的JSR303規(guī)范中給出了具體的數(shù)據(jù)校驗(yàn)標(biāo)準(zhǔn)，開發(fā)者可以根據(jù)自己的需要選擇對應(yīng)的校驗(yàn)框架，此處使用Hibernate提供的校驗(yàn)框架來作為實(shí)現(xiàn)進(jìn)行數(shù)據(jù)校驗(yàn)。

導(dǎo)入驗(yàn)證包和校驗(yàn)實(shí)現(xiàn)包

<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
</dependency>
<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
</dependency>

添加注解@Validated

給屬性添加驗(yàn)證規(guī)則

@Data
@Component
@ConfigurationProperties(prefix = "userinfo")
@Validated
public class UserInfo {
   @Max(value = 1000,message = "userid超出范圍了！")
   @Min(value = 0,message = "userid不能小于0！")
   private String userId;
   @Size(min = 2,max = 5,message = "name長度應(yīng)該在2-5之間")
   private String name;
}

這里我們先輸入不符合規(guī)范的數(shù)據(jù)，來驗(yàn)證數(shù)據(jù)是否能夠校驗(yàn)成功

userInfo:
  userId: 1001
  name: lucycd

編寫一個控制器方法來檢驗(yàn)

@RestController
public class HelloController {
    @Autowired
    private UserInfo userInfo;
    @GetMapping("/user")
    public UserInfo getUserInfo(){
        return userInfo;
    }
}

運(yùn)行程序，查看控制臺，校驗(yàn)成功?。?！

同樣，將數(shù)據(jù)修改為符合規(guī)則的數(shù)據(jù)，程序就可以成功運(yùn)行了?。?！

當(dāng)然，這里的校驗(yàn)規(guī)則還有許多，@NotNull、@NotEmpty、@Email等等，可以根據(jù)實(shí)際情況選擇合適的注解。

到此這篇關(guān)于關(guān)于SpringBoot的@ConfigurationProperties注解和松散綁定、數(shù)據(jù)校驗(yàn)的文章就介紹到這了,更多相關(guān)SpringBoot的@ConfigurationProperties注解內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: