本ページはプロモーションが含まれています

Java入門

Java enum完全ガイド｜宣言・比較・switch文まで

トム

・都内自社開発企業勤務／Javaバックエンドエンジニア
／Java歴10年以上 ・首都圏在住30代
・資格：基本情報技術者／応用情報技術者／Java Silver／Python3エンジニア認定基礎 詳細なプロフィール

Javaで決まった値のみを扱う定数管理をしたいなら、final static intではなくenum（列挙型）を使うのが最適です。

型安全性が高く、意図しない値の混入をコンパイル時に防げます。

「Javaの定数管理、final staticでやっているけど、もっと良い方法はないかな…？」

「enumが良いと聞くけど、具体的な使い方や、比較の仕方がよくわからない…」

もし、あなたがJavaの定数管理でこのように感じているなら、この記事はきっとお役に立てます。

以前のプロジェクトで、ステータス管理にfinal static intを多用したことがあります。

その結果、コード内に意味不明な数字（いわゆるマジックナンバー）が溢れてしまい、バグの温床になった苦い経験があります。

その問題を解決してくれたのがenum（列挙型）でした。

この記事では、Javaのenumの基本的な使い方から、==とequalsどちらで比較すべきかという迷いどころ、switch文との組み合わせまで解説します。

あなたのコードを劇的に改善する実践的なテクニックも、私の経験を交えながら紹介します。

この記事を読み終える頃には、あなたもenumを自信を持って使いこなし、安全で読みやすいコードを書けるようになります。

この記事でわかること

  • enumとfinal staticの違い・型安全性のメリット
  • enum同士の比較は==とequalsどちらを使うべきか
  • フィールド・メソッドを持たせる実践的な書き方
  • ordinal()の危険性とvalues()の使い方

enum（列挙型）とは？基本の仕組みをやさしく解説

Javaのenum（列挙型）とは何かを示す基本概念の図解

Javaのenum（イーナム）は、決まった値のセットをひとまとめにして扱うための仕組みです。列挙型とも呼ばれます。

例えば、「信号機の色」を考えてみましょう。信号の色は「赤」「黄」「青」の3つしかありません。

取りうる値が限定されているものを扱うのにenumは最適です。

public enum Signal {
    RED,
    YELLOW,
    BLUE
}

このように定義することで、信号機の色を「文字列」や「数値」ではなく、Signal.REDという 意味のある名前で安全に扱えるようになります。

enumが使われるシーンとは？

enumは、プログラムの中で固定的な値を扱いたい様々な場面で活躍します。具体的な利用シーンは以下の通りです。

  • 曜日: MONDAY, TUESDAY, ...
  • 性別: MALE, FEMALE, OTHER
  • 血液型: A, B, O, AB
  • 会員ランク: GOLD, SILVER, BRONZE
  • 処理ステータス: WAITING, PROCESSING, COMPLETED, ERROR

これらのように、あらかじめ決まっている選択肢の中から1つを選ぶ、という状況でenumの真価が発揮されます。

定数（final static）との違いを比較してみよう

「public static final int RED = 0; のように、定数で管理するのと何が違うの？」という疑問が浮かびます。

enumとfinal staticを使った定数定義には、決定的な違いがあります。それは型安全性です。

以下のコードを見てください。

final staticを使った例

public class Light {
    public static final int RED = 0;
    public static final int YELLOW = 1;
    public static final int BLUE = 2;
}

// メソッドの引数はint型なので、どんな整数でも受け入れてしまう
public void changeLight(int color) {
    if (color == Light.RED) {
        System.out.println("赤信号です");
    }
    // ...
}

// 呼び出し側
changeLight(Light.RED); // OK
changeLight(100);       // 文法的にはOKだが、意図しない値が渡ってしまう！

final staticの場合、定数の実体はただのint型です。

そのため、changeLightメソッドに100のような無関係な数値を渡しても、コンパイルエラーにはなりません。これがバグの原因になります。

enumを使った例

public enum Signal {
    RED,
    YELLOW,
    BLUE
}

