SYSTEM
实用技术
src/content/notes/system/实用技术.md 实用技术
校验框架
校验概述
表单校验保障了数据有效性、安全性
校验分类:客户端校验和服务端校验
- 格式校验
- 客户端:使用 js 技术,利用正则表达式校验
- 服务端:使用校验框架
- 逻辑校验
- 客户端:使用ajax发送要校验的数据,在服务端完成逻辑校验,返回校验结果
- 服务端:接收到完整的请求后,在执行业务操作前,完成逻辑校验
表单校验框架:
-
JSR(Java Specification Requests):Java 规范提案
-
303:提供bean属性相关校验规则
-
JCP(Java Community Process):Java社区
-
Hibernate框架中包含一套独立的校验框架hibernate-validator
-
导入坐标:
<!--导入校验的jsr303规范--> <dependency> <groupId>javax.validation</groupId> <artifactId>validation-api</artifactId> <version>2.0.1.Final</version> </dependency> <!--导入校验框架实现技术--> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-validator</artifactId> <version>6.1.0.Final</version> </dependency>
注意:
- tomcat7:搭配 hibernate-validator 版本 5...Final
- tomcat8.5:搭配 hibernate-validator 版本 6...Final
基本使用
开启校验
名称:@Valid、@Validated
类型:形参注解
位置:处理器类中的实体类类型的方法形参前方
作用:设定对当前实体类类型参数进行校验
范例:
@RequestMapping(value = "/addemployee")
public String addEmployee(@Valid Employee employee) {
System.out.println(employee);
}
校验规则
名称:@NotNull
类型:属性注解等
位置:实体类属性上方
作用:设定当前属性校验规则
范例:每个校验规则所携带的参数不同,根据校验规则进行相应的调整,具体的校验规则查看对应的校验框架进行获取
public class Employee{
@NotNull(message = "姓名不能为空")
private String name;//员工姓名
}
错误信息
@RequestMapping(value = "/addemployee")
//Errors对象用于封装校验结果,如果不满足校验规则,对应的校验结果封装到该对象中,包含校验的属性名和校验不通过返回的消息
public String addEmployee(@Valid Employee employee, Errors errors, Model model){
System.out.println(employee);
//判定Errors对象中是否存在未通过校验的字段
if(errors.hasErrors()){
for(FieldError error : errors.getFieldErrors()){
//将校验结果添加到Model对象中,用于页面显示,返回json数据即可
model.addAttribute(error.getField(),error.getDefaultMessage());
}
//当出现未通过校验的字段时,跳转页面到原始页面,进行数据回显
return "addemployee.jsp";
}
return "success.jsp";
}
通过形参Errors获取校验结果数据,通过Model接口将数据封装后传递到页面显示,页面获取后台封装的校验结果信息
<form action="/addemployee" method="post">
员工姓名:<input type="text" name="name"><span style="color:red">${name}</span><br/>
员工年龄:<input type="text" name="age"><span style="color:red">${age}</span><br/>
<input type="submit" value="提交">
</form>
多规则校验
-
同一个属性可以添加多个校验器
public class Employee{ @NotBlank(message = "姓名不能为空") private String name;//员工姓名 @NotNull(message = "请输入年龄") @Max(value = 60,message = "年龄最大值60") @Min(value = 18,message = "年龄最小值18") private Integer age;//员工年龄 } -
三种判定空校验器的区别

嵌套校验
名称:@Valid
类型:属性注解
位置:实体类中的引用类型属性上方
作用:设定当前应用类型属性中的属性开启校验
范例:
public class Employee {
//实体类中的引用类型通过标注@Valid注解,设定开启当前引用类型字段中的属性参与校验
@Valid
private Address address;
}
注意:开启嵌套校验后,被校验对象内部需要添加对应的校验规则
//嵌套校验的实体中,对每个属性正常添加校验规则即可
public class Address implements Serializable {
@NotBlank(message = "请输入省份名称")
private String provinceName;//省份名称
@NotBlank(message = "请输入邮政编码")
@Size(max = 6,min = 6,message = "邮政编码由6位组成")
private String zipCode;//邮政编码
}
分组校验
分组校验的介绍
- 同一个模块,根据执行的业务不同,需要校验的属性会有不同
- 新增用户
- 修改用户
- 对不同种类的属性进行分组,在校验时可以指定参与校验的字段所属的组类别
- 定义组(通用)
- 为属性设置所属组,可以设置多个
- 开启组校验
domain:
//用于设定分组校验中的组名,当前接口仅提供字节码,用于识别
public interface GroupOne {
}
public class Employee{
@NotBlank(message = "姓名不能为空",groups = {GroupA.class})
private String name;//员工姓名
@NotNull(message = "请输入年龄",groups = {GroupA.class})
@Max(value = 60,message = "年龄最大值60")//不加Group的校验不生效
@Min(value = 18,message = "年龄最小值18")
private Integer age;//员工年龄
@Valid
private Address address;
//......
}
controller:
@Controller
public class EmployeeController {
@RequestMapping(value = "/addemployee")
public String addEmployee(@Validated({GroupA.class}) Employee employee, Errors errors, Model m){
if(errors.hasErrors()){
List<FieldError> fieldErrors = errors.getFieldErrors();
System.out.println(fieldErrors.size());
for(FieldError error : fieldErrors){
m.addAttribute(error.getField(),error.getDefaultMessage());
}
return "addemployee.jsp";
}
return "success.jsp";
}
}
jsp:
<form action="/addemployee" method="post"><%--页面使用${}获取后台传递的校验信息--%>
员工姓名:<input type="text" name="name"><span style="color:red">${name}</span><br/>
员工年龄:<input type="text" name="age"><span style="color:red">${age}</span><br/>
<%--注意,引用类型的校验未通过信息不是通过对象进行封装的,直接使用对象名.属性名的格式作为整体属性字符串进行保存的,和使用者的属性传递方式有关,不具有通用性,仅适用于本案例--%>
省:<input type="text" name="address.provinceName"><span style="color:red">${requestScope['address.provinceName']}</span><br/>
<input type="submit" value="提交">
/form>
Lombok
Lombok 用标签方式代替构造器、getter/setter、toString() 等方法
引入依赖:
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</dependency>
下载插件:IDEA 中 File → Settings → Plugins,搜索安装 Lombok 插件
常用注解:
@NoArgsConstructor // 无参构造
@AllArgsConstructor // 全参构造
@Data // set + get
@ToString // toString
@EqualsAndHashCode // hashConde + equals
简化日志:
@Slf4j
@RestController
public class HelloController {
@RequestMapping("/hello")
public String handle01(@RequestParam("name") String name){
log.info("请求进来了....");
return "Hello, Spring!" + "你好:" + name;
}
}