Changeset 232 for draft-ietf-httpbis/latest/p3-payload.html
- Timestamp:
- 11/03/08 08:43:48 (15 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
draft-ietf-httpbis/latest/p3-payload.html
r230 r232 445 445 <tr> 446 446 <td class="header left"></td> 447 <td class="header right">March 8, 2008</td>447 <td class="header right">March 11, 2008</td> 448 448 </tr> 449 449 </table> … … 601 601 <a href="#abnf.dependencies" class="smpl">relativeURI</a> = <relativeURI, defined in <a href="#Part1" id="rfc.xref.Part1.10"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#general.syntax" title="General Syntax">Section 3.2.1</a>> 602 602 <a href="#abnf.dependencies" class="smpl">message-header</a> = <message-header, defined in <a href="#Part1" id="rfc.xref.Part1.11"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#message.headers" title="Message Headers">Section 4.2</a>> 603 </pre><div id="rfc.figure.u.4"></div><pre class="inline"> <a href="#abnf.dependencies" class="smpl">Allow</a> = <Allow, defined in <a href="#Part2" id="rfc.xref.Part2.1"><cite title="HTTP/1.1, part 2: Message Semantics">[Part2]</cite></a>, <a href="p2-semantics.html#header.allow" title="Allow">Section 10.1</a>> 604 </pre><div id="rfc.figure.u.5"></div><pre class="inline"> <a href="#abnf.dependencies" class="smpl">Last-Modified</a> = <Last-Modified, defined in <a href="#Part4" id="rfc.xref.Part4.1"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>, <a href="p4-conditional.html#header.last-modified" title="Last-Modified">Section 7.6</a>> 605 </pre><div id="rfc.figure.u.6"></div><pre class="inline"> <a href="#abnf.dependencies" class="smpl">Content-Range</a> = <Content-Range, defined in <a href="#Part5" id="rfc.xref.Part5.1"><cite title="HTTP/1.1, part 5: Range Requests and Partial Responses">[Part5]</cite></a>, <a href="p5-range.html#header.content-range" title="Content-Range">Section 6.2</a>> 606 </pre><div id="rfc.figure.u.7"></div><pre class="inline"> <a href="#abnf.dependencies" class="smpl">Expires</a> = <Expires, defined in <a href="#Part6" id="rfc.xref.Part6.1"><cite title="HTTP/1.1, part 6: Caching">[Part6]</cite></a>, <a href="p6-cache.html#header.expires" title="Expires">Section 16.3</a>> 603 </pre><div id="rfc.figure.u.4"></div><pre class="inline"> <a href="#abnf.dependencies" class="smpl">Last-Modified</a> = <Last-Modified, defined in <a href="#Part4" id="rfc.xref.Part4.1"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>, <a href="p4-conditional.html#header.last-modified" title="Last-Modified">Section 7.6</a>> 604 </pre><div id="rfc.figure.u.5"></div><pre class="inline"> <a href="#abnf.dependencies" class="smpl">Content-Range</a> = <Content-Range, defined in <a href="#Part5" id="rfc.xref.Part5.1"><cite title="HTTP/1.1, part 5: Range Requests and Partial Responses">[Part5]</cite></a>, <a href="p5-range.html#header.content-range" title="Content-Range">Section 6.2</a>> 605 </pre><div id="rfc.figure.u.6"></div><pre class="inline"> <a href="#abnf.dependencies" class="smpl">Expires</a> = <Expires, defined in <a href="#Part6" id="rfc.xref.Part6.1"><cite title="HTTP/1.1, part 6: Caching">[Part6]</cite></a>, <a href="p6-cache.html#header.expires" title="Expires">Section 16.3</a>> 607 606 </pre><h1 id="rfc.section.3"><a href="#rfc.section.3">3.</a> <a id="protocol.parameters" href="#protocol.parameters">Protocol Parameters</a></h1> 608 607 <h2 id="rfc.section.3.1"><a href="#rfc.section.3.1">3.1</a> <a id="character.sets" href="#character.sets">Character Sets</a></h2> … … 626 625 </p> 627 626 </div> 628 <div id="rfc.figure.u. 8"></div><pre class="inline"><span id="rfc.iref.g.1"></span> <a href="#rule.charset" class="smpl">charset</a> = <a href="#notation" class="smpl">token</a>627 <div id="rfc.figure.u.7"></div><pre class="inline"><span id="rfc.iref.g.1"></span> <a href="#rule.charset" class="smpl">charset</a> = <a href="#notation" class="smpl">token</a> 629 628 </pre><p id="rfc.section.3.1.p.6">Although HTTP allows an arbitrary token to be used as a charset value, any token that has a predefined value within the IANA 630 629 Character Set registry <em class="bcp14">MUST</em> represent the character set defined by that registry. Applications <em class="bcp14">SHOULD</em> limit their use of character sets to those defined by the IANA registry. … … 649 648 decoded by the recipient. 650 649 </p> 651 <div id="rfc.figure.u. 9"></div><pre class="inline"><span id="rfc.iref.g.2"></span> <a href="#content.codings" class="smpl">content-coding</a> = <a href="#notation" class="smpl">token</a>650 <div id="rfc.figure.u.8"></div><pre class="inline"><span id="rfc.iref.g.2"></span> <a href="#content.codings" class="smpl">content-coding</a> = <a href="#notation" class="smpl">token</a> 652 651 </pre><p id="rfc.section.3.2.p.3">All content-coding values are case-insensitive. HTTP/1.1 uses content-coding values in the Accept-Encoding (<a href="#header.accept-encoding" id="rfc.xref.header.accept-encoding.1" title="Accept-Encoding">Section 6.3</a>) and Content-Encoding (<a href="#header.content-encoding" id="rfc.xref.header.content-encoding.1" title="Content-Encoding">Section 6.5</a>) header fields. Although the value describes the content-coding, what is more important is that it indicates what decoding 653 652 mechanism will be required to remove the encoding. … … 693 692 <p id="rfc.section.3.3.p.1">HTTP uses Internet Media Types <a href="#RFC2046" id="rfc.xref.RFC2046.1"><cite title="Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types">[RFC2046]</cite></a> in the Content-Type (<a href="#header.content-type" id="rfc.xref.header.content-type.1" title="Content-Type">Section 6.9</a>) and Accept (<a href="#header.accept" id="rfc.xref.header.accept.1" title="Accept">Section 6.1</a>) header fields in order to provide open and extensible data typing and type negotiation. 694 693 </p> 695 <div id="rfc.figure.u. 10"></div><pre class="inline"><span id="rfc.iref.g.4"></span><span id="rfc.iref.g.5"></span><span id="rfc.iref.g.6"></span> <a href="#media.types" class="smpl">media-type</a> = <a href="#media.types" class="smpl">type</a> "/" <a href="#media.types" class="smpl">subtype</a> *( ";" <a href="#rule.parameter" class="smpl">parameter</a> )694 <div id="rfc.figure.u.9"></div><pre class="inline"><span id="rfc.iref.g.4"></span><span id="rfc.iref.g.5"></span><span id="rfc.iref.g.6"></span> <a href="#media.types" class="smpl">media-type</a> = <a href="#media.types" class="smpl">type</a> "/" <a href="#media.types" class="smpl">subtype</a> *( ";" <a href="#rule.parameter" class="smpl">parameter</a> ) 696 695 <a href="#media.types" class="smpl">type</a> = <a href="#notation" class="smpl">token</a> 697 696 <a href="#media.types" class="smpl">subtype</a> = <a href="#notation" class="smpl">token</a> … … 700 699 </p> 701 700 </div> 702 <div id="rfc.figure.u.1 1"></div><pre class="inline"><span id="rfc.iref.g.7"></span><span id="rfc.iref.g.8"></span><span id="rfc.iref.g.9"></span> <a href="#rule.parameter" class="smpl">parameter</a> = <a href="#rule.parameter" class="smpl">attribute</a> "=" <a href="#rule.parameter" class="smpl">value</a>701 <div id="rfc.figure.u.10"></div><pre class="inline"><span id="rfc.iref.g.7"></span><span id="rfc.iref.g.8"></span><span id="rfc.iref.g.9"></span> <a href="#rule.parameter" class="smpl">parameter</a> = <a href="#rule.parameter" class="smpl">attribute</a> "=" <a href="#rule.parameter" class="smpl">value</a> 703 702 <a href="#rule.parameter" class="smpl">attribute</a> = <a href="#notation" class="smpl">token</a> 704 703 <a href="#rule.parameter" class="smpl">value</a> = <a href="#notation" class="smpl">token</a> | <a href="#notation" class="smpl">quoted-string</a> … … 753 752 a quality value of 0, then content with this parameter is `not acceptable' for the client. HTTP/1.1 applications <em class="bcp14">MUST NOT</em> generate more than three digits after the decimal point. User configuration of these values <em class="bcp14">SHOULD</em> also be limited in this fashion. 754 753 </p> 755 <div id="rfc.figure.u.1 2"></div><pre class="inline"><span id="rfc.iref.g.10"></span> <a href="#quality.values" class="smpl">qvalue</a> = ( "0" [ "." 0*3<a href="#notation" class="smpl">DIGIT</a> ] )754 <div id="rfc.figure.u.11"></div><pre class="inline"><span id="rfc.iref.g.10"></span> <a href="#quality.values" class="smpl">qvalue</a> = ( "0" [ "." 0*3<a href="#notation" class="smpl">DIGIT</a> ] ) 756 755 | ( "1" [ "." 0*3("0") ] ) 757 756 </pre><p id="rfc.section.3.4.p.3">"Quality values" is a misnomer, since these values merely represent relative degradation in desired quality.</p> … … 763 762 <p id="rfc.section.3.5.p.2">The syntax and registry of HTTP language tags is the same as that defined by <a href="#RFC1766" id="rfc.xref.RFC1766.1"><cite title="Tags for the Identification of Languages">[RFC1766]</cite></a>. In summary, a language tag is composed of 1 or more parts: A primary language tag and a possibly empty series of subtags: 764 763 </p> 765 <div id="rfc.figure.u.1 3"></div><pre class="inline"><span id="rfc.iref.g.11"></span><span id="rfc.iref.g.12"></span><span id="rfc.iref.g.13"></span> <a href="#language.tags" class="smpl">language-tag</a> = <a href="#language.tags" class="smpl">primary-tag</a> *( "-" <a href="#language.tags" class="smpl">subtag</a> )764 <div id="rfc.figure.u.12"></div><pre class="inline"><span id="rfc.iref.g.11"></span><span id="rfc.iref.g.12"></span><span id="rfc.iref.g.13"></span> <a href="#language.tags" class="smpl">language-tag</a> = <a href="#language.tags" class="smpl">primary-tag</a> *( "-" <a href="#language.tags" class="smpl">subtag</a> ) 766 765 <a href="#language.tags" class="smpl">primary-tag</a> = 1*8<a href="#notation" class="smpl">ALPHA</a> 767 766 <a href="#language.tags" class="smpl">subtag</a> = 1*8<a href="#notation" class="smpl">ALPHA</a> … … 769 768 by the IANA. Example tags include: 770 769 </p> 771 <div id="rfc.figure.u.1 4"></div><pre class="text"> en, en-US, en-cockney, i-cherokee, x-pig-latin770 <div id="rfc.figure.u.13"></div><pre class="text"> en, en-US, en-cockney, i-cherokee, x-pig-latin 772 771 </pre><p id="rfc.section.3.5.p.6">where any two-letter primary-tag is an ISO-639 language abbreviation and any two-letter initial subtag is an ISO-3166 country 773 772 code. (The last three tags above are not registered tags; all but the last are examples of tags which could be registered … … 785 784 by the request. 786 785 </p> 787 <div id="rfc.figure.u.15"></div><pre class="inline"><span id="rfc.iref.g.14"></span><span id="rfc.iref.g.15"></span> <a href="#entity.header.fields" class="smpl">entity-header</a> = <a href="#abnf.dependencies" class="smpl">Allow</a> ; <a href="#Part2" id="rfc.xref.Part2.2"><cite title="HTTP/1.1, part 2: Message Semantics">[Part2]</cite></a>, <a href="p2-semantics.html#header.allow" title="Allow">Section 10.1</a> 788 | <a href="#header.content-encoding" class="smpl">Content-Encoding</a> ; <a href="#header.content-encoding" id="rfc.xref.header.content-encoding.2" title="Content-Encoding">Section 6.5</a> 786 <div id="rfc.figure.u.14"></div><pre class="inline"><span id="rfc.iref.g.14"></span><span id="rfc.iref.g.15"></span> <a href="#entity.header.fields" class="smpl">entity-header</a> = <a href="#header.content-encoding" class="smpl">Content-Encoding</a> ; <a href="#header.content-encoding" id="rfc.xref.header.content-encoding.2" title="Content-Encoding">Section 6.5</a> 789 787 | <a href="#header.content-language" class="smpl">Content-Language</a> ; <a href="#header.content-language" id="rfc.xref.header.content-language.1" title="Content-Language">Section 6.6</a> 790 788 | <a href="#abnf.dependencies" class="smpl">Content-Length</a> ; <a href="#Part1" id="rfc.xref.Part1.12"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#header.content-length" title="Content-Length">Section 8.2</a> … … 803 801 <h2 id="rfc.section.4.2"><a href="#rfc.section.4.2">4.2</a> <a id="entity.body" href="#entity.body">Entity Body</a></h2> 804 802 <p id="rfc.section.4.2.p.1">The entity-body (if any) sent with an HTTP request or response is in a format and encoding defined by the entity-header fields.</p> 805 <div id="rfc.figure.u.1 6"></div><pre class="inline"><span id="rfc.iref.g.16"></span> <a href="#entity.body" class="smpl">entity-body</a> = *<a href="#notation" class="smpl">OCTET</a>803 <div id="rfc.figure.u.15"></div><pre class="inline"><span id="rfc.iref.g.16"></span> <a href="#entity.body" class="smpl">entity-body</a> = *<a href="#notation" class="smpl">OCTET</a> 806 804 </pre><p id="rfc.section.4.2.p.3">An entity-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 4.3</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>. The entity-body is obtained from the message-body by decoding any Transfer-Encoding that might have been applied to ensure 807 805 safe and proper transfer of the message. … … 811 809 and Content-Encoding. These define a two-layer, ordered encoding model: 812 810 </p> 813 <div id="rfc.figure.u.1 7"></div><pre class="text"> entity-body := Content-Encoding( Content-Type( data ) )811 <div id="rfc.figure.u.16"></div><pre class="text"> entity-body := Content-Encoding( Content-Type( data ) ) 814 812 </pre><p id="rfc.section.4.2.1.p.3">Content-Type specifies the media type of the underlying data. Content-Encoding may be used to indicate any additional content 815 813 codings applied to the data, usually for the purpose of data compression, that are a property of the requested resource. There … … 866 864 </ol> 867 865 <p id="rfc.section.5.1.p.4">HTTP/1.1 includes the following request-header fields for enabling server-driven negotiation through description of user agent 868 capabilities and user preferences: Accept (<a href="#header.accept" id="rfc.xref.header.accept.2" title="Accept">Section 6.1</a>), Accept-Charset (<a href="#header.accept-charset" id="rfc.xref.header.accept-charset.1" title="Accept-Charset">Section 6.2</a>), Accept-Encoding (<a href="#header.accept-encoding" id="rfc.xref.header.accept-encoding.2" title="Accept-Encoding">Section 6.3</a>), Accept-Language (<a href="#header.accept-language" id="rfc.xref.header.accept-language.1" title="Accept-Language">Section 6.4</a>), and User-Agent (<a href="p2-semantics.html#header.user-agent" title="User-Agent">Section 10.9</a> of <a href="#Part2" id="rfc.xref.Part2. 3"><cite title="HTTP/1.1, part 2: Message Semantics">[Part2]</cite></a>). However, an origin server is not limited to these dimensions and <em class="bcp14">MAY</em> vary the response based on any aspect of the request, including information outside the request-header fields or within extension866 capabilities and user preferences: Accept (<a href="#header.accept" id="rfc.xref.header.accept.2" title="Accept">Section 6.1</a>), Accept-Charset (<a href="#header.accept-charset" id="rfc.xref.header.accept-charset.1" title="Accept-Charset">Section 6.2</a>), Accept-Encoding (<a href="#header.accept-encoding" id="rfc.xref.header.accept-encoding.2" title="Accept-Encoding">Section 6.3</a>), Accept-Language (<a href="#header.accept-language" id="rfc.xref.header.accept-language.1" title="Accept-Language">Section 6.4</a>), and User-Agent (<a href="p2-semantics.html#header.user-agent" title="User-Agent">Section 10.9</a> of <a href="#Part2" id="rfc.xref.Part2.1"><cite title="HTTP/1.1, part 2: Message Semantics">[Part2]</cite></a>). However, an origin server is not limited to these dimensions and <em class="bcp14">MAY</em> vary the response based on any aspect of the request, including information outside the request-header fields or within extension 869 867 header fields not defined by this specification. 870 868 </p> … … 915 913 for an in-line image. 916 914 </p> 917 <div id="rfc.figure.u.1 8"></div><pre class="inline"><span id="rfc.iref.g.17"></span><span id="rfc.iref.g.18"></span><span id="rfc.iref.g.19"></span><span id="rfc.iref.g.20"></span> <a href="#header.accept" class="smpl">Accept</a> = "Accept" ":"915 <div id="rfc.figure.u.17"></div><pre class="inline"><span id="rfc.iref.g.17"></span><span id="rfc.iref.g.18"></span><span id="rfc.iref.g.19"></span><span id="rfc.iref.g.20"></span> <a href="#header.accept" class="smpl">Accept</a> = "Accept" ":" 918 916 #( <a href="#header.accept" class="smpl">media-range</a> [ <a href="#header.accept" class="smpl">accept-params</a> ] ) 919 917 … … 939 937 </dl> 940 938 <p id="rfc.section.6.1.p.5">The example</p> 941 <div id="rfc.figure.u.1 9"></div><pre class="text"> Accept: audio/*; q=0.2, audio/basic939 <div id="rfc.figure.u.18"></div><pre class="text"> Accept: audio/*; q=0.2, audio/basic 942 940 </pre><p id="rfc.section.6.1.p.7"> <em class="bcp14">SHOULD</em> be interpreted as "I prefer audio/basic, but send me any audio type if it is the best available after an 80% mark-down in 943 941 quality." … … 948 946 </p> 949 947 <p id="rfc.section.6.1.p.9">A more elaborate example is</p> 950 <div id="rfc.figure.u. 20"></div><pre class="text"> Accept: text/plain; q=0.5, text/html,948 <div id="rfc.figure.u.19"></div><pre class="text"> Accept: text/plain; q=0.5, text/html, 951 949 text/x-dvi; q=0.8, text/x-c 952 950 </pre><p id="rfc.section.6.1.p.11">Verbally, this would be interpreted as "text/html and text/x-c are the preferred media types, but if they do not exist, then … … 956 954 to a given type, the most specific reference has precedence. For example, 957 955 </p> 958 <div id="rfc.figure.u.2 1"></div><pre class="text"> Accept: text/*, text/html, text/html;level=1, */*956 <div id="rfc.figure.u.20"></div><pre class="text"> Accept: text/*, text/html, text/html;level=1, */* 959 957 </pre><p id="rfc.section.6.1.p.14">have the following precedence:</p> 960 <div id="rfc.figure.u.2 2"></div><pre class="text"> 1) text/html;level=1958 <div id="rfc.figure.u.21"></div><pre class="text"> 1) text/html;level=1 961 959 2) text/html 962 960 3) text/* … … 965 963 which matches that type. For example, 966 964 </p> 967 <div id="rfc.figure.u.2 3"></div><pre class="text"> Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1,965 <div id="rfc.figure.u.22"></div><pre class="text"> Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1, 968 966 text/html;level=2;q=0.4, */*;q=0.5 969 967 </pre><p id="rfc.section.6.1.p.18">would cause the following values to be associated:</p> 970 <div id="rfc.figure.u.2 4"></div><pre class="text"> text/html;level=1 = 1968 <div id="rfc.figure.u.23"></div><pre class="text"> text/html;level=1 = 1 971 969 text/html = 0.7 972 970 text/plain = 0.3 … … 984 982 to a server which is capable of representing documents in those character sets. 985 983 </p> 986 <div id="rfc.figure.u.2 5"></div><pre class="inline"><span id="rfc.iref.g.21"></span> <a href="#header.accept-charset" class="smpl">Accept-Charset</a> = "Accept-Charset" ":"984 <div id="rfc.figure.u.24"></div><pre class="inline"><span id="rfc.iref.g.21"></span> <a href="#header.accept-charset" class="smpl">Accept-Charset</a> = "Accept-Charset" ":" 987 985 1#( ( <a href="#rule.charset" class="smpl">charset</a> | "*" ) [ ";" "q" "=" <a href="#quality.values" class="smpl">qvalue</a> ] ) 988 986 </pre><p id="rfc.section.6.2.p.3">Character set values are described in <a href="#character.sets" title="Character Sets">Section 3.1</a>. Each charset <em class="bcp14">MAY</em> be given an associated quality value which represents the user's preference for that charset. The default value is q=1. An 989 987 example is 990 988 </p> 991 <div id="rfc.figure.u.2 6"></div><pre class="text"> Accept-Charset: iso-8859-5, unicode-1-1;q=0.8989 <div id="rfc.figure.u.25"></div><pre class="text"> Accept-Charset: iso-8859-5, unicode-1-1;q=0.8 992 990 </pre><p id="rfc.section.6.2.p.5">The special value "*", if present in the Accept-Charset field, matches every character set (including ISO-8859-1) which is 993 991 not mentioned elsewhere in the Accept-Charset field. If no "*" is present in an Accept-Charset field, then all character sets … … 1003 1001 <p id="rfc.section.6.3.p.1">The Accept-Encoding request-header field is similar to Accept, but restricts the content-codings (<a href="#content.codings" title="Content Codings">Section 3.2</a>) that are acceptable in the response. 1004 1002 </p> 1005 <div id="rfc.figure.u.2 7"></div><pre class="inline"><span id="rfc.iref.g.22"></span><span id="rfc.iref.g.23"></span> <a href="#header.accept-encoding" class="smpl">Accept-Encoding</a> = "Accept-Encoding" ":"1003 <div id="rfc.figure.u.26"></div><pre class="inline"><span id="rfc.iref.g.22"></span><span id="rfc.iref.g.23"></span> <a href="#header.accept-encoding" class="smpl">Accept-Encoding</a> = "Accept-Encoding" ":" 1006 1004 #( <a href="#header.accept-encoding" class="smpl">codings</a> [ ";" "q" "=" <a href="#quality.values" class="smpl">qvalue</a> ] ) 1007 1005 <a href="#header.accept-encoding" class="smpl">codings</a> = ( <a href="#content.codings" class="smpl">content-coding</a> | "*" ) 1008 1006 </pre><p id="rfc.section.6.3.p.3">Examples of its use are:</p> 1009 <div id="rfc.figure.u.2 8"></div><pre class="text"> Accept-Encoding: compress, gzip1007 <div id="rfc.figure.u.27"></div><pre class="text"> Accept-Encoding: compress, gzip 1010 1008 Accept-Encoding: 1011 1009 Accept-Encoding: * … … 1049 1047 as a response to the request. Language tags are defined in <a href="#language.tags" title="Language Tags">Section 3.5</a>. 1050 1048 </p> 1051 <div id="rfc.figure.u.2 9"></div><pre class="inline"><span id="rfc.iref.g.24"></span><span id="rfc.iref.g.25"></span> <a href="#header.accept-language" class="smpl">Accept-Language</a> = "Accept-Language" ":"1049 <div id="rfc.figure.u.28"></div><pre class="inline"><span id="rfc.iref.g.24"></span><span id="rfc.iref.g.25"></span> <a href="#header.accept-language" class="smpl">Accept-Language</a> = "Accept-Language" ":" 1052 1050 1#( <a href="#header.accept-language" class="smpl">language-range</a> [ ";" "q" "=" <a href="#quality.values" class="smpl">qvalue</a> ] ) 1053 1051 <a href="#header.accept-language" class="smpl">language-range</a> = ( ( 1*8<a href="#notation" class="smpl">ALPHA</a> *( "-" 1*8<a href="#notation" class="smpl">ALPHA</a> ) ) | "*" ) … … 1055 1053 that range. The quality value defaults to "q=1". For example, 1056 1054 </p> 1057 <div id="rfc.figure.u. 30"></div><pre class="text"> Accept-Language: da, en-gb;q=0.8, en;q=0.71055 <div id="rfc.figure.u.29"></div><pre class="text"> Accept-Language: da, en-gb;q=0.8, en;q=0.7 1058 1056 </pre><p id="rfc.section.6.4.p.5">would mean: "I prefer Danish, but will accept British English and other types of English." A language-range matches a language-tag 1059 1057 if it exactly equals the tag, or if it exactly equals a prefix of the tag such that the first tag character following the … … 1093 1091 without losing the identity of its underlying media type. 1094 1092 </p> 1095 <div id="rfc.figure.u.3 1"></div><pre class="inline"><span id="rfc.iref.g.26"></span> <a href="#header.content-encoding" class="smpl">Content-Encoding</a> = "Content-Encoding" ":" 1#<a href="#content.codings" class="smpl">content-coding</a>1093 <div id="rfc.figure.u.30"></div><pre class="inline"><span id="rfc.iref.g.26"></span> <a href="#header.content-encoding" class="smpl">Content-Encoding</a> = "Content-Encoding" ":" 1#<a href="#content.codings" class="smpl">content-coding</a> 1096 1094 </pre><p id="rfc.section.6.5.p.3">Content codings are defined in <a href="#content.codings" title="Content Codings">Section 3.2</a>. An example of its use is 1097 1095 </p> 1098 <div id="rfc.figure.u.3 2"></div><pre class="text"> Content-Encoding: gzip1096 <div id="rfc.figure.u.31"></div><pre class="text"> Content-Encoding: gzip 1099 1097 </pre><p id="rfc.section.6.5.p.5">The content-coding is a characteristic of the entity identified by the Request-URI. Typically, the entity-body is stored with 1100 1098 this encoding and is only decoded before rendering or analogous usage. However, a non-transparent proxy <em class="bcp14">MAY</em> modify the content-coding if the new coding is known to be acceptable to the recipient, unless the "no-transform" cache-control … … 1113 1111 Note that this might not be equivalent to all the languages used within the entity-body. 1114 1112 </p> 1115 <div id="rfc.figure.u.3 3"></div><pre class="inline"><span id="rfc.iref.g.27"></span> <a href="#header.content-language" class="smpl">Content-Language</a> = "Content-Language" ":" 1#<a href="#language.tags" class="smpl">language-tag</a>1113 <div id="rfc.figure.u.32"></div><pre class="inline"><span id="rfc.iref.g.27"></span> <a href="#header.content-language" class="smpl">Content-Language</a> = "Content-Language" ":" 1#<a href="#language.tags" class="smpl">language-tag</a> 1116 1114 </pre><p id="rfc.section.6.6.p.3">Language tags are defined in <a href="#language.tags" title="Language Tags">Section 3.5</a>. The primary purpose of Content-Language is to allow a user to identify and differentiate entities according to the user's 1117 1115 own preferred language. Thus, if the body content is intended only for a Danish-literate audience, the appropriate field is 1118 1116 </p> 1119 <div id="rfc.figure.u.3 4"></div><pre class="text"> Content-Language: da1117 <div id="rfc.figure.u.33"></div><pre class="text"> Content-Language: da 1120 1118 </pre><p id="rfc.section.6.6.p.5">If no Content-Language is specified, the default is that the content is intended for all language audiences. This might mean 1121 1119 that the sender does not consider it to be specific to any natural language, or that the sender does not know for which language … … 1125 1123 simultaneously in the original Maori and English versions, would call for 1126 1124 </p> 1127 <div id="rfc.figure.u.3 5"></div><pre class="text"> Content-Language: mi, en1125 <div id="rfc.figure.u.34"></div><pre class="text"> Content-Language: mi, en 1128 1126 </pre><p id="rfc.section.6.6.p.8">However, just because multiple languages are present within an entity does not mean that it is intended for multiple linguistic 1129 1127 audiences. An example would be a beginner's language primer, such as "A First Lesson in Latin," which is clearly intended … … 1140 1138 accessed, the server <em class="bcp14">SHOULD</em> provide a Content-Location for the particular variant which is returned. 1141 1139 </p> 1142 <div id="rfc.figure.u.3 6"></div><pre class="inline"><span id="rfc.iref.g.28"></span> <a href="#header.content-location" class="smpl">Content-Location</a> = "Content-Location" ":"1140 <div id="rfc.figure.u.35"></div><pre class="inline"><span id="rfc.iref.g.28"></span> <a href="#header.content-location" class="smpl">Content-Location</a> = "Content-Location" ":" 1143 1141 ( <a href="#abnf.dependencies" class="smpl">absoluteURI</a> | <a href="#abnf.dependencies" class="smpl">relativeURI</a> ) 1144 1142 </pre><p id="rfc.section.6.7.p.3">The value of Content-Location also defines the base URI for the entity.</p> … … 1159 1157 attacks.) 1160 1158 </p> 1161 <div id="rfc.figure.u.3 7"></div><pre class="inline"><span id="rfc.iref.g.29"></span><span id="rfc.iref.g.30"></span> <a href="#header.content-md5" class="smpl">Content-MD5</a> = "Content-MD5" ":" <a href="#header.content-md5" class="smpl">md5-digest</a>1159 <div id="rfc.figure.u.36"></div><pre class="inline"><span id="rfc.iref.g.29"></span><span id="rfc.iref.g.30"></span> <a href="#header.content-md5" class="smpl">Content-MD5</a> = "Content-MD5" ":" <a href="#header.content-md5" class="smpl">md5-digest</a> 1162 1160 <a href="#header.content-md5" class="smpl">md5-digest</a> = <base64 of 128 bit MD5 digest as per <a href="#RFC1864" id="rfc.xref.RFC1864.2"><cite title="The Content-MD5 Header Field">[RFC1864]</cite></a>> 1163 1161 </pre><p id="rfc.section.6.8.p.3">The Content-MD5 header field <em class="bcp14">MAY</em> be generated by an origin server or client to function as an integrity check of the entity-body. Only origin servers or clients <em class="bcp14">MAY</em> generate the Content-MD5 header field; proxies and gateways <em class="bcp14">MUST NOT</em> generate it, as this would defeat its value as an end-to-end integrity check. Any recipient of the entity-body, including … … 1196 1194 the HEAD method, the media type that would have been sent had the request been a GET. 1197 1195 </p> 1198 <div id="rfc.figure.u.3 8"></div><pre class="inline"><span id="rfc.iref.g.31"></span> <a href="#header.content-type" class="smpl">Content-Type</a> = "Content-Type" ":" <a href="#media.types" class="smpl">media-type</a>1196 <div id="rfc.figure.u.37"></div><pre class="inline"><span id="rfc.iref.g.31"></span> <a href="#header.content-type" class="smpl">Content-Type</a> = "Content-Type" ":" <a href="#media.types" class="smpl">media-type</a> 1199 1197 </pre><p id="rfc.section.6.9.p.3">Media types are defined in <a href="#media.types" title="Media Types">Section 3.3</a>. An example of the field is 1200 1198 </p> 1201 <div id="rfc.figure.u.3 9"></div><pre class="text"> Content-Type: text/html; charset=ISO-8859-41199 <div id="rfc.figure.u.38"></div><pre class="text"> Content-Type: text/html; charset=ISO-8859-4 1202 1200 </pre><p id="rfc.section.6.9.p.5">Further discussion of methods for identifying the media type of an entity is provided in <a href="#type" title="Type">Section 4.2.1</a>. 1203 1201 </p> … … 1415 1413 environments. 1416 1414 </p> 1417 <div id="rfc.figure.u. 40"></div><pre class="inline"><span id="rfc.iref.g.32"></span> <a href="#mime-version" class="smpl">MIME-Version</a> = "MIME-Version" ":" 1*<a href="#notation" class="smpl">DIGIT</a> "." 1*<a href="#notation" class="smpl">DIGIT</a>1415 <div id="rfc.figure.u.39"></div><pre class="inline"><span id="rfc.iref.g.32"></span> <a href="#mime-version" class="smpl">MIME-Version</a> = "MIME-Version" ":" 1*<a href="#notation" class="smpl">DIGIT</a> "." 1*<a href="#notation" class="smpl">DIGIT</a> 1418 1416 </pre><p id="rfc.section.A.1.p.3">MIME version "1.0" is the default for use in HTTP/1.1. However, HTTP/1.1 message parsing and semantics are defined by this 1419 1417 document and not the MIME specification. … … 1469 1467 in <a href="#RFC1806" id="rfc.xref.RFC1806.3"><cite title="Communicating Presentation Information in Internet Messages: The Content-Disposition Header">[RFC1806]</cite></a>. 1470 1468 </p> 1471 <div id="rfc.figure.u.4 1"></div><pre class="inline"><span id="rfc.iref.g.33"></span><span id="rfc.iref.g.34"></span><span id="rfc.iref.g.35"></span><span id="rfc.iref.g.36"></span><span id="rfc.iref.g.37"></span><span id="rfc.iref.g.38"></span> <a href="#content-disposition" class="smpl">content-disposition</a> = "Content-Disposition" ":"1469 <div id="rfc.figure.u.40"></div><pre class="inline"><span id="rfc.iref.g.33"></span><span id="rfc.iref.g.34"></span><span id="rfc.iref.g.35"></span><span id="rfc.iref.g.36"></span><span id="rfc.iref.g.37"></span><span id="rfc.iref.g.38"></span> <a href="#content-disposition" class="smpl">content-disposition</a> = "Content-Disposition" ":" 1472 1470 <a href="#content-disposition" class="smpl">disposition-type</a> *( ";" <a href="#content-disposition" class="smpl">disposition-parm</a> ) 1473 1471 <a href="#content-disposition" class="smpl">disposition-type</a> = "attachment" | <a href="#content-disposition" class="smpl">disp-extension-token</a> … … 1477 1475 <a href="#content-disposition" class="smpl">disp-extension-parm</a> = <a href="#notation" class="smpl">token</a> "=" ( <a href="#notation" class="smpl">token</a> | <a href="#notation" class="smpl">quoted-string</a> ) 1478 1476 </pre><p id="rfc.section.B.1.p.3">An example is</p> 1479 <div id="rfc.figure.u.4 2"></div><pre class="text"> Content-Disposition: attachment; filename="fname.ext"1477 <div id="rfc.figure.u.41"></div><pre class="text"> Content-Disposition: attachment; filename="fname.ext" 1480 1478 </pre><p id="rfc.section.B.1.p.5">The receiving user agent <em class="bcp14">SHOULD NOT</em> respect any directory path information present in the filename-parm parameter, which is the only parameter believed to apply 1481 1479 to HTTP implementations at this time. The filename <em class="bcp14">SHOULD</em> be treated as a terminal component only. … … 1550 1548 <h2 id="rfc.section.D.4"><a href="#rfc.section.D.4">D.4</a> Since draft-ietf-httpbis-p3-payload-02 1551 1549 </h2> 1550 <p id="rfc.section.D.4.p.1">Closed issues: </p> 1551 <ul> 1552 <li> <<a href="http://www3.tools.ietf.org/wg/httpbis/trac/ticket/105">http://www3.tools.ietf.org/wg/httpbis/trac/ticket/105</a>>: "Classification for Allow header" 1553 </li> 1554 </ul> 1552 1555 <h1><a id="rfc.copyright" href="#rfc.copyright">Full Copyright Statement</a></h1> 1553 1556 <p>This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the … … 1694 1697 </ul> 1695 1698 </li> 1696 <li class="indline1"><em>Part2</em> <a class="iref" href="#rfc.xref.Part2.1">2</a>, <a class="iref" href="#rfc.xref.Part2.2">4.1</a>, <a class="iref" href="#rfc.xref.Part2.3">5.1</a>, <a class="iref" href="#Part2"><b>10.1</b></a><ul class="ind"> 1697 <li class="indline1"><em>Section 10.1</em> <a class="iref" href="#rfc.xref.Part2.1">2</a>, <a class="iref" href="#rfc.xref.Part2.2">4.1</a></li> 1698 <li class="indline1"><em>Section 10.9</em> <a class="iref" href="#rfc.xref.Part2.3">5.1</a></li> 1699 <li class="indline1"><em>Part2</em> <a class="iref" href="#rfc.xref.Part2.1">5.1</a>, <a class="iref" href="#Part2"><b>10.1</b></a><ul class="ind"> 1700 <li class="indline1"><em>Section 10.9</em> <a class="iref" href="#rfc.xref.Part2.1">5.1</a></li> 1699 1701 </ul> 1700 1702 </li>
Note: See TracChangeset
for help on using the changeset viewer.