RFC 6573 - The Item and Collection Link Relations 日本語訳

原文URL : https://datatracker.ietf.org/doc/html/rfc6573
タイトル : RFC 6573 - アイテムとコレクションのリンク関係
翻訳編集 : 自動生成

[要約] RFC 6573は、アイテムとコレクションのリンク関係についての標準化された仕様であり、リンク関係の定義と使用方法を提供しています。その目的は、Web上のリソース間の関係を明確にし、リンクの一貫性と相互運用性を向上させることです。

Internet Engineering Task Force (IETF)                       M. Amundsen
Request for Comments: 6573                                    April 2012
Category: Informational
ISSN: 2070-1721

The Item and Collection Link Relations

アイテムとコレクションのリンク関係

Abstract

概要

RFC 5988 standardized a means of indicating the relationships between resources on the Web. This specification defines a pair of reciprocal link relation types that may be used to express the relationship between a collection and its members.

RFC 5988は、Web上のリソース間の関係を示す手段を標準化しました。この仕様は、コレクションとそのメンバー間の関係を表すために使用できる相互リンク関係タイプのペアを定義します。

Status of This Memo

本文書の状態

This document is not an Internet Standards Track specification; it is published for informational purposes.

このドキュメントはInternet Standards Trackの仕様ではありません。情報提供を目的として公開されています。

This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Not all documents approved by the IESG are a candidate for any level of Internet Standard; see Section 2 of RFC 5741.

このドキュメントは、IETF（Internet Engineering Task Force）の製品です。これは、IETFコミュニティのコンセンサスを表しています。公開レビューを受け、インターネットエンジニアリングステアリンググループ（IESG）による公開が承認されました。 IESGによって承認されたすべてのドキュメントが、あらゆるレベルのインターネット標準の候補になるわけではありません。 RFC 5741のセクション2をご覧ください。

Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc6573.

このドキュメントの現在のステータス、エラータ、およびフィードバックの提供方法に関する情報は、http：//www.rfc-editor.org/info/rfc6573で入手できます。

著作権表示

This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.

この文書は、BCP 78およびIETF文書に関するIETFトラストの法的規定（http://trustee.ietf.org/license-info）の対象であり、この文書の発行日に有効です。これらのドキュメントは、このドキュメントに関するあなたの権利と制限を説明しているため、注意深く確認してください。このドキュメントから抽出されたコードコンポーネントには、Trust Legal Provisionsのセクション4.eに記載されているSimplified BSD Licenseのテキストが含まれている必要があり、Simplified BSD Licenseに記載されているように保証なしで提供されます。

1. Introduction

1. はじめに

These link relation types can be applied to a wide range of use cases across multiple media types. For example, the 'collection' and 'item' link relation types are used in these media types:

これらのリンク関係タイプは、複数のメディアタイプにわたる幅広いユースケースに適用できます。たとえば、「コレクション」および「アイテム」リンクの関係タイプは、次のメディアタイプで使用されます。

1. OpenSearch 1.1: see Section 4.5.4.1 of [OpenSearch]

1. OpenSearch 1.1：[OpenSearch]のセクション4.5.4.1を参照

2. Maze+XML: see [Maze]

2. まぜ＋ＸＭＬ：せえ「まぜ」

3. Collection+JSON: see [CollectionJSON]

3. Collection + JSON：[CollectionJSON]を参照

2. Link Relations

2. リンク関係

The following link relations are defined.

以下のリンク関係が定義されています。

2.1. 'item'

2.1. '項目'

When included in a resource that represents a collection, the 'item' link relation identifies a target resource that represents a member of that collection.

コレクションを表すリソースに含まれる場合、「アイテム」リンク関係は、そのコレクションのメンバーを表すターゲットリソースを識別します。

For example, if a resource represents a catalog of products, that same representation may include one or more links to resources that represent members of that catalog.

たとえば、リソースが製品のカタログを表す場合、その同じ表現には、そのカタログのメンバーを表すリソースへの1つ以上のリンクが含まれる場合があります。

   <html>
   ...
     <h1>Product Group X Listing</h1>
     ...
     <a href="..." rel="item">View Product X001</a>
     <a href="..." rel="item">View Product X002</a>
     ...
   </html>

or, in the case of a Link Header field

または、リンクヘッダーフィールドの場合

   Link: <...>; rel="item"; title="View Product X001"
   Link: <...>; rel="item"; title="View Product X002"

2.2. 'collection'

2.2. 'コレクション'

When included in a resource that represents a member of a collection, the 'collection' link relation identifies a target resource that represents a collection of which the context resource is a member.

コレクションのメンバーを表すリソースに含まれる場合、「コレクション」リンク関係は、コンテキストリソースがメンバーであるコレクションを表すターゲットリソースを識別します。

For example, if a resource represents a single product in a catalog, that same representation may include a link to a resource that represents a product group to which this single product belongs:

