コンテンツにスキップ

DIPS Connector暫定実装 (forDemo)

本ドキュメントは、「4.1.2. DIPS Connector」で参照される、forDemo向けのDIPS Connector暫定実装の詳細を記載する(issue #108)。

「3. 用語定義」の通り、DIPS Connectorは当初UTM Backends側の機能が担う設計としていた。 しかし、10月デモまでにDIPS Connector相当の処理が必要なのが運航調整機能のみであるため、10月デモ向けの暫定対応として、DIPS Connector相当の機能を運航調整機能(本リポジトリ)側に一時的に実装する。(将来的に運航調整機能とは別機能として切り離すかは10月以降に別途検討想定)

10月デモ完了後、UTM Backends側にDIPS Connectorとして正式に実装される際は、本実装をベースに移管することを想定している。

運航調整機能自体がMQTT Subscriberを持ち、模擬DIPSのトピック(/{自USSID}/adjustmentmsg)をSubscribeする。 受信した通知を解析し、下記のように扱う。

coordinationMessage相当する処理
notificationType:0 (重複通知)「重複通知の受信」(5.1節の重複情報を新規登録)
notificationType:1 (重複更新通知)「重複通知の受信」と同じ処理 (forDemo時点では、既存の重複情報が重複状態のまま再通知された場合は冪等なno-opとして扱うため、更新固有の処理はない)
notificationType:2 (重複解消通知)「重複解除通知の受信」(重複情報の重複状態フラグをfalseへ更新)

coordinationTypeが10(DIPS起因)以外、または上記以外のcoordinationMessageの通知は対象外として無視する。

DIPS Connectorが運航調整機能内部に同居するため、既存の「重複通知の受信」「重複解除通知の受信」APIをHTTP経由で 自分自身に呼び返すのではなく、対応するユースケースをアプリ内で直接呼び出す。ただし、手動での動作確認のため、 上記2つの内部APIは引き続き提供する。

模擬DIPSへのMQTT接続は設定(dips.mqtt.enabled)で有効/無効を切り替えられ、既定は無効。 ローカル開発や模擬DIPS未起動の環境では、接続自体を試みないため、他の処理へ影響しない。 接続断時の再接続はPaho/Spring Integrationの自動再接続に任せる。

DIPSの重複通知に含まれない下記の情報を補うため、USSIDをキーとしたデフォルト情報テーブル (coordination.uss_default_info)を設ける。スキーマはdb/schema/coordination.sqlを参照。

カラム説明
uss_id (PK)USSID (DIPSの重複通知のfrom/to.ussIdに対応)
utm_endpoint_url当該USSのUTMエンドポイントURL (パスを含まないベースURL)
operator_id運航者識別子のデフォルト値
mail_addressメールアドレスのデフォルト値
utm_usage_typeUTM利用タイプ

forDemo向けの投入データ(db/migrations/002_seed_uss_default_info.sql):

uss_idutm_endpoint_urloperator_idmail_addressutm_usage_type
IX_001https://demo-001.uss-intent-exchange.comix_ope_001ix-dummy@example.comIX_UTM
NTTD_001https://diana.airpaletteutm.comnttd_ope_001nttd-dummy@example.comCOORDINATION_CAPABLE_UTM

テーブルに存在しないUSSIDは、COORDINATION_INCAPABLE_UTM扱いとし、operator_id・mail_addressは 固定のフォールバック値(unknown・unknown@example.com)を使用する。

  • self_operator_id / opponent_operator_id: 上記テーブルの値(ダミー)を使用する。
    • 理由: (a) DIPSの飛行計画参照APIで取得できる情報の中に一意な識別子に相当するフィールドがない (b) コンテキストオーナー優先度判定ロジック(6.3節)はforDemoまで実装・テスト対象外のため、値が何であっても動作に影響しない (c) 10月デモまで期間がなく、本番向け仕様は別途検討する
  • self_mail_address / opponent_mail_address: 上記テーブルの値(ダミー)を使用する。10月デモ時点では使用しないため。
    • 補足: メールアドレスは個人ではなく組織のメールアドレスを設定することが多く、同じUTM利用者間で重複が 発生した際は両者が同じメールアドレスになる可能性がある。
  • self_utm_endpoint_url: 常に上記テーブルの値を使用する(通知メッセージに自分自身のURLは含まれないため)。
  • opponent_utm_endpoint_url: DIPS通知のfrom.uriを優先し、取得できない場合のみ上記テーブルの値を フォールバックとして使用する。
  • self_utm_usage_type / opponent_utm_usage_type: 常に上記テーブルの値を使用する。

TODO(#335)

上記はいずれもforDemo向けの暫定対応であり、10月デモ完了後、UTM Backends結合後の実データ取得を含めた 本番向け仕様は別途検討する。

  • issue #108
  • コード: ReceiveDipsAdjustmentMessageUseCase、UssDefaultInfoRepository、DipsMqttConfig、DipsMqttProperties、 handler.mqttパッケージ (DipsAdjustmentMessageListener等)