目录
一、JSR 303
1.1 JSR 303介绍
1.2 为什么要使用JSR-303
1.3 常用注解
1.4 使用示例
1.4.1 导入JSR303依赖
1.4.2 配置校验规则
1.4.3 编写方法校验
1.4.4 编写前端
1.4.5 测试
编辑
1.5 @Validated与@Valid区别
二、拦截器(interceptor)
2.1 什么是拦截器 ?
2.2 拦截器与过滤器的区别
2.3 拦截器的应用场景及作用
2.4 快速入门
2.4.1 创建拦截器
2.4.2 配置拦截器
2.4.3 运行测试
2.5 拦截器工作流程
2.6 拦截器链
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对象是否符合正则表达式的规则 |
用于String对象是否符合邮箱格式 | |
@Min | 用于Number和String对象是否大等于指定的值 |
@Max | 用于Number和String对象是否小等于指定的值 |
@AssertTrue | 用于Boolean对象是否为true |
@AssertFalse | 用于Boolean对象是否为false |
1.4 使用示例
1.4.1 导入JSR303依赖
<!-- 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 配置校验规则
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<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标签形式将后端保存的错误信息输出在页面。
<%@ 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生命周期之内可以多次调用。
拦截器主要用于实现以下功能:
-
预处理操作:拦截器可以在请求被处理之前进行一些预处理操作,例如参数校验、权限验证、请求日志记录等。这样可以在进入具体的请求处理逻辑之前,对请求进行一些统一的处理。
-
后处理操作:拦截器可以在请求处理完成后进行一些后处理操作,例如统一的异常处理、结果封装、响应日志记录等。这样可以在请求处理完成后,对响应进行一些统一的处理。
-
请求拦截和过滤:拦截器可以对请求进行拦截和过滤,根据一定的条件判断是否允许请求继续处理。例如,可以根据用户的权限进行拦截,如果用户没有权限访问某个资源,可以直接拦截请求并返回相应的错误信息。
例如在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中配置:
<!--配置拦截器-->
<mvc:interceptors>
<bean class="com.ycxw.interceptor.OneInterceptor"></bean>
</mvc:interceptors>
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 异常对象
2.6 拦截器链
在spring-mvc.xml中配置多个拦截器
<!--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 登录操作拦截案例
具体解析在代码上做了注解 :
步骤一:创建拦截器
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>
步骤三:编写处理登录操作控制层
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" %>
<html>
<head>
<title>登录界面</title>
</head>
<body>
<h1>登录界面</h1>
<form action="/login" method="post">
账号:<input name="uname">
<input type="submit">
</form>
</body>
</html>
操作演示:
1. 登录
2. 退出