// メソッドの引数をSignal型に限定できる
public void changeSignal(Signal signal) {
    if (signal == Signal.RED) {
        System.out.println("赤信号です");
    }
    // ...
}

// 呼び出し側
changeSignal(Signal.RED);      // OK
// changeSignal(100);          // コンパイルエラー！Signal型以外の値は渡せない

enumを使うと、changeSignalメソッドの引数をSignal型に限定できます。

これにより、定義されていない値を誤って渡してしまうことをコンパイラが防いでくれるのです。この型安全性が、enumを使う最大のメリットです。

Javaのenumの基本構文と使い方

Javaのenumの基本的な宣言方法と構文を示す図解

ここからは、具体的なenumの使い方を見ていきましょう。構文は非常にシンプルで、すぐに覚えられます。

enumの宣言方法

enumを宣言するには、classの代わりにenumキーワードを使います。

public enum Season {
    SPRING,
    SUMMER,
    AUTUMN,
    WINTER
}

enumの中に書かれたSPRINGやSUMMERなどを列挙子と呼びます。慣習的に、列挙子はすべて大文字で記述するのが一般的です。

あわせて読む

enumの呼び出し方・使い方の基本例

enumの値を呼び出すのはとても簡単です。「enum名.列挙子」の形式でアクセスします。

// Season型の変数を宣言し、SPRINGを代入
Season currentSeason = Season.SPRING;

// 値の比較
if (currentSeason == Season.SPRING) {
    System.out.println("春が来ました。");
}

// enumの名称を文字列として取得
String seasonName = currentSeason.name(); // "SPRING" が返される
System.out.println(seasonName);

直感的でわかりやすいコードを書けるのがenumの魅力です。

switch文でのenumの活用方法

enumはswitch文と非常に相性が良いです。case句では、enum名を省略して列挙子だけを記述できるため、コードがスッキリします。

Season season = Season.SUMMER;

switch (season) {
    case SPRING:
        System.out.println("桜が綺麗です。");
        break;
    case SUMMER:
        System.out.println("海に行きたいですね。");
        break;
    case AUTUMN:
        System.out.println("紅葉の季節です。");
        break;
    case WINTER:
        System.out.println("雪が降ります。");
        break;
    default:
        System.out.println("季節外れです。");
        break;
}

caseの記述がシンプルになり、可読性が向上します。もしcaseで全ての列挙子を網羅していない場合、コンパイラが警告を出してくれることもあるため、分岐漏れを防ぐ効果も期待できます。なお、Java 14以降ではアロー構文（case SPRING -> System.out.println("桜が綺麗です。");）でbreak文を省略しつつ同様に書けます。

あわせて読む
あわせて読む

enum同士の比較は==とequalsどちらを使うべきか

enumの値を比較する際、「==」と「equals()」のどちらを使うべきか迷ったことはありませんか。

結論から言うと、enumの比較には==を使うのが安全かつ確実です。

理由は、enumの各列挙子（SPRINGやSUMMERなど）はJVMによってそれぞれ1つだけインスタンスが生成されることが保証されているからです。

同じ列挙子であれば、必ず同じインスタンスを参照します。

Season season = Season.SPRING;

// ==で比較（推奨）
if (season == Season.SPRING) {
    System.out.println("春です");
}

// equalsでも動作は同じだが、Object型へのキャストが発生する
if (season.equals(Season.SPRING)) {
    System.out.println("春です");
}

equals()でも結果は同じになりますが、Enumクラスのequals()は内部的にthis == otherという==比較をそのまま実装しているだけなので、実行時のパフォーマンス差はほとんどありません。

ただしメソッド呼び出しになる分だけ==より冗長になり、記述量も増えます。

Stringの比較で==を避けるべきという習慣からenumでもequals()を使ってしまうケースを見かけますが、enumに関しては==で問題ありません。

むしろ==を使えばnullチェックなしで安全に比較できるという利点もあります。

enumにフィールドやメソッドを持たせる方法

enumにフィールドやメソッドを持たせる書き方を示す図解

enumは単なる定数の集まりではなく、独自のフィールドやメソッドを持たせることで、関連するデータと処理を一体化できます。

