RFC 7168 - The Hyper Text Coffee Pot Control Protocol for Tea Efflux Appliances (HTCPCP-TEA) 日本語訳

原文URL : https://datatracker.ietf.org/doc/html/rfc7168
タイトル : RFC 7168 - Tea Effluxアプライアンス用のハイパーテキストコーヒーポットコントロールプロトコル（HTCPCP-TEA）
翻訳編集 : 自動生成

[要約] RFC 7168は、ティーエフラックスアプライアンスのためのHyper Text Coffee Pot Control Protocol for Tea Efflux Appliances（HTCPCP-TEA）に関する規格です。この規格の目的は、ティーポットを制御するためのプロトコルを提供することです。

Independent Submission                                          I. Nazar
Request for Comments: 7168                                  1 April 2014
Updates: 2324
Category: Informational
ISSN: 2070-1721

The Hyper Text Coffee Pot Control Protocol for Tea Efflux Appliances (HTCPCP-TEA)

Tea Effluxアプライアンス用のハイパーテキストコーヒーポットコントロールプロトコル（HTCPCP-TEA）

Abstract

概要

The Hyper Text Coffee Pot Control Protocol (HTCPCP) specification does not allow for the brewing of tea, in all its variety and complexity. This paper outlines an extension to HTCPCP to allow for pots to provide networked tea-brewing facilities.

ハイパーテキストコーヒーポットコントロールプロトコル（HTCPCP）仕様では、その多様性と複雑さの点で、お茶の醸造は許可されていません。このペーパーでは、ポットがネットワーク化されたお茶醸造施設を提供できるようにするためのHTCPCPの拡張について概説します。

Status of This Memo

本文書の状態

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

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

This is a contribution to the RFC Series, independently of any other RFC stream. The RFC Editor has chosen to publish this document at its discretion and makes no statement about its value for implementation or deployment. Documents approved for publication by the RFC Editor are not a candidate for any level of Internet Standard; see Section 2 of RFC 5741.

これは、他のRFCストリームとは無関係に、RFCシリーズへの貢献です。 RFCエディターは、このドキュメントを独自の裁量で公開することを選択し、実装または展開に対するその価値については何も述べていません。 RFC Editorによって公開が承認されたドキュメントは、どのレベルのインターネット標準の候補にもなりません。 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/rfc7168.

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

著作権表示

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.

この文書は、BCP 78およびこの文書の発行日に有効なIETF文書に関するIETFトラストの法的規定（http://trustee.ietf.org/license-info）の対象となります。これらのドキュメントは、このドキュメントに関するあなたの権利と制限を説明しているため、注意深く確認してください。

Table of Contents

   1. Introduction  . . . . . . . . . . . . . . . . . . . . . . . . .  2
     1.1. Terminology . . . . . . . . . . . . . . . . . . . . . . . .  3
   2. HTCPCP-TEA Protocol Additions . . . . . . . . . . . . . . . . .  3
     2.1. BREW and POST Methods . . . . . . . . . . . . . . . . . . .  3
       2.1.1. The "/" URI . . . . . . . . . . . . . . . . . . . . . .  3
       2.1.2. Variety-Specific URIs . . . . . . . . . . . . . . . . .  4
     2.2. Modified Header Fields  . . . . . . . . . . . . . . . . . .  4
       2.2.1. The Accept-Additions Header Field . . . . . . . . . . .  4
     2.3. Response Codes  . . . . . . . . . . . . . . . . . . . . . .  5
       2.3.1. 300 Multiple Options  . . . . . . . . . . . . . . . . .  5
       2.3.2. 403 Forbidden . . . . . . . . . . . . . . . . . . . . .  5
       2.3.3. 418 I'm a Teapot  . . . . . . . . . . . . . . . . . . .  5
   3. The "message/teapot" Media Type . . . . . . . . . . . . . . . .  6
   4. Environmental Considerations  . . . . . . . . . . . . . . . . .  6
   5. Security Considerations . . . . . . . . . . . . . . . . . . . .  6
   6. Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . .  7
   7. References  . . . . . . . . . . . . . . . . . . . . . . . . . .  7
     7.1. Normative References  . . . . . . . . . . . . . . . . . . .  7
     7.2. Informative References  . . . . . . . . . . . . . . . . . .  7

1. Introduction

1. はじめに

