Java switch 패턴 매칭 & 향상된 문법 — switch 표현식부터 가드 패턴까지

Java 17+에서 switch 표현식과 instanceof 패턴 매칭을 실무 관점에서 정리하고, Java 21의 switch 패턴 매칭/가드(when)로 분기 코드를 더 안전하고 읽기 좋게 만드는 방법을 예제로 설명합니다.

도입 (문제 상황)

조건 분기가 조금만 복잡해져도 if-else가 길어지고, 중간에 빠진 케이스나 break 누락 같은 실수가 생기기 쉽습니다. 특히 “타입에 따라 다르게 처리” 같은 요구가 들어오면 instanceof + 캐스팅이 반복되면서 코드가 금방 지저분해집니다. 이럴 때 Java의 switch 표현식과 패턴 매칭을 쓰면 분기 로직을 훨씬 짧고 안전하게 만들 수 있어요.

핵심 개념 (Java switch 표현식/패턴 매칭이 중요한 이유)

switch 표현식에서 상수 분기와 타입 패턴 매칭, when 가드로 이어지는 흐름도

Java 14+ switch 표현식: “값을 반환하는 switch”

기존 switch는 문(statement)이라서 값을 만들려면 변수를 선언해두고 각 케이스에서 대입하는 패턴이 흔했습니다. switch 표현식은 switch (...) { ... } 자체가 값을 반환하므로, “분기 결과를 변수로 만들기”가 자연스럽고 누락에도 강합니다.

• case ... -> 화살표 문법으로 **fall-through(의도치 않은 다음 case 실행)**를 원천적으로 줄입니다.
• 여러 문장이 필요하면 블록 { ... }에서 yield로 값을 반환합니다.
• enum/상수 분기에서 특히 깔끔하고, IDE가 exhaustive(모든 케이스 처리) 여부를 더 잘 도와줍니다.

Java 16+ instanceof 패턴 매칭: 캐스팅을 “언어가” 해줍니다

예전에는 다음처럼 썼죠.

if (obj instanceof String) {
    String s = (String) obj;
    ...
}

Java 16+에서는:

if (obj instanceof String s) {
    ...
}

instanceof에서 타입 체크와 바인딩을 동시에 해주니 중복이 줄고, 실수(잘못된 캐스팅) 여지도 줄어듭니다.

Java 21 switch 패턴 매칭 + 가드(when): 타입 + 조건을 한 번에

여기서 한 단계 더 나아가면, switch가 단순히 “값 비교”가 아니라 타입에 따른 분기까지 담당할 수 있습니다.

• case String s -> 처럼 타입 패턴을 case에 직접 쓸 수 있습니다.
• when으로 **가드(추가 조건)**를 붙여 “타입은 맞지만 조건이 다를 때”를 깔끔하게 분리합니다.
• null도 case null ->로 명시 처리할 수 있어, NPE 회피가 더 명확해집니다.

참고: switch 패턴 매칭은 Java 21에서 정식 기능으로 제공됩니다. (Java 17 LTS에서는 switch 표현식은 가능하지만, switch에서 타입 패턴/when 가드는 사용할 수 없습니다.)

한눈에 비교: if-else vs switch 표현식 vs switch 패턴 매칭

목적	추천 문법	장점	주의점
단순 값 분기(상수/enum)	switch 표현식(->)	fall-through 방지, 결과값 생성 쉬움	블록이면 yield 필요
타입 확인 + 안전한 바인딩	instanceof T t	캐스팅 제거, 가독성↑	변수 스코프는 if 블록 내부
타입별 분기 + 추가 조건(가드)	switch 패턴 매칭 + when (Java 21)	분기 로직이 선언적으로 정리됨	Java 21 필요(빌드/런타임)

flowchart TD
  A["Input value"] --> B["switch expression"]
  B --> C["case constant -> result"]
  B --> D["case type pattern -> result"]
  D --> E["when guard condition"]
  E --> F["result"]
  C --> F

switch 표현식은 “값/타입/가드 조건”을 한 흐름으로 묶어 분기 결과를 만들 수 있습니다.

코드 예제 (복붙 실행 가능): switch 표현식 + instanceof 패턴 + switch 패턴 매칭(when)