たとえば、リソースがカタログ内の単一の製品を表す場合、その同じ表現には、この単一の製品が属する製品グループを表すリソースへのリンクが含まれる場合があります。

   <a href="..." rel="collection">Return to Product Group X</a>

or, in the case of a Link Header field

または、リンクヘッダーフィールドの場合

   Link: <...>; rel="collection"; title="Return to Product Group X"

Since it is possible that a resource could be a member of multiple collections, multiple 'collection' link relations may appear within the same representation:

リソースが複数のコレクションのメンバーである可能性があるため、複数の「コレクション」リンク関係が同じ表現内に表示される場合があります。

   <a href="..." rel="collection">View other widgets</a>
   <a href="..." rel="collection">View all discontinued items</a>

The target resource representation need not be restricted to representing a list. It may simply be a document that provides details on the collection of which the context resource is a member:

ターゲットリソースの表現は、リストの表現に限定する必要はありません。これは、コンテキストリソースがメンバーとなっているコレクションの詳細を提供するドキュメントの場合もあります。

   Link: <...>; rel="collection";
         title="Shakespeare's Collected Works - A History"

It should also be noted that the same link might represent an 'item' in one collection as well as a 'collection' itself. In this case, both link relation values can be applied to the same link:

また、同じリンクが1つのコレクション内の「アイテム」と「コレクション」自体を表す場合があることにも注意してください。この場合、両方のリンク関係値を同じリンクに適用できます。

   Link: <...>; rel="collection item";
         title="A Review of Issac Asimov's Collected Works - Vol. I"

3. IANA Considerations

3. IANAに関する考慮事項

IANA has registered the 'collection' and 'item' link relations below as per [RFC5988].

IANAは、[RFC5988]に従って、以下の「コレクション」および「アイテム」リンク関係を登録しました。

3.1. 'item' Link Relation Registration

3.1. 'item'リンク関係登録

Relation Name:

リレーション名：

item

項目

Description:

説明：

The target IRI points to a resource that is a member of the collection represented by the context IRI.

ターゲットIRIは、コンテキストIRIで表されるコレクションのメンバーであるリソースを指します。

Reference:

参照：

See Section 2

セクション2を参照

3.2. 'collection' Link Relation Registration

3.2. 「コレクション」リンク関係登録

Relation Name:

リレーション名：

collection

コレクション

Description:

説明：

The target IRI points to a resource that represents the collection resource for the context IRI.

ターゲットIRIは、コンテキストIRIのコレクションリソースを表すリソースを指します。

Reference:

参照：

See Section 2

セクション2を参照

4. Security Considerations

4. セキュリティに関する考慮事項

The two link relation types defined in this document do not introduce any new security issues to those which are discussed in Section 7 of RFC5988 [RFC5988].

このドキュメントで定義されている2つのリンク関係タイプは、RFC5988 [RFC5988]のセクション7で説明されているものに新しいセキュリティ問題をもたらしません。

5. Internationalisation Considerations

5. 国際化に関する考慮事項

The 'item' and 'collection' link relation types do not have any internationalization considerations other than those which are discussed in Section 8 of RFC5988 [RFC5988].

「アイテム」および「コレクション」リンクの関係タイプには、RFC5988 [RFC5988]のセクション8で説明されているもの以外の国際化に関する考慮事項はありません。

6. References

6. 参考文献

6.1. Normative References

6.1. 引用文献

[RFC5988] Nottingham, M., "Web Linking", RFC 5988, October 2010.

[RFC5988]ノッティンガム、M。、「Webリンク」、RFC 5988、2010年10月。

6.2. Informative References

6.2. 参考引用

[CollectionJSON] Amundsen, M., "Collection+JSON - Document Format", Web Page , July 2011, <http://www.iana.org/assignments/media-types>.

[CollectionJSON] Amundsen、M。、「Collection + JSON-Document Format」、Webページ、2011年7月、<http://www.iana.org/assignments/media-types>。

[Maze] Amundsen, M., "Maze+XML - Format", Web Page , December 2010, <http://www.iana.org/assignments/media-types>.

[迷路] Amundsen、M。、「Maze + XML-Format」、Webページ、2010年12月、<http://www.iana.org/assignments/media-types>。

[OpenSearch] Clinton, D., "Open Search 1.1", Work in Progress , March 2011, <http://www.opensearch.org/ Specifications/OpenSearch/1.1/>.

[OpenSearch]クリントン、D。、「Open Search 1.1」、Work in Progress、2011年3月、<http://www.opensearch.org/Specifications/OpenSearch/1.1/>。

Appendix A. Acknowledgements

付録A謝辞

The author gratefully acknowledges the contributions of Julian Reschke and Mykyta Yevstifeyev.

著者は、Julian ReschkeとMykyta Yevstifeyevの貢献に感謝します。

Author's Address

著者のアドレス

Mike Amundsen

マイク・アムンセン

   EMail: mca@amundsen.com
   URI:   http://amundsen.com