リンクと関係

A リンクと関係

ビジネス・オブジェクト関係は、現在のビジネス・オブジェクトとリンクが指すビジネス・オブジェクトとの間の関係を定義するURLとして、レスポンス内に表されます。

この付録の内容は次のとおりです。

リンクの説明オブジェクトの構造

linksは、値が常にURLリンクであり、リンク名がリンクのrelに従って定義されるJSONオブジェクトです。リソースの収集、アイテム、リソース自体に対して、linksオブジェクトが生成されます。

URLのすべての部分を判別するのに十分な情報がない場合は、リソース記述内のURLリンクは、テンプレートのプレースホルダー値({id})を使用して生成されます。たとえば、次の子リンクは、特定のDepartmentリソースの値のプレースホルダーをURLに提供します:

"item" : {
     "links" : [ {
        "rel" : "child",
        "href" : "<base_url>/Department/{id}/child/Employee",
        "name" : "Employee",
        "kind" : "collection",
        "cardinality" : {
          "value" : "1 to *",
          "sourceAttributes" : "DepartmentId",
          "destinationAttributes" : "DepartmentId"
        }

rel属性値

rel属性は、現在のリソースとリンクが指しているリソース間のリンク関係のタイプを定義します。関係は、以下の表に示すいずれかの値で指定できます。

表A-1 RESTリソース記述におけるリンク関係

リンク関係	説明
`self`	リソースに対して常に生成。 `href`は、リソース自体またはリソースの記述を指します。 `links`オブジェクトでは、リンク名は`self`で、この`rel`のものです。
`parent`	ネストされたリソースでは、常に生成します。 `href`は、親リソースの`self`リンクを指します。 `links`オブジェクトでは、リンク名は`parent`です(この`rel`の場合)。
`child`	リソースにネストされた子がある場合に生成されました。 `href`は、ネストされたコレクションを指し示しています。 `links`オブジェクトでは、リンク名はこの`rel`のアクセサ名です。
`current`	複数のリソース・バージョン識別子が存在する場合に、リソース・バージョン記述で生成されました。 `href`は、Webアプリケーションのバージョン定義で定義された最新のバージョン識別子を指します。
`predecessor-version`	複数のリソース・バージョン識別子が存在する場合に、リソース・バージョン記述で生成されました。 `href`は、Webアプリケーションのバージョン定義により定義された以前のバージョン識別子を指します。
`successor-version`	複数のリソース・バージョン識別子が存在する場合に、リソース・バージョン記述で生成されました。 `href`は、Webアプリケーションのバージョン定義で定義された次の最新のバージョン識別子を指します。
`describe`	リソース・バージョン記述で生成されました。 `href`は、同じバージョンのすべてのリソースについて記述するリソース・カタログを指します。

href属性値

href属性は、リンクされたリソースまたはリソース記述へのURLを定義します。

カーディナリティ属性値

cardinality属性は、ソース・リソースと宛先リソースのカーディナリティを定義するオプションの属性です。この属性は、rel属性値がchildで、リソース・タイプがvnd.oracle.adf.description+jsonの場合にのみ使用できます。このカーディナリティ属性には次の属性があります。

value: カーディナリティの値です。例: "1 to *"
sourceAttributes: 宛先リソースへのリンクに使用されるソース・リソースの属性。
destinationAttributes: ソース・リソースへのリンクに使用される宛先リソースの属性。