As noted in the Hyper Text Coffee Pot Control Protocol [HTCPCP], coffee is renowned worldwide as an artfully brewed caffeinated beverage, but coffee shares this quality with many other varied preparations based on the filtration of plant material. Foremost, among these are the category of brews based on the straining of water through prepared leaves from a tea tree: the lineage and history of the tea genus will not be recounted as part of this paper, but evidence shows that the production of tea existed many thousands of years ago.

ハイパーテキストコーヒーポットコントロールプロトコル[HTCPCP]で述べられているように、コーヒーは巧みに醸造されたカフェイン入り飲料として世界中で知られていますが、コーヒーは植物材料のろ過に基づく他の多くのさまざまな準備と同じ品質を持っています。第一に、これらの中には、ティーツリーから準備された葉を通る水のひずみに基づく醸造のカテゴリーがあります。茶属の系統と歴史は、この論文の一部として再計算されませんが、茶の生産が存在したことを証明しています数千年前。

The deficiency of HTCPCP in addressing the networked production of such a venerable beverage as tea is noteworthy: indeed, the only provision given for networked teapots is that they not respond to requests for the production of coffee, which, while eminently reasonable, does not allow for communication with the teapot for its intended purpose.

お茶のような由緒ある飲料のネットワーク化された生産に取り組む際のHTCPCPの欠陥は注目に値します：実際、ネットワーク化されたティーポットに与えられた唯一の規定は、コーヒーの生産の要求に応答しないことです。意図した目的でティーポットと通信するため。

This paper specifies an extension to HTCPCP to allow communication with networked tea production devices and teapots. The additions to the protocol specified herein permit the requests and responses necessary to control all devices capable of making, arguably, the most popular caffeinated hot beverage.

このホワイトペーパーでは、ネットワーク化されたお茶の製造装置やティーポットとの通信を可能にするHTCPCPの拡張について説明します。ここで指定されたプロトコルへの追加により、間違いなく最も人気のあるカフェイン入りホット飲料を作ることができるすべてのデバイスを制御するために必要な要求と応答が可能になります。

1.1. Terminology

1.1. 用語

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 [KEYWORDS].

このドキュメントのキーワード「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「MAY」、および「OPTIONAL」は、 RFC 2119 [KEYWORDS]で説明されているように解釈されます。

2. HTCPCP-TEA Protocol Additions

2. HTCPCP-TEAプロトコルの追加

The TEA extension to HTCPCP adapts the operation of certain HTCPCP methods.

HTCPCPのTEA拡張機能は、特定のHTCPCPメソッドの操作を適合させます。

2.1. BREW and POST Methods

2.1. BREWおよびPOSTメソッド

Control of a TEA-capable pot is performed, as described in the base HTCPCP specification, through the sending of BREW requests. POST requests are treated equivalently, but they remain deprecated. Tea production differs from coffee, however, in that a choice of teas is often provided for client selection before the tea is brewed. To this end, a TEA-capable pot that receives a BREW message of content type "message/teapot" MUST respond in accordance with the URI requested, as below.

TEA対応ポットの制御は、基本のHTCPCP仕様で説明されているように、BREW要求の送信を通じて実行されます。 POSTリクエストは同等に扱われますが、非推奨のままです。お茶の生産はコーヒーとは異なりますが、お茶を淹れる前に、クライアントの選択のためにお茶の選択肢が提供されることがよくあります。この目的のために、コンテンツタイプ「メッセージ/ティーポット」のBREWメッセージを受信するTEA対応ポットは、以下のように、要求されたURIに従って応答する必要があります。

2.1.1. The "/" URI

2.1.1. 「/」URI

For the URI "/", brewing will not commence. Instead, an Alternates header as defined in RFC 2295 [RFC2295] MUST be sent, with the available tea bags and/or leaf varieties as entries. An example of such a response is as follows:

URI "/"の場合、抽出は開始されません。代わりに、RFC 2295 [RFC2295]で定義されているAlternatesヘッダーを、利用可能なティーバッグや葉の種類をエントリとして送信する必要があります。このような応答の例は次のとおりです。

      Alternates: {"/darjeeling" {type message/teapot}},
                  {"/earl-grey" {type message/teapot}},
                  {"/peppermint" {type message/teapot}}

The following example demonstrates the possibility of interoperability of a TEA-capable pot that also complies with the base HTCPCP specification:

