NGSI-LD Wrapper (NGSI-LD ラッパー)

MIT license Build badge Docker badge

このプロジェクトの目的は、FIWARE Context Broker 上にある、プロキシによって生成されるラッパーに基づいて NGSI-LD の実装を作成することです。FIWARE NGSI を活用する NGSI-LD は、ETSI ISG CIM によって開発された国際標準であり、複数のシナリオでのコンテキスト情報の提供、使用、およびサブスクライブを目的としています。これにより、IoT だけでなく、さまざまな情報源からの情報へのリアルタイムのアクセスが可能になります。

FIWARE NGSI の根幹となる、OMA NGSI-9/10 情報モデル は、JSON-LD の機能を活用した、リンクト・データ (エンティティのリレーションシップ)、プロパティ・グラフ、セマンティクスをよりよくサポートするために ETSI CIM によって強化されています。結果の仕様は、NGSI-LD と命名されました。注目すべきは、NGSI-LD 情報モデル が OMA NGSI-9/10 情報モデル の一般化であることです。結果として、両方の情報モデルの間に良好なレベルの互換性と明確な移行パスが期待されます。

このラッパーは、FIWARE Context Broker 上で動作し、基本的に、NGSIv2 (JSON) 表現と NGSI-LD (JSON-LD) 表現の間で適応します。

NGSI-LD の使用例をここに示します。

ビルド方法

前提条件

  • Java 8
  • Scala runtime
  • SBT build tool
$ sbt compile
$ export NGSI_Endpoint=http://<Your_NGSI_Endpoint i.e. Orion's host:port>
$ sbt jetty:start

テスト方法

$ sbt test

Docker を使った実行方法

$ docker run -e NGSI_Endpoint="http://<Your_NGSI_Endpoint i.e. Orion's host:port>" fiware/ngsi-ld_wrapper

$ curl http://localhost:1030/version

Docker Compose を使った実行方法

$ wget https://raw.githubusercontent.com/Fiware/NGSI-LD_Wrapper/master/docker-compose.yml
$ docker-compose up

$ curl http://localhost:1030/version

設定を確認する方法 (NGSI endpoint)

$ curl http://localhost:1030/configuration 

API オペレーションを呼び出す方法

$ curl http://localhost:1030/api/entities/ 

参照 :

https://github.com/fiware/dataModels

https://github.com/fiware/context.Orion