Changeset 1641 for draft-ietf-httpbis/latest/p3-payload.html
- Timestamp:
- Mar 30, 2012, 7:44:42 AM (8 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
draft-ietf-httpbis/latest/p3-payload.html
r1640 r1641 573 573 <ul class="toc"> 574 574 <li>1. <a href="#introduction">Introduction</a><ul> 575 <li>1.1 <a href="#terminology">Terminology</a></li> 576 <li>1.2 <a href="#intro.conformance.and.error.handling">Conformance and Error Handling</a></li> 577 <li>1.3 <a href="#notation">Syntax Notation</a><ul> 578 <li>1.3.1 <a href="#core.rules">Core Rules</a></li> 579 <li>1.3.2 <a href="#abnf.dependencies">ABNF Rules defined in other Parts of the Specification</a></li> 575 <li>1.1 <a href="#notation">Syntax Notation</a><ul> 576 <li>1.1.1 <a href="#core.rules">Core Rules</a></li> 577 <li>1.1.2 <a href="#abnf.dependencies">ABNF Rules defined in other Parts of the Specification</a></li> 580 578 </ul> 581 579 </li> … … 676 674 <h1 id="rfc.section.1" class="np"><a href="#rfc.section.1">1.</a> <a id="introduction" href="#introduction">Introduction</a></h1> 677 675 <p id="rfc.section.1.p.1">This part is now obsolete. Please see HTTPbis, Part 2.</p> 678 <h2 id="rfc.section.1.1"><a href="#rfc.section.1.1">1.1</a> <a id="terminology" href="#terminology">Terminology</a></h2> 679 <p id="rfc.section.1.1.p.1">This specification uses a number of terms to refer to the roles played by participants in, and objects of, the HTTP communication.</p> 680 <p id="rfc.section.1.1.p.2"> <span id="rfc.iref.c.1"></span> <dfn>content negotiation</dfn> 681 </p> 682 <ul class="empty"> 683 <li>The mechanism for selecting the appropriate representation when servicing a request. The representation in any response can 684 be negotiated (including error responses). 685 </li> 686 </ul> 687 <p id="rfc.section.1.1.p.3"> <span id="rfc.iref.s.1"></span> <dfn>selected representation</dfn> 688 </p> 689 <ul class="empty"> 690 <li>The current representation of the target resource that would have been selected in a successful response if the same request 691 had used the method GET and excluded any conditional request header fields. 692 </li> 693 </ul> 694 <h2 id="rfc.section.1.2"><a href="#rfc.section.1.2">1.2</a> <a id="intro.conformance.and.error.handling" href="#intro.conformance.and.error.handling">Conformance and Error Handling</a></h2> 695 <p id="rfc.section.1.2.p.1">The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" 696 in this document are to be interpreted as described in <a href="#RFC2119" id="rfc.xref.RFC2119.1"><cite title="Key words for use in RFCs to Indicate Requirement Levels">[RFC2119]</cite></a>. 697 </p> 698 <p id="rfc.section.1.2.p.2">This document defines conformance criteria for several roles in HTTP communication, including Senders, Recipients, Clients, 699 Servers, User-Agents, Origin Servers, Intermediaries, Proxies and Gateways. See <a href="p1-messaging.html#architecture" title="Architecture">Section 2</a> of <a href="#Part1" id="rfc.xref.Part1.1"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a> for definitions of these terms. 700 </p> 701 <p id="rfc.section.1.2.p.3">An implementation is considered conformant if it complies with all of the requirements associated with its role(s). Note that 702 SHOULD-level requirements are relevant here, unless one of the documented exceptions is applicable. 703 </p> 704 <p id="rfc.section.1.2.p.4">This document also uses ABNF to define valid protocol elements (<a href="#notation" title="Syntax Notation">Section 1.3</a>). In addition to the prose requirements placed upon them, Senders <em class="bcp14">MUST NOT</em> generate protocol elements that are invalid. 705 </p> 706 <p id="rfc.section.1.2.p.5">Unless noted otherwise, Recipients <em class="bcp14">MAY</em> take steps to recover a usable protocol element from an invalid construct. However, HTTP does not define specific error handling 707 mechanisms, except in cases where it has direct impact on security. This is because different uses of the protocol require 708 different error handling strategies; for example, a Web browser may wish to transparently recover from a response where the 709 Location header field doesn't parse according to the ABNF, whereby in a systems control protocol using HTTP, this type of 710 error recovery could lead to dangerous consequences. 711 </p> 712 <h2 id="rfc.section.1.3"><a href="#rfc.section.1.3">1.3</a> <a id="notation" href="#notation">Syntax Notation</a></h2> 713 <p id="rfc.section.1.3.p.1">This specification uses the Augmented Backus-Naur Form (ABNF) notation of <a href="#RFC5234" id="rfc.xref.RFC5234.1"><cite title="Augmented BNF for Syntax Specifications: ABNF">[RFC5234]</cite></a> with the list rule extension defined in <a href="p1-messaging.html#notation" title="Syntax Notation">Section 1.2</a> of <a href="#Part1" id="rfc.xref.Part1.2"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>. 714 </p> 715 <p id="rfc.section.1.3.p.2">The following core rules are included by reference, as defined in <a href="#RFC5234" id="rfc.xref.RFC5234.2"><cite title="Augmented BNF for Syntax Specifications: ABNF">[RFC5234]</cite></a>, <a href="http://tools.ietf.org/html/rfc5234#appendix-B.1">Appendix B.1</a>: ALPHA (letters), CR (carriage return), CRLF (CR LF), CTL (controls), DIGIT (decimal 0-9), DQUOTE (double quote), HEXDIG 676 <h2 id="rfc.section.1.1"><a href="#rfc.section.1.1">1.1</a> <a id="notation" href="#notation">Syntax Notation</a></h2> 677 <p id="rfc.section.1.1.p.1">This specification uses the Augmented Backus-Naur Form (ABNF) notation of <a href="#RFC5234" id="rfc.xref.RFC5234.1"><cite title="Augmented BNF for Syntax Specifications: ABNF">[RFC5234]</cite></a> with the list rule extension defined in <a href="p1-messaging.html#notation" title="Syntax Notation">Section 1.2</a> of <a href="#Part1" id="rfc.xref.Part1.1"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>. 678 </p> 679 <p id="rfc.section.1.1.p.2">The following core rules are included by reference, as defined in <a href="#RFC5234" id="rfc.xref.RFC5234.2"><cite title="Augmented BNF for Syntax Specifications: ABNF">[RFC5234]</cite></a>, <a href="http://tools.ietf.org/html/rfc5234#appendix-B.1">Appendix B.1</a>: ALPHA (letters), CR (carriage return), CRLF (CR LF), CTL (controls), DIGIT (decimal 0-9), DQUOTE (double quote), HEXDIG 716 680 (hexadecimal 0-9/A-F/a-f), LF (line feed), OCTET (any 8-bit sequence of data), SP (space), and VCHAR (any visible US-ASCII 717 681 character). 718 682 </p> 719 <h3 id="rfc.section.1. 3.1"><a href="#rfc.section.1.3.1">1.3.1</a> <a id="core.rules" href="#core.rules">Core Rules</a></h3>720 <p id="rfc.section.1. 3.1.p.1">The core rules below are defined in <a href="#Part1" id="rfc.xref.Part1.3"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>:721 </p> 722 <div id="rfc.figure.u.1"></div><pre class="inline"> <a href="#core.rules" class="smpl">OWS</a> = <OWS, defined in <a href="#Part1" id="rfc.xref.Part1. 4"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#whitespace" title="Whitespace">Section 3.2.1</a>>723 <a href="#core.rules" class="smpl">token</a> = <token, defined in <a href="#Part1" id="rfc.xref.Part1. 5"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#field.components" title="Field value components">Section 3.2.4</a>>724 <a href="#core.rules" class="smpl">word</a> = <word, defined in <a href="#Part1" id="rfc.xref.Part1. 6"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#field.components" title="Field value components">Section 3.2.4</a>>725 </pre><h3 id="rfc.section.1. 3.2"><a href="#rfc.section.1.3.2">1.3.2</a> <a id="abnf.dependencies" href="#abnf.dependencies">ABNF Rules defined in other Parts of the Specification</a></h3>726 <p id="rfc.section.1. 3.2.p.1">The ABNF rules below are defined in other parts:</p>727 <div id="rfc.figure.u.2"></div><pre class="inline"> <a href="#abnf.dependencies" class="smpl">absolute-URI</a> = <absolute-URI, defined in <a href="#Part1" id="rfc.xref.Part1. 7"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#uri" title="Uniform Resource Identifiers">Section 2.7</a>>728 <a href="#abnf.dependencies" class="smpl">partial-URI</a> = <partial-URI, defined in <a href="#Part1" id="rfc.xref.Part1. 8"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#uri" title="Uniform Resource Identifiers">Section 2.7</a>>729 <a href="#abnf.dependencies" class="smpl">qvalue</a> = <qvalue, defined in <a href="#Part1" id="rfc.xref.Part1. 9"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#quality.values" title="Quality Values">Section 4.3.1</a>>683 <h3 id="rfc.section.1.1.1"><a href="#rfc.section.1.1.1">1.1.1</a> <a id="core.rules" href="#core.rules">Core Rules</a></h3> 684 <p id="rfc.section.1.1.1.p.1">The core rules below are defined in <a href="#Part1" id="rfc.xref.Part1.2"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>: 685 </p> 686 <div id="rfc.figure.u.1"></div><pre class="inline"> <a href="#core.rules" class="smpl">OWS</a> = <OWS, defined in <a href="#Part1" id="rfc.xref.Part1.3"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#whitespace" title="Whitespace">Section 3.2.1</a>> 687 <a href="#core.rules" class="smpl">token</a> = <token, defined in <a href="#Part1" id="rfc.xref.Part1.4"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#field.components" title="Field value components">Section 3.2.4</a>> 688 <a href="#core.rules" class="smpl">word</a> = <word, defined in <a href="#Part1" id="rfc.xref.Part1.5"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#field.components" title="Field value components">Section 3.2.4</a>> 689 </pre><h3 id="rfc.section.1.1.2"><a href="#rfc.section.1.1.2">1.1.2</a> <a id="abnf.dependencies" href="#abnf.dependencies">ABNF Rules defined in other Parts of the Specification</a></h3> 690 <p id="rfc.section.1.1.2.p.1">The ABNF rules below are defined in other parts:</p> 691 <div id="rfc.figure.u.2"></div><pre class="inline"> <a href="#abnf.dependencies" class="smpl">absolute-URI</a> = <absolute-URI, defined in <a href="#Part1" id="rfc.xref.Part1.6"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#uri" title="Uniform Resource Identifiers">Section 2.7</a>> 692 <a href="#abnf.dependencies" class="smpl">partial-URI</a> = <partial-URI, defined in <a href="#Part1" id="rfc.xref.Part1.7"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#uri" title="Uniform Resource Identifiers">Section 2.7</a>> 693 <a href="#abnf.dependencies" class="smpl">qvalue</a> = <qvalue, defined in <a href="#Part1" id="rfc.xref.Part1.8"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#quality.values" title="Quality Values">Section 4.3.1</a>> 730 694 </pre><h1 id="rfc.section.2"><a href="#rfc.section.2">2.</a> <a id="protocol.parameters" href="#protocol.parameters">Protocol Parameters</a></h1> 731 695 <h2 id="rfc.section.2.1"><a href="#rfc.section.2.1">2.1</a> <a id="character.sets" href="#character.sets">Character Encodings (charset)</a></h2> … … 756 720 mechanism will be required to remove the encoding. 757 721 </p> 758 <p id="rfc.section.2.2.p.4">compress<span id="rfc.iref.c. 2"></span><span id="rfc.iref.c.3"></span>722 <p id="rfc.section.2.2.p.4">compress<span id="rfc.iref.c.1"></span><span id="rfc.iref.c.2"></span> 759 723 </p> 760 724 <ul class="empty"> 761 <li>See <a href="p1-messaging.html#compress.coding" title="Compress Coding">Section 4.2.1</a> of <a href="#Part1" id="rfc.xref.Part1. 10"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>.762 </li> 763 </ul> 764 <p id="rfc.section.2.2.p.5">deflate<span id="rfc.iref.d.1"></span><span id="rfc.iref.c. 4"></span>725 <li>See <a href="p1-messaging.html#compress.coding" title="Compress Coding">Section 4.2.1</a> of <a href="#Part1" id="rfc.xref.Part1.9"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>. 726 </li> 727 </ul> 728 <p id="rfc.section.2.2.p.5">deflate<span id="rfc.iref.d.1"></span><span id="rfc.iref.c.3"></span> 765 729 </p> 766 730 <ul class="empty"> 767 <li>See <a href="p1-messaging.html#deflate.coding" title="Deflate Coding">Section 4.2.2</a> of <a href="#Part1" id="rfc.xref.Part1.1 1"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>.768 </li> 769 </ul> 770 <p id="rfc.section.2.2.p.6">gzip<span id="rfc.iref.g.3"></span><span id="rfc.iref.c. 5"></span>731 <li>See <a href="p1-messaging.html#deflate.coding" title="Deflate Coding">Section 4.2.2</a> of <a href="#Part1" id="rfc.xref.Part1.10"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>. 732 </li> 733 </ul> 734 <p id="rfc.section.2.2.p.6">gzip<span id="rfc.iref.g.3"></span><span id="rfc.iref.c.4"></span> 771 735 </p> 772 736 <ul class="empty"> 773 <li>See <a href="p1-messaging.html#gzip.coding" title="Gzip Coding">Section 4.2.3</a> of <a href="#Part1" id="rfc.xref.Part1.1 2"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>.737 <li>See <a href="p1-messaging.html#gzip.coding" title="Gzip Coding">Section 4.2.3</a> of <a href="#Part1" id="rfc.xref.Part1.11"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>. 774 738 </li> 775 739 </ul> … … 783 747 <li>Pointer to specification text</li> 784 748 </ul> 785 <p id="rfc.section.2.2.1.p.3">Names of content codings <em class="bcp14">MUST NOT</em> overlap with names of transfer codings (<a href="p1-messaging.html#transfer.codings" title="Transfer Codings">Section 4</a> of <a href="#Part1" id="rfc.xref.Part1.1 3"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>), unless the encoding transformation is identical (as is the case for the compression codings defined in <a href="p1-messaging.html#compression.codings" title="Compression Codings">Section 4.2</a> of <a href="#Part1" id="rfc.xref.Part1.14"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>).749 <p id="rfc.section.2.2.1.p.3">Names of content codings <em class="bcp14">MUST NOT</em> overlap with names of transfer codings (<a href="p1-messaging.html#transfer.codings" title="Transfer Codings">Section 4</a> of <a href="#Part1" id="rfc.xref.Part1.12"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>), unless the encoding transformation is identical (as is the case for the compression codings defined in <a href="p1-messaging.html#compression.codings" title="Compression Codings">Section 4.2</a> of <a href="#Part1" id="rfc.xref.Part1.13"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>). 786 750 </p> 787 751 <p id="rfc.section.2.2.1.p.4">Values to be added to this name space require IETF Review (see <a href="http://tools.ietf.org/html/rfc5226#section-4.1">Section 4.1</a> of <a href="#RFC5226" id="rfc.xref.RFC5226.1"><cite title="Guidelines for Writing an IANA Considerations Section in RFCs">[RFC5226]</cite></a>), and <em class="bcp14">MUST</em> conform to the purpose of content coding defined in this section. … … 883 847 <tr> 884 848 <td class="left">Content-Length</td> 885 <td class="left"><a href="p1-messaging.html#header.content-length" title="Content-Length">Section 3.3.2</a> of <a href="#Part1" id="rfc.xref.Part1.1 5"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a></td>849 <td class="left"><a href="p1-messaging.html#header.content-length" title="Content-Length">Section 3.3.2</a> of <a href="#Part1" id="rfc.xref.Part1.14"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a></td> 886 850 </tr> 887 851 <tr> … … 893 857 </div> 894 858 <h2 id="rfc.section.3.2"><a href="#rfc.section.3.2">3.2</a> <a id="payload.body" href="#payload.body">Payload Body</a></h2> 895 <p id="rfc.section.3.2.p.1">A payload body is only present in a message when a message body is present, as described in <a href="p1-messaging.html#message.body" title="Message Body">Section 3.3</a> of <a href="#Part1" id="rfc.xref.Part1.1 6"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>. The payload body is obtained from the message body by decoding any Transfer-Encoding that might have been applied to ensure859 <p id="rfc.section.3.2.p.1">A payload body is only present in a message when a message body is present, as described in <a href="p1-messaging.html#message.body" title="Message Body">Section 3.3</a> of <a href="#Part1" id="rfc.xref.Part1.15"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>. The payload body is obtained from the message body by decoding any Transfer-Encoding that might have been applied to ensure 896 860 safe and proper transfer of the message. 897 861 </p> … … 1049 1013 that doesn't conform to them is better than sending a 406 (Not Acceptable) response. 1050 1014 </p> 1051 <p id="rfc.section.5.1.p.5">Many of the mechanisms for expressing preferences use quality values to declare relative preference. See <a href="p1-messaging.html#quality.values" title="Quality Values">Section 4.3.1</a> of <a href="#Part1" id="rfc.xref.Part1.1 7"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a> for more information.1015 <p id="rfc.section.5.1.p.5">Many of the mechanisms for expressing preferences use quality values to declare relative preference. See <a href="p1-messaging.html#quality.values" title="Quality Values">Section 4.3.1</a> of <a href="#Part1" id="rfc.xref.Part1.16"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a> for more information. 1052 1016 </p> 1053 1017 <p id="rfc.section.5.1.p.6">HTTP/1.1 includes the following header fields for enabling server-driven negotiation through description of user agent capabilities … … 1102 1066 <p id="rfc.section.6.1.p.4">Each media-range <em class="bcp14">MAY</em> be followed by one or more accept-params, beginning with the "q" parameter for indicating a relative quality factor. The first 1103 1067 "q" parameter (if any) separates the media-range parameter(s) from the accept-params. Quality factors allow the user or user 1104 agent to indicate the relative degree of preference for that media-range, using the qvalue scale from 0 to 1 (<a href="p1-messaging.html#quality.values" title="Quality Values">Section 4.3.1</a> of <a href="#Part1" id="rfc.xref.Part1.1 8"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>). The default value is q=1.1068 agent to indicate the relative degree of preference for that media-range, using the qvalue scale from 0 to 1 (<a href="p1-messaging.html#quality.values" title="Quality Values">Section 4.3.1</a> of <a href="#Part1" id="rfc.xref.Part1.17"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>). The default value is q=1. 1105 1069 </p> 1106 1070 <div class="note" id="rfc.section.6.1.p.5"> … … 1232 1196 </li> 1233 1197 <li>If the representation's content-coding is one of the content-codings listed in the Accept-Encoding field, then it is acceptable 1234 unless it is accompanied by a qvalue of 0. (As defined in <a href="p1-messaging.html#quality.values" title="Quality Values">Section 4.3.1</a> of <a href="#Part1" id="rfc.xref.Part1.1 9"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, a qvalue of 0 means "not acceptable".)1198 unless it is accompanied by a qvalue of 0. (As defined in <a href="p1-messaging.html#quality.values" title="Quality Values">Section 4.3.1</a> of <a href="#Part1" id="rfc.xref.Part1.18"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, a qvalue of 0 means "not acceptable".) 1235 1199 </li> 1236 1200 <li>If multiple content-codings are acceptable, then the acceptable content-coding with the highest non-zero qvalue is preferred.</li> … … 1283 1247 </p> 1284 1248 </div> 1285 <div id="rfc.iref.c. 6"></div>1249 <div id="rfc.iref.c.5"></div> 1286 1250 <div id="rfc.iref.h.5"></div> 1287 1251 <h2 id="rfc.section.6.5"><a href="#rfc.section.6.5">6.5</a> <a id="header.content-encoding" href="#header.content-encoding">Content-Encoding</a></h2> … … 1312 1276 <p id="rfc.section.6.5.p.9">If the content-coding of a representation in a request message is not acceptable to the origin server, the server <em class="bcp14">SHOULD</em> respond with a status code of 415 (Unsupported Media Type). 1313 1277 </p> 1314 <div id="rfc.iref.c. 7"></div>1278 <div id="rfc.iref.c.6"></div> 1315 1279 <div id="rfc.iref.h.6"></div> 1316 1280 <h2 id="rfc.section.6.6"><a href="#rfc.section.6.6">6.6</a> <a id="header.content-language" href="#header.content-language">Content-Language</a></h2> … … 1338 1302 <p id="rfc.section.6.6.p.9">Content-Language <em class="bcp14">MAY</em> be applied to any media type — it is not limited to textual documents. 1339 1303 </p> 1340 <div id="rfc.iref.c. 8"></div>1304 <div id="rfc.iref.c.7"></div> 1341 1305 <div id="rfc.iref.h.7"></div> 1342 1306 <h2 id="rfc.section.6.7"><a href="#rfc.section.6.7">6.7</a> <a id="header.content-location" href="#header.content-location">Content-Location</a></h2> … … 1346 1310 </p> 1347 1311 <div id="rfc.figure.u.26"></div><pre class="inline"><span id="rfc.iref.g.22"></span> <a href="#header.content-location" class="smpl">Content-Location</a> = <a href="#abnf.dependencies" class="smpl">absolute-URI</a> / <a href="#abnf.dependencies" class="smpl">partial-URI</a> 1348 </pre><p id="rfc.section.6.7.p.3">The Content-Location value is not a replacement for the effective Request URI (<a href="p1-messaging.html#effective.request.uri" title="Effective Request URI">Section 5.5</a> of <a href="#Part1" id="rfc.xref.Part1. 20"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>). It is representation metadata. It has the same syntax and semantics as the header field of the same name defined for MIME1312 </pre><p id="rfc.section.6.7.p.3">The Content-Location value is not a replacement for the effective Request URI (<a href="p1-messaging.html#effective.request.uri" title="Effective Request URI">Section 5.5</a> of <a href="#Part1" id="rfc.xref.Part1.19"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>). It is representation metadata. It has the same syntax and semantics as the header field of the same name defined for MIME 1349 1313 body parts in <a href="http://tools.ietf.org/html/rfc2557#section-4">Section 4</a> of <a href="#RFC2557" id="rfc.xref.RFC2557.1"><cite title="MIME Encapsulation of Aggregate Documents, such as HTML (MHTML)">[RFC2557]</cite></a>. However, its appearance in an HTTP message has some special implications for HTTP recipients. 1350 1314 </p> … … 1380 1344 </p> 1381 1345 <p id="rfc.section.6.7.p.9">If the Content-Location value is a partial URI, the partial URI is interpreted relative to the effective request URI.</p> 1382 <div id="rfc.iref.c. 9"></div>1346 <div id="rfc.iref.c.8"></div> 1383 1347 <div id="rfc.iref.h.8"></div> 1384 1348 <h2 id="rfc.section.6.8"><a href="#rfc.section.6.8">6.8</a> <a id="header.content-type" href="#header.content-type">Content-Type</a></h2> … … 1412 1376 <td class="left">compress</td> 1413 1377 <td class="left">UNIX "compress" program method</td> 1414 <td class="left"> <a href="p1-messaging.html#compress.coding" title="Compress Coding">Section 4.2.1</a> of <a href="#Part1" id="rfc.xref.Part1.2 1"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>1378 <td class="left"> <a href="p1-messaging.html#compress.coding" title="Compress Coding">Section 4.2.1</a> of <a href="#Part1" id="rfc.xref.Part1.20"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a> 1415 1379 </td> 1416 1380 </tr> … … 1419 1383 <td class="left">"deflate" compression mechanism (<a href="#RFC1951" id="rfc.xref.RFC1951.1"><cite title="DEFLATE Compressed Data Format Specification version 1.3">[RFC1951]</cite></a>) used inside the "zlib" data format (<a href="#RFC1950" id="rfc.xref.RFC1950.1"><cite title="ZLIB Compressed Data Format Specification version 3.3">[RFC1950]</cite></a>) 1420 1384 </td> 1421 <td class="left"> <a href="p1-messaging.html#deflate.coding" title="Deflate Coding">Section 4.2.2</a> of <a href="#Part1" id="rfc.xref.Part1.2 2"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>1385 <td class="left"> <a href="p1-messaging.html#deflate.coding" title="Deflate Coding">Section 4.2.2</a> of <a href="#Part1" id="rfc.xref.Part1.21"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a> 1422 1386 </td> 1423 1387 </tr> … … 1425 1389 <td class="left">gzip</td> 1426 1390 <td class="left">Same as GNU zip <a href="#RFC1952" id="rfc.xref.RFC1952.1"><cite title="GZIP file format specification version 4.3">[RFC1952]</cite></a></td> 1427 <td class="left"> <a href="p1-messaging.html#gzip.coding" title="Gzip Coding">Section 4.2.3</a> of <a href="#Part1" id="rfc.xref.Part1.2 3"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>1391 <td class="left"> <a href="p1-messaging.html#gzip.coding" title="Gzip Coding">Section 4.2.3</a> of <a href="#Part1" id="rfc.xref.Part1.22"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a> 1428 1392 </td> 1429 1393 </tr> … … 1465 1429 <h2 id="rfc.references.1"><a href="#rfc.section.9.1" id="rfc.section.9.1">9.1</a> Normative References 1466 1430 </h2> 1467 <table> 1431 <table> 1468 1432 <tr> 1469 1433 <td class="reference"><b id="Part1">[Part1]</b></td> … … 1514 1478 <td class="reference"><b id="RFC2046">[RFC2046]</b></td> 1515 1479 <td class="top"><a href="mailto:ned@innosoft.com" title="Innosoft International, Inc.">Freed, N.</a> and <a href="mailto:nsb@nsb.fv.com" title="First Virtual Holdings">N. Borenstein</a>, “<a href="http://tools.ietf.org/html/rfc2046">Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types</a>”, RFC 2046, November 1996. 1516 </td>1517 </tr>1518 <tr>1519 <td class="reference"><b id="RFC2119">[RFC2119]</b></td>1520 <td class="top"><a href="mailto:sob@harvard.edu" title="Harvard University">Bradner, S.</a>, “<a href="http://tools.ietf.org/html/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a>”, BCP 14, RFC 2119, March 1997.1521 1480 </td> 1522 1481 </tr> … … 1670 1629 to perform a function equivalent to Content-Encoding. However, this parameter is not part of the MIME standards). 1671 1630 </p> 1672 <div id="rfc.iref.c. 10"></div>1631 <div id="rfc.iref.c.9"></div> 1673 1632 <div id="rfc.iref.h.10"></div> 1674 1633 <h2 id="rfc.section.A.5"><a href="#rfc.section.A.5">A.5</a> <a id="no.content-transfer-encoding" href="#no.content-transfer-encoding">No Content-Transfer-Encoding</a></h2> … … 1681 1640 </p> 1682 1641 <h2 id="rfc.section.A.6"><a href="#rfc.section.A.6">A.6</a> <a id="introduction.of.transfer-encoding" href="#introduction.of.transfer-encoding">Introduction of Transfer-Encoding</a></h2> 1683 <p id="rfc.section.A.6.p.1">HTTP/1.1 introduces the Transfer-Encoding header field (<a href="p1-messaging.html#header.transfer-encoding" title="Transfer-Encoding">Section 3.3.1</a> of <a href="#Part1" id="rfc.xref.Part1.2 4"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>). Proxies/gateways <em class="bcp14">MUST</em> remove any transfer-coding prior to forwarding a message via a MIME-compliant protocol.1642 <p id="rfc.section.A.6.p.1">HTTP/1.1 introduces the Transfer-Encoding header field (<a href="p1-messaging.html#header.transfer-encoding" title="Transfer-Encoding">Section 3.3.1</a> of <a href="#Part1" id="rfc.xref.Part1.23"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>). Proxies/gateways <em class="bcp14">MUST</em> remove any transfer-coding prior to forwarding a message via a MIME-compliant protocol. 1684 1643 </p> 1685 1644 <h2 id="rfc.section.A.7"><a href="#rfc.section.A.7">A.7</a> <a id="mhtml.line.length" href="#mhtml.line.length">MHTML and Line Length Limitations</a></h2> … … 1957 1916 <p id="rfc.section.D.21.p.1">None yet.</p> 1958 1917 <h1 id="rfc.index"><a href="#rfc.index">Index</a></h1> 1959 <p class="noprint"><a href="#rfc.index.A">A</a> <a href="#rfc.index.C">C</a> <a href="#rfc.index.D">D</a> <a href="#rfc.index.G">G</a> <a href="#rfc.index.H">H</a> <a href="#rfc.index.M">M</a> <a href="#rfc.index.P">P</a> <a href="#rfc.index.R">R</a> <a href="#rfc.index.S">S</a>1918 <p class="noprint"><a href="#rfc.index.A">A</a> <a href="#rfc.index.C">C</a> <a href="#rfc.index.D">D</a> <a href="#rfc.index.G">G</a> <a href="#rfc.index.H">H</a> <a href="#rfc.index.M">M</a> <a href="#rfc.index.P">P</a> <a href="#rfc.index.R">R</a> 1960 1919 </p> 1961 1920 <div class="print2col"> … … 1971 1930 <li>Coding Format 1972 1931 <ul> 1973 <li>compress <a href="#rfc.iref.c. 3">2.2</a></li>1974 <li>deflate <a href="#rfc.iref.c. 4">2.2</a></li>1975 <li>gzip <a href="#rfc.iref.c. 5">2.2</a></li>1932 <li>compress <a href="#rfc.iref.c.2">2.2</a></li> 1933 <li>deflate <a href="#rfc.iref.c.3">2.2</a></li> 1934 <li>gzip <a href="#rfc.iref.c.4">2.2</a></li> 1976 1935 </ul> 1977 1936 </li> 1978 <li>compress (Coding Format) <a href="#rfc.iref.c.2">2.2</a></li> 1979 <li>content negotiation <a href="#rfc.iref.c.1">1.1</a></li> 1980 <li>Content-Encoding header field <a href="#rfc.xref.header.content-encoding.1">2.2</a>, <a href="#rfc.xref.header.content-encoding.2">4.1</a>, <a href="#rfc.iref.c.6"><b>6.5</b></a>, <a href="#rfc.xref.header.content-encoding.3">6.5</a></li> 1981 <li>Content-Language header field <a href="#rfc.xref.header.content-language.1">4.1</a>, <a href="#rfc.iref.c.7"><b>6.6</b></a></li> 1982 <li>Content-Location header field <a href="#rfc.xref.header.content-location.1">4.1</a>, <a href="#rfc.iref.c.8"><b>6.7</b></a>, <a href="#rfc.xref.header.content-location.2">C</a></li> 1983 <li>Content-Transfer-Encoding header field <a href="#rfc.iref.c.10">A.5</a>, <a href="#rfc.xref.no.content-transfer-encoding.1">C</a></li> 1984 <li>Content-Type header field <a href="#rfc.xref.header.content-type.1">2.3</a>, <a href="#rfc.xref.header.content-type.2">4.1</a>, <a href="#rfc.iref.c.9"><b>6.8</b></a></li> 1937 <li>compress (Coding Format) <a href="#rfc.iref.c.1">2.2</a></li> 1938 <li>Content-Encoding header field <a href="#rfc.xref.header.content-encoding.1">2.2</a>, <a href="#rfc.xref.header.content-encoding.2">4.1</a>, <a href="#rfc.iref.c.5"><b>6.5</b></a>, <a href="#rfc.xref.header.content-encoding.3">6.5</a></li> 1939 <li>Content-Language header field <a href="#rfc.xref.header.content-language.1">4.1</a>, <a href="#rfc.iref.c.6"><b>6.6</b></a></li> 1940 <li>Content-Location header field <a href="#rfc.xref.header.content-location.1">4.1</a>, <a href="#rfc.iref.c.7"><b>6.7</b></a>, <a href="#rfc.xref.header.content-location.2">C</a></li> 1941 <li>Content-Transfer-Encoding header field <a href="#rfc.iref.c.9">A.5</a>, <a href="#rfc.xref.no.content-transfer-encoding.1">C</a></li> 1942 <li>Content-Type header field <a href="#rfc.xref.header.content-type.1">2.3</a>, <a href="#rfc.xref.header.content-type.2">4.1</a>, <a href="#rfc.iref.c.8"><b>6.8</b></a></li> 1985 1943 </ul> 1986 1944 </li> … … 2042 2000 </li> 2043 2001 <li><a id="rfc.index.P" href="#rfc.index.P"><b>P</b></a><ul> 2044 <li><em>Part1</em> <a href="#rfc.xref.Part1.1">1.2</a>, <a href="#rfc.xref.Part1.2">1.3</a>, <a href="#rfc.xref.Part1.3">1.3.1</a>, <a href="#rfc.xref.Part1.4">1.3.1</a>, <a href="#rfc.xref.Part1.5">1.3.1</a>, <a href="#rfc.xref.Part1.6">1.3.1</a>, <a href="#rfc.xref.Part1.7">1.3.2</a>, <a href="#rfc.xref.Part1.8">1.3.2</a>, <a href="#rfc.xref.Part1.9">1.3.2</a>, <a href="#rfc.xref.Part1.10">2.2</a>, <a href="#rfc.xref.Part1.11">2.2</a>, <a href="#rfc.xref.Part1.12">2.2</a>, <a href="#rfc.xref.Part1.13">2.2.1</a>, <a href="#rfc.xref.Part1.14">2.2.1</a>, <a href="#rfc.xref.Part1.15">3.1</a>, <a href="#rfc.xref.Part1.16">3.2</a>, <a href="#rfc.xref.Part1.17">5.1</a>, <a href="#rfc.xref.Part1.18">6.1</a>, <a href="#rfc.xref.Part1.19">6.3</a>, <a href="#rfc.xref.Part1.20">6.7</a>, <a href="#rfc.xref.Part1.21">7.1</a>, <a href="#rfc.xref.Part1.22">7.1</a>, <a href="#rfc.xref.Part1.23">7.1</a>, <a href="#Part1"><b>9.1</b></a>, <a href="#rfc.xref.Part1.24">A.6</a><ul> 2045 <li><em>Section 1.2</em> <a href="#rfc.xref.Part1.2">1.3</a></li> 2046 <li><em>Section 2</em> <a href="#rfc.xref.Part1.1">1.2</a></li> 2047 <li><em>Section 2.7</em> <a href="#rfc.xref.Part1.7">1.3.2</a>, <a href="#rfc.xref.Part1.8">1.3.2</a></li> 2048 <li><em>Section 3.2.1</em> <a href="#rfc.xref.Part1.4">1.3.1</a></li> 2049 <li><em>Section 3.2.4</em> <a href="#rfc.xref.Part1.5">1.3.1</a>, <a href="#rfc.xref.Part1.6">1.3.1</a></li> 2050 <li><em>Section 3.3</em> <a href="#rfc.xref.Part1.16">3.2</a></li> 2051 <li><em>Section 3.3.1</em> <a href="#rfc.xref.Part1.24">A.6</a></li> 2052 <li><em>Section 3.3.2</em> <a href="#rfc.xref.Part1.15">3.1</a></li> 2053 <li><em>Section 4</em> <a href="#rfc.xref.Part1.13">2.2.1</a></li> 2054 <li><em>Section 4.2.1</em> <a href="#rfc.xref.Part1.10">2.2</a>, <a href="#rfc.xref.Part1.21">7.1</a></li> 2055 <li><em>Section 4.2</em> <a href="#rfc.xref.Part1.14">2.2.1</a></li> 2056 <li><em>Section 4.2.2</em> <a href="#rfc.xref.Part1.11">2.2</a>, <a href="#rfc.xref.Part1.22">7.1</a></li> 2057 <li><em>Section 4.2.3</em> <a href="#rfc.xref.Part1.12">2.2</a>, <a href="#rfc.xref.Part1.23">7.1</a></li> 2058 <li><em>Section 4.3.1</em> <a href="#rfc.xref.Part1.9">1.3.2</a>, <a href="#rfc.xref.Part1.17">5.1</a>, <a href="#rfc.xref.Part1.18">6.1</a>, <a href="#rfc.xref.Part1.19">6.3</a></li> 2059 <li><em>Section 5.5</em> <a href="#rfc.xref.Part1.20">6.7</a></li> 2002 <li><em>Part1</em> <a href="#rfc.xref.Part1.1">1.1</a>, <a href="#rfc.xref.Part1.2">1.1.1</a>, <a href="#rfc.xref.Part1.3">1.1.1</a>, <a href="#rfc.xref.Part1.4">1.1.1</a>, <a href="#rfc.xref.Part1.5">1.1.1</a>, <a href="#rfc.xref.Part1.6">1.1.2</a>, <a href="#rfc.xref.Part1.7">1.1.2</a>, <a href="#rfc.xref.Part1.8">1.1.2</a>, <a href="#rfc.xref.Part1.9">2.2</a>, <a href="#rfc.xref.Part1.10">2.2</a>, <a href="#rfc.xref.Part1.11">2.2</a>, <a href="#rfc.xref.Part1.12">2.2.1</a>, <a href="#rfc.xref.Part1.13">2.2.1</a>, <a href="#rfc.xref.Part1.14">3.1</a>, <a href="#rfc.xref.Part1.15">3.2</a>, <a href="#rfc.xref.Part1.16">5.1</a>, <a href="#rfc.xref.Part1.17">6.1</a>, <a href="#rfc.xref.Part1.18">6.3</a>, <a href="#rfc.xref.Part1.19">6.7</a>, <a href="#rfc.xref.Part1.20">7.1</a>, <a href="#rfc.xref.Part1.21">7.1</a>, <a href="#rfc.xref.Part1.22">7.1</a>, <a href="#Part1"><b>9.1</b></a>, <a href="#rfc.xref.Part1.23">A.6</a><ul> 2003 <li><em>Section 1.2</em> <a href="#rfc.xref.Part1.1">1.1</a></li> 2004 <li><em>Section 2.7</em> <a href="#rfc.xref.Part1.6">1.1.2</a>, <a href="#rfc.xref.Part1.7">1.1.2</a></li> 2005 <li><em>Section 3.2.1</em> <a href="#rfc.xref.Part1.3">1.1.1</a></li> 2006 <li><em>Section 3.2.4</em> <a href="#rfc.xref.Part1.4">1.1.1</a>, <a href="#rfc.xref.Part1.5">1.1.1</a></li> 2007 <li><em>Section 3.3</em> <a href="#rfc.xref.Part1.15">3.2</a></li> 2008 <li><em>Section 3.3.1</em> <a href="#rfc.xref.Part1.23">A.6</a></li> 2009 <li><em>Section 3.3.2</em> <a href="#rfc.xref.Part1.14">3.1</a></li> 2010 <li><em>Section 4</em> <a href="#rfc.xref.Part1.12">2.2.1</a></li> 2011 <li><em>Section 4.2.1</em> <a href="#rfc.xref.Part1.9">2.2</a>, <a href="#rfc.xref.Part1.20">7.1</a></li> 2012 <li><em>Section 4.2</em> <a href="#rfc.xref.Part1.13">2.2.1</a></li> 2013 <li><em>Section 4.2.2</em> <a href="#rfc.xref.Part1.10">2.2</a>, <a href="#rfc.xref.Part1.21">7.1</a></li> 2014 <li><em>Section 4.2.3</em> <a href="#rfc.xref.Part1.11">2.2</a>, <a href="#rfc.xref.Part1.22">7.1</a></li> 2015 <li><em>Section 4.3.1</em> <a href="#rfc.xref.Part1.8">1.1.2</a>, <a href="#rfc.xref.Part1.16">5.1</a>, <a href="#rfc.xref.Part1.17">6.1</a>, <a href="#rfc.xref.Part1.18">6.3</a></li> 2016 <li><em>Section 5.5</em> <a href="#rfc.xref.Part1.19">6.7</a></li> 2060 2017 </ul> 2061 2018 </li> … … 2100 2057 <li><em>RFC2068</em> <a href="#RFC2068"><b>9.2</b></a>, <a href="#rfc.xref.RFC2068.1">B</a></li> 2101 2058 <li><em>RFC2076</em> <a href="#RFC2076"><b>9.2</b></a>, <a href="#rfc.xref.RFC2076.1">B</a></li> 2102 <li><em>RFC2119</em> <a href="#rfc.xref.RFC2119.1">1.2</a>, <a href="#RFC2119"><b>9.1</b></a></li>2103 2059 <li><em>RFC2277</em> <a href="#rfc.xref.RFC2277.1">2.1</a>, <a href="#RFC2277"><b>9.2</b></a></li> 2104 2060 <li><em>RFC2295</em> <a href="#rfc.xref.RFC2295.1">5</a>, <a href="#RFC2295"><b>9.2</b></a></li> … … 2125 2081 </ul> 2126 2082 </li> 2127 <li><em>RFC5234</em> <a href="#rfc.xref.RFC5234.1">1. 3</a>, <a href="#rfc.xref.RFC5234.2">1.3</a>, <a href="#RFC5234"><b>9.1</b></a><ul>2128 <li><em>Appendix B.1</em> <a href="#rfc.xref.RFC5234.2">1. 3</a></li>2083 <li><em>RFC5234</em> <a href="#rfc.xref.RFC5234.1">1.1</a>, <a href="#rfc.xref.RFC5234.2">1.1</a>, <a href="#RFC5234"><b>9.1</b></a><ul> 2084 <li><em>Appendix B.1</em> <a href="#rfc.xref.RFC5234.2">1.1</a></li> 2129 2085 </ul> 2130 2086 </li> … … 2138 2094 </ul> 2139 2095 </li> 2140 <li><a id="rfc.index.S" href="#rfc.index.S"><b>S</b></a><ul>2141 <li>selected representation <a href="#rfc.iref.s.1"><b>1.1</b></a></li>2142 </ul>2143 </li>2144 2096 </ul> 2145 2097 </div>
Note: See TracChangeset
for help on using the changeset viewer.