次の例は、基本のHTCPCP仕様にも準拠するTEA対応ポットの相互運用の可能性を示しています。

      Alternates: {"/" {type message/coffeepot}},
                  {"/pot-0/darjeeling" {type message/teapot}},
                  {"/pot-0/earl-grey" {type message/teapot}},
                  {"/pot-1/peppermint" {type message/teapot}}

TEA-capable HTCPCP clients MUST check the contents of the Alternates header returned by a BREW request, and provide a specific URI for subsequent requests of the "message/teapot" type.

TEA対応HTCPCPクライアントは、BREW要求によって返されたAlternatesヘッダーの内容を確認し、「メッセージ/ティーポット」タイプの後続の要求に特定のURIを提供する必要があります。

A request to the "/" URI with a Content-Type header of "message/coffeepot" SHOULD also be responded to with an Alternates header in the above format, to allow TEA-capable clients the opportunity to present the selection of teas to the user if inferior caffeinated beverages have initially been requested.

Content-Typeヘッダーが「message / coffeepot」である「/」URIへのリクエストも、上記の形式のAlternatesヘッダーで応答する必要があります。これにより、TEA対応クライアントがお茶の選択を提示できるようになります。劣ったカフェイン入り飲料が最初に要求された場合のユーザー。

2.1.2. Variety-Specific URIs

2.1.2. 品種固有のURI

TEA-capable pots follow the base HTCPCP specification when presented with a BREW request for a specific variety of tea. Pots SHOULD follow the recommendations for brewing strength given by each variety, and stop brewing when this strength is reached; it is suggested that the strength be measured by detection of the opacity of the beverage currently under brew by the pot.

TEA対応のポットは、特定の種類のお茶に対するBREW要求が提示されると、基本的なHTCPCP仕様に従います。ポットは、各品種の醸造強度の推奨事項に従い、この強度に達したら醸造を停止する必要があります。ポットで抽出中の飲料の不透明度を検出することにより、強度を測定することをお勧めします。

TEA-capable clients SHOULD indicate the end of brewing by sending a BREW request with an entity body containing "stop"; the pot MAY continue brewing beyond the recommended strength until this is received. If the "stop" request is not sent by the client, this may result in a state inversion in the proportion of tea to water in the brewing pot, which may be reported by some pots as a negative strength.

TEA対応クライアントは、エンティティ本体に「stop」を含むBREWリクエストを送信して、醸造の終了を示す必要があります（SHOULD）。ポットは、これが受け取られるまで、推奨される強度を超えて醸造を続けることができます。「停止」リクエストがクライアントによって送信されない場合、醸造ポットのお茶と水の比率の状態が反転する可能性があり、一部のポットでは負の強度として報告される場合があります。

If a BREW command with an entity body containing "stop" is received before the recommended strength is achieved, the pot MUST abort brewing and serve the resultant beverage at lesser strength. Finding the preferred strength of beverage when using this override is a function of the time between the TEA-capable pot receiving a "start" request and the subsequent "stop". Clients SHOULD be prepared to make multiple attempts to reach the preferred strength.

エンティティのボディに「stop」を含むBREWコマンドが、推奨される強度に達する前に受信された場合、ポットは醸造を中止し、結果として得られる飲料を低い強度で提供する必要があります。このオーバーライドを使用するときに飲料の好ましい強さを見つけることは、TEA対応ポットが「開始」要求を受け取ってから次の「停止」を受け取るまでの時間の関数です。クライアントは、望ましい強度に到達するために複数の試行を行う準備ができている必要があります。

2.2. Modified Header Fields

2.2. 変更されたヘッダーフィールド

HTCPCP-TEA modifies the definition of one header field from the base HTCPCP specification.

HTCPCP-TEAは、基本HTCPCP仕様の1つのヘッダーフィールドの定義を変更します。

2.2.1. The Accept-Additions Header Field

2.2.1. Accept-Additionsヘッダーフィールド

It has been observed that some users of blended teas have an occasional preference for teas brewed as an emulsion of cane sugar with hints of water. To allow for this circumstance, the Accept-Additions header field defined in the base HTCPCP specification is updated to allow the following options:

