DocsPricingBlog
Contact Us
Log inSign up for FREE
Back to Tech Articles

RustにおけるEnumとMatchを用いた型安全なステートマシンの構築

Aug 06, 2025
# Misc

Min-jun Kim

Dev Intern · Leapcell

This post is also available in English, 한국어, and Deutsch
Cover of "RustにおけるEnumとMatchを用いた型安全なステートマシンの構築"

はじめに

ソフトウェア開発において、複雑なプロセスを管理することは、さまざまな状態を遷移することを含みます。ユーザーインターフェースのフローからネットワークプロトコルの処理、ゲームロジックに至るまで、ステートマシンはこれらの逐次的な動作をモデリングするための強力なパラダイムです。しかし、ステートマシンの実装はトリッキーになることがあり、状態遷移が厳密に強制されない場合、微妙なバグにつながることがよくあります。従来の多くのアプローチは、フラグや整数コードに依存していますが、型安全性がないためにエラーが発生しやすくなります。そこでRustが輝きます。その強力な型システム、特にenumとmatch式により、Rustはステートマシンを構築するためのエレガントで驚くほど型安全な方法を提供します。この記事では、Rustのユニークな機能が、コンパイル時の保証をもって状態と遷移を定義することをどのように可能にし、ステートマシンをより堅牢で理解しやすくするかを掘り下げていきます。

堅牢なステートマシンのためのコアコンポーネント

実装の詳細に入る前に、効果的なステートマシン、特にRustのような型安全な言語で構築するための基本的なコアコンポーネントを明確にしましょう。

ステートマシン: その核心において、ステートマシンは計算の数学的モデルです。これは、任意の時点で有限個の「状態」のいずれかに存在するシステムを記述します。システムは、特定のアクションやイベントに応じて、ある状態から別の状態へと「遷移」することができます。

状態: システムが特定時点で存在できる特定の条件またはモード。Rustでは、これらの状態はenumを使用して表します。

遷移: ある状態から別の状態への変化の行為。遷移は通常、イベントまたは条件によってトリガーされ、アクションに関連付けることができます。Rustのmatch式は、これらの遷移を網羅的に定義するのに最適です。

型安全性: 型エラーを防ぐプログラミング言語の機能。ステートマシンの文脈における型安全性とは、コンパイラが有効な状態遷移のみが試行されることを保証し、実行時ではなくコンパイル時に不可能な、または意図しない遷移を検出できることを意味します。これにより、バグのリスクが大幅に軽減されます。

Enum（列挙型）: Rustのデータ型で、有限個の名前付きバリアントのいずれかを表します。Enumは、すべての可能な状態を明示的に定義できるため、型安全なステートマシンの中心となります。各バリアントは関連データを持つこともでき、状態はその現在の条件に関連するコンテキストを保持できます。

Match式: Rustの強力な制御フロー構築で、値を一連のパターンと比較できます。これは網羅的であり、明示的に無視（_）しない限り、すべての可能なケースが処理される必要があることを意味します。この網羅性は、すべての状態遷移が適切に考慮され、処理されることを保証するために重要です。

型安全なステートマシンの構築

Rustのenumとmatch式の相乗効果は、コンパイル時の保証を持つステートマシンを実装するための強力なメカニズムを提供します。enumはすべての可能な状態を定義し、match式はすべての状態遷移が明示的に処理されることを保証します。処理されていない、または無効な遷移の試みは、コンパイル時にエラーとなり、バグのクラス全体を防ぎます。

簡単なTrafficLightステートマシンの例を考えてみましょう。トラフィックライトはRed、Yellow、またはGreenの状態を持つことができます。タイマーまたは外部イベントに基づいて遷移します。

// 1. Enumによる状態の定義
#[derive(Debug, PartialEq)]
enum TrafficLightState {
    Red,
    Yellow,
    Green,
}

// 2. 遷移をトリガーできるイベントの定義
enum TrafficLightEvent {
    TimerElapsed,
    EmergencyOverride,
}

// 3. ステートマシンロジックの実装
struct TrafficLight {
    current_state: TrafficLightState,
}

impl TrafficLight {
    // トラフィックライトを初期化するためのコンストラクタ
    fn new() -> Self {
        TrafficLight {
            current_state: TrafficLightState::Red, // Red状態で開始
        }
    }

