当前位置：首页 > news >正文

策略模式与元数据映射模式融合 JSR 380 验证规范实现枚举范围校验

news 来源：原创 2025/6/29 15:01:29

类文件

@Target({ElementType.METHOD,ElementType.FIELD,ElementType.ANNOTATION_TYPE,ElementType.CONSTRUCTOR,ElementType.PARAMETER,ElementType.TYPE_USE
})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Constraint(validatedBy = {InEnumValidator.class, InEnumCollectionValidator.class}
)
public @interface InEnum {/*** @return 实现 ArrayValuable 接口的类*/Class<? extends ArrayValuable<?>> value();String message() default "必须在指定范围 {value}";Class<?>[] groups() default {};Class<? extends Payload>[] payload() default {};}

public class InEnumCollectionValidator implements ConstraintValidator<InEnum, Collection<?>> {private List<?> values;@Overridepublic void initialize(InEnum annotation) {ArrayValuable<?>[] values = annotation.value().getEnumConstants();if (values.length == 0) {this.values = Collections.emptyList();} else {this.values = Arrays.asList(values[0].array());}}@Overridepublic boolean isValid(Collection<?> list, ConstraintValidatorContext context) {if (list == null) {return true;}// 校验通过if (CollUtil.containsAll(values, list)) {return true;}// 校验不通过，自定义提示语句context.disableDefaultConstraintViolation(); // 禁用默认的 message 的值context.buildConstraintViolationWithTemplate(context.getDefaultConstraintMessageTemplate().replaceAll("\\{value}", CollUtil.join(list, ","))).addConstraintViolation(); // 重新添加错误提示语句return false;}
}

public class InEnumValidator implements ConstraintValidator<InEnum, Object> {private List<?> values;@Overridepublic void initialize(InEnum annotation) {ArrayValuable<?>[] values = annotation.value().getEnumConstants();if (values.length == 0) {this.values = Collections.emptyList();} else {this.values = Arrays.asList(values[0].array());}}@Overridepublic boolean isValid(Object value, ConstraintValidatorContext context) {// 为空时，默认不校验，即认为通过if (value == null) {return true;}// 校验通过if (values.contains(value)) {return true;}// 校验不通过，自定义提示语句context.disableDefaultConstraintViolation(); // 禁用默认的 message 的值context.buildConstraintViolationWithTemplate(context.getDefaultConstraintMessageTemplate().replaceAll("\\{value}", values.toString())).addConstraintViolation(); // 重新添加错误提示语句return false;}
}

public interface ArrayValuable<T> {/*** @return 数组*/T[] array();}

@Getter
@AllArgsConstructor
public enum CommonStatusEnum implements ArrayValuable<Integer> {ENABLE(0, "开启"),DISABLE(1, "关闭");public static final Integer[] ARRAYS = Arrays.stream(values()).map(CommonStatusEnum::getStatus).toArray(Integer[]::new);/*** 状态值*/private final Integer status;/*** 状态名*/private final String name;@Overridepublic Integer[] array() {return ARRAYS;}public static boolean isEnable(Integer status) {return ObjUtil.equal(ENABLE.status, status);}public static boolean isDisable(Integer status) {return ObjUtil.equal(DISABLE.status, status);}}

1. 策略模式（Strategy Pattern）

核心体现

InEnumValidator 和 InEnumCollectionValidator 是两个不同的验证策略：
- InEnumValidator：验证单个值是否在枚举允许范围内
- InEnumCollectionValidator：验证集合中所有元素是否都在枚举允许范围内
通过 @Constraint(validatedBy = {…}) 动态选择验证策略，符合策略模式的多态特性。

模式优势

开闭原则：新增验证类型（如数组验证）只需添加新策略类，无需修改已有代码。
解耦验证逻辑：将不同场景的校验规则分离到独立类中。

2. 元数据映射模式（Metadata Mapping Pattern）

核心体现

ArrayValuable 接口：通过 array() 方法将枚举值映射为统一元数据格式（数组）。
InEnum 注解：通过 value() 属性关联具体枚举类，建立校验规则与元数据的映射关系。

代码示例

// 元数据定义：CommonStatusEnum 提供状态数组
public enum CommonStatusEnum implements ArrayValuable<Integer> {ENABLE(0, "开启"), DISABLE(1, "关闭");public static final Integer[] ARRAYS = Arrays.stream(values()).map(...);@Override public Integer[] array() { return ARRAYS; }
}// 元数据使用：验证器通过 ArrayValuable 获取校验范围
public class InEnumValidator implements ConstraintValidator<InEnum, Object> {private List<?> values;@Override public void initialize(InEnum annotation) {ArrayValuable<?>[] values = annotation.value().getEnumConstants();this.values = Arrays.asList(values[0].array());}
}

模式优势

统一元数据接口：所有实现 ArrayValuable 的枚举自动具备提供校验范围的能力。
动态元数据获取：通过反射机制实现运行时元数据解析。

3. JSR 380 规范扩展

核心体现

自定义注解 @InEnum：通过实现 ConstraintValidator 接口扩展标准校验规则。
校验逻辑复用：InEnumValidator 和 InEnumCollectionValidator 复用相同的元数据映射逻辑。

典型应用场景

// 在 DTO 中使用自定义校验注解
public class UserStatusDTO {@InEnum(CommonStatusEnum.class)private Integer status; // 自动校验 status 是否为 0 或 1
}

4. 设计优势总结

特性	实现方式
扩展性	新增枚举只需实现 ArrayValuable，无需修改验证逻辑
类型安全	通过泛型 ArrayValuable 保证元数据类型与校验值类型一致
校验语义明确	@InEnum(CommonStatusEnum.class) 直观表达业务约束
错误提示友好	通过 context.buildConstraintViolationWithTemplate 动态生成错误信息

5. 同类设计对比

传统硬编码校验方式：

// 非模式化的校验逻辑（缺乏扩展性）
if (!(status == 0 || status == 1)) {throw new IllegalArgumentException("状态值无效");
}

对比优势：当前设计通过策略+元数据映射，实现校验逻辑与业务代码解耦，符合现代化框架的声明式校验趋势。

策略模式与元数据映射模式融合 JSR 380 验证规范实现枚举范围校验

类文件 Target({ElementType.METHOD,ElementType.FIELD,ElementType.ANNOTATION_TYPE,ElementType.CONSTRUCTOR,ElementType.PARAMETER,ElementType.TYPE_USE }) Retention(RetentionPolicy.RUNTIME) Documented Constraint(validatedBy {InEnumValidator.class, InEnumColle…...

编程日记 2025/6/29 15:01:29

9对象树(3)

目录创建自定义的类，最主要的目的,是自定义一个析构函数,在析构函数中,完成打印.方便咱们看到最终的自动销毁对象的效果!!! 写完一个函数的声名之后, 按下 altenter, 在按下enter就可以自动的在对应的 cpp 文件中添加函数的定义了内置类型，析构不会明…...

编程日记 2025/6/28 4:25:45

深入 OpenPDF：高级 PDF 生成与操作技巧

1 引言 1.1 项目背景在许多企业级应用中，生成和操作 PDF 文档是一个常见的需求。PDF（Portable Document Format）因其格式统一、易于打印和分发而被广泛使用。本文将介绍如何使用 OpenPDF 库在 Java 项目中生成和操作 PDF 文档。 1.2 技术选型理由 OpenPDF：OpenPDF 是一…...

编程日记 2025/6/29 14:58:45

电脑屏幕亮度随心控，在Windows上自由调整屏幕亮度的方法

调整电脑屏幕的亮度对于保护视力和适应不同环境光线条件非常重要。无论是在白天强光下还是夜晚昏暗环境中，合适的屏幕亮度都能让您的眼睛更加舒适。本文中简鹿办公小编将向您介绍几种在 Windows 系统中调整屏幕亮度的方法。方法一：使用快捷键大多数笔…...

编程日记 2025/6/29 2:18:18

Navicat导出mysql数据库表结构说明到excel、word，单表导出方式记录

目前只找到一张一张表导出的方式使用information_schema传入表名查询字段名根据需要自行删减，一般保留序号、字段名、类型、说明就行 SELECT COLUMNS.ORDINAL_POSITION AS 序号, COLUMNS.COLUMN_NAME AS 字段名, COLUMNS.COLUMN_TYPE AS 类型(长度), COLUMNS.N…...

编程日记 2025/6/28 3:31:04

【C++笔记】C++常见二叉树OJ和拓扑排序

【C笔记】C常见二叉树OJ和拓扑排序 🔥个人主页：大白的编程日记 🔥专栏：C笔记文章目录【C笔记】C常见二叉树OJ和拓扑排序前言一.二叉树OJ1.1 根据二叉树创建字符串1.2 二叉树的层序遍历1.3 二叉树的最近公共祖先1.4 将二叉搜索…...

编程日记 2025/6/27 2:13:47

ARM-----数据处理、异常处理、模式切换

实列一： 1. 异常向量表 area reset, code, readonly code32 entry area reset, code, readonly：定义一个名为reset的代码区域，只读。 code32：指示编译器生成32位ARM指令。 entry：标记程序的入口点。 2. 程序入口…...

编程日记 2025/6/29 14:54:58

mapbox基础，使用geojson加载line线图层，实现铁路黑白间隔效果

👨‍⚕️ 主页： gis分享者 👨‍⚕️ 感谢各位大佬点赞👍 收藏⭐ 留言📝 加关注✅! 👨‍⚕️ 收录于专栏：mapbox 从入门到精通文章目录一、🍀前言1.1 ☘️mapboxgl.Map 地图对象1.2 ☘️mapboxgl.Map style属性1.3 ☘️line线图层样式二、🍀使用geojson加载…...

编程日记 2025/6/28 6:36:14

Python FastAPI + Celery + RabbitMQ 分布式图片水印处理系统

FastAPI 服务器Celery 任务队列RabbitMQ 作为消息代理定时任务处理首先创建项目结构： c:\Users\Administrator\Desktop\meitu\ ├── app/ │ ├── __init__.py │ ├── main.py │ ├── celery_app.py │ ├── tasks.py │ └── config.py…...

编程日记 2025/6/28 1:21:05

阶段项目：Windows 服务器的组建与管理

项目概述公司简介创鑫公司是一家新成立的小型 IT 公司公司决定组建部署一个小型的企业网络员工人数不到20人使用一台独立的 Windows 服务器提供各种网络服务网络拓扑设计需求权限部分权限部分要求公司的网络管理员对办公计算机和服务器分别进行独立管理&#xff…...

编程日记 2025/6/28 1:20:42

【408】26考研-王道计算机408

王道408考研全套视频资料： 讲义01.26考研王道计算机【C语言督学营】02.【408领学班】26考研王道计算机B站独家03.26考研王道计算机【组成原理领学班】04.26王道计算机【计算机网络领学班】05.26考研王道计算机【数据结构领学班】06.26王道计算机【操作系统领学班】…...

编程日记 2025/6/28 1:20:43

数据分析问题思考路径

一、思考问题 1. 确认问题因为背景: 因为5月1日的营业额突然下滑了10%,而历史从未出现过类似的跌幅我想目的: 我想知道本次下滑的原因以此避免再出现这样的异常情况现在思路: 现在能想到是原因是节假日和产品环节转化异常最后感谢: 想请你帮我取数分析一下&#xff0c…...

编程日记 2025/6/28 6:38:31

vue省市区懒加载，用el-cascader 新增和回显

el-cascader对于懒加载有支持方法，小难点在于回显的时候，由于懒加载第一次只有一层，所以要根据选中id数组一层层的加载。子组件 <template><el-cascaderref"cascaderRef"v-model"selectedValue":props"…...

编程日记 2025/6/28 1:21:22

从零构建大语言模型全栈开发指南：第三部分：训练与优化技术-3.3.3领域适配案例：医疗文本分类与法律合同生成

👉 点击关注不迷路 👉 点击关注不迷路 👉 点击关注不迷路文章大纲从零构建大语言模型全栈开发指南-第三部分：训练与优化技术-3.3.3 领域适配案例：医疗文本分类与法律合同生成1. 领域适配的核心挑战与解决方案2. 医疗文本分类：从通用到专业的跃迁2.1 医疗领域适配的技…...

编程日记 2025/6/28 4:05:52

Web网页内嵌 Adobe Pdf Reader 谷歌Chrome在线预览编辑PDF文档

随着数字化办公的普及，PDF文档已成为信息处理的核心载体，虽然桌面端有很多软件可以实现预览编辑PDF文档，而在线在线预览编辑PDF也日益成为一个难题。作为网页内嵌本地程序的佼佼者——猿大师中间件，之前发布的猿大师办公助手&am…...

编程日记 2025/6/28 4:10:35

Python WebSockets 库详解：从基础到实战

1. 引言 WebSocket 是一种全双工、持久化的网络通信协议，适用于需要低延迟的应用，如实时聊天、股票行情推送、在线协作、多人游戏等。相比传统的 HTTP 轮询方式，WebSocket 减少了带宽开销，提高了实时性。在 Python 中&#xff…...

编程日记 2025/6/28 1:21:31

php根据一个数组里面的元素顺序来排序另外一个数组的的顺序

根据arr2的顺序来排序arr $arr [[size_id > 9],[size_id > 1],[size_id > 1],[size_id > 6],[size_id > 6],[size_id > 8],];$arr2 [1,9,6,8];usort($arr, function ($item1, $item2) use ($arr2) {return array_search($item1[size_id], $arr2) - array_s…...

编程日记 2025/6/28 1:20:44

从JVM到分布式锁：高并发架构设计的六把密钥

【300秒速览分布式核心技术栈】作为十年架构老兵，今天用一张图说透高并发系统的底层逻辑： 🔑 JVM锁：synchronized与AQS构筑单机防线，却难逃分布式困局 🔑 数据库锁：MySQL行锁/间隙锁守住…...

编程日记 2025/6/28 1:21:19

《深度剖析SQL游标：复杂数据处理场景下的智慧抉择》

在数据库领域的广袤天地中，SQL游标宛如一把独特的钥匙，为复杂数据处理场景开启了一扇充满可能的大门。它以一种细腻且精准的方式，穿梭于数据库的记录之间，为众多棘手的数据处理难题提供了解决之道。复杂数据处理场景的挑战随着…...

编程日记 2025/6/28 1:59:15

【数据分享】中国3254座水库集水区特征数据集（免费获取）

水库在水循环、碳通量、能量平衡中扮演关键角色，实实在在地影响着我们的生活。其功能和环境影响高度依赖于地理位置、上游流域属性（如地形、气候、土地类型）和水库自身的动态特征（如水位、蒸发量）。但在此之前一直缺乏…...

编程日记 2025/6/28 1:21:54

【蓝桥杯每日一题】4.1

🏝️专栏： 【蓝桥杯备篇】 🌅主页： f狐o狸x "今日秃头刷题，明日荣耀加冕！" 今天我们来练习二分算法不熟悉二分算法的朋友可以看：【C语言刷怪篇】二分法_编程解决算术问题-CSDN博客 …...

编程日记 2025/6/28 1:21:28

PHY——LAN8720A 代码解析 (三)

文章目录 PHY——LAN8720A 代码解析 (三)PHY 源码解析ETH_PHY_IO_InitETH_PHY_IO_DeInitETH_PHY_IO_WriteRegETH_PHY_IO_ReadRegETH_PHY_IO_GetTick LAN8720 源码解析LAN8720_RegisterBusIOLAN8720_InitLAN8720_DisablePowerDownModeLAN8720_EnablePowerDownMode PHY——LAN872…...

编程日记 2025/6/28 3:41:10

【工具】BioPred一个用于精准医疗中生物标志物分析的 R 软件包

介绍 R 语言包 BioPred 提供了一系列用于精准医疗中的亚组分析和生物标志物分析的工具。它借助极端梯度提升（XGBoost）算法，并结合倾向得分加权和 A 学习方法，帮助优化个体化治疗规则，从而简化亚组识别过程。BioPred 还…...

编程日记 2025/6/28 1:20:52

如何修复 SQL Server 数据库中的恢复挂起状态？

原文：如何修复 SQL Server 数据库中的恢复挂起状态？ | w3cschool笔记当我们想与关系数据库交互时，SQL 就会出现并帮助用户与数据库进行交互。SQL 从高级语言中获取用户的输入，然后访问将代码转换为机器可理解的形式。SQL 确实会…...

编程日记 2025/6/28 6:02:54

C++11QT复习（十）

基类与派生类之间的转换 **Day7-4 基类与派生类之间的转换****一、问题回顾****二、基类与派生类间的转换****1. 类型适应（Upcasting）****2. 逆向转换（Downcasting）** **三、代码示例****四、派生类间的复制控制****五、总结****1…...

编程日记 2025/6/28 5:32:46

Linux——冯 • 诺依曼体系结构操作系统初识

目录 1. 冯 • 诺依曼体系结构 1.1 冯•诺依曼体系结构推导 1.2 内存提高冯•诺依曼体系结构效率的方法 1.3 理解数据流动 2. 初步认识操作系统 2.1 操作系统的概念 2.2 设计OS的目的 3. 操作系统的管理精髓 1. 冯 • 诺依曼体系结构 1.1 冯•诺依曼体系结构推导计算…...

编程日记 2025/6/28 1:22:03

JVM 学习计划表（2025 版）

JVM 学习计划表（2025 版） 📚 基础阶段（2 周） 1. JVM 核心概念 JVM 作用与体系结构理解 JVM 在 Java 跨平台运行中的核心作用，掌握类加载子系统、运行时数据区、执行引擎的交互流程内存结构与数据存…...

编程日记 2025/6/28 1:21:50

arm_mat_init_f32用法 dsp库

arm_mat_init_f32 是 CMSIS DSP 库中的一个函数，用于初始化一个浮点矩阵结构体。以下是其使用方法： 函数原型 c复制 void arm_mat_init_f32(arm_matrix_instance_f32 * S,uint16_t nRows,uint16_t nColumns,float32_t * pData ); 参数说明 S&#xf…...

编程日记 2025/6/28 1:20:45

【蓝桥杯14天冲刺课题单】Day3

1. 题目链接：1025 答疑贪心类型的题目做法很简单，只需要保证局部解最优即可保证整体解最优。这里的思路就是第i个学生前面的人答疑所用的时间最短，那么他所发送短信的时间节点越小。这道题目有个需要注意的点是：要先将前i-1个…...

编程日记 2025/6/28 1:21:18

基于开源AI大模型与S2B2C模式的线下服务型门店增长策略研究——以AI智能名片与小程序源码技术为核心

摘要在传统零售行业中，商品零售可通过无限流量实现销量增长，但服务型门店（如餐饮、医疗、美容等）因受限于地理位置、服务承载能力及非标化服务特性，需从“流量驱动”转向“复购驱动”增长模式。本研究以“开源AI大…...

编程日记 2025/6/28 1:22:08

批量修改图像命名

打开存放图片的文件 ctrA全选找到功能栏上的三个点的位置，点击选择复制路径打开一个Excel表格将复制的图片路径复制到Excel表格中选中刚复制的图片路径，点击选择数据->分列->分列在打开的窗口中选中分隔符号，在点击下一步选中…...

编程日记 2025/6/27 9:49:05

linux-- 0. C语言过、Java半静对、Python纯动和C++对+C

学习目标： java,CPYTHONC 学习内容： java,CPYTHONC 目录学习目标： 学习内容： java 纯解释型语言（如 Python）的对比‌ C语言与Java的核心区别 java,C PYTHON C 学习时间： 学习产出…...

编程日记 2025/6/28 4:23:26

程序化广告行业（50/89）：Cookie映射技术深度剖析

程序化广告行业（50/89）：Cookie映射技术深度剖析大家好！一直以来，我都希望能和大家一起深入探索程序化广告行业，共同学习进步。在之前的分享中，我们已经了解了程序化广告的很多关键内容&#x…...

编程日记 2025/6/28 1:20:50

大语言模型智体的综述：方法论、应用和挑战（下）

25年3月来自北京大学、UIC、广东大亚湾大学、中科院计算机网络信息中心、新加坡南阳理工、UCLA、西雅图华盛顿大学、北京外经贸大学、乔治亚理工和腾讯优图的论文“Large Language Model Agent: A Survey on Methodology, Applications and Challenges”。智体时代已经到来&a…...

编程日记 2025/6/28 3:59:27

【操作系统】Linux进程管理和调试

在 Linux 中，可以通过以下方法查看 PID（进程ID）对应的进程名称和详细信息： 1. 使用 ps 命令（最直接） ps -p <PID> -o pid,comm,cmd示例： ps -p 1234 -o pid,comm,cmd输出： P…...

编程日记 2025/6/28 3:11:23

C++---RAII模式

一、RAII模式概述 1. 定义 RAII（Resource Acquisition Is Initialization）即资源获取即初始化，是C中用于管理资源生命周期的一种重要编程模式。其核心在于将资源的获取和释放操作与对象的生命周期紧密绑定。当对象被创建时，资源…...

编程日记 2025/6/28 1:20:53

Clion刷题攻略-配置Cmake

使用Clion刷题，在一个项目中创建多个main函数，每一个文件对应一道题目，将Clion作为题目管理系统使用，并且cpp文件允许使用中文名，exe文件统一输出到runtime目录，防止污染根目录，CmakeLists文件如…...

编程日记 2025/6/28 1:20:46

DEBUG：file命令

file 命令详解 file 是 Linux/Unix 系统中用于检测文件类型的实用工具。它通过检查文件的**魔数（magic number）**和内容结构来判断文件类型，而不是依赖文件扩展名。 1. 基本语法 file [选项] 文件名... 常用选项选项说明-b (--brief)简洁…...

编程日记 2025/6/27 2:10:29

hackmyvn-casino

arp-scan -l nmap -sS -v 192.168.255.205 目录扫描 dirsearch -u http://192.168.255.205/ -e * gobuster dir -u http://192.168.255.205 -w /usr/share/wordlists/dirbuster/directory-list-2.3-medium.txt -x php -b 301,401,403,404 80端口随便注册一个账号玩游戏时的…...

编程日记 2025/6/28 1:21:40

Elasticsearch笔记

官网 https://www.elastic.co/docs 简介 Elasticsearch 是一个分布式、开源的搜索引擎，专门用于处理大规模的数据搜索和分析。它基于 Apache Lucene 构建，具有实时搜索、分布式计算和高可扩展性，广泛用于全文检索、日志分析、监控数据分析…...

编程日记 2025/6/28 1:21:06

在Windows下使用Docker部署Nacos注册中心(基于MySQL容器)

需要两个容器Nacos容器和MySQL容器，MySQL容器专注数据存储，Nacos容器专注服务发现/配置管理准备工作确保已安装Docker Desktop for Windows确保已启用WSL 2(推荐)或Hyper-V确保Docker服务正在运行部署步骤 1. 拉取所需镜像 # 拉取MySQL镜像(这里…...

编程日记 2025/6/28 3:30:53

去中心化自治组织（DAO）：革新未来治理的下一站

去中心化自治组织（DAO）：革新未来治理的下一站引言去中心化自治组织（DAO）的诞生，像是互联网时代的一道新曙光。它打破了传统组织的等级壁垒，以去中心化和智能合约为核心，让社区成员能够直接参与决策并共享收益。从NFT社区到投资基金，DAO的应用场景正以前所未有的速…...

编程日记 2025/6/28 3:47:02

ideal自动生成类图的方法

在 IntelliJ IDEA 中，“**在项目资源管理器中选择以下类**” 是指通过 **项目资源管理器（Project Tool Window）** 找到并选中你需要生成类图的类文件（如 .java 文件），然后通过右键菜单或快捷键操作生成类图…...

编程日记 2025/6/28 5:55:27

爬虫获取1688关键字搜索接口的实战指南

在当今电商行业竞争激烈的环境下，数据的重要性不言而喻。1688作为国内领先的B2B电商平台，拥有海量的商品信息，这些数据对于商家的市场分析、选品决策、价格策略制定等都有着重要的价值。本文将详细介绍如何通过爬虫技术获取1688关键字搜索接口…...

编程日记 2025/6/28 3:35:25

视频设备轨迹回放平台EasyCVR渡口码头智能监控系统方案，确保港口安全稳定运行

一、背景近年来，随着水上交通运输业的快速发展，辖区内渡口码头数量持续增加，船舶运营规模不断扩大，各类船舶活动频繁，给水上交通安全监管带来了巨大挑战。近期发生的多起村民使用无证木船捕鱼导致的伤亡事故&#xf…...

编程日记 2025/6/28 3:54:09

使用 Sales_data 类实现交易合并（三十）

1. Sales_data 类定义假设 Sales_data 类定义在头文件 Sales_data.h 中，其基本定义如下： // Sales_data.h #ifndef SALES_DATA_H #define SALES_DATA_H#include <string>struct Sales_data {std::string bookNo; // ISBN 编号unsigned uni…...

编程日记 2025/6/28 1:21:25