Spring boot validation校驗(yàn)方法實(shí)例
接觸springboot一年多,是時(shí)候擺脫這種校驗(yàn)方式了233 ,每個(gè)參數(shù)都if判斷,一眼看過去就是很low的程序員。
Validation有了這個(gè)插件就再也不用這樣去校驗(yàn)參數(shù)了,可以讓我們?cè)陧?xiàng)目中不用浪費(fèi)很多時(shí)間在參數(shù)校驗(yàn)這里,從而更專注于業(yè)務(wù)邏輯
正文首先引入依賴
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>
這里創(chuàng)建一個(gè)用戶的DTO對(duì)象
@Data@ApiModel('用戶-表單對(duì)象')public class SportsUserCreatForm{ @ApiModelProperty(value='用戶唯一標(biāo)識(shí)',example = '0') @NotNull(groups = {Update.class}) private long id; @ApiModelProperty(value = '所屬機(jī)構(gòu)唯一標(biāo)識(shí)(冗余字段)', example = '0') private long organizationId; @ApiModelProperty('登錄用戶名') @NotBlank(message = '用戶名不能為空') @Length(max = 10, message = '用戶名最長為10位') private String loginName; @ApiModelProperty('密碼') private String password; @ApiModelProperty('手機(jī)號(hào)') private String phone; @ApiModelProperty('郵箱') private String email; @ApiModelProperty('性別( ’MALE’, ’FEMALE’ )') @NotNull(message = '用戶性別不能為空') private SportsUserEnumGender gander; @ApiModelProperty(value = '出生日期-13位時(shí)間戳',example = '0') private long birthday; @ApiModelProperty('身份證號(hào)') private String idNumber; @ApiModelProperty('用戶昵稱') private String nickname; }
在controller層添加@Validated注解,添加注解之后spring就會(huì)逐個(gè)校驗(yàn)DTO中加了校驗(yàn)注解的字段,完全通過才可以進(jìn)入業(yè)務(wù)處理,否則就會(huì)拋出MethodArgumentNotValidException異常
@PostMapping('user/add') @RequiresAuthentication @ApiOperation('添加用戶') public SportsUser addUser(@Validated @RequestBody SportsUserCreatForm user) throws Exception{ return userBiz.addUser(user); }
一般項(xiàng)目來說拋出異常都會(huì)有約定好的JSON格式返回錯(cuò)誤碼和錯(cuò)誤信息,如果不處理就無法按照約定格式返回。這里我們可以通過聲明全局異常處理類來攔截異常并將異常處理成前端能操作的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);// 如果有多個(gè)異常,這里只取第一個(gè)異常。沒有必要把所有異常都拋出(錯(cuò)就是錯(cuò),第一個(gè)校驗(yàn)都沒通過,自然也輪不到第二個(gè)校驗(yàn)。) String json = JsonUtils.obj2json(error); Map map = JsonUtils.json2map(json); OkMessage result = new OkMessage(); result.setMsg('請(qǐng)求參數(shù)錯(cuò)誤'e.getBindingResult().getFieldError().getDefaultMessage() + ']'); result.setCode('PARAM-000001'); return new ResponseEntity<>(result, HttpStatus.OK); }}分組校驗(yàn)
有的人就要發(fā)問了,'啊,你這校驗(yàn)不行啊,我在添加的時(shí)候id是自動(dòng)生成的不需要校驗(yàn),編輯的時(shí)候就需要校驗(yàn)id了,我是不是要建兩個(gè)一模一樣的DTO,這樣豈不是顯得我很憨?!這不是增加無用代碼嗎?差評(píng)!'
其實(shí)不然,在此我們可以用到 groups 屬性來解決此場(chǎng)景下的問題。
聲明分組
注意:在聲明分組的時(shí)候盡量繼承 extend javax.validation.groups.Default。 否則,在你聲明@Validated(Update.class)的時(shí)候,就會(huì)出現(xiàn)你在默認(rèn)沒添加groups = {}的時(shí)候的校驗(yàn)組@Email(message = '郵箱格式不對(duì)')不會(huì)自動(dòng)校驗(yàn),因?yàn)槟J(rèn)的校驗(yàn)組是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注解,聲明校驗(yàn)分組(下面用的是Create.class所以并不會(huì)校驗(yàn)id)
@PostMapping('user/add') @RequiresAuthentication @ApiOperation('添加用戶') public SportsUser addUser(@Validated(Create.class) @RequestBody SportsUserCreatForm user) throws Exception{ return userBiz.addUser(user); }下面附上注解說明 驗(yàn)證注解 驗(yàn)證的數(shù)據(jù)類型 說明 @AssertFalse Boolean,boolean 驗(yàn)證注解的元素值是false @AssertTrue Boolean,boolean 驗(yàn)證注解的元素值是true @NotNull 任意類型 驗(yàn)證注解的元素值不是null @Null 任意類型 驗(yàn)證注解的元素值是null @Min(value=值) BigDecimal,BigInteger, byte,short, int, long,等任何Number或CharSequence(存儲(chǔ)的是數(shù)字)子類型 驗(yàn)證注解的元素值大于等于@Min指定的value值 @Max(value=值) 和@Min要求一樣 驗(yàn)證注解的元素值小于等于@Max指定的value值 @DecimalMin(value=值) 和@Min要求一樣 驗(yàn)證注解的元素值大于等于@ DecimalMin指定的value值 @DecimalMax(value=值) 和@Min要求一樣 驗(yàn)證注解的元素值小于等于@ DecimalMax指定的value值 @Digits(integer=整數(shù)位數(shù), fraction=小數(shù)位數(shù)) 和@Min要求一樣 驗(yàn)證注解的元素值的整數(shù)位數(shù)和小數(shù)位數(shù)上限 @Size(min=下限, max=上限) 字符串、Collection、Map、數(shù)組等 驗(yàn)證注解的元素值的在min和max(包含)指定區(qū)間之內(nèi),如字符長度、集合大小 @Past java.util.Date,java.util.Calendar;Joda Time類庫的日期類型 驗(yàn)證注解的元素值(日期類型)比當(dāng)前時(shí)間早 @Future 與@Past要求一樣 驗(yàn)證注解的元素值(日期類型)比當(dāng)前時(shí)間晚 @NotBlank CharSequence子類型 驗(yàn)證注解的元素值不為空(不為null、去除首位空格后長度為0),不同于@NotEmpty,@NotBlank只應(yīng)用于字符串且在比較時(shí)會(huì)去除字符串的首位空格 @Length(min=下限, max=上限) CharSequence子類型 驗(yàn)證注解的元素值長度在min和max區(qū)間內(nèi) @NotEmpty CharSequence子類型、Collection、Map、數(shù)組 驗(yàn)證注解的元素值不為null且不為空(字符串長度不為0、集合大小不為0) @Range(min=最小值, max=最大值) BigDecimal,BigInteger,CharSequence, byte, short, int, long等原子類型和包裝類型 驗(yàn)證注解的元素值在最小值和最大值之間 @Email(regexp=正則表達(dá)式,flag=標(biāo)志的模式) CharSequence子類型(如String) 驗(yàn)證注解的元素值是Email,也可以通過regexp和flag指定自定義的email格式 @Pattern(regexp=正則表達(dá)式,flag=標(biāo)志的模式) String,任何CharSequence的子類型 驗(yàn)證注解的元素值與指定的正則表達(dá)式匹配 @Valid 任何非原子類型 指定遞歸驗(yàn)證關(guān)聯(lián)的對(duì)象如用戶對(duì)象中有個(gè)地址對(duì)象屬性,如果想在驗(yàn)證用戶對(duì)象時(shí)一起驗(yàn)證地址對(duì)象的話,在地址對(duì)象上加@Valid注解即可
此處只列出Hibernate Validator提供的大部分驗(yàn)證約束注解,請(qǐng)參考hibernate validator官方文檔了解其他驗(yàn)證約束注解和進(jìn)行自定義的驗(yàn)證約束注解定義。
常用的幾個(gè):1.@NotNull:不能為null,但可以為empty('',' ',' ')2.@NotEmpty:不能為null,而且長度必須大于0 (' ',' ')3.@NotBlank:只能作用在String上,不能為null,而且調(diào)用trim()后,長度必須大于0('test') 即:必須有實(shí)際字符總結(jié)
到此這篇關(guān)于Spring boot validation校驗(yàn)的文章就介紹到這了,更多相關(guān)Springboot validation校驗(yàn)內(nèi)容請(qǐng)搜索好吧啦網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持好吧啦網(wǎng)!
相關(guān)文章:
1. 如何利用python操作注冊(cè)表2. Xml簡介_動(dòng)力節(jié)點(diǎn)Java學(xué)院整理3. jsp文件下載功能實(shí)現(xiàn)代碼4. 詳解瀏覽器的緩存機(jī)制5. ASP動(dòng)態(tài)網(wǎng)頁制作技術(shù)經(jīng)驗(yàn)分享6. jsp實(shí)現(xiàn)登錄驗(yàn)證的過濾器7. phpstudy apache開啟ssi使用詳解8. vue3+ts+elementPLus實(shí)現(xiàn)v-preview指令9. 如何在jsp界面中插入圖片10. JSP之表單提交get和post的區(qū)別詳解及實(shí)例