아래 예제는 Java 21 기준입니다. (switch 패턴 매칭과 when을 사용합니다.)
실행: javac SwitchPatternDemo.java && java SwitchPatternDemo

import java.math.BigDecimal;

public class SwitchPatternDemo {

    // Java 14+ : switch "표현식" (값을 반환)
    static String gradeMessage(int score) {
        return switch (score / 10) {
            case 10, 9 -> "A";
            case 8 -> "B";
            case 7 -> "C";
            case 6 -> "D";
            default -> "F";
        };
    }

    // Java 16+ : instanceof 패턴 매칭 (캐스팅 제거)
    static BigDecimal extractAmount(Object value) {
        if (value instanceof BigDecimal bd) {
            return bd;
        }
        if (value instanceof Integer i) {
            return BigDecimal.valueOf(i);
        }
        if (value instanceof String s) {
            return new BigDecimal(s.trim());
        }
        throw new IllegalArgumentException("Unsupported amount type: " + value);
    }

    // Java 21 : switch 패턴 매칭 + 가드(when)
    static String describe(Object obj) {
        return switch (obj) {
            case null -> "null input";

            // 타입 패턴 + 가드: 문자열이면서 비어있지 않을 때/비어있을 때 분리
            case String s when s.isBlank() -> "blank string";
            case String s -> "string: " + s;

            // 숫자 처리: 타입별로 분기
            case Integer i when i < 0 -> "negative int: " + i;
            case Integer i -> "int: " + i;

            // 레코드/봉인 클래스(sealed)와도 궁합이 좋지만, 여기서는 간단히 타입만
            case BigDecimal bd -> "bigdecimal: " + bd.toPlainString();

            // 어떤 타입이든 마지막에 안전망
            default -> "unknown type: " + obj.getClass().getName();
        };
    }

    public static void main(String[] args) {
        System.out.println("== switch expression ==");
        System.out.println("95 -> " + gradeMessage(95));
        System.out.println("72 -> " + gradeMessage(72));

        System.out.println("\n== instanceof pattern matching ==");
        System.out.println("amount(Integer 1200) -> " + extractAmount(1200));
        System.out.println("amount(String \" 99.50 \") -> " + extractAmount(" 99.50 "));

        System.out.println("\n== switch pattern matching + when guard (Java 21) ==");
        System.out.println(describe(null));
        System.out.println(describe("   "));
        System.out.println(describe("hello"));
        System.out.println(describe(-3));
        System.out.println(describe(42));
        System.out.println(describe(new BigDecimal("10.00")));
        System.out.println(describe(3.14));
    }
}

실무 팁

💡 실무에서는: switch 표현식은 “결과를 만드는 로직”에 먼저 적용해 보세요
분기 끝에서 결국 문자열/상태/코드값을 만들어 리턴하는 메서드가 많습니다. 이런 곳을 switch 표현식으로 바꾸면 중간 변수 + 여러 번의 대입이 사라지고, “반드시 값이 리턴된다”는 형태가 코드 리뷰에서 바로 보입니다. 특히 case ... ->를 우선 사용하면 fall-through 사고를 거의 없앨 수 있어요.

💡 실무에서는: switch 패턴 매칭 도입 시 “빌드/런타임 버전”을 먼저 고정하세요
로컬은 JDK 21인데 서버 런타임이 17이면, 컴파일/배포 파이프라인에서 바로 문제가 납니다. 팀에서 Java 21을 쓸 수 있는 시점이 아니라면, 당장은 Java 17의 switch 표현식 + Java 16의 instanceof 패턴 매칭만으로도 충분히 코드 품질이 좋아집니다. 그리고 Java 21 전환 시점에 타입별 분기 로직을 switch 패턴 매칭으로 단계적으로 옮겨가면 리스크가 적습니다.

---

핵심 요약: switch 표현식은 “값을 반환하는 분기”로 코드를 짧고 안전하게 만듭니다.
instanceof 패턴 매칭은 캐스팅을 제거해 타입 분기 코드를 깔끔하게 합니다.
Java 21의 switch 패턴 매칭 + when 가드는 타입+조건 분기를 선언적으로 정리해 줍니다.

다음 글: #32 Virtual Thread — 경량 스레드의 시대