Java枚举类型在实际开发中应用广泛，当需要获取枚举中定义的所有实例时，values方法是最直接的实现方式，同时结合不同的遍历逻辑可以完成各类业务场景的需求。
什么是Java枚举
Java枚举是一种特殊的类，一般用于表示一组固定的常量，比如订单状态、性别类型、错误码等。枚举类型使用enum关键字定义，每个枚举实例都是枚举类的对象，在枚举类加载时就会被初始化。
values方法的基本使用
values方法是Java编译器为所有枚举类自动添加的内置方法，它的返回值是当前枚举类中所有实例组成的数组，数组的顺序和枚举实例的定义顺序一致。
我们可以通过一个简单的枚举示例来演示values方法的使用：
// 定义一个表示性别的枚举
enum Gender {
MALE("男"),
FEMALE("女");
private String desc;
// 枚举构造方法，默认是private修饰
Gender(String desc) {
this.desc = desc;
}
public String getDesc() {
return desc;
}
}
public class EnumDemo {
public static void main(String[] args) {
// 调用values方法获取所有枚举实例
Gender[] genders = Gender.values();
// 遍历输出枚举实例和对应的描述
for (Gender gender : genders) {
System.out.println(gender.name() + ":" + gender.getDesc());
}
}
}
上述代码中，Gender枚举定义了两个实例，调用values()方法后会得到一个包含两个Gender对象的数组，通过遍历数组就可以拿到所有的枚举值。
枚举遍历的多种方式
获取到枚举数组之后，我们可以使用多种遍历方式来处理枚举值，常见的遍历方式有以下几种：
1. 增强for循环遍历
这是最常用的遍历方式，语法简洁，适合大多数场景：
enum OrderStatus {
PENDING,
PAID,
SHIPPED,
FINISHED
}
public class OrderDemo {
public static void main(String[] args) {
for (OrderStatus status : OrderStatus.values()) {
System.out.println("订单状态:" + status);
}
}
}
2. 普通for循环遍历
如果需要用到索引，或者需要更灵活的控制遍历过程，可以使用普通for循环：
enum ErrorCode {
SUCCESS(0, "成功"),
PARAM_ERROR(1001, "参数错误"),
SYSTEM_ERROR(1002, "系统错误");
private int code;
private String msg;
ErrorCode(int code, String msg) {
this.code = code;
this.msg = msg;
}
public int getCode() {
return code;
}
public String getMsg() {
return msg;
}
}
public class ErrorDemo {
public static void main(String[] args) {
ErrorCode[] codes = ErrorCode.values();
for (int i = 0; i < codes.length; i++) {
ErrorCode code = codes[i];
System.out.println("索引" + i + ": 错误码" + code.getCode() + ", 描述:" + code.getMsg());
}
}
}
3. 使用Stream API遍历
如果需要对枚举值进行过滤、映射等操作，可以结合Java 8的Stream API使用：
import java.util.Arrays;
enum WeekDay {
MONDAY,
TUESDAY,
WEDNESDAY,
THURSDAY,
FRIDAY,
SATURDAY,
SUNDAY
}
public class WeekDemo {
public static void main(String[] args) {
// 过滤出工作日并输出
Arrays.stream(WeekDay.values())
.filter(day -> day.compareTo(WeekDay.SATURDAY) < 0)
.forEach(day -> System.out.println("工作日:" + day));
}
}
values方法的注意事项
- values方法是编译器自动生成的，在枚举类的源码中看不到该方法的声明，它是返回一个新的数组，修改返回的数组不会影响枚举类的原始实例。
- values方法返回的数组顺序和枚举实例的定义顺序完全一致，如果需要自定义顺序，可以在枚举中添加排序字段，遍历时再按照自定义规则排序。
- 除了values方法，枚举类还有
valueOf(String name)方法，可以根据枚举实例的名称获取对应的枚举对象，需要注意的是传入的名称必须和枚举实例定义的大小写完全一致，否则会抛出IllegalArgumentException异常。
实际应用场景
在实际开发中，获取枚举所有值的场景非常多，比如：
- 前端下拉框需要展示所有可选的枚举选项，后端可以直接调用values方法返回所有枚举值给前端。
- 需要校验某个值是否属于枚举定义的合法值范围时，可以先获取所有枚举值，再判断目标值是否在其中。
- 批量处理枚举对应的业务数据时，遍历所有枚举值依次处理对应逻辑。
掌握values方法的使用和枚举遍历的多种方式，能够让我们在处理Java枚举相关需求时更加高效，减少不必要的代码编写。