如何在 Java 中使用 Enum.valueOf() 根据名称字符串动态获取枚举项

千静吖_8401

千静吖_8401

2026-05-06

442人浏览

原创

会,enum.valueof() 会抛出 illegalargumentexception;只要字符串与枚举常量的 name() 值不完全匹配(大小写、空格等),就直接抛异常,不返回 null 或模糊匹配。

如何在 java 中使用 enum.valueof() 根据名称字符串动态获取枚举项

Enum.valueOf() 会抛出 IllegalArgumentException 吗?

会,而且非常容易触发。只要传入的字符串和枚举类中任一 name() 值不完全匹配(大小写、空格、下划线等),Enum.valueOf() 就直接抛 IllegalArgumentException,不会返回 null 或尝试模糊匹配。

常见错误现象:

  • 从 HTTP 请求参数或配置文件读到 "pending",但枚举定义的是 PENDING —— 直接崩溃
  • 用户输入了 "PENDING "(带尾部空格)或 "pending"(小写)—— 同样抛异常
  • 调用方没做 try-catch,导致上层服务 500

实操建议:

  • 永远把 Enum.valueOf() 放在 try-catch 块里,不要依赖“数据干净”
  • 不要把它当“安全转换函数”,它本质是严格校验型 API
  • 如果需要容错(比如忽略大小写),必须自己封装,不能依赖原生方法

如何安全地根据字符串获取枚举项(带容错)

Java 没有内置的“宽松模式”枚举查找,得手动遍历 + 条件判断。核心思路是:用 values() 获取所有实例,再逐个比对 name() 或自定义字段。

示例(忽略大小写的查找):

public static Optional<status> fromNameIgnoreCase(String name) {
    if (name == null) return Optional.empty();
    return Arrays.stream(Status.values())
            .filter(e -> e.name().equalsIgnoreCase(name.trim()))
            .findFirst();
}</status>

使用场景:

  • 解析前端传来的 status 字段,允许传 "pending"、"PENDING"、"Pending"
  • 读取 YAML/properties 配置时,值可能不规范

注意点:

  • name() 是编译期固定的标识符,不可变;别和 toString() 或自定义 getter 混淆
  • 每次调用 values() 都会复制数组,高频调用建议缓存为静态 final 数组
  • 如果枚举项很多(>100),考虑用 Map<string enum></string> 预热索引,避免每次遍历

为什么不能直接用 valueOf() 处理中文或自定义描述?

Enum.valueOf() 只认 name(),也就是枚举常量的大写标识符(如 OPEN),它**完全不识别注释、Javadoc、toString() 返回值,也不支持中文字段**。

Java Maven Common
Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

比如你写了:

public enum Status {
    OPEN("开启"),
    CLOSED("关闭");

    private final String desc;
    Status(String desc) { this.desc = desc; }
    public String getDesc() { return desc; }
}

这时 Enum.valueOf(Status.class, "开启") 一定失败 —— 因为 "开启" 不是任何常量的 name()。

实操建议:

  • 若需按中文描述查找,必须自己遍历并比对 getDesc()
  • 更推荐的做法:把中文映射关系抽成静态 Map<string status></string>,初始化一次,查询 O(1)
  • 别在 valueOf() 上加反射或重载,那会破坏类型安全和可读性

valueOf() 和 getDeclaredMethod("valueOf", String.class) 有什么区别?

没有实际区别 —— 后者是徒劳的反射调用。所有枚举类在编译后都自动继承了静态 valueOf(Class<t>, String)</t> 方法,且该方法就是标准库实现,反射调用只是绕路,还损失性能和可读性。

错误写法示例:

Status s = (Status) Status.class
        .getDeclaredMethod("valueOf", String.class)
        .invoke(null, "OPEN"); // 完全没必要

正确做法始终是直接调用:

Status s = Status.valueOf("OPEN"); // 简洁、高效、明确

真正要注意的是:这个调用本身脆弱,必须配套异常处理或前置校验,而不是换种方式调用它。

复杂点在于枚举本身的使用边界:它不是字符串解析器,也不是配置映射表。一旦需求超出 name() 的严格匹配范围,就得主动退出 valueOf() 路径,走自定义查找逻辑。这点很容易被忽略,直到线上报错才意识到。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11137

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8242

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7132

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1204

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

968

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1436

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2929

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20211

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1295

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习