Binding

実際の通信方式（HTTPS、ファイル転送、WebSocket等）に当てはめたときの定義を記述する。 以下に記述する内容は全てNon-normative（例示）である。

Concrete Specification（実装例）

Prerequisites（前提条件）

• HTTPS通信

• RDF

• JSON-LD

• UTF-8

• SAMM

• dcterms

Field Definitions（フィールド定義）

本プロトコルで使用される各フィールドの定義を記す。

Discovery Finder/Discovery Serviceは「サービスインスタンス」データを返却する。 サービスインスタンスはJSON-LD形式で表現され、以下の主要な構成要素を持つ：

• フィールド名：binding内で使用される名称

• 型：データ型（例：整数、文字列）

• 必須性：フィールドの利用条件

  • R = Required（必須）

  • C = Conditional（条件付き必須）

  • O = Optional（任意）

• Request：リクエストにおいて使用される

• Response：レスポンスにおいて使用される

• 説明：フィールドの意味や利用方法

フィールド名	説明	必須	Request	Response	説明
@context	文字列	R		○	JSON-LD名前空間の定義。使用するボキャブラリ（dcterms, ods, serviceなど）のプレフィックスとURIを紐付ける
@graph	文字列	R		○	サービスインスタンスの実体データを格納する配列
ods:DomainApp	文字列	R		○	Discovery Serviceまたはドメインアプリケーションの定義。それらが提供するエンドポイント一覧やサービスプロバイダ名を含む
ods:DomainAppEndpoint	文字列	R		○	Discovery Serviceまたはドメインアプリケーションが持つ個別のAPIエンドポイント定義。各エンドポイントのURIを指定
ods:BaseEndpoint	文字列	R		○	Discovery ServiceまたはドメインアプリケーションのベースURL
ods:SparqlEndpoint	文字列	R		○	ドメインアプリケーションが持つRDFサーバのSPARQLクエリを受け付けるエンドポイントのURL

Discovery Serviceが返却するサービスインスタンス例（航空分野のドローン航路）

{
  "@context": {
    "dcterms": "http://purl.org/dc/terms/",
    "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
    "api": "https://localhost.com/v1/api#",
    "inst": "http://www.example.com/myservice/instance#",
    "ods": "https://github.com/ODS-DFS-L4/ods/",
    "service": "urn:samm:com.uasl.service:1.1.0#"
  },
  "@graph": [
    {
      "@id": "inst:MyServiceProd",
      "@type": "ods:DomainApp",
      "dcterms:conformsTo": [
        {
          "@id": "api:UaslServiceWebService"
        },
        {
          "@id": "service:UaslService"
        }
      ],
      "ods:hasBaseEndpoint": {
        "@id": "inst:myServiceBaseEndpoint"
      },
      "ods:hasEndpoint": [
        {
          "@id": "inst:airwayReservationDetailGetEndpoint"
        },
        {
          "@id": "inst:airwayReservationsPostEndpoint"
        }
      ],
      "ods:hasSparqlEndpoint": {
        "@id": "inst:myServiceSparqlEndpoint"
      },
      "service:serviceProviderName": {
        "@type": "http://www.w3.org/2001/XMLSchema#string",
        "@value": "Service Provider Name"
      }
    },
    {
      "@id": "inst:airwayReservationsPostEndpoint",
      "@type": "ods:DomainAppEndpoint",
      "service:airwayReservationsPostRequestUri": {
        "@type": "http://www.w3.org/2001/XMLSchema#anyURI",
        "@value": "https://example.com/api/v1/path"
      }
    },
    {
      "@id": "inst:airwayReservationDetailGetEndpoint",
      "@type": "ods:DomainAppEndpoint",
      "service:airwayReservationDetailGetRequestUri": {
        "@type": "http://www.w3.org/2001/XMLSchema#anyURI",
        "@value": "https://example.com/api/v1/path"
      }
    },
    {
      "@id": "inst:myServiceSparqlEndpoint",
      "@type": "ods:SparqlEndpoint",
      "ods:accessURL": {
        "@type": "http://www.w3.org/2001/XMLSchema#anyURI",
        "@value": "https://example.com/sparql"
      }
    }
  ]
}

Discovery Finderが返却するサービスインスタンス例（航空分野のドローン航路）

