详解如何在Spring Boot项目使用参数校验

发布时间 - 2026-01-11 01:44:05    点击率:

开发web项目有时候我们需要对controller层传过来的参数进行一些基本的校验,比如非空,非null,整数值的范围,字符串的个数,日期,邮箱等等。最常见的就是我们直接写代码校验,这样以后比较繁琐,而且不够灵活。

Bean Validation 1.0(JSR-303)是一个校验规范,在spring Boot项目由于自带了hibernate validator 5(http://hibernate.org/validator/)实现,所以我们可以非常方便的使用这个特性 。

核心的pom依赖:

<dependency>
  <groupId>org.hibernate</groupId>
  <artifactId>hibernate-validator</artifactId>
  <version>5.3.1.Final</version>
</dependency>

首先,需要我们声明一个Bean,注入校验器到Spring Boot的运行环境

@Configuration
@EnableAutoConfiguration
public class FactoryConfig {
  
  final static Logger logger= LoggerFactory.getLogger(FactoryConfig.class);
 
  @Bean
  public MethodValidationPostProcessor methodValidationPostProcessor(){
   return new MethodValidationPostProcessor();
  }
  
  }

校验常用的注解如下:

@AssertFalse 校验false
@AssertTrue 校验true
@DecimalMax(value=,inclusive=) 小于等于value,
inclusive=true,是小于等于
@DecimalMin(value=,inclusive=) 与上类似
@Max(value=) 小于等于value
@Min(value=) 大于等于value
@NotNull 检查Null
@Past 检查日期
@Pattern(regex=,flag=) 正则
@Size(min=, max=) 字符串,集合,map限制大小
@Valid 对po实体类进行校验

下面看一个使用例子:

package hello;

import javax.validation.constraints.Min;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;

public class PersonForm {

  //名字不能为空,而且长度必须在2和30之间
  @NotNull(message = "名称不能为空")
  @Size(min=2, max=30, message = "名字长度必须在2和30之间")
  private String name;
  
  //年龄不能为空,而且必须大于等于18岁
  @NotNull
  @Min(18)
  private Integer age;

  public String getName() {
    return this.name;
  }

  public void setName(String name) {
    this.name = name;
  }

  public Integer getAge() {
    return age;
  }

  public void setAge(Integer age) {
    this.age = age;
  }

  public String toString() {
    return "Person(Name: " + this.name + ", Age: " + this.age + ")";
  }
}

接着看下如何在Controller层使用

//非实体类参数可以直接使用注解
 @GetMapping("/check")
@ResponseBody
public String check(@Min(0,message = "kpId必须大于等于0") @RequestParam int kpId,@RequestParam int level) {
    return "ok";
}
  //实体类注解校验使用@Valid
  @PostMapping("/")
  public String checkPersonInfo(@Valid PersonForm personForm, BindingResult bindingResult) {
    if (bindingResult.hasErrors()) {
      return "form";
    }
    return "redirect:/results";
  }

注意上面的Spring提供的BindingResult是错误结果的一个封装,我们可以在web页面中通过这个对象拿到详细的错误信息,

<td th:if="${#fields.hasErrors('age')}" th:errors="*{age}">Age Error</td>

总结:

通过使用注解来快速检验传入的web参数还是非常简洁强大的,这里仅仅列举了一小部分的校验的知识,希望对大家的学习有所帮助,也希望大家多多支持。


# spring  # boot  # 参数校验 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 1688铺货到淘宝怎么操作 1688一键铺货到自己店铺详细步骤  php在windows下怎么调试_phpwindows环境调试操作说明【操作】  Laravel怎么上传文件_Laravel图片上传及存储配置  JavaScript模板引擎Template.js使用详解  PHP 实现电台节目表的智能时间匹配与今日/明日轮播逻辑  文字头像制作网站推荐软件,醒图能自动配文字吗?  如何在搬瓦工VPS快速搭建网站?  香港代理服务器配置指南:高匿IP选择、跨境加速与SEO优化技巧  如何获取免费开源的自助建站系统源码?  Laravel怎么实现观察者模式Observer_Laravel模型事件监听与解耦开发【指南】  Bootstrap CSS布局之列表  魔毅自助建站系统:模板定制与SEO优化一键生成指南  安克发布新款氮化镓充电宝:体积缩小 30%,支持 200W 输出  用yum安装MySQLdb模块的步骤方法  详解vue.js组件化开发实践  Claude怎样写约束型提示词_Claude约束提示词写法【教程】  Laravel如何使用Facades(门面)及其工作原理_Laravel门面模式与底层机制  北京网页设计制作网站有哪些,继续教育自动播放怎么设置?  JavaScript如何实现倒计时_时间函数如何精确控制  UC浏览器如何设置启动页 UC浏览器启动页设置方法  香港服务器租用每月最低只需15元?  Windows10如何删除恢复分区_Win10 Diskpart命令强制删除分区  Laravel如何使用Seeder填充数据_Laravel模型工厂Factory批量生成测试数据【方法】  做企业网站制作流程,企业网站制作基本流程有哪些?  Laravel如何生成和使用数据填充?(Seeder和Factory示例)  如何在阿里云购买域名并搭建网站?  网站视频制作书签怎么做,ie浏览器怎么将网站固定在书签工具栏?  Laravel Admin后台管理框架推荐_Laravel快速开发后台工具  PHP怎么接收前端传的文件路径_处理文件路径参数接收方法【汇总】  Python正则表达式进阶教程_复杂匹配与分组替换解析  使用豆包 AI 辅助进行简单网页 HTML 结构设计  如何获取上海专业网站定制建站电话?  Windows10电脑怎么设置虚拟光驱_Win10右键装载ISO镜像文件  PHP 500报错的快速解决方法  教你用AI将一段旋律扩展成一首完整的曲子  Laravel怎么实现搜索功能_Laravel使用Eloquent实现模糊查询与多条件搜索【实例】  WordPress 子目录安装中正确处理脚本路径的完整指南  Laravel怎么做缓存_Laravel Cache系统提升应用速度的策略与技巧  Linux后台任务运行方法_nohup与&使用技巧【技巧】  微信h5制作网站有哪些,免费微信H5页面制作工具?  如何在Ubuntu系统下快速搭建WordPress个人网站?  Laravel Seeder怎么填充数据_Laravel数据库填充器的使用方法与技巧  Internet Explorer官网直接进入 IE浏览器在线体验版网址  如何快速生成凡客建站的专业级图册?  Laravel如何使用Service Provider服务提供者_Laravel依赖注入与容器绑定【深度】  Laravel如何生成URL和重定向?(路由助手函数)  大连网站制作费用,大连新青年网站,五年四班里的视频怎样下载啊?  5种Android数据存储方式汇总  清除minerd进程的简单方法  Laravel如何设置定时任务(Cron Job)_Laravel调度器与任务计划配置