enumの真価は、単なる定数の集まりに留まらない点にあります。enumはクラスのように、独自のフィールド（値）やメソッドを持たせられるのです。

これにより、関連するデータと振る舞いを一つにまとめられます。

値を持たせるenumの書き方

例えば、季節に日本語名を持たせたいケースを考えてみましょう。

public enum Season {
    SPRING("春"),
    SUMMER("夏"),
    AUTUMN("秋"),
    WINTER("冬"); // ← セミコロンが必要

    // フィールドを定義
    private final String japaneseName;

    // コンストラクタを定義（privateである必要がある）
    private Season(String japaneseName) {
        this.japaneseName = japaneseName;
    }

    // 値を取得するためのメソッド（ゲッター）
    public String getJapaneseName() {
        return japaneseName;
    }
}

ポイントは以下の3つです。

ポイント

  1. 列挙子の末尾にセミコロン（;）を付ける。
  2. private finalなフィールドを定義する。
  3. privateなコンストラクタを定義して、フィールドを初期化する。

コンストラクタ付きenumの実例

あわせて読む

実際に値を持つenumを使ってみましょう。ゲッターメソッドを呼び出すことで、設定した値を取得できます。

Season season = Season.AUTUMN;

// enumが持つ日本語名を取得
System.out.println(season.getJapaneseName()); // "秋" が表示される

AUTUMNという定数に「秋」というデータを関連付けられました。定数とそれに関連する情報を一元管理できるため、非常に便利です。

enumでメソッドを定義するケース

さらにenumは、独自のメソッドを定義できます。例えば、各季節におすすめのアクティビティを返すメソッドを追加してみましょう。

public enum Season {
    SPRING("春"),
    SUMMER("夏"),
    AUTUMN("秋"),
    WINTER("冬");

    private final String japaneseName;

    private Season(String japaneseName) {
        this.japaneseName = japaneseName;
    }

    public String getJapaneseName() {
        return japaneseName;
    }

    // 独自のメソッドを定義
    public String getRecommendedActivity() {
        switch (this) {
            case SPRING:
                return "お花見";
            case SUMMER:
                return "海水浴";
            case AUTUMN:
                return "紅葉狩り";
            case WINTER:
                return "スキー";
            default:
                return "不明";
        }
    }
}

// メソッドの呼び出し
Season season = Season.WINTER;
System.out.println(season.getRecommendedActivity()); // "スキー" が表示される

データとそのデータに関連する処理（ロジック）をenum内にカプセル化できます。

if文やswitch文がenumの外に散らばるのを防ぎ、コードの凝集度を高められます。

enumを使うときの実践的な活用例

注文ステータス管理などenumの実践的な活用例を示す図解

基本を理解したところで、より実践的なJava enumの活用方法を紹介します。

状態管理でのenumの使い方（例：注文ステータス）

ECサイトの注文ステータス管理は、enumの得意分野です。

public enum OrderStatus {
    PENDING("受付待ち"),
    PROCESSING("発送準備中"),
    SHIPPED("発送済み"),
    DELIVERED("配達完了"),
    CANCELED("キャンセル");

    private final String description;

    private OrderStatus(String description) {
        this.description = description;
    }

    public String getDescription() {
        return this.description;
    }

    // 次のステータスに進めるか判定するメソッド
    public boolean canProceedTo(OrderStatus nextStatus) {
        if (this == PENDING && nextStatus == PROCESSING) return true;
        if (this == PROCESSING && nextStatus == SHIPPED) return true;
        if (this == SHIPPED && nextStatus == DELIVERED) return true;
        return false;
    }
}

canProceedToのような状態遷移のロジックをenum内に実装することで、ステータスに関するルールを1箇所にまとめられます。

これにより、ビジネスロジックが明確になり、保守性が格段に向上します。

enumとインターフェースを組み合わせる方法

enumはクラスを継承できませんが、インターフェースを実装（implements）することはできます。

これを利用すると、異なるenumに共通の振る舞いを持たせられます。

// 共通のメソッドを定義したインターフェース
interface Describable {
    String getDescription();
}

// インターフェースを実装したenum
public enum UserType implements Describable {
    GENERAL_USER("一般ユーザー"),
    ADMIN_USER("管理者");

