【SpringMVC】JSR 303与拦截器注释使用

目录

[一、JSR 303](#一、JSR 303)

[1.1 JSR 303介绍](#1.1 JSR 303介绍)

[1.2 为什么要使用JSR-303](#1.2 为什么要使用JSR-303)

[1.3 常用注解](#1.3 常用注解)

[1.4 使用示例](#1.4 使用示例)

[1.4.1 导入JSR303依赖](#1.4.1 导入JSR303依赖)

[1.4.2 配置校验规则](#1.4.2 配置校验规则)

[1.4.3 编写方法校验](#1.4.3 编写方法校验)

[1.4.4 编写前端](#1.4.4 编写前端)

[1.4.5 测试](#1.4.5 测试)

​编辑

[1.5 @Validated与@Valid区别](#1.5 @Validated与@Valid区别)

二、拦截器(interceptor)

[2.1 什么是拦截器 ?](#2.1 什么是拦截器 ?)

[2.2 拦截器与过滤器的区别](#2.2 拦截器与过滤器的区别)

[2.3 拦截器的应用场景及作用](#2.3 拦截器的应用场景及作用)

[2.4 快速入门](#2.4 快速入门)

[2.4.1 创建拦截器](#2.4.1 创建拦截器)

[2.4.2 配置拦截器](#2.4.2 配置拦截器)

[2.4.3 运行测试](#2.4.3 运行测试)

[2.5 拦截器工作流程](#2.5 拦截器工作流程)

[2.6 拦截器链](#2.6 拦截器链)

[2.7 登录操作拦截案例](#2.7 登录操作拦截案例)


一、JSR 303

1.1 JSR 303介绍

JSR 303,它是Java EE(现在称为Jakarta EE)规范中的一部分。JSR 303定义了一种用于验证Java对象的标准规范,也称为Bean验证。

Bean验证是一种用于验证对象属性的框架,它可以确保对象符合特定的规则和约束。这些规则可以包括字段的非空性、长度限制、格式验证等。通过使用Bean验证,开发人员可以在应用程序中轻松地定义和应用验证规则,以确保数据的完整性和一致性。

1.2 为什么要使用JSR-303

当我们开发应用程序时,经常需要对用户输入的数据进行验证,以确保数据的有效性和一致性。例如,我们可能需要验证用户注册表单中的用户名是否符合要求、密码是否足够强壮、电子邮件地址是否有效等等。

在学这个之前我们都是通过前端进行验证的,如果说前端代码校验没写好又或者是对于会一点编程的人来说,可以直接绕过前端发请求(通过类似Postman这样的测试工具进行非常数据请求),把一些错误的参数传过来,这样是不安全的。

所以我们一般都是前端做一套校验,后端再做一套校验,这样安全性就能够大大得到提升了。

总的来说,使用JSR 303可以让数据验证过程更加简单、直观和可靠。它可以帮助我们减少重复的验证代码,提高代码的可读性和可维护性,减少错误和漏洞的出现,并提高开发效率。因此,JSR 303是一个有用的工具,可以在开发过程中帮助我们更好地处理数据验证的需求。

1.3 常用注解

注解 说明
@Null 用于验证对象为null
@NotNull 用于对象不能为null,无法查检长度为0的字符串
@NotBlank 只用于String类型上,不能为null且trim()之后的size>0
@NotEmpty 用于集合类、String类不能为null,且size>0。但是带有空格的字符串校验不出来
@Size 用于对象(Array,Collection,Map,String)长度是否在给定的范围之内
@Length 用于String对象的大小必须在指定的范围内
@Pattern 用于String对象是否符合正则表达式的规则
@Email 用于String对象是否符合邮箱格式
@Min 用于Number和String对象是否大等于指定的值
@Max 用于Number和String对象是否小等于指定的值
@AssertTrue 用于Boolean对象是否为true
@AssertFalse 用于Boolean对象是否为false

1.4 使用示例

1.4.1 导入JSR303依赖

java 复制代码
<!-- JSR303 -->
<hibernate.validator.version>6.0.7.Final</hibernate.validator.version>

<!-- JSR303 -->
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>${hibernate.validator.version}</version>
</dependency>

1.4.2 配置校验规则

java 复制代码
package com.ycxw.model;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.hibernate.validator.constraints.Length;

import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull;

@Data//相当于set get toString方法
@AllArgsConstructor //有参构造器
@NoArgsConstructor //无参构造器
public class User {
    @NotNull(message = "用户编号不能为空")
    private Long id;

    @NotBlank(message = "用户名不能为空")
    private String name;

    @NotBlank(message = "账号不能为空")
    private String loginname;

    @Length(min = 6, max = 15, message = "用户名长度是6-15位")
    private String pwd;
    //权限
    private Long rid;
}

1.4.3 编写方法校验

使用@Validated注解对User对象进行服务端校验。User对象需要使用JSR 303注解进行属性验证规则的定义。

java 复制代码
    //给数据添加服务端校验
    @RequestMapping("/valiAdd")
    public String valiAdd(@Validated User user, BindingResult result, HttpServletRequest req) {
        //如果服务端验证不通过,有错误 boolean
        if (result.hasErrors()) {
            //得到所有错误
            List<FieldError> fieldErrors = result.getFieldErrors();
            //创建集合保存错误信息,用户传输到前端进行显示
            Map<String, Object> map = new HashMap<>();
            //迭代错误
            for (FieldError fieldError : fieldErrors) {
                //将多个属性的验证失败信息输送到控制台
                System.out.println(fieldError.getField() + ":" + fieldError.getDefaultMessage());
                //保存错误信息
                map.put(fieldError.getField(), fieldError.getDefaultMessage());
            }
            //将集合保存到域对象
            req.setAttribute("errorMap", map);
        } else {
            //如果校验没有错误则进行增加
            this.userBiz.insertSelective(user);
            //返回到主页
            return "redirect:list";
        }
        //校验错误继续在本界面
        return "user/edit";
    }

1.4.4 编写前端

通过span标签形式将后端保存的错误信息输出在页面。

java 复制代码
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>用户编辑、新增公共页面</title>
</head>
<body>
<form action="${pageContext.request.contextPath }/${empty u ? 'users/valiAdd' : 'users/edit'}" method="post">
    用户id:<input type="text" name="id" value="${u.id }"><span style="color: red">${errorMap.id}</span><br>
    用户名:<input type="text" name="name" value="${u.name }"><span style="color: red">${errorMap.naem}</span><br>
    账号:<input type="text" name="loginname" value="${u.loginname }"><span style="color: red">${errorMap.loginname}</span><br>
    密码:<input type="text" name="pwd" value="${u.pwd }"><span style="color: red">${errorMap.pwd}</span><br>
    权限:<input type="text" name="rid" value="${u.rid }"><span style="color: red">${errorMap.rid}</span><br>
    <input type="submit">
</form>
</body>
</html>

1.4.5 测试

控制条输出:

1.5 @Validated与@Valid区别

@Validated:

  • Spring提供的

  • 支持分组校验

  • 可以用在类型、方法和方法参数上。但是不能用在成员属性(字段)上

  • 由于无法加在成员属性(字段)上,所以无法单独完成级联校验,需要配合@Valid

@Valid:

  • JDK提供的(标准JSR-303规范)

  • 不支持分组校验

  • 可以用在方法、构造函数、方法参数和成员属性(字段)上

  • 可以加在成员属性(字段)上,能够独自完成级联校验

二、拦截器(interceptor)

2.1 什么是拦截器 ?

SpringMVC的处理器拦截器,类似于Servlet开发中的过滤器Filter,用于对处理器进行预处理和后处理还有请求拦截和过滤。依赖于web框架,在实现上基于Java的反射机制,属于面向切面编程(AOP)的一种运用。由于拦截器是基于web框架的调用,因此可以使用Spring的依赖注入(DI)进行一些业务操作,同时一个拦截器实例在一个 controller生命周期之内可以多次调用。

拦截器主要用于实现以下功能:

  1. 预处理操作:拦截器可以在请求被处理之前进行一些预处理操作,例如参数校验、权限验证、请求日志记录等。这样可以在进入具体的请求处理逻辑之前,对请求进行一些统一的处理。

  2. 后处理操作:拦截器可以在请求处理完成后进行一些后处理操作,例如统一的异常处理、结果封装、响应日志记录等。这样可以在请求处理完成后,对响应进行一些统一的处理。

  3. 请求拦截和过滤:拦截器可以对请求进行拦截和过滤,根据一定的条件判断是否允许请求继续处理。例如,可以根据用户的权限进行拦截,如果用户没有权限访问某个资源,可以直接拦截请求并返回相应的错误信息。

例如在Java的Spring框架中,可以通过实现HandlerInterceptor接口来创建自定义的拦截器。在Spring中,拦截器可以通过配置来指定拦截的路径和顺序,以及是否拦截子路径等。

拦截器的执行顺序一般是根据配置的顺序来确定的,可以通过配置来控制拦截器的执行顺序。在请求处理过程中,拦截器会按照配置的顺序依次执行,每个拦截器都可以对请求进行拦截、处理和修改。

总之,拦截器是一种在请求处理过程中对请求进行拦截和处理的组件,可以用于实现一些预处理、后处理、请求拦截和过滤等功能。它提供了一种灵活的机制,可以对请求进行统一的处理和控制。

2.2拦截器与过滤器的区别

什么是过滤器(Filter):

依赖于servlet容器。在实现上基于函数回调,可以对几乎所有请求进行过滤,但是缺点是一个过滤器实例只能在容器初始化时调用一次。使用过滤器的目的是用来做一些过滤操作,比如:在过滤器中修改字符编码;在过滤器中修改HttpServletRequest的一些参数,包括:过滤低俗文字、危险字符等。

  • 过滤器(filter)

    1.filter属于Servlet技术,只要是web工程都可以使用

    2.filter主要由于对所有请求过滤

    3.filter的执行时机早于Interceptor

  • 拦截器(interceptor)

    1.interceptor属于SpringMVC技术,必须要有SpringMVC环境才可以使用

    2.interceptor通常由于对处理器Controller进行拦截

    3.interceptor只能拦截dispatcherServlet处理的请求

2.3 拦截器的应用场景及作用

  1. 权限验证:拦截器可以用于验证用户的权限,例如检查用户是否登录、是否具有访问某个资源的权限等。通过拦截请求并进行权限验证,可以保护系统的安全性和数据的完整性。

  2. 日志记录:拦截器可以用于记录请求和响应的日志信息,包括请求的URL、请求参数、处理时间、响应结果等。通过记录日志,可以方便地进行系统的监控、故障排查和性能优化。

  3. 参数预处理:拦截器可以对请求参数进行预处理,例如对参数进行验证、转换、修正等操作。这样可以确保请求参数的有效性和一致性,减少错误和异常的发生。

  4. 异常处理:拦截器可以用于统一处理请求过程中出现的异常。通过拦截异常并进行统一的处理,可以提供友好的错误提示页面或返回特定的错误信息,提高系统的容错性和用户体验。

  5. 缓存控制:拦截器可以用于控制缓存的使用,例如根据请求的URL、参数等条件判断是否使用缓存,以及缓存的过期时间等。通过拦截请求并进行缓存控制,可以提高系统的性能和响应速度。

  6. 请求重定向:拦截器可以根据一定的条件对请求进行重定向,将请求转发到其他的URL或处理器进行处理。通过拦截请求并进行重定向,可以实现请求的转发、路由和流程控制。

  7. 统一处理:拦截器可以用于实现一些统一的处理逻辑,例如对请求进行统一的编码转换、字符集设置、响应头设置等。通过拦截请求并进行统一处理,可以提高系统的一致性和可维护性。

拦截器在Web开发中的应用非常广泛,它可以对请求进行拦截、处理和修改,实现权限验证、日志记录、参数预处理、异常处理、缓存控制、请求重定向和统一处理等功能。通过使用拦截器,可以提高系统的安全性、稳定性、性能和可维护性。

2.4 快速入门

2.4.1 创建拦截器

java 复制代码
package com.ycxw.interceptor;

import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/*
1. 定义拦截器类,实现HandlerInterceptor接口
2. 注意当前类必须受Spring容器控制
 */
public class OneInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("【OneInterceptor】:preHandle...");

        return true;
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("【OneInterceptor】:postHandle...");

    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("【OneInterceptor】:afterCompletion...");
    }
}

2.4.2 配置拦截器

在spring-mvc.xml中配置:

java 复制代码
    <!--配置拦截器-->
    <mvc:interceptors>
        <bean class="com.ycxw.interceptor.OneInterceptor"></bean>
    </mvc:interceptors>

2.4.3 运行测试

启动项目,打开浏览器访问请求地址,测试拦截器你会发现他们运行顺序是

复制代码
preHandle --> postHandle --> afterCompletion

http://localhost:8080/demo/hello

2.5 拦截器工作流程

  1. 当有拦截器后,请求会先进入preHandle方法,
  2. 如果方法返回true,则放行继续执行后面的handle[controller的方法]和后面的方法
  3. 如果返回false,则直接跳过后面方法的执行。
  • preHandle:用于对拦截到的请求进行预处理,方法接收布尔(true,false)类型的返回值,返回true:放行,false:不放行。

    执行时机:在处理器方法执行前执行

    方法参数

    参数 说明
    request 请求对象
    response 响应对象
    handler 拦截到的方法处理
  • postHandle:用于对拦截到的请求进行后处理,可以在方法中对模型数据和视图进行修改

    执行时机:在处理器的方法执行后,视图渲染之前

    方法参数

    参数 说明
    request 请求对象
    response 响应对象
    handler 拦截到的处理器方法
    ModelAndView 处理器方法返回的模型和视图对象,可以在方法中修改模型和视图
  • afterCompletion:用于在整个流程完成之后进行最后的处理,如果请求流程中有异常,可以在方法中获取对象

    执行时机:视图渲染完成后(整个流程结束之后)

    方法参数

    参数 说明
    request 请求参数
    response 响应对象
    handler 拦截到的处理器方法
    ex 异常对象

2.6 拦截器链

在spring-mvc.xml中配置多个拦截器

java 复制代码
    <!--2) 多拦截器(拦截器链)-->
    <mvc:interceptors>
            <mvc:interceptor>
                <!--拦截所有-->
                <mvc:mapping path="/**"/>
                <bean class="com.ycxw.interceptor.OneInterceptor"/>
            </mvc:interceptor>
            <mvc:interceptor>
                <!--拦截users下的controller-->
                <mvc:mapping path="/users/**"/>
                <bean class="com.ycxw.interceptor.TwoInterceptor"/>
            </mvc:interceptor>
    </mvc:interceptors>

运行测试: 走了两个拦截器,如果运行的是 http://localhost:8080/file/list 将不会执行Two...拦截器。

2.7 登录操作拦截案例

具体解析在代码上做了注解 :

**步骤一:**创建拦截器

java 复制代码
package com.ycxw.interceptor;

import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class LoginInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("【implements】:preHandle...");
        //获取请求路径
        StringBuffer url = request.getRequestURL();
        //判断是否为登录和退出登入请求
        if (url.indexOf("/login") > 0 || url.indexOf("/logout") > 0) {
            //如果是 登录、退出 中的一种
            return true;
        }
        //代表不是登录,也不是退出
        //除了登录、退出,其他操作都需要判断是否 session 登录成功过
        String uname = (String) request.getSession().getAttribute("uname");
        if (uname == null || "".equals(uname)) {
            response.sendRedirect("/page/login");
            return false;
        }
        return true;
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {

    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {

    }
}

**步骤二:**配置拦截器

复制代码
<mvc:interceptors>
    <bean class="com.ycxw.interceptor.LoginInterceptor"></bean>
</mvc:interceptors>

**步骤三:**编写处理登录操作控制层

java 复制代码
package com.ycxw.web;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpSession;

/**
 * @author 云村小威
 * @create 2023-09-12 15:04
 */
@Controller
public class LoginController {
    @RequestMapping("/login")
    public String login(HttpServletRequest req) {
        //获取请求参数
        String uname = req.getParameter("uname");
        //创建session对象
        HttpSession session = req.getSession();
        //这里定死的为ycxw
        if ("ycxw".equals(uname)) {
            session.setAttribute("uname", uname);
        }
        //返回主页面
        return "redirect:/users/list";
    }

    @RequestMapping("/logout")
    public String logout(HttpServletRequest req) {
        //退出登录操作:清空session的存储
        req.getSession().invalidate();
        //返回主界面
        /*
        这里会被拦截,就会判断session是否有值,没有将会返回登录界面
         */
        return "redirect:/users/list";
    }
}

**步骤四:**编写前端界面

java 复制代码
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>登录界面</title>
</head>
<body>
<h1>登录界面</h1>
<form action="/login" method="post">
    账号:<input name="uname">
    <input type="submit">
</form>
</body>
</html>

操作演示:

1. 登录

2. 退出

相关推荐
求知若饥11 分钟前
NestJS 项目实战-权限管理系统开发(六)
后端·node.js·nestjs
禁默40 分钟前
深入浅出:AWT的基本组件及其应用
java·开发语言·界面编程
Cachel wood1 小时前
python round四舍五入和decimal库精确四舍五入
java·linux·前端·数据库·vue.js·python·前端框架
Code哈哈笑1 小时前
【Java 学习】深度剖析Java多态:从向上转型到向下转型,解锁动态绑定的奥秘,让代码更优雅灵活
java·开发语言·学习
gb42152871 小时前
springboot中Jackson库和jsonpath库的区别和联系。
java·spring boot·后端
程序猿进阶1 小时前
深入解析 Spring WebFlux:原理与应用
java·开发语言·后端·spring·面试·架构·springboot
zfoo-framework1 小时前
【jenkins插件】
java
风_流沙1 小时前
java 对ElasticSearch数据库操作封装工具类(对你是否适用嘞)
java·数据库·elasticsearch
颜淡慕潇1 小时前
【K8S问题系列 |19 】如何解决 Pod 无法挂载 PVC问题
后端·云原生·容器·kubernetes