ブレンドティーの一部のユーザーは、少量の水分を含むサトウキビの乳濁液として醸造されるティーを時折好みます。この状況に対応するために、基本HTCPCP仕様で定義されているAccept-Additionsヘッダーフィールドが更新され、次のオプションが許可されます。

      addition-type   = ( "*"
                        | milk-type
                        | syrup-type
                        | sweetener-type
                        | spice-type
                        | alcohol-type
                        | sugar-type
                        ) *( ";" parameter )
      sugar-type      = ( "Sugar" | "Xylitol" | "Stevia" )

Implementers should be aware that excessive use of the Sugar addition may cause the BREW request to exceed the segment size allowed by the transport layer, causing fragmentation and a delay in brewing.

実装者は、Sugarの追加を過度に使用すると、BREWリクエストがトランスポート層で許可されているセグメントサイズを超え、断片化と醸造の遅延を引き起こす可能性があることに注意する必要があります。

2.3. Response Codes

2.3. 応答コード

HTCPCP-TEA makes use of normal HTTP error codes and those defined in the base HTCPCP specification.

HTCPCP-TEAは、通常のHTTPエラーコードと、基本のHTCPCP仕様で定義されているコードを利用します。

2.3.1. 300 Multiple Options

2.3.1. 300複数のオプション

A BREW request to the "/" URI, as defined in Section 2.1.1, will return an Alternates header indicating the URIs of the available varieties of tea to brew. It is RECOMMENDED that this response be served with a status code of 300, to indicate that brewing has not commenced and further options must be chosen by the client.

セクション2.1.1で定義されている「/」URIへのBREWリクエストは、醸造に利用できるお茶の種類のURIを示すAlternatesヘッダーを返します。醸造が開始されておらず、クライアントがさらにオプションを選択する必要があることを示すために、この応答にステータスコード300を提供することをお勧めします。

2.3.2. 403 Forbidden

2.3.2. 403禁止します

Services that implement the Accept-Additions header field MAY return a 403 status code for a BREW request of a given variety of tea, if the service deems the combination of additions requested to be contrary to the sensibilities of a consensus of drinkers regarding the variety in question.

Accept-Additionsヘッダーフィールドを実装するサービスは、指定された種類のお茶のBREWリクエストに対して403ステータスコードを返します。質問。

A method of garnering and collating consensus indicators of the most viable combinations of additions for each variety to be served is outside the scope of this document.

提供される各種類の追加の最も実行可能な組み合わせのコンセンサス指標を収集して照合する方法は、このドキュメントの範囲外です。

2.3.3. 418 I'm a Teapot

2.3.3. 418私はティーポットです

TEA-capable pots that are not provisioned to brew coffee may return either a status code of 503, indicating temporary unavailability of coffee, or a code of 418 as defined in the base HTCPCP specification to denote a more permanent indication that the pot is a teapot.

コーヒーを淹れるためにプロビジョニングされていないTEA対応のポットは、コーヒーが一時的に利用できないことを示す503のステータスコード、またはベースHTCPCP仕様で定義されている418のいずれかのコードを返し、ポットがティーポットであることをより永続的に示します。。

3. The "message/teapot" Media Type

3. 「メッセージ/ティーポット」メディアタイプ

To distinguish messages destined for TEA-capable HTCPCP services from pots compliant with the base HTCPCP specification, a new MIME media type is defined by this document. The Content-Type header of a POST or BREW request sent to a TEA-capable pot MUST be "message/teapot" if tea is to be requested.

TEA対応HTCPCPサービス宛てのメッセージを、基本HTCPCP仕様に準拠したポットから区別するために、このドキュメントでは新しいMIMEメディアタイプを定義しています。 TEA対応のポットに送信されるPOSTまたはBREWリクエストのContent-Typeヘッダーは、お茶がリクエストされる場合、「メッセージ/ティーポット」でなければなりません。

4. Environmental Considerations

4. 環境への配慮

As noted in Section 2.1, a BREW request with a Content-Type header field of "message/teapot" to a TEA-capable pot will result in an Alternates header being sent with the response, and a pot will not be brewed. However, if the BREW request has a Content-Type of "message/coffeepot", and the pot is capable of brewing coffee, the service's behavior will fall back to the base HTCPCP specification and a pot will be brewed.