    private final String description;

    private UserType(String description) {
        this.description = description;
    }

    @Override
    public String getDescription() {
        return this.description;
    }
}

このように実装することで、Describableインターフェースを介して、様々なenumを統一的に扱えるようになります。

enumでif文をスッキリ書くテクニック

enumのメソッドを活用することで、複雑になりがちなif文のネストを解消できます。

改善前：if文が散らかっている例

public int calculateShippingFee(UserRank rank) {
    if (rank == UserRank.GOLD) {
        return 0; // 送料無料
    } else if (rank == UserRank.SILVER) {
        return 300;
    } else {
        return 500;
    }
}

改善後：enumのメソッドでロジックをまとめた例

public enum UserRank {
    GOLD(0),
    SILVER(300),
    BRONZE(500);

    private final int shippingFee;

    private UserRank(int shippingFee) {
        this.shippingFee = shippingFee;
    }

    // 送料を返すメソッドをenum内に定義
    public int getShippingFee() {
        return this.shippingFee;
    }
}

// 呼び出し側
public int calculateShippingFee(UserRank rank) {
    return rank.getShippingFee(); // 非常にシンプル！
}

会員ランクに応じた送料計算のロジックをUserRank enum内に閉じ込めました。

呼び出し側のコードが驚くほどスッキリし、ランクが増えた場合でもenumを修正するだけで対応できます。

enumを使うときの注意点・よくあるミス

enumを使う際の注意点やよくあるミスを示す図解

enumには、クラスの拡張不可・ordinal()の誤用・valueOf()の例外という3つの代表的な注意点があります。

enumを拡張できない理由・新しいインスタンスを生成できない理由

enumは、他のクラスを継承（extends）できません。

これは、全てのenumが内部的にjava.lang.Enumという抽象クラスを暗黙的に継承しているためです。

Javaは多重継承をサポートしていないので、他のクラスをextendsすることは不可能です。

同様に、new Season()のようにenumのインスタンスを自分で新規生成することもできません。

理由はコンストラクタが常にprivateであるためです。

各列挙子（SPRINGやSUMMERなど）は、enumを宣言した時点でJVMによって1度だけインスタンス化されます。

この「後から増やせない」という制約が、前述の==比較を安全に行える根拠です。

あわせて読む

ordinal()を安易に使うのは危険？

enumには、列挙子の定義順（0から始まる）を返すordinal()というメソッドがあります。

System.out.println(Season.SPRING.ordinal()); // 0
System.out.println(Season.SUMMER.ordinal()); // 1

一見便利に見えますが、このメソッドの安易な利用は危険です。

もし将来、enumの定義順を変更すると、ordinal()が返す値も変わってしまい、予期せぬバグを引き起こします。

データベースに保存する値としてordinal()を使うのは絶対に避けるべきです。

代わりに、name()メソッドで名前を保存するか、今回紹介したように独自のフィールド（IDなど）を持たせる方法が安全で確実です。

文字列変換のtoString()・valueOf()の使い分け

enumと文字列を相互に変換する際には、toString()（またはname()）とvalueOf()を使います。

  • toString(): enum定数を文字列に変換します。name()メソッドも同様の働きをします。String springStr = Season.SPRING.toString(); // "SPRING"
  • valueOf(): 文字列をenum定数に変換します。Season springEnum = Season.valueOf("SPRING"); // Season.SPRING

ここで注意すべきは、valueOf()です。

もし引数に定義されていない文字列を渡すと、IllegalArgumentExceptionという実行時エラーが発生します。

// Season.valueOf("HOGE"); // ← これを実行すると例外が発生！

ユーザー入力など、外部から受け取った文字列をvalueOf()で変換する際は、try-catchで例外処理をきちんと行いましょう。

values()メソッドで全ての列挙子を取得する

enumには、定義されている全ての列挙子を配列として取得できるvalues()という静的メソッドが自動的に用意されています。

for (Season s : Season.values()) {
    System.out.println(s.name() + ": " + s.getJapaneseName());
}
// 出力:
// SPRING: 春
// SUMMER: 夏
// AUTUMN: 秋
// WINTER: 冬

