コンテンツにスキップ

運航調整機能 処理の流れ詳細 運航調整コンテキストのスイープ(定期実行) デモ向け版

デモ向け版(forDemo)の、運航調整コンテキストの時間経過に伴う状態遷移をポーリングで反映する定期処理(以下「スイープ処理」)の処理の流れを示す。

外部からのAPI呼び出しに応じて実行される他の処理と異なり、本処理はアプリケーション内部のスケジューラ(CoordinationSweepScheduler)が一定間隔で起動する。

  • 業務ロジック仕様
    • docs/coordination/BusinessLogicSpecifications.md 6.2節
  • 状態遷移
    • docs/coordination/state/forDemo/StateTransition_Coordination_Context_SimpleVerForDemo.pu
  • Springのスケジューラ(@Scheduled)により、一定間隔で自動的に起動する
  • ポーリング間隔はcoordination.sweep.interval-secondsで設定する(既定60秒、forDemo環境向け)
  • 1回の起動で例外が発生しても、以降の定期実行は継続する(ログ出力のみでスケジューラスレッドを落とさない)

デモ向け版(forDemo)では、下記のBlocked→Negotiableの遷移のみを対象とする。期限切れ判定(context_timeout等経過時のNotCoordinated遷移、docs/coordination/state/future/StateTransition_Coordination_Context.pu参照)は今後追加予定で、本処理に手順を追加していく想定(スケジューラ自体の変更は不要)。

    1. コンテキストごとの最新の運航調整情報レコードのうち、下記両方に該当するものを一覧取得
    • コンテキスト状態がBlocked
    • インターバル解除時刻(interval_cancellation_time)を現在時刻が経過している
    1. 対象レコードそれぞれについて、以下を実行
    • 2-1. コンテキスト状態をNegotiableへ更新
    • 2-2. 画面表示用情報(display_status・request_possible_flag・response_possible_flag)を、更新後のコンテキスト状態から算出し直して保存する(CoordinationStatus_MappingTable_forDisplay.md準拠。フロントエンドの「調整依頼実行」ボタンの活性判定に使用)
  • 「調整依頼の実行」処理(Coordination_SequenceDetail_Requests_forDemo.md4節)は、本スイープ処理の実行タイミングを待たずに、コンテキスト状態がBlockedかつインターバル解除時刻を経過している場合はその場でNegotiableと読み替えて判定する(DB更新はしない、その場限りの判定)。そのため、再依頼の受理可否自体は本スイープ処理の間隔に依存しない。
  • 本スイープ処理は、GET系API(GET /api/v1/coordination/coordinations)で参照するcontext_status・display_status・request_possible_flagを実態に追従させるためのものであり、最大でポーリング間隔分の反映遅延が生じ得る。