    // イベントを処理し、状態を遷移させるメソッド
    fn handle_event(&mut self, event: TrafficLightEvent) {
        // match式は状態遷移を網羅的に処理します
        self.current_state = match (&self.current_state, event) {
            // Redから:
            (TrafficLightState::Red, TrafficLightEvent::TimerElapsed) => {
                println!("Light changed from Red to Green.");
                TrafficLightState::Green
            }
            (TrafficLightState::Red, TrafficLightEvent::EmergencyOverride) => {
                println!("Emergency override from Red to Red.");
                // 緊急オーバーライドはRedのまま、または点滅、あるいはYellowになるかもしれません。
                // この例では、Redのままにします。
                TrafficLightState::Red
            }

            // Greenから:
            (TrafficLightState::Green, TrafficLightEvent::TimerElapsed) => {
                println!("Light changed from Green to Yellow.");
                TrafficLightState::Yellow
            }
            (TrafficLightState::Green, TrafficLightEvent::EmergencyOverride) => {
                println!("Emergency override from Green to Red.");
                TrafficLightState::Red
            }

            // Yellowから:
            (TrafficLightState::Yellow, TrafficLightEvent::TimerElapsed) => {
                println!("Light changed from Yellow to Red.");
                TrafficLightState::Red
            }
            (TrafficLightState::Yellow, TrafficLightEvent::EmergencyOverride) => {
                println!("Emergency override from Yellow to Red.");
                TrafficLightState::Red
            }
        };
    }

    // 現在の状態を取得するヘルパー
    fn get_state(&self) -> &TrafficLightState {
        &self.current_state
    }
}

fn main() {
    let mut light = TrafficLight::new();
    println!("Initial state: {:?}", light.get_state()); // 出力: Initial state: Red

    light.handle_event(TrafficLightEvent::TimerElapsed); // 出力: Light changed from Red to Green.
    println!("Current state: {:?}", light.get_state()); // 出力: Current state: Green

    light.handle_event(TrafficLightEvent::TimerElapsed); // 出力: Light changed from Green to Yellow.
    println!("Current state: {:?}", light.get_state()); // 出力: Current state: Yellow

    light.handle_event(TrafficLightEvent::EmergencyOverride); // 出力: Emergency override from Yellow to Red.
    println!("Current state: {:?}", light.get_state()); // 出力: Current state: Red

    light.handle_event(TrafficLightEvent::TimerElapsed); // 出力: Light changed from Red to Green.
    println!("Current state: {:?}", light.get_state()); // 出力: Current state: Green
}

この例では：

  1. 状態の定義: TrafficLightState enumは、Red、Yellow、Greenの3つの可能な状態を明確に定義しています。これは型安全です。なぜなら、他の任意の文字列や整数を状態として表すことはできないからです。
  2. イベントの定義: TrafficLightEvent enumは、状態遷移をトリガーできるアクションを定義します。
  3. ステートマシンの構造: TrafficLight構造体はcurrent_stateを保持します。
  4. 遷移ロジック: handle_eventメソッドは、タプル (&self.current_state, event) に対して match式を使用します。これにより、現在の状態と受信したイベントの両方に基づいて遷移を定義できます。matchの網羅性により、(state, event)のすべての可能な組み合わせが明示的に処理されるか、コンパイル時のエラーで終わります。特定の(state, event)ペアを忘れた場合、Rustコンパイラは警告を発し、ステートマシンにとっては比類なきレベルで型安全性を強制します。

関連データを持つ状態

Enumはデータを持つこともでき、特定のコンテキストを保持する必要がある状態にとって非常に便利です。例えば、Payment処理ステートマシンの例を考えてみましょう。

#[derive(Debug, PartialEq)]
enum PaymentState {
    Initiated { transaction_id: String },
    Processing { transaction_id: String, merchant_id: String },
    Approved { transaction_id: String, amount: f64 },
    Declined { transaction_id: String, reason: String },
    Refunded { transaction_id: String, original_amount: f64, refunded_amount: f64 },
}

enum PaymentEvent {
    StartPayment(String),
    ProcessPayment(String, String), // transaction_id, merchant_id
    ApprovePayment(String, f64),    // transaction_id, amount
    DeclinePayment(String, String), // transaction_id, reason
    InitiateRefund(String, f64, f64), // transaction_id, original_amount, refunded_amount
}

struct PaymentProcessor {
    current_state: PaymentState,
}

impl PaymentProcessor {
    fn new(initial_id: String) -> Self {
        PaymentProcessor {
            current_state: PaymentState::Initiated { transaction_id: initial_id },
        }
    }

