广州网站开发公司,石碣仿做网站,徐州土地交易网,用什么网站可以做介绍–什么是JSR303
JSR 303是Java中的一项规范#xff0c;用于定义在Java应用程序中执行数据校验的元数据模型和API。JSR 303的官方名称是Bean Validation#xff0c;它提供了一种在Java对象级别上执行验证的方式#xff0c;通常用于确保输入数据的完整性和准…介绍–什么是JSR303
JSR 303是Java中的一项规范用于定义在Java应用程序中执行数据校验的元数据模型和API。JSR 303的官方名称是Bean Validation它提供了一种在Java对象级别上执行验证的方式通常用于确保输入数据的完整性和准确性。
JSR 303中最常见的用法是使用注解在Java Bean上添加验证规则。以下是一些常用的注解 此实现与 Hibernate ORM 没有任何关系。 JSR 303 用于对 Java Bean 中的字段的值进行验证。 Spring MVC 3.x 之中也大力支持 JSR-303可以在控制器中对表单提交的数据方便地验证。 注:可以使用注解的方式进行验证
JSR 303 基本的校验规则
空检查
Null 验证对象是否为nullNotNull 验证对象是否不为null, 无法查检长度为0的字符串NotBlank 检查约束字符串是不是Null还有被Trim的长度是否大于0, 只对字符串, 且会去掉前后空格.NotEmpty 检查约束元素是否为NULL或者是EMPTY.
Booelan检查
AssertTrue 验证 Boolean 对象是否为 trueAssertFalse 验证 Boolean 对象是否为 false
其他校验
Size(min, max): 检查值的长度是否在指定范围内。 Min(value): 检查数字值是否大于等于指定值。 Max(value): 检查数字值是否小于等于指定值。 Pattern(regex): 使用正则表达式检查字符串值。 Email: 检查字符串是否为有效的电子邮件地址等。
在实体类或者vo类使用验证规则,可以大幅度减轻数据校验的规范性价比。
具体使用
添加依赖 dependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-validation/artifactId/dependencydependencygroupIdjakarta.servlet/groupIdartifactIdjakarta.servlet-api/artifactIdscopeprovided/scope/dependency对需要使用校验的字段添加注解
信息可以进行传值设置,不然就是默认值
NotEmpty(message 品牌名必须填写)Schema(description 品牌名)private String name;默认信息如下
在控制层开启校验
在控制层开启该注解Validated即可开启校验 public ResultString update(Validated RequestBody PmsBrandVO vo){pmsBrandService.update(vo);return Result.ok();}自定义校验失败
上诉的步骤中,校验失败,不满足条件的会抛出异常,所以为了和前端配合需要进行自定义异常处理,返回前端一个json,而不是服务端抛出异常 BindException 在需要返回json的校验bean后跟,BindingResult,校验绑定结果类,对异常进行处理 public ResultString save(Validated({AddGroup.class}) RequestBody PmsBrandVO vo, BindingResult result){
//
// 形参单个添加这个可以,但是批量很难实现,为此需要自定义异常处理
// 需要取求掉该注解,才可以将异常抛出if (result.hasErrors()){String message result.getFieldErrors().stream().map(fieldError - {// 获取到错误字段String field fieldError.getField();// 获取到自定义的错误消息提示String errMessage fieldError.getDefaultMessage();// 返回拼接的错误消息字符串return field : errMessage;}).collect(Collectors.joining(, )); // 将错误消息用逗号分隔
log.info(错误消息:{},message);
// 创建一个 Result 对象将错误消息传递给它return Result.error(message);}else {pmsBrandService.save(vo);return Result.ok();}但是上诉只样也只是对单个控制器校验校验为此,需要自己,定义异常处理结果
自定义异常处理器 处理校验失败异常
1.把控制层的结构异常结果绑定类进行删除,让控制器将异常进行抛出 2.自定义异常处理
/*** 异常处理器* 用于集中处理所有异常情况并确保返回给前端的是处理过的 JSON 信息而不是异常信息。*/Slf4j
RestControllerAdvice//监听rescontroller的增强方法 advice增强 对应还有controllelrAdvice
public class ServerExceptionHandler {/*** 处理自定义异常* param ex 抛出的自定义异常* return 包含异常信息的 Result 对象*/ExceptionHandler(ServerException.class)//捕获的异常类型public ResultString handleException(ServerException ex) {return Result.error(ex.getCode(), ex.getMsg());}/*** 处理 Spring MVC 参数绑定、Validator 校验不正确的异常* param ex 抛出的绑定异常* return 包含异常信息的 Result 对象*/ExceptionHandler(BindException.class)public ResultString bindException(BindException ex) {FieldError fieldError ex.getFieldError();assert fieldError ! null;return Result.error(fieldError.getDefaultMessage());}/*** 处理访问被拒绝的异常* param ex 抛出的访问被拒绝异常* return 包含异常信息的 Result 对象*/ExceptionHandler(AccessDeniedException.class)public ResultString handleAccessDeniedException(Exception ex) {return Result.error(ErrorCode.FORBIDDEN);}/*** 未知异常类型用于处理未捕获的其他异常情况*/ExceptionHandler(Exception.class)public ResultString handleException(Exception ex) {log.error(ex.getMessage(), ex);return Result.error(ErrorCode.INTERNAL_SERVER_ERROR);}}这样就可以做到统一处理,异常结果
高级功能
自定义校验注解
如果现有的异常处理结果满足不了我们对字段的需求,那么可以进行自定义校验注解,在自定义校验注解之前,我们需要了解自定义校验注解
自定义注解
注解有些元注解,以及生命周期都是很简单的概念,这里讲一下大致 自定义注解主要通过interface关键字来定义。 自定义注解的组成包括
注解声明使用interface关键字。 元注解Meta-annotations 用于注解其他注解的注解。常用的元注解有Target、Retention、- Documented和Inherited。
Target指定注解可以应用的Java元素类型如METHOD, FIELD等。Retention指定注解在哪一个级别可用,生命周期源代码中SOURCE、类文件中CLASS或运行时RUNTIME,而我们定义的大部分注解都是在运行时候,用来进行操作日志保存和权限校验 注解体定义注解的属性。 其他的注解关键字,点开任意注解都可以了解大概
演示
我这里定义自定义注解,模拟操作前进行的日志保存 首先启动开启注解功能
EnableAspectJAutoProxy/*** 所有的Annotation 会自动继承java.lang.Annotation这一接口,并且不能再去继承别的类或是接口。*/
Target({ElementType.CONSTRUCTOR, ElementType.METHOD, ElementType.PARAMETER, ElementType.FIELD, ElementType.ANNOTATION_TYPE})
Retention(RetentionPolicy.RUNTIME)
public interface Prelog {String message() default 执行前先打印的日志信息;
}在我的业务控制器上添加注解
好了现在我的注解定义好了,并且让我的方法使用上了注解,但是这样注解是没办法知道我们的业务逻辑的, 所以需要实现他的逻辑,这里运用到了aop详细了解aop思想,大概就是对目标做增强,在不改变源码的基础上
引入aop的依赖 dependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-aop/artifactId/dependency定义一个切面类,对我自定义注解进行逻辑实现
Aspect
Component
Slf4j
public class PrelogAspect {//切点使用LogAnnotation注解标识的方法都进行切入也可以使用通配符配置具体要切入的方法名Pointcut(annotation(com.mall.Annotation.Prelog))public void pointCut(){}//环绕通知/*** 在AOP中joinPoint.proceed()方法用于继续执行切入点处的原始方法。换句话说它实际上调用了被切入的方法无论是类的构造函数、方法或字段初始化等。* 在你的情况下你的切点是使用Prelog注解标识的方法因此当切点匹配到一个被Prelog注解标记的方法时joinPoint.proceed()方法会执行该方法。因此在Around通知中joinPoint.proceed()执行的就是被Prelog注解标记的方法。* 所以Object jsonResult joinPoint.proceed();这行代码实际上执行了被Prelog注解标记的方法并将其结果存储在jsonResult变量中。这个变量可以在切面中进一步处理或返回给调用方。* param joinPoint* return* throws Throwable*/Around(pointCut())public Object logAround(ProceedingJoinPoint joinPoint) throws Throwable {try {System.out.println(开始执行注解逻辑);// 获取目标方法签名MethodSignature signature (MethodSignature) joinPoint.getSignature();// 获取目标方法Method method signature.getMethod();// 获取注解值Prelog annotation method.getAnnotation(Prelog.class);// 获取属性String message annotation.message();System.out.println(message);// 执行目标方法Object jsonResult joinPoint.proceed(); // 执行方法return jsonResult;} catch (Exception e) {e.printStackTrace();throw e; // 抛出异常}}}访问被标记注解的接口
当然自定义注解配合aop还可以做权限校验,访问接口前判断是否有对应权限
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.reflect.MethodSignature;
import org.springframework.stereotype.Component;Aspect
Component
public class PermissionAspect {Around(annotation(CheckPermission))public Object checkPermission(ProceedingJoinPoint joinPoint) throws Throwable {MethodSignature signature (MethodSignature) joinPoint.getSignature();CheckPermission annotation signature.getMethod().getAnnotation(CheckPermission.class);String permission annotation.value();// 这里模拟权限校验逻辑if (!hasPermission(permission)) {throw new SecurityException(没有权限执行此操作);}return joinPoint.proceed(); // 执行原方法}private boolean hasPermission(String permission) {/***根据该用户在系统的上下文 对照是否拥有该权限**/// 模拟权限校验逻辑实际中应替换为具体的校验逻辑// 例如检查当前用户是否拥有该权限// 这里简单模拟总是返回truereturn true;}
}好了大概了解自定义注解和aop的原理进行实现,自定义校验数据的注解
自定义校验注解实现
1.定义校验注解 我这里定义的是判断字段的值是否是我设置的集合中的值
/*** 1.编写一个自定义注解作用于多个元素校验*/
Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE })
Retention(RUNTIME)
Documented
Constraint(validatedBy {OptionListConstraint.class })//3.指定使用什么校验器 可以指定多个校验器
public interface OptionList {/*** 1.1改造validate注解的基本属性* 注解的类型只能是基本类型和布尔值以及枚举,字符串* return*///2.定义自己需要的注解属性int[] values() default {0,1};//默认该注解的这个属性是01String message() default 必须提交指定的数值;//原min注解的默认消息定义在租界中华这个Class?[] groups() default { };
//做校验的时候自定义负载参数Class? extends Payload[] payload() default { };
}2.对注解进行实现 jsr中的注解进行注解校验都是通过实现校验器接口实现的,点开Constrain注解
所以需要实现该接口
/*** 2.对校验器进行重写* 实现该接口的俩个方法* 参数校验注解,校验对象类型* 就是自定义注解中的逻辑实现*/
public class OptionListConstraint implements ConstraintValidatorOptionList, Integer {private SetInteger set new HashSetInteger();//初始化方法// 参数为校验注解// 可以在该方法中获取校验注解中的属性值Overridepublic void initialize(OptionList constraintAnnotation) {//1.得到赋于注解的数值int[] values constraintAnnotation.values();//2.将数值赋值给setfor (int i : values) {set.add(i);}}/*** 判断是否校验成功* param value object to validate 需要校验的对象 也就是赋值的属性字段的值* param context context in which the constraint is evaluated 上下文对象** return*/Overridepublic boolean isValid(Integer value, ConstraintValidatorContext context) {// 判断当前的值是否在set集合中return set.contains(value);}
}校验分组
这个行为类似于范围限制,比如,对于id主键字段,我们在新增时候是需要前端不传递的,修改又需要前端传递,为此对与不同状态进行分组处理
定义俩个接口 表示不同组别 无需写什么方法 2.限定字段校验范围,那些字段是什么组别的时候进行校验 3.控制层 对应校验赋值时标明组别 注意注解是Validated 不是Valid