{
  "@context": {
    "dcterms": "http://purl.org/dc/terms/",
    "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
    "ods": "https://github.com/ODS-DFS-L4/ods/",
    "ads": "urn:samm:org.eclipse.esmf:1.0.0#",
    "api": "https://airway-discovery.example.com/1.0.0/api#",
    "inst": "http://airway-discovery.example.com/instance#"
  },
  "@graph": [
    {
      "@id": "inst:AirwayDiscoveryServiceProd",
      "@type": "ods:DomainApp",
      "dcterms:conformsTo": [
        {
          "@id": "ads:AirwayDiscoveryService"
        },
        {
          "@id": "api:AirwayDiscoveryWebService"
        }
      ],
      "dcterms:description": [
        {
          "@language": "en",
          "@value": "Production instance of Airway Discovery Service for finding and managing airway resources"
        },
        {
          "@language": "ja",
          "@value": "航路リソースの検索と管理のための航路ディスカバリーサービスの本番インスタンス"
        }
      ],
      "dcterms:title": [
        {
          "@language": "en",
          "@value": "Airway Discovery Service - Production"
        },
        {
          "@language": "ja",
          "@value": "航路ディスカバリーサービス - 本番環境"
        }
      ],
      "ods:hasEndpoint": [
        {
          "@id": "inst:FindResourceEndpointProd"
        },
        {
          "@id": "inst:RegisterDomainApplicationEndpointProd"
        },
        {
          "@id": "inst:RegisterResourceEndpointProd"
        }
      ],
      "ods:sparqlEndpoint": {
        "@type": "http://www.w3.org/2001/XMLSchema#anyURI",
        "@value": "https://example.com/sparql"
      },
      "ads:serverUrl": {
        "@type": "http://www.w3.org/2001/XMLSchema#anyURI",
        "@value": "https://example.com/rpc-api/v1"
      }
    },
    {
      "@id": "inst:RegisterDomainApplicationEndpointProd",
      "@type": "ods:DomainAppEndpoint",
      "dcterms:conformsTo": {
        "@id": "api:RegisterDomainApplicationAPI"
      },
      "dcterms:title": [
        {
          "@language": "en",
          "@value": "Register Domain Application Endpoint"
        },
        {
          "@language": "ja",
          "@value": "ドメインアプリケーション登録エンドポイント"
        }
      ],
      "ods:endpointInformation": "JSON-RPC endpoint for registering new domain applications",
      "ads:registerDomainApplicationRequestUri": {
        "@type": "http://www.w3.org/2001/XMLSchema#anyURI",
        "@value": "https://example.com/rpc-api/v1/airway/operations"
      }
    },
    {
      "@id": "inst:RegisterResourceEndpointProd",
      "@type": "ods:DomainAppEndpoint",
      "dcterms:conformsTo": {
        "@id": "api:RegisterResourceAPI"
      },
      "dcterms:title": [
        {
          "@language": "en",
          "@value": "Register Resource Endpoint"
        },
        {
          "@language": "ja",
          "@value": "リソース登録エンドポイント"
        }
      ],
      "ods:endpointInformation": "JSON-RPC endpoint for registering new resources",
      "ads:registerResourceRequestUri": {
        "@type": "http://www.w3.org/2001/XMLSchema#anyURI",
        "@value": "https://example.com/rpc-api/v1/airway/operations"
      }
    },
    {
      "@id": "inst:FindResourceEndpointProd",
      "@type": "ods:DomainAppEndpoint",
      "dcterms:conformsTo": {
        "@id": "api:FindResourceAPI"
      },
      "dcterms:title": [
        {
          "@language": "en",
          "@value": "Find Resource Endpoint"
        },
        {
          "@language": "ja",
          "@value": "リソース検索エンドポイント"
        }
      ],
      "ods:endpointInformation": "JSON-RPC endpoint for finding resources by location and drone model",
      "ads:findResourceRequestUri": {
        "@type": "http://www.w3.org/2001/XMLSchema#anyURI",
        "@value": "https://example.com/rpc-api/v1/airway/operations"
      }
    }
  ]
}

---

Functional Description（機能詳細）

Discovery Service

• ビジネスドメインにおけるアプリケーション（データ/サービス）のリソース情報を元に、そのリソースに関するアプリケーションのエンドポイントを解決

• 利用者が、ドメインで使用する様々なデータを検索キーで検索し、データおよびそのデータ獲得に必要なドメインアプリケーションのメタデータを解決

  • 検索キー：緯度・経度、文字列、数値

  • 検索結果：サービスインスタンスのメタデータ

機能分類	機能概要
空間インデックス	緯度経度の近いデータを近傍に管理することで、緯度経度情報を含む空間検索を高速に実施可能。緯度経度の範囲と、半径指定検索に対応
文字列インデックス	同じキーワードを持つリソースを検索可能
メッセージ処理作成機能	インターフェース定義から、メッセージ処理プログラムを生成する
データベース作成機能	インターフェース定義から、インデックス管理用のRDBテーブルを作成する

なお、独自のビジネスドメイン用にDiscovery Serviceを構築する場合、メッセージ処理とデータベース部分は自動生成されるが、それらをつなぐ処理のみ開発を行う必要がある。

Discovery Finder

• Discovery Service利用者がDiscovery Serviceにアクセスするエンドポイントを解決するために使用

• Discovery Serviceのエンドポイントを登録

  • 既存のキーワードに登録するか新しいキーワードを作成して登録するか選択可能

• Discovery Serviceのエンドポイント(アクセスURL)を検索

  • 検索キー：

    1. ディスカバリーサービスのキーワード（例：UAS Lines）

    2. 事業ドメインを表すキーワード（例：ドローン、ドローン航路、ポートなど）

---

Sequence Diagram