values()は、プルダウンメニューの選択肢を動的に生成したり、全列挙子に対してバリデーションチェックを行ったりする場面で頻繁に使われます。

列挙子を1つ追加・削除しても、values()を使ったループ処理側のコードを修正する必要がない点も大きなメリットです。

あわせて読む

enumがこれだけ便利なのに、現場のコードで今もfinal static intが使われ続けているのはなぜでしょうか。

理由の多くは「移行コストの高さ」にあります。

既存の定数がデータベースの値やAPIのレスポンスと直接紐づいている場合、enumへの置き換えは型の変更だけでは済まず、シリアライズ・デシリアライズの仕組みまで見直す必要が出てきます。

新規開発ではenumを迷わず選び、既存コードの改修では「触る機会があったときに少しずつ置き換える」くらいの気持ちで臨むのが現実的です。

よくある質問

Q1. Javaのenumとfinal staticの違いは何ですか？

A1. 最大の違いは型安全性です。final static intは実体がただのint型のため、無関係な数値を渡してもコンパイルエラーになりません。一方enumは専用の型として扱われるため、定義されていない値を渡すとコンパイルエラーになり、バグを未然に防げます。

Q2. enum同士の比較は==とequalsどちらを使うべきですか？

A2. ==を使うのが安全かつ確実です。enumの各列挙子はJVMによって1つだけインスタンスが生成されることが保証されているため、==で確実に比較できます。equals()でも動作は同じですが、Enumのequals()は内部的に==比較をそのまま実装しているだけなので、パフォーマンス差はほとんどありません。

Q3. enumはクラスを継承できますか？

A3. いいえ、できません。すべてのenumは内部的にjava.lang.Enumという抽象クラスを暗黙的に継承しており、Javaは多重継承をサポートしていないため、他のクラスをextendsすることはできません。ただしインターフェースの実装（implements）は可能です。

Q4. enumのordinal()を使うのは危険ですか？

A4. はい、データベースへの保存等には使うべきではありません。ordinal()は列挙子の定義順を返しますが、将来定義順を変更すると返り値も変わり、予期せぬバグを引き起こします。代わりにname()や独自のフィールド（IDなど）を使うのが安全です。

Q5. enumの全列挙子を取得するにはどうすればよいですか？

A5. values()という静的メソッドを使います。定義されている全ての列挙子を配列として返すため、for文で全列挙子をループ処理する際に便利です。列挙子を追加・削除してもループ処理側のコードを修正する必要がありません。

Q6. 文字列からenumに変換するにはどうすればよいですか？

A6. valueOf()メソッドを使います。ただし定義されていない文字列を渡すとIllegalArgumentExceptionが発生するため、ユーザー入力など外部から受け取った文字列を変換する場合はtry-catchで例外処理を行う必要があります。

まとめ：enumを使いこなせば定数管理が劇的に楽になる

今回は、Javaのenumの使い方について、基本から実践的なテクニックまで幅広く解説しました。

最後に要点をまとめます。

  • enumは、決まった値のセットを安全に扱うための仕組みです。
  • final static定数と比較して、型安全である点が最大のメリットです。
  • switch文と組み合わせると、コードがスッキリして見やすくなります。
  • フィールドやメソッドを持たせることで、データとロジックを一体化させ、コードの保守性を格段に向上させます。
  • ordinal()の安易な使用は避け、name()や独自のフィールドを活用するのが安全です。

enumは、単なる定数置き場ではありません。Javaのコードをより安全で、読みやすく、そして保守しやすくするための強力なツールです。

この記事で紹介したenumの使い方を参考に、ぜひあなたのプロジェクトでもenumを積極的に活用して、定数管理の悩みを解消してください。

きっと、その便利さに驚くはずです。

  • この記事を書いた人
  • 最新記事

トム

・都内自社開発企業勤務／Javaバックエンドエンジニア
／Java歴10年以上 ・首都圏在住30代
・資格：基本情報技術者／応用情報技術者／Java Silver／Python3エンジニア認定基礎 詳細なプロフィール

-Java入門