springmvc项目使用@Valid+BindingResult遇到的问题

 更新时间:2021年12月02日 14:28:57   作者:大妖怪-kane  
这篇文章主要介绍了springmvc项目使用@Valid+BindingResult遇到的问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教

今天在一个老的dubbo+springmvc结构的项目做一个接口。通过controller的方式,因为参数复杂,所以想通过@valid+BindingResult的方式做参数校验。

在springcloude+springboot中,maven的依赖无需你去考虑,一般都引用好了。但是在老的springmvc中,还是需要你自己添加一下引用的。

看了网上的一些资料,往往都忽略着这部分,所以@valid一致无效,也不报错,BindingResult的errors数量是0。后来经过多方查找,资料拼凑,终于解决了这个问题。这里记录一下。

第一步:pom.xml中引入

javax.validation和hibernate-validator

<!-- springmvc的参数valid校验依赖 开始 -->
		<dependency>
			<groupId>javax.validation</groupId>
			<artifactId>validation-api</artifactId>
			<version>2.0.1.Final</version>
		</dependency>
		<dependency>
			<groupId>org.hibernate</groupId>
			<artifactId>hibernate-validator</artifactId>
			<version>6.0.16.Final</version>
		</dependency>
<!-- springmvc的参数valid校验依赖 结束 -->

之前我只引入了javax的验证,这样做系统不会报错。就是bindingResult返回的errors一直为0。校验不起作用。

第二步:创建需要校验的参数bean类

需要引入的类:

import javax.validation.constraints.Min;
import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Pattern;
@Component
public class UserScheduleByManualBean implements Serializable { 
	/**
	 * 
	 */
	private static final long serialVersionUID = 8093326646402381469L; 
	@NotBlank(message = "赛事不能为空")
	private String matchEventName; // 赛事名称
 
	@NotBlank(message = "发枪时间不能为空")
	@Pattern(regexp = "((([0-9]{3}[1-9]|[0-9]{2}[1-9][0-9]{1}|[0-9]{1}[1-9][0-9]{2}|[1-9][0-9]{3})-(((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01]))|((0[469]|11)-(0[1-9]|[12][0-9]|30))|(02-(0[1-9]|[1][0-9]|2[0-8]))))|((([0-9]{2})(0[48]|[2468][048]|[13579][26])|((0[48]|[2468][048]|[3579][26])00))-02-29))\\s([0-1][0-9]|2[0-3]):([0-5][0-9]):([0-5][0-9])$", message = "发枪格式错误")
	private String gunTime; // 发枪时间
	
	@NotNull(message = "国家ID不能为空")
	@Min(value = 0,message = "国家ID数据格式错误")
	private int dicCountryId; // 国家ID
	
	@NotBlank(message = "国家名称不能为空")
	private String countryName; // 国家名称
	
	@NotNull(message = "省份ID不能为空")
	@Min(value = 0,message = "省份ID数据格式错误")
	private int dicProvinceId; // 省份ID
	@NotBlank(message = "省份名称不能为空")
	private String provinceName; // 省份名称
	
	@NotNull(message = "城市ID不能为空")
	@Min(value = 0,message = "城市ID数据格式错误")
	private int dicCityId; // 城市ID
	@NotBlank(message = "城市名称不能为空")
	private String cityName; // 城市名称	
	
	private String projectName; // 项目名称
	private String remarks; // 说明 可以为空
	private String bib; // 赛号 可以为空
 
    //get和set方法忽略
}

这里一定要注意两个问题

1: bean上加@Component注解,并且spring配置要扫描到这个包,否则也不生效。

2: @valid方式校验,有很多限制注解(后面附表)。不通的限制注解,对应的数据类型不一样。比如:@Pattern注解,只能在String类型上使用。我一开始希望int的属性也直接通过正则做校验。结果报错:HV000030: No validator could be found for constraint 'javax.validation.constraints.Pattern' validating type 'java.lang.Integer'

3: 注解可以多个

第三步:写controller类

首先,我们先创建一个BaseController抽象类,其中有BindingResult校验方法,其他所有的controller继承该类实现校验。

引入的java类:

       import org.springframework.validation.BindingResult;
       import javax.validation.Valid;
public abstract class BaseController { 
	/**
	 * 校验通过bean当参数的验证结果方法
	 * @param bindingResult
	 * @return
	 */
	protected Map<String, Object> validate(BindingResult bindingResult) { 
		Map<String, Object> ret = new HashMap<>();
		boolean isTrue = true;
		StringBuilder sb = new StringBuilder("");
		if (bindingResult.hasErrors()) {
			bindingResult.getAllErrors().forEach(o ->{
                FieldError error = (FieldError) o;
                sb.append("|" + error.getDefaultMessage());//	添加错误信息
            });
			isTrue = false;
		} 
		ret.put("isTrue", isTrue);
		ret.put("message", sb.toString());// 错误信息
		return ret;
	}
}

其次,我们创建业务的controller类,继承BaseController。

