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の自動再接続に任せる。
uss_default_infoテーブル
Section titled “uss_default_infoテーブル”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_type | UTM利用タイプ |
forDemo向けの投入データ(db/migrations/002_seed_uss_default_info.sql):
| uss_id | utm_endpoint_url | operator_id | mail_address | utm_usage_type |
|---|---|---|---|---|
| IX_001 | https://demo-001.uss-intent-exchange.com | ix_ope_001 | ix-dummy@example.com | IX_UTM |
| NTTD_001 | https://diana.airpaletteutm.com | nttd_ope_001 | nttd-dummy@example.com | COORDINATION_CAPABLE_UTM |
テーブルに存在しないUSSIDは、COORDINATION_INCAPABLE_UTM扱いとし、operator_id・mail_addressは
固定のフォールバック値(unknown・unknown@example.com)を使用する。
各項目の値の決定方針 (forDemo)
Section titled “各項目の値の決定方針 (forDemo)”- 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等)