外贸网站后台企业信用信息网公示网官网查询

外贸网站后台,企业信用信息网公示网官网查询,12306的网站建设,本科学历提升一、 背景与痛点 在 Spring Boot 后端开发中#xff0c;我们经常遇到需要前端传递 “状态码”、“类型” 或 “场景码” 的情况。这些值在后端通常对应一个枚举#xff08;Enum#xff09;。 例如#xff0c;发送短信的场景#xff08;scene#xff09;#xff1a; 1: 登…一、 背景与痛点在 Spring Boot 后端开发中我们经常遇到需要前端传递“状态码”、“类型”或“场景码”的情况。这些值在后端通常对应一个枚举Enum。例如发送短信的场景scene1: 登录2: 忘记密码3: 注册痛点在于如果前端传了一个99不存在的场景或者传了一个非法的数字如果后端只用了NotNull这个非法值会穿透 Controller 进入 Service 层导致业务逻辑报错如空指针或者产生脏数据。我们需要一个机制像保安一样手里拿着一份“白名单”只有在枚举范围内定义过的值才允许通过。本文将带你实现一个高性能的自定义注解InEnum。二、 核心架构设计为了实现通用且高性能的校验我们需要三个组件配合接口 (ArrayValuable)定义统一的规范要求枚举类必须提供一个“返回所有合法值”的方法。注解 (InEnum)标注在 DTO 字段上指定使用哪个枚举类作为白名单。校验器 (InEnumValidator)执行具体的校验逻辑。1. 定义统一接口为了让校验器能读懂所有的枚举我们需要定义一个接口。publicinterfaceArrayValuableT{/** * return 返回枚举中所有合法的数值集合 */T[]array();}2. 定义注解 InEnum这是 JSR-303 标准的自定义注解写法。Target({ElementType.METHOD,ElementType.FIELD,ElementType.PARAMETER})Retention(RetentionPolicy.RUNTIME)DocumentedConstraint(validatedByInEnumValidator.class)// 指定校验器publicinterfaceInEnum{/** * return 必须传入实现 ArrayValuable 接口的枚举类 */Class?extendsArrayValuable?value();Stringmessage()default必须在指定范围 {value};Class?[]groups()default{};Class?extendsPayload[]payload()default{};}关键点解析Class? extends ArrayValuable? value();这里利用泛型限定强制要求使用该注解时传入的 Class 必须是实现了ArrayValuable接口的类。这在编译期就杜绝了乱传 Class 的可能。3. 实现校验器 InEnumValidator这是“执法者”负责初始化白名单并进行比对。publicclassInEnumValidatorimplementsConstraintValidatorInEnum,Object{// 缓存白名单避免每次校验都去反射计算privateList?values;Overridepublicvoidinitialize(InEnumannotation){// 1. 获取注解传入的枚举类的所有实例value()返回的就是实现了ArrayValuable接口的类// getEnumConstants()返回的就是实现类中的所有枚举类型ArrayValuable?[]constantsannotation.value().getEnumConstants();if(constants.length0){this.valuesCollections.emptyList();}else{// 2. 【核心】随便拿第一个实例调用接口的 array() 方法拿到白名单// 利用了接口多态性根本不需要关心具体是哪个 Enumthis.valuesArrays.asList(constants[0].array());}}OverridepublicbooleanisValid(Objectvalue,ConstraintValidatorContextcontext){// Object value指的是Inenum标注的字段也就是前端传入的// 1. 判空放行非空校验交给 NotNull 处理保持职责单一if(valuenull){returntrue;}// 2. 校验通过值在白名单内if(values.contains(value)){returntrue;}// 3. 校验失败自定义友好的报错信息// 禁用默认提示改写为必须在指定范围 [1, 2, 3]context.disableDefaultConstraintViolation();context.buildConstraintViolationWithTemplate(context.getDefaultConstraintMessageTemplate().replaceAll(\\{value},values.toString())).addConstraintViolation();returnfalse;}}三、 最佳实践案例SmsSceneEnum有了基础设施我们来看看在业务中如何优雅地使用。这里展示一个高性能的枚举写法。1. 编写枚举类GetterAllArgsConstructorpublicenumSmsSceneEnumimplementsArrayValuableInteger{MEMBER_LOGIN(1,user-sms-login,会员用户 - 手机号登陆),MEMBER_UPDATE_MOBILE(2,user-update-mobile,会员用户 - 修改手机),MEMBER_UPDATE_PASSWORD(3,user-update-password,会员用户 - 修改密码),// ... 其他枚举值ADMIN_MEMBER_LOGIN(21,admin-sms-login,后台用户 - 手机号登录);// 【性能黑科技】// 在类加载时就利用 Stream 流计算好所有合法的 scene 值存入静态数组。// 避免了每次调用 array() 方法都要去遍历 values()极大提升性能。publicstaticfinalInteger[]ARRAYSArrays.stream(values()).map(SmsSceneEnum::getScene).toArray(Integer[]::new);privatefinalIntegerscene;privatefinalStringtemplateCode;privatefinalStringdescription;// 实现接口方法直接返回计算好的静态数组OverridepublicInteger[]array(){returnARRAYS;}// ... getCodeByScene 等其他方法}2. 在 DTO 中使用DatapublicclassSmsSendReqVO{Schema(description手机号,requiredModeSchema.RequiredMode.REQUIRED)Mobile// 假设有一个手机号格式校验注解privateStringmobile;Schema(description发送场景,requiredModeSchema.RequiredMode.REQUIRED,example1)NotNull(message发送场景不能为空)// 一行代码搞定白名单校验InEnum(valueSmsSceneEnum.class,message发送场景必须是 {value})privateIntegerscene;}四、 运行原理深度解析当前端请求接口时整个校验流程如下Spring 启动/首次调用时InEnumValidator的initialize方法被触发。它拿到SmsSceneEnum.class。它获取SmsSceneEnum的第一个实例MEMBER_LOGIN。它调用MEMBER_LOGIN.array()。关键点array()方法直接返回了SmsSceneEnum中预先计算好的static final ARRAYS([1, 2, 3, 21])。Validator 将这个 List 存入内存this.values。前端请求到来 (scene 99)进入isValid方法。判断values.contains(99)。结果为false。拦截请求抛出异常。前端收到错误提示发送场景必须是 [1, 2, 3, 21]。