Java / 知识点

Java 开发速查手册

手册条目

CODE
<类型> 结果 = switch (<值>) {
    case <常量1>, <常量2> -> <表达式>;
    default -> { yield <值>; }
};

使用箭头分支、yield 和穷尽检查简化多分支逻辑。

使用 switch 表达式

当一个值需要映射为结果时,优先使用 switch 表达式。箭头分支避免意外贯穿,代码块分支用 yield 返回值;对枚举等有限类型,编译器还能检查是否覆盖所有分支。

基本语法

switch 表达式本身会产生值,因此通常直接赋给变量或从方法返回。单表达式分支使用 ->,需要多条语句时使用代码块,并以 yield 给出该分支的结果。

java
public class SwitchExpressionDemo {
    enum Level {
        LOW, MEDIUM, HIGH
    }

    static int score(Level level) {
        return switch (level) {
            case LOW -> 10;
            case MEDIUM -> {
                int base = 20;
                // 代码块分支必须显式产出结果
                yield base + 5;
            }
            case HIGH -> 50;
        };
    }

    static String classify(int status) {
        return switch (status) {
            case 200, 201, 204 -> "success";
            case 400, 404 -> "client-error";
            default -> "other";
        };
    }

    public static void main(String[] args) {
        System.out.println("score=" + score(Level.MEDIUM));
        System.out.println("status=" + classify(201));
    }
}

编译并运行:

bash
javac --release 21 SwitchExpressionDemo.java
java SwitchExpressionDemo

预期输出:

text
score=25
status=success

读取结果时注意:MEDIUM 分支先执行局部计算,再由 yield 返回 25;状态码 201 与同一 case 中的多个标签匹配,返回 success。

高频用法

多个值返回同一结果时,用逗号合并标签,避免重复分支:

java
String type = switch (day) {
    case SATURDAY, SUNDAY -> "weekend";
    default -> "weekday";
};

需要记录日志、校验或计算中间变量时,使用代码块分支:

java
int price = switch (level) {
    case LOW -> 10;
    case MEDIUM -> {
        int discount = 2;
        yield 20 - discount;
    }
    case HIGH -> 30;
};

以上为片段示例,依赖已定义的 day、level 及对应枚举。生效行为是每个分支只产生一个结果,不会像传统冒号分支那样继续执行后续 case。

穷尽检查

switch 表达式必须覆盖所有可能输入。整数、字符串等开放集合通常需要 default;枚举覆盖全部常量后可以省略 default。省略后若未来新增枚举常量,相关代码会在重新编译时暴露缺失分支,比静默落入默认值更安全。

所有分支的结果还必须能推导为兼容类型。一个分支返回数字、另一个分支返回无关对象,可能导致类型过宽或直接编译失败,应统一返回类型。

风险与边界

箭头语法不会贯穿分支,不能依赖传统 case 的 fall-through 行为;若业务确实需要连续执行,应改用普通 if 或显式提取公共逻辑。

代码块分支中使用 break 不能为表达式返回值,必须使用 yield。选择器为 null 时通常会抛出 NullPointerException,生产代码应在进入 switch 前校验,或在明确支持的 Java 版本中显式处理 case null。

排障清单

  • 报“switch expression does not cover all possible input values”:补齐枚举分支或增加 default。
  • 报“no result expressions”:检查代码块分支是否在所有可达路径执行 yield 或抛出异常。
  • 编译器不识别 -> 或 yield:确认实际使用的 javac 版本,并检查构建工具的 source、target 或 release 配置。
  • 返回类型异常:逐个核对分支结果,避免混用不相关类型。

兼容性

switch 表达式在 Java 14 成为正式特性。生产项目建议使用与运行环境一致的 --release 编译;仅升级本地 JDK,而未同步 Maven、Gradle 或 CI 的编译级别,仍会构建失败。

目录与阅读设置

记录一个想法

Java 开发速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通