SpringBoot 2.x 开发案例之优雅的校验参数


前言

参数如何校验?撸主很久很久之前的项目都是在前端页面一个个 if else 的,后来就用了一系列的前端校验框架,比如 layui iview 等等,几个样式属性就可以轻松搞定,的确是美滋滋。

后端验证

那么问题来了?前端已经验证了,后端还有必要验证吗?

如果非要有个结果,答案只能是不安全的。虽然客户端自己对自己已经做了验证,但是你不能避免一些恶意用户人为的修改表单直接发送欺骗请求。

所以说,从安全的角度来说,单纯的依靠前端验证,是不安全的,任何健壮的系统都必须在后端进行验证。

当然,你也不必担心后台再写一坨if else,这里推荐大家一款参数校验神器 Hibernate-Validator SpringBoot的标配JPA是自带的,小伙伴们直接使用即可。

注解

基本提供了常用的校验注解,如果不满足业务,可以通过@Pattern自行定义正则表达式。

@Null  被注释的元素必须为null
@NotNull  被注释的元素不能为null
@AssertTrue  被注释的元素必须为true
@AssertFalse  被注释的元素必须为false
@Min(value)  被注释的元素必须是一个数字,其值必须大于等于指定的最小值
@Max(value)  被注释的元素必须是一个数字,其值必须小于等于指定的最大值
@DecimalMin(value)  被注释的元素必须是一个数字,其值必须大于等于指定的最小值
@DecimalMax(value)  被注释的元素必须是一个数字,其值必须小于等于指定的最大值
@Size(max,min)  被注释的元素的大小必须在指定的范围内。
@Digits(integer,fraction)  被注释的元素必须是一个数字,其值必须在可接受的范围内
@Past  被注释的元素必须是一个过去的日期
@Future  被注释的元素必须是一个将来的日期
@Pattern(value) 被注释的元素必须符合指定的正则表达式。
@Email 被注释的元素必须是电子邮件地址
@Length 被注释的字符串的大小必须在指定的范围内
@NotEmpty  被注释的字符串必须非空
@Range  被注释的元素必须在合适的范围内

案例

这里以用户注册为例:

@Data
@Entity
@Table(name = "sys_user")
public class SysUser implements Serializable{
   /**
    * 用户id 
    */ 
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "user_id", nullable = false, length = 20)
    private Long userId;

   /**
    * 用户名 
    */
    @NotNull
    @Column(name = "username", nullable = false, length = 50)
    private String username;

   /**
    * 密码 
    */
    @Size(min = 6, max = 25, message = "密码长度要求6到25之间")
    @Column(name = "password", nullable = false, length = 50)
    private String password;

   /**
    * 姓名(昵称) 
    */ 
    @NotNull
    @Column(name = "nickname", length = 50)
    private String nickname;

   /**
    * 邮箱 
    */
    @Email(message="邮箱格式不正确")
    @Column(name = "email", length = 100)
    private String email;

   /**
    * 手机号 
    */
    @Pattern(regexp="^((13[0-9])|(14[5|7])|(15([0-3]|[5-9]))|(17[013678])|(18[0,5-9]))\\d{8}$",message="手机格式不正确")
    @Column(name = "mobile", length = 100)
    private String mobile;

   /**
    * 状态 0:禁用,1:正常 
    */ 
    @Column(name = "status", length = 4)
    private Short status;

   /**
    * 备注 
    */ 
    @Column(name = "remark", length = 500)
    private String remark;

   /**
    * 创建用户id 
    */ 
    @Column(name = "user_id_create")
    private Long userIdCreate;

   /**
    * 创建时间 
    */
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    @Column(name = "gmt_create")
    private Timestamp gmtCreate;

   /**
    * 修改时间 
    */
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    @Column(name = "gmt_modified")
    private Timestamp gmtModified;
}

小结

是不是很爽,再也不用 if else 了,当然后台还没校验的另说!最后还是建议各位小伙伴,把安全校验做充分,省的以后前后端扯皮,最重要的是避免背锅!!!

爪哇笔记

作者: 小柒

出处: https://blog.52itstyle.vip

分享是快乐的,也见证了个人成长历程,文章大多都是工作经验总结以及平时学习积累,基于自身认知不足之处在所难免,也请大家指正,共同进步。

本文版权归作者所有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出, 如有问题, 可邮件(345849402@qq.com)咨询。