springboot @Valid注解對嵌套類型的校驗功能
@Valid注解可以實現(xiàn)數(shù)據(jù)的驗證,你可以定義實體,在實體的屬性上添加校驗規(guī)則,而在API接收數(shù)據(jù)時添加@valid關鍵字,這時你的實體將會開啟一個校驗的功能,具體的代碼如下,是最基本的應用:
實體:
public class DepartmentDto {
@ApiModelProperty("id")
private String id;
@ApiModelProperty("上級Id")
private String parentId;
@ApiModelProperty("編號")
@NotBlank(message = "部門編號不能為空。")
private String code;
@ApiModelProperty("名稱")
@NotBlank(message = "部門名稱不能為空。")
private String name;
@ApiModelProperty("員工集合")
@Builder.Default
private List<Employee> employees = new ArrayList<>();
}
Restful接口:
@PostMapping()
public Response<ClientAccount> initialAccount(
@ApiParam("客戶編號") @PathVariable String code,
@ApiParam("賬期") @PathVariable YearMonth accountPeriod,
@ApiParam("請求體") @Valid @RequestBody Request<DepartmentDto> request) {
ClientAccount result = clientAccountService.initialAccount(
code,
accountPeriod,
request.getOperator(),
request.getBody());{}
上面代碼中,我們?yōu)檎埱篌wRequest<DepartmentDto>添加了校驗,在測試時,如果你的DepartmnetDto.name為空字符時,當出現(xiàn)400的異常,麗時異常消息是『部門名稱不能為空』,這對于我們來說是沒有問題的,也是符合我們要求的,下面看另一個場景。
需要驗證的實體是另一個實休的屬性
這種方式我們也需要會看到,一個大對象,如被封裝的其它小對象組成,比如部門下面有員工,這時如果需要驗證員工的有效性,需要如何實現(xiàn)呢?如果我們不修改源代碼,執(zhí)行結(jié)果是否定的, 它并不會校驗員工這個對象,而只針對第一層對象的屬性 。
我們將實體的員工屬性添加上@Valid即可實現(xiàn)對這個屬性的校驗
public class DepartmentDto {
@ApiModelProperty("id")
private String id;
@ApiModelProperty("上級Id")
private String parentId;
@ApiModelProperty("編號")
@NotBlank(message = "部門編號不能為空。")
private String code;
@ApiModelProperty("名稱")
@NotBlank(message = "部門名稱不能為空。")
private String name;
@Valid
@ApiModelProperty("員工集合")
@Builder.Default
private List<Employee> employees = new ArrayList<>();
}
下面看一下驗證結(jié)果,我們的400錯誤就可以在單元測試下面正常輸出了!
@Test
public void initialAccount_employee_name_empty() {
List<Employee> employees = new ArrayList<>();
employees.add(Employee.builder()
.name("")
.email("zzl@sina.com")
.idNumber("110111198203182012")
.build());
List<DepartmentDto> departments = new ArrayList<>();
departments.add(DepartmentDto.builder()
.name("部門")
.description("技術(shù)部")
.salaryType(SalaryType.ResearchAndDevelopmentCosts)
.employees(employees)
.build());
ClientAccountDto clientAccountDto = ClientAccountDto.builder()
.name("客戶")
.departments(departments)
.build();
Request<ClientAccountDto> request = buildRequest(clientAccountDto);
api.post()
.uri("/v1/12345/2018-03")
.body(BodyInserters.fromObject(request))
.exchange()
.expectStatus().isEqualTo(400)
.expectBody()
.jsonPath("$.errors[0].message").isEqualTo("姓名不能為空");
}
結(jié)果如下,測試通過
如果是測試它是IsOk的話,由于用戶名為空,所以會出現(xiàn)錯誤提示
api.post()
.uri("/v1/12345/2018-03")
.body(BodyInserters.fromObject(request))
.exchange()
.expectStatus().isOk();
可以看一下結(jié)果的提示信息
總結(jié)
以上所述是小編給大家介紹的springboot @Valid注解對嵌套類型的校驗,希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回復大家的。在此也非常感謝大家對腳本之家網(wǎng)站的支持!
相關文章
rabbitmq的消息持久化處理開啟,再關閉后,消費者啟動報錯問題
這篇文章主要介紹了rabbitmq的消息持久化處理開啟,再關閉后,消費者啟動報錯問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-11-11
Springboot集成MongoDB無認證與開啟認證的配置方式
本文主要介紹了Springboot集成MongoDB無認證與開啟認證的配置方式,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2024-03-03
redis 使用lettuce 啟動內(nèi)存泄漏錯誤的解決方案
這篇文章主要介紹了redis 使用lettuce 啟動內(nèi)存泄漏錯誤的解決方案,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2021-04-04
使用Jenkins自動化構(gòu)建工具進行敏捷開發(fā)
這篇文章主要為大家介紹了使用Jenkins自動化構(gòu)建工具進行敏捷開發(fā),有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步早日升職加薪2022-04-04

