java 枚举本身不支持通配符（如 `0x83xx`），但可通过函数式接口（`predicate
在实际系统集成（尤其是与底层硬件、协议栈或嵌入式设备交互）中，错误码常以固定前缀加可变后缀的形式出现，例如 0x8300–0x83FF 表示一类“数据相关错误”。此时，传统枚举的静态字面量定义（如 ERR_DATA(0x8300)）无法覆盖整个范围，而硬编码所有 256 个值又违背枚举的设计初衷。
幸运的是，Java 枚举完全支持构造器注入行为逻辑——我们可将每个枚举常量与一个 Predicate
import java.util.function.Predicate;
public enum ErrorCode {
ERR_NONE (0x9000), // 精确匹配 0x9000
ERR_PARAM (0x8200), // 精确匹配 0x8200
ERR_DATA (n -> n >= 0x8300 && n <= 0x83FF), // 匹配整个 0x83XX 范围
ERR_ANOTHER_83(0x8377); // 单独声明的精确值（仍属于 0x83XX 范围）
private final Predicate forValue;
// 构造器：支持单值匹配
ErrorCode(int singleValue) {
this(n -> n == singleValue);
}
// 构造器：支持任意谓词逻辑（范围、掩码、正则等）
ErrorCode(Predicate matches) {
this.forValue = matches;
}
// 核心查找方法：线性遍历并返回首个匹配项
public static ErrorCode forInt(int code) {
ErrorCode matched = null;
for (ErrorCode c : values()) {
if (c.forValue.test(code)) {
if (matched != null) {
throw new IllegalArgumentException(
String.format("Ambiguous match: %s and %s both match 0x%04x",
matched.name(), c.name(), code));
}
matched = c;
}
}
return matched; // 若无匹配，返回 null；生产环境建议抛出异常或返回默认值
}
} ✅ 使用示例：
System.out.println(ErrorCode.forInt(0x8312)); // 输出: ERR_DATA System.out.println(ErrorCode.forInt(0x9000)); // 输出: ERR_NONE System.out.println(ErrorCode.forInt(0x8377)); // 输出: ERR_ANOTHER_83 System.out.println(ErrorCode.forInt(0x8400)); // 输出: null（未匹配）
⚠️ 关键注意事项：
立即学习“Java免费学习笔记（深入）”；
- 匹配冲突检测：当前实现会在多个枚举同时匹配同一数值时抛出 IllegalArgumentException，避免语义歧义；若业务允许“优先级覆盖”，可改为按声明顺序返回首个匹配项（需移除冲突检查并确保枚举顺序合理）。
- 性能考量：forInt() 是 O(n) 线性查找，适用于枚举项较少（ 或布隆过滤器预索引。
- 空值防御：forInt() 返回 null 表示无匹配，调用方必须显式判空；更健壮的做法是定义 ERR_UNKNOWN(-1) 并在末尾兜底，或直接抛出 NoSuchErrorCodeException。
- 扩展性提示：可轻松添加掩码匹配（如 n -> (n & 0xFF00) == 0x8300）、位域校验或外部配置驱动的动态规则。
这种设计既保持了枚举的类型安全与可读性，又赋予其动态判断能力，是处理协议化错误码、状态码分组等场景的经典范式。
