【Java学習｜実務向け】Java 21以降の必須知識：Null-friendly Pattern Matching for switchの活用術

1. 導入：なぜNull-friendlyなswitchが必要なのか

従来のJavaにおけるswitch文やif-elseの連鎖において、nullチェックは避けて通れない大きな課題でした。特に外部システムから受け取ったオブジェクトを扱う際、明示的なnullチェックを忘れるとNullPointerException（NPE）が発生します。Java 21で正式導入された「パターンマッチングによるswitch（Pattern Matching for switch）」は、このnullチェックをswitch文の中に統合することで、コードの安全性と可読性を劇的に向上させました。本記事では、この機能を正しく使いこなし、堅牢な制御フローを実現する方法を解説します。

2. 基礎知識：パターンマッチングとnullの扱い

Javaのパターンマッチングにおけるswitchは、単なる値の比較だけでなく、型の判定とキャストを同時に行います。以前のJavaでは、switchの対象がnullであれば即座にNPEが発生しましたが、最新の仕様では、明示的にnullをケースとして定義することで、安全にハンドリングできるようになりました。これにより、従来の「if (obj == null) { … }」という定型的な記述を減らすことが可能です。

3. 実装/解決策：nullを考慮したswitchの構築

実装のポイントは、switchのcaseラベルに「null」を直接記述できるようになった点です。また、sealed class（封印クラス）を組み合わせることで、網羅的なチェックをコンパイラに保証させることができます。これにより、予期せぬnullの混入を防ぐ設計が容易になります。

4. サンプルプログラム

以下は、sealed interfaceとパターンマッチングを組み合わせた、null安全な実装例です。

// 封印インターフェースの定義 sealed interface Result permits Success, Failure {} record Success(String data) implements Result {} record Failure(String error) implements Result {}


public class SwitchExample {

    public static void main(String[] args) {

        processResult(new Success("データ受信"));

        processResult(new Failure("接続エラー"));

        processResult(null); // nullを渡しても安全に処理される

    }
    public static void processResult(Result result) {

        // switch式による網羅的な処理

        String message = switch (result) {

            case null -> "結果がnullです"; // nullを明示的にハンドリング

            case Success s -> "成功: " + s.data();

            case Failure f -> "失敗: " + f.error();

            // sealed classのおかげでdefaultが不要

        };

System.out.println(message); } }

5. 応用・注意点：現場でのベストプラクティス

現場での注意点として、以下の3点を意識してください。

1. 網羅性の重要性: sealed classを使用することで、将来的に新しい型が追加された際にコンパイルエラーとして検知できます。これにより、メンテナンス性が向上します。
2. default節の安易な使用を避ける: パターンマッチングを利用している場合、可能な限りcaseで型を網羅してください。default節を多用すると、型追加時の安全性が損なわれます。
3. nullの仕様理解: 「null」ケースを記述しない場合、従来通りNPEが発生します。コードレビューの際は、「そのswitchブロックでnullを受け入れるべきか、あるいは呼び出し元でフィルタリングすべきか」という観点を持つことが、シニアエンジニアとしての重要な視点です。

この機能を活用することで、Javaのコードはより宣言的で、かつ堅牢なものになります。ぜひ、既存のプロジェクトのif-elseリファクタリングに活用してみてください。