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

注解	说明
@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依赖


6.0.7.Final
 
    org.hibernate
    hibernate-validator
    ${hibernate.validator.version}

1.4.2 配置校验规则


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注解进行属性验证规则的定义。


    //给数据添加服务端校验
    @RequestMapping("/valiAdd")
    public String valiAdd(@Validated User user, BindingResult result, HttpServletRequest req) {
        //如果服务端验证不通过，有错误 boolean
        if (result.hasErrors()) {
            //得到所有错误
            List fieldErrors = result.getFieldErrors();
            //创建集合保存错误信息，用户传输到前端进行显示
            Map 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标签形式将后端保存的错误信息输出在页面。


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

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生命周期之内可以多次调用。

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

预处理操作：拦截器可以在请求被处理之前进行一些预处理操作，例如参数校验、权限验证、请求日志记录等。这样可以在进入具体的请求处理逻辑之前，对请求进行一些统一的处理。
后处理操作：拦截器可以在请求处理完成后进行一些后处理操作，例如统一的异常处理、结果封装、响应日志记录等。这样可以在请求处理完成后，对响应进行一些统一的处理。
请求拦截和过滤：拦截器可以对请求进行拦截和过滤，根据一定的条件判断是否允许请求继续处理。例如，可以根据用户的权限进行拦截，如果用户没有权限访问某个资源，可以直接拦截请求并返回相应的错误信息。

例如在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 拦截器的应用场景及作用

权限验证：拦截器可以用于验证用户的权限，例如检查用户是否登录、是否具有访问某个资源的权限等。通过拦截请求并进行权限验证，可以保护系统的安全性和数据的完整性。
日志记录：拦截器可以用于记录请求和响应的日志信息，包括请求的URL、请求参数、处理时间、响应结果等。通过记录日志，可以方便地进行系统的监控、故障排查和性能优化。
参数预处理：拦截器可以对请求参数进行预处理，例如对参数进行验证、转换、修正等操作。这样可以确保请求参数的有效性和一致性，减少错误和异常的发生。
异常处理：拦截器可以用于统一处理请求过程中出现的异常。通过拦截异常并进行统一的处理，可以提供友好的错误提示页面或返回特定的错误信息，提高系统的容错性和用户体验。
缓存控制：拦截器可以用于控制缓存的使用，例如根据请求的URL、参数等条件判断是否使用缓存，以及缓存的过期时间等。通过拦截请求并进行缓存控制，可以提高系统的性能和响应速度。
请求重定向：拦截器可以根据一定的条件对请求进行重定向，将请求转发到其他的URL或处理器进行处理。通过拦截请求并进行重定向，可以实现请求的转发、路由和流程控制。
统一处理：拦截器可以用于实现一些统一的处理逻辑，例如对请求进行统一的编码转换、字符集设置、响应头设置等。通过拦截请求并进行统一处理，可以提高系统的一致性和可维护性。

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

2.4 快速入门

2.4.1 创建拦截器


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中配置：


    
    
        "com.ycxw.interceptor.OneInterceptor">

2.4.3 运行测试

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

preHandle --> postHandle --> afterCompletion

http://localhost:8080/demo/hello

2.5 拦截器工作流程

当有拦截器后，请求会先进入preHandle方法，
如果方法返回true，则放行继续执行后面的handle[controller的方法]和后面的方法
如果返回false，则直接跳过后面方法的执行。

preHandle：用于对拦截到的请求进行预处理，方法接收布尔(true,false)类型的返回值，返回true：放行，false：不放行。

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

方法参数

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

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

方法参数

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

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

方法参数

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

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

参数	说明
request	请求对象
response	响应对象
handler	拦截到的处理器方法
ModelAndView	处理器方法返回的模型和视图对象，可以在方法中修改模型和视图

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

2.6 拦截器链

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


    
    
            
                
                "/**"/>
                "com.ycxw.interceptor.OneInterceptor"/>
            
            
                
                "/users/**"/>
                "com.ycxw.interceptor.TwoInterceptor"/>

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

2.7 登录操作拦截案例

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

步骤一：创建拦截器


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 {
 
    }
}

步骤二：配置拦截器

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


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";
    }
}

步骤四：编写前端界面


<%@ page contentType="text/html;charset=UTF-8" language="java" %>
    登录界面
登录界面
"/login" method="post">
    账号："uname">
    "submit">

操作演示：

1. 登录

2. 退出

相关阅读:
（2021，中文，双向生成，端到端，双向稀疏注意力）ERNIE-ViLG：双向视觉语言生成的统一生成预训练
 基于SSM的在线投稿系统设计与实现
 Kubernetes 使用 containerd 做为 CRI
快速幂算法
 netcore基于asp.net的校园二手闲置商品交易系统
 树莓派安装retropie 打造属于你的小霸王街机游戏机
 SDRAM 控制器（三）——自动刷新模块
 达芬奇DaVinci Resolve Studio 18.6.3 for Mac
人工智能在电力系统的典型应用有哪些
 【蓝桥杯选拔赛真题26】python统计字符个数青少年组蓝桥杯python 选拔赛STEMA比赛真题解析
原文地址：https://blog.csdn.net/Justw320/article/details/132826452