Java枚举状态机教程：怎么在switch语句中匹配枚举常量-java教程-PHP中文网

Java中用switch匹配枚举常量是实现状态机最简洁、类型安全的方式，支持编译期穷尽性校验，推荐加default分支保障扩展性，Java14+可用switch表达式提升安全性与函数式表达能力。

java枚举状态机教程：怎么在switch语句中匹配枚举常量

在 Java 中，用 switch 匹配枚举常量是实现状态机最简洁、类型安全的方式之一。从 Java 5 引入枚举开始，switch 就原生支持枚举类型——你不需要写 .name() 或 toString()，直接用枚举常量本身即可，编译器会做类型检查和穷尽性校验（配合 IDE 或 Java 14+ 的 switch 表达式可进一步强化）。

定义清晰的状态枚举

状态机的核心是明确、不可变的状态集合。枚举天然适合这个角色：

// 示例：订单状态机
public enum OrderStatus {
  CREATED,
  PAID,
  SHIPPED,
  DELIVERED,
  CANCELLED
}

注意：枚举常量全大写、无参数、无方法时最适合作为纯状态标识；若需携带行为或数据，可为每个常量添加字段或抽象方法（但 switch 仍只关心“是哪个状态”，不依赖其内部逻辑）。

在 switch 中直接匹配枚举常量

语法简单，无需任何转换：

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

public void handleOrder(OrderStatus status) {
  switch (status) {
    case CREATED:
      System.out.println("新订单，等待支付");
      break;
    case PAID:
      System.out.println("已支付，准备发货");
      break;
    case SHIPPED:
      System.out.println("已发货，物流进行中");
      break;
    case DELIVERED:
      System.out.println("已签收，交易完成");
      break;
    case CANCELLED:
      System.out.println("订单已取消");
      break;
  }
}

关键点：
• 不写 OrderStatus.CREATED，直接写 case CREATED:
• 每个 case 必须是该枚举的**显式常量**，不能是变量或表达式
• 编译器确保所有枚举值都被覆盖（除非加 default），避免遗漏状态

处理未知/扩展状态（推荐 default + 日志）

即使当前枚举只有 5 个值，未来可能新增。为健壮性，建议始终包含 default 分支：

switch (status) {
  case CREATED: ... break;
  case PAID: ... break;
  default:
    log.warn("未处理的订单状态：{}", status);
    throw new IllegalStateException("未知订单状态: " + status);
}

这样既防止运行时漏处理，又便于后续扩展时快速发现需补充逻辑的位置。

Java 14+：用 switch 表达式返回值（更函数式）

如果状态处理需要返回结果（比如状态描述、下一步操作），用 switch 表达式更简洁安全：

public String getStatusDescription(OrderStatus status) {
  return switch (status) {
    case CREATED -> "新建";
    case PAID -> "已支付";
    case SHIPPED -> "已发货";
    case DELIVERED -> "已完成";
    case CANCELLED -> "已取消";
&nbsp};
}