セクション2.1で述べたように、TEA対応ポットへの「メッセージ/ティーポット」のContent-Typeヘッダーフィールドを持つBREWリクエストでは、Alternatesヘッダーが応答とともに送信され、ポットは抽出されません。ただし、BREWリクエストのContent-Typeが「message / coffeepot」であり、ポットがコーヒーを淹れることができる場合、サービスの動作はベースHTCPCP仕様にフォールバックし、ポットが淹れられます。

If the entity returned by the server when brewing commences contains a TEA-compliant Alternates header indicating "message/coffeepot" and the client does not want coffee, the client SHOULD then send a BREW request with an entity body containing "stop". This will result in wasted coffee; whether this is regarded as a bad thing is user-defined.

醸造の開始時にサーバーから返されたエンティティに、「message / coffeepot」を示すTEA準拠のAlternatesヘッダーが含まれていて、クライアントがコーヒーを望まない場合、クライアントは「stop」を含むエンティティ本体を含むBREWリクエストを送信する必要があります（SHOULD）。これはコーヒーの無駄になります。これが悪いことと見なされるかどうかはユーザーが定義します。

Such waste can be prevented by TEA-capable clients, by first requesting a BREW of type "message/teapot" and then allowing selection of an available beverage.

このような無駄は、TEA対応クライアントが最初に「メッセージ/ティーポット」タイプのBREWを要求し、次に利用可能な飲料を選択できるようにすることで防止できます。

5. Security Considerations

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

As with the base HTCPCP specification, most TEA-capable pots are expected to heat water through the use of electric elements, and as such will not be in proximity to fire. Therefore, no firewalls are necessary for communication with these pots to proceed.

ベースのHTCPCP仕様と同様に、ほとんどのTEA対応ポットは電気要素を使用して水を加熱することが想定されているため、火の近くにはありません。したがって、これらのポットとの通信を続行するためにファイアウォールは必要ありません。

This extension does support communication with fired pots, however, which may require heat retention and control policies. Care should be taken so that coal-fired pots and electrically heated kettles are not connected to the same network, to prevent pots from referring to any kettles on the network as darkened or otherwise smoke driven.

この拡張機能は、加熱された鍋との通信をサポートしますが、保温および制御ポリシーが必要になる場合があります。ポットがネットワーク上のやかんを暗くしたり、他の方法で煙で駆動されていると見なさないように、石炭火鍋と電気加熱釜が同じネットワークに接続されないように注意する必要があります。

6. Acknowledgements

6. 謝辞

This extension to the HTCPCP specification would not be possible without the base specification, and research on networked beverage production leading up thereto. In that vein, the author wishes to acknowledge the sterling work of Larry Masinter in the development of the leading protocol for coffee pot communication.

HTCPCP仕様へのこの拡張は、基本仕様とそれにつながるネットワーク化された飲料製造に関する研究なしでは不可能です。その意味で、著者はコーヒーポットコミュニケーションの主要なプロトコルの開発におけるLarry Masinterのスターリング作業を認めたいと思います。

Many thanks also to Kevin Waterson and Pete Davis, for providing guidance and suggestions during the drafting of this document.

この文書の起草中にガイダンスと提案を提供してくれたKevin WatersonとPete Davisにも感謝します。

7. References

7. 参考文献

7.1. Normative References

7.1. 引用文献

[KEYWORDS] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997.

[キーワード] Bradner、S。、「要件レベルを示すためにRFCで使用するキーワード」、BCP 14、RFC 2119、1997年3月。

7.2. Informative References

7.2. 参考引用

[HTCPCP] Masinter, L., "Hyper Text Coffee Pot Control Protocol (HTCPCP/1.0)", RFC 2324, April 1 1998.

[HTCPCP] Masinter、L。、「ハイパーテキストコーヒーポットコントロールプロトコル（HTCPCP / 1.0）」、RFC 2324、1998年4月1日。

[RFC2295] Holtman, K. and A. Mutz, "Transparent Content Negotiation in HTTP", RFC 2295, March 1998.

[RFC2295] Holtman、K。およびA. Mutz、「HTTPでの透過的なコンテンツネゴシエーション」、RFC 2295、1998年3月。

Author's Address

著者のアドレス

Imran Nazar deviantART Inc. 7095 Hollywood Blvd Hollywood, CA 90028

Imran Nazar deviantART Inc. 7095 Hollywood Blvd Hollywood、CA 90028

   EMail: inazar@deviantart.com