Spring boot validation校驗方法實例
接觸springboot一年多,是時候擺脫這種校驗方式了233 ,每個參數(shù)都if判斷,一眼看過去就是很low的程序員。
Validation有了這個插件就再也不用這樣去校驗參數(shù)了,可以讓我們在項目中不用浪費很多時間在參數(shù)校驗這里,從而更專注于業(yè)務(wù)邏輯
正文首先引入依賴
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>
這里創(chuàng)建一個用戶的DTO對象
@Data@ApiModel('用戶-表單對象')public class SportsUserCreatForm{ @ApiModelProperty(value='用戶唯一標識',example = '0') @NotNull(groups = {Update.class}) private long id; @ApiModelProperty(value = '所屬機構(gòu)唯一標識(冗余字段)', example = '0') private long organizationId; @ApiModelProperty('登錄用戶名') @NotBlank(message = '用戶名不能為空') @Length(max = 10, message = '用戶名最長為10位') private String loginName; @ApiModelProperty('密碼') private String password; @ApiModelProperty('手機號') private String phone; @ApiModelProperty('郵箱') private String email; @ApiModelProperty('性別( ’MALE’, ’FEMALE’ )') @NotNull(message = '用戶性別不能為空') private SportsUserEnumGender gander; @ApiModelProperty(value = '出生日期-13位時間戳',example = '0') private long birthday; @ApiModelProperty('身份證號') private String idNumber; @ApiModelProperty('用戶昵稱') private String nickname; }
在controller層添加@Validated注解,添加注解之后spring就會逐個校驗DTO中加了校驗注解的字段,完全通過才可以進入業(yè)務(wù)處理,否則就會拋出MethodArgumentNotValidException異常
@PostMapping('user/add') @RequiresAuthentication @ApiOperation('添加用戶') public SportsUser addUser(@Validated @RequestBody SportsUserCreatForm user) throws Exception{ return userBiz.addUser(user); }
一般項目來說拋出異常都會有約定好的JSON格式返回錯誤碼和錯誤信息,如果不處理就無法按照約定格式返回。這里我們可以通過聲明全局異常處理類來攔截異常并將異常處理成前端能操作的JSON數(shù)據(jù)。(這里只需要關(guān)注MethodArgumentNotValidException異常)
@Slf4j@Order(Ordered.HIGHEST_PRECEDENCE)@RestControllerAdvicepublic class GlobalExceptionAdvice { @ExceptionHandler(MethodArgumentNotValidException.class) @ResponseBody public ResponseEntity<Object> handleBeanValidation(HttpServletResponse res, MethodArgumentNotValidException e) throws Exception{ res.setStatus(HttpStatus.OK.value()); List<ObjectError> errors = e.getBindingResult().getAllErrors(); ObjectError error = errors.get(0);// 如果有多個異常,這里只取第一個異常。沒有必要把所有異常都拋出(錯就是錯,第一個校驗都沒通過,自然也輪不到第二個校驗。) String json = JsonUtils.obj2json(error); Map map = JsonUtils.json2map(json); OkMessage result = new OkMessage(); result.setMsg('請求參數(shù)錯誤'e.getBindingResult().getFieldError().getDefaultMessage() + ']'); result.setCode('PARAM-000001'); return new ResponseEntity<>(result, HttpStatus.OK); }}分組校驗
有的人就要發(fā)問了,'啊,你這校驗不行啊,我在添加的時候id是自動生成的不需要校驗,編輯的時候就需要校驗id了,我是不是要建兩個一模一樣的DTO,這樣豈不是顯得我很憨?!這不是增加無用代碼嗎?差評!'
其實不然,在此我們可以用到 groups 屬性來解決此場景下的問題。
聲明分組
注意:在聲明分組的時候盡量繼承 extend javax.validation.groups.Default。 否則,在你聲明@Validated(Update.class)的時候,就會出現(xiàn)你在默認沒添加groups = {}的時候的校驗組@Email(message = '郵箱格式不對')不會自動校驗,因為默認的校驗組是groups = {Default.class}。
import javax.validation.groups.Default; /** * 數(shù)據(jù)新增分組 */public interface Create extends Default { }
import javax.validation.groups.Default; /** * 數(shù)據(jù)更新分組 */public interface Update extends Default { }
修改Controller中的@Validated注解,聲明校驗分組(下面用的是Create.class所以并不會校驗id)
@PostMapping('user/add') @RequiresAuthentication @ApiOperation('添加用戶') public SportsUser addUser(@Validated(Create.class) @RequestBody SportsUserCreatForm user) throws Exception{ return userBiz.addUser(user); }下面附上注解說明 驗證注解 驗證的數(shù)據(jù)類型 說明 @AssertFalse Boolean,boolean 驗證注解的元素值是false @AssertTrue Boolean,boolean 驗證注解的元素值是true @NotNull 任意類型 驗證注解的元素值不是null @Null 任意類型 驗證注解的元素值是null @Min(value=值) BigDecimal,BigInteger, byte,short, int, long,等任何Number或CharSequence(存儲的是數(shù)字)子類型 驗證注解的元素值大于等于@Min指定的value值 @Max(value=值) 和@Min要求一樣 驗證注解的元素值小于等于@Max指定的value值 @DecimalMin(value=值) 和@Min要求一樣 驗證注解的元素值大于等于@ DecimalMin指定的value值 @DecimalMax(value=值) 和@Min要求一樣 驗證注解的元素值小于等于@ DecimalMax指定的value值 @Digits(integer=整數(shù)位數(shù), fraction=小數(shù)位數(shù)) 和@Min要求一樣 驗證注解的元素值的整數(shù)位數(shù)和小數(shù)位數(shù)上限 @Size(min=下限, max=上限) 字符串、Collection、Map、數(shù)組等 驗證注解的元素值的在min和max(包含)指定區(qū)間之內(nèi),如字符長度、集合大小 @Past java.util.Date,java.util.Calendar;Joda Time類庫的日期類型 驗證注解的元素值(日期類型)比當(dāng)前時間早 @Future 與@Past要求一樣 驗證注解的元素值(日期類型)比當(dāng)前時間晚 @NotBlank CharSequence子類型 驗證注解的元素值不為空(不為null、去除首位空格后長度為0),不同于@NotEmpty,@NotBlank只應(yīng)用于字符串且在比較時會去除字符串的首位空格 @Length(min=下限, max=上限) CharSequence子類型 驗證注解的元素值長度在min和max區(qū)間內(nèi) @NotEmpty CharSequence子類型、Collection、Map、數(shù)組 驗證注解的元素值不為null且不為空(字符串長度不為0、集合大小不為0) @Range(min=最小值, max=最大值) BigDecimal,BigInteger,CharSequence, byte, short, int, long等原子類型和包裝類型 驗證注解的元素值在最小值和最大值之間 @Email(regexp=正則表達式,flag=標志的模式) CharSequence子類型(如String) 驗證注解的元素值是Email,也可以通過regexp和flag指定自定義的email格式 @Pattern(regexp=正則表達式,flag=標志的模式) String,任何CharSequence的子類型 驗證注解的元素值與指定的正則表達式匹配 @Valid 任何非原子類型 指定遞歸驗證關(guān)聯(lián)的對象如用戶對象中有個地址對象屬性,如果想在驗證用戶對象時一起驗證地址對象的話,在地址對象上加@Valid注解即可
此處只列出Hibernate Validator提供的大部分驗證約束注解,請參考hibernate validator官方文檔了解其他驗證約束注解和進行自定義的驗證約束注解定義。
常用的幾個:1.@NotNull:不能為null,但可以為empty('',' ',' ')2.@NotEmpty:不能為null,而且長度必須大于0 (' ',' ')3.@NotBlank:只能作用在String上,不能為null,而且調(diào)用trim()后,長度必須大于0('test') 即:必須有實際字符總結(jié)
到此這篇關(guān)于Spring boot validation校驗的文章就介紹到這了,更多相關(guān)Springboot validation校驗內(nèi)容請搜索好吧啦網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持好吧啦網(wǎng)!
相關(guān)文章:
1. asp(vbs)Rs.Open和Conn.Execute的詳解和區(qū)別及&H0001的說明2. CSS hack用法案例詳解3. ASP 處理JSON數(shù)據(jù)的實現(xiàn)代碼4. PHP設(shè)計模式中工廠模式深入詳解5. 用css截取字符的幾種方法詳解(css排版隱藏溢出文本)6. asp中response.write("中文")或者js中文亂碼問題7. ASP.NET MVC遍歷驗證ModelState的錯誤信息8. ThinkPHP5實現(xiàn)JWT Token認證的過程(親測可用)9. ASP 信息提示函數(shù)并作返回或者轉(zhuǎn)向10. .Net Core和RabbitMQ限制循環(huán)消費的方法