    fn handle_event(&mut self, event: PaymentEvent) -> Result<(), String> {
        let next_state = match (&self.current_state, event) {
            (PaymentState::Initiated { transaction_id }, PaymentEvent::ProcessPayment(event_id, merchant_id)) => {
                if transaction_id == &event_id {
                    PaymentState::Processing { transaction_id: event_id, merchant_id }
                } else {
                    return Err(format!("Mismatched transaction ID for processing: expected {}, got {}", transaction_id, event_id));
                }
            }
            (PaymentState::Processing { transaction_id, .. }, PaymentEvent::ApprovePayment(event_id, amount)) => {
                if transaction_id == &event_id {
                    PaymentState::Approved { transaction_id: event_id, amount }
                } else {
                    return Err(format!("Mismatched transaction ID for approval: expected {}, got {}", transaction_id, event_id));
                }
            }
            (PaymentState::Processing { transaction_id, .. }, PaymentEvent::DeclinePayment(event_id, reason)) => {
                if transaction_id == &event_id {
                    PaymentState::Declined { transaction_id: event_id, reason }
                } else {
                    return Err(format!("Mismatched transaction ID for decline: expected {}, got {}", transaction_id, event_id));
                }
            }
            (PaymentState::Approved { transaction_id, amount: original_amount }, PaymentEvent::InitiateRefund(event_id, _, refunded_amount)) => {
                 if transaction_id == &event_id {
                    PaymentState::Refunded {
                        transaction_id: event_id,
                        original_amount: *original_amount,
                        refunded_amount,
                    }
                } else {
                    return Err(format!("Mismatched transaction ID for refund: expected {}, got {}", transaction_id, event_id));
                }
            }
            // 無効な遷移のためのキャッチオール、型安全性と明示的なエラー処理を保証
            (current, event) => return Err(format!("Invalid transition: {:?} from {:?}", event, current)),
        };
        self.current_state = next_state;
        Ok(())
    }

    fn get_state(&self) -> &PaymentState {
        &self.current_state
    }
}

fn main() {
    let mut processor = PaymentProcessor::new("TX123".to_string());
    println!("Initial state: {:?}", processor.get_state());

    processor.handle_event(PaymentEvent::ProcessPayment("TX123".to_string(), "MercA".to_string())).unwrap();
    println!("Current state: {:?}", processor.get_state());

    processor.handle_event(PaymentEvent::ApprovePayment("TX123".to_string(), 99.99)).unwrap();
    println!("Current state: {:?}", processor.get_state());

    let res_err = processor.handle_event(PaymentEvent::DeclinePayment("TX123".to_string(), "Fraud detected".to_string()));
    assert!(res_err.is_err()); // 承認された支払いを直接拒否することはできません
    println!("Attempted invalid transition: {:?}", res_err.unwrap_err());
    println!("Current state after invalid attempt: {:?}", processor.get_state());

    processor.handle_event(PaymentEvent::InitiateRefund("TX123".to_string(), 99.99, 50.00)).unwrap();
    println!("Current state: {:?}", processor.get_state());
}

PaymentProcessorの例では、各PaymentStateバリアントは関連データ（例：transaction_id、amount、reason）を保持しています。これにより、PaymentProcessor構造体内の、一部の状態では初期化されていないか無関係である可能性のある個別のフィールドが不要になり、データ整合性が向上し、メモリフットプリントが削減されます。handle_eventメソッドは、無効な遷移を適切に処理するためにResultを返すようになりましたが、主たる型安全性はmatch式が網羅的であることによって、処理されない状態を防ぐことから来ています。

アプリケーションシナリオ

Rustのenumとmatchを使用した型安全なステートマシンは、以下に最適です。

  • ネットワークプロトコル: ハンドシェイクや接続ライフサイクルの段階の定義。
  • ゲーム開発: キャラクターの状態（アイドル、歩行、攻撃）、ゲームステージ（メニュー、プレイ中、ゲームオーバー）、またはAIの動作の管理。
  • ワークフローエンジン: 明確で強制されたステップと遷移を持つビジネスプロセスのモデリング。
  • パーサー設計: 入力が処理されるにつれて、解析コンテキストを追跡する。
  • UIコンポーネントの状態: UI要素の無効/有効、表示/非表示、またはさまざまなインタラクション状態の処理。

その利点は明らかです。実行時エラーの削減、明示的な状態定義によるコード可読性の向上、コンパイラが正しい状態ロジックの強制を支援することによる保守性の向上です。

結論

Rustの強力なenumとmatch構文は、ステートマシンを構築するための例外的に型安全でイディオマティックなアプローチを提供します。状態をenumバリアントとして定義し、遷移を網羅的なパターンマッチングを通じて定義することで、開発者は無効な状態遷移に関連するバグのクラス全体を排除し、堅牢で信頼性の高いシステムロジックを実現できます。このコンパイル時の検証は、コードの正確性に対する信頼を高めるだけでなく、複雑なシステム動作の理解と保守を大幅に容易にします。Rustにおける型安全なステートマシンは、アプリケーションのフローが常に予測可能で正しいことを保証します。

Share this article

HackerNews

More Posts from Leapcell

Popular Posts