@Api(value = "TestController-API", description = "测试操作接口")
@Controller
@RequestMapping("testController/*")
public class TestController extends BaseController { 
    @RequestMapping(value = "tstex", method = RequestMethod.POST, produces = "application/json;charset=UTF-8")
	@ApiOperation(value = "测试异常方法", notes = "测试异常方法")
	public @ResponseBody String tstex(@Valid @RequestBody UserScheduleByManualBean userScheduleByManualBean,
			BindingResult bindingResult) {
		Map<String, Object> ret = new HashMap<>();
 
		// 校验userScheduleByManualBean是否合法
		Map<String, Object> validRet = validate(bindingResult);
		boolean isTrue = (Boolean) validRet.get("isTrue");
		if (!isTrue) {
			// 参数不合法
			String erroMsg = (String) validRet.get("message");
			ret.put("resultCode", “0001”);
			ret.put("resultDesc", “参数错误” + erroMsg);
			return JsonUtil.gson_ObjectToJSON(ret);
		} 
		ret.put("resultCode", “0000”);
		ret.put("resultDesc", “成功”);
		return JsonUtil.gson_ObjectToJSON(ret);
	}
}

这里需要注意的问题:@Valid和@RequestBody是有位置关系的,必须@Valid在前面。BindingResult bindingResult作为参数传递进来,然后通过validate校验参数,并设置统一的返回结果。

通过swagger运行结果如下:

附 件

限制注解 说明 限制类型 样例
@Null 限制只能为null 全部 @Null(message="")
@NotNull 限制必须不为null 全部 @NotNull(message="")
@AssertFalse 限制必须为false
@AssertTrue 限制必须为true
@DecimalMax(value) 限制必须为一个不大于指定值的数字
@DecimalMin(value) 限制必须为一个不小于指定值的数字
@Digits(integer,fraction) 限制必须为一个小数,且整数部分的位数不能超过integer,小数部分的位数不能超过fraction
@Future 限制必须是一个将来的日期
@Max(value) 限制必须为一个不大于指定值的数字 int @Max(value=100,message="")
@Min(value) 限制必须为一个不小于指定值的数字 int @Min(value=100,message="")
@Past 限制必须是一个过去的日期
@Pattern(value) 限制必须符合指定的正则表达式 String

@Pattern(regexp="",message="")

@Size(max,min) 限制字符长度必须在min到max之间
@NotEmpty 验证注解的元素值不为null且不为空(字符串长度不为0、集合大小不为0) String

@NotEmpty(message = "")

@NotBlank 验证注解的元素值不为空(不为null、去除首位空格后长度为0),不同于@NotEmpty,@NotBlank只应用于字符串且在比较时会去除字符串的空格 String

@NotBlank(message = "")

@Email 验证注解的元素值是Email,也可以通过正则表达式和flag指定自定义的email格式 String

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • ES多条件查询写法举例

    ES多条件查询写法举例

    这篇文章主要给大家介绍了关于ES多条件查询的相关资料,Elasticsearch多条件查询是指在查询数据时,可以同时使用多个条件来筛选数据,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2023-11-11
  • Java实现计网循环冗余检验算法的方法示例

    Java实现计网循环冗余检验算法的方法示例

    这篇文章主要给大家介绍了关于Java实现计网循环冗余检验算法的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-04-04
  • Java使用POI从Excel读取数据并存入数据库(解决读取到空行问题)

    Java使用POI从Excel读取数据并存入数据库(解决读取到空行问题)

    有时候需要在java中读取excel文件的内容,专业的方式是使用java POI对excel进行读取,这篇文章主要给大家介绍了关于Java使用POI从Excel读取数据并存入数据库,文中介绍的办法可以解决读取到空行问题,需要的朋友可以参考下
    2023-12-12
  • java多线程的同步方法实例代码

    java多线程的同步方法实例代码

    这篇文章主要介绍了 java多线程的同步方法实例代码的相关资料,需要的朋友可以参考下
    2017-04-04
  • Java容器HashMap与HashTable详解

    Java容器HashMap与HashTable详解

    本文主要介绍HashMap 和 Hashtable的工作原理和使用方法,有兴趣的朋友可以参考
    2017-04-04
  • 详解feign调用session丢失解决方案

    详解feign调用session丢失解决方案

    这篇文章主要介绍了详解feign调用session丢失解决方案,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-02-02
  • java统计字符串中重复字符出现次数的方法

    java统计字符串中重复字符出现次数的方法

    这篇文章主要介绍了java统计字符串中重复字符出现次数的方法,涉及java针对字符串的遍历与判断相关操作技巧,需要的朋友可以参考下
    2016-08-08
  • Java数据结构学习之栈和队列

    Java数据结构学习之栈和队列

    这篇文章主要介绍了Java数据结构学习之栈和队列,文中有非常详细的代码示例,对正在学习java的小伙伴们有一定的帮助,需要的朋友可以参考下
    2021-05-05
  • Java删除String中指定字符的11种方法汇总

    Java删除String中指定字符的11种方法汇总

    这篇文章主要给大家介绍了关于Java删除String中指定字符的11种方法,在Java中String类提供了许多方法来处理字符串,其中包括删除指定字符的方法,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2023-11-11
  • SpringBoot返回Json对象报错(返回对象为空{})

    SpringBoot返回Json对象报错(返回对象为空{})

    本文主要介绍介绍了SpringBoot返回Json对象报错(返回对象为空{}),文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-01-01

最新评论