Changeset 1853 for draft-ietf-httpbis/latest
- Timestamp:
- 02/09/12 21:05:07 (10 years ago)
- Location:
- draft-ietf-httpbis/latest
- Files:
-
- 2 edited
Legend:
- Unmodified
- Added
- Removed
-
draft-ietf-httpbis/latest/p2-semantics.html
r1852 r1853 619 619 <li><a href="#rfc.section.5.3">5.3</a> <a href="#request.conneg">Content Negotiation</a></li> 620 620 <li><a href="#rfc.section.5.4">5.4</a> <a href="#request.auth">Authentication</a></li> 621 <li><a href="#rfc.section.5.5">5.5</a> <a href="#request. inform">Information</a></li>621 <li><a href="#rfc.section.5.5">5.5</a> <a href="#request.context">Context</a></li> 622 622 </ul> 623 623 </li> … … 1332 1332 </p> 1333 1333 <h1 id="rfc.section.5"><a href="#rfc.section.5">5.</a> <a id="request.header.fields" href="#request.header.fields">Request Header Fields</a></h1> 1334 <p id="rfc.section.5.p.1">The request header fields allow the client to pass additional information about the request, and about the client itself, 1335 to the server. These fields act as request modifiers, with semantics equivalent to the parameters on a programming language 1336 method invocation. 1334 <p id="rfc.section.5.p.1">A client sends request header fields to provide more information about the request context, make the request conditional based 1335 on the target resource state, suggest preferred formats for the response, supply authentication credentials, or modify the 1336 expected request processing. These fields act as request modifiers, similar to the parameters on a programming language method 1337 invocation. 1337 1338 </p> 1338 1339 <h2 id="rfc.section.5.1"><a href="#rfc.section.5.1">5.1</a> <a id="request.controls" href="#request.controls">Controls</a></h2> 1340 <p id="rfc.section.5.1.p.1">Controls are request header fields that direct specific handling of the request.</p> 1339 1341 <div id="rfc.table.u.3"> 1340 1342 <table class="tt full left" cellpadding="3" cellspacing="0"> … … 1366 1368 </div> 1367 1369 <h2 id="rfc.section.5.2"><a href="#rfc.section.5.2">5.2</a> <a id="request.conditionals" href="#request.conditionals">Conditionals</a></h2> 1370 <p id="rfc.section.5.2.p.1">Conditionals are request header fields that indicate a precondition to be tested before applying the method semantics to the 1371 target resource. Each precondition is based on metadata that is expected to change if the selected representation of the target 1372 resource is changed. The HTTP/1.1 conditional request mechanisms are defined in <a href="#Part4" id="rfc.xref.Part4.4"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>. 1373 </p> 1368 1374 <div id="rfc.table.u.4"> 1369 1375 <table class="tt full left" cellpadding="3" cellspacing="0"> … … 1377 1383 <tr> 1378 1384 <td class="left">If-Match</td> 1379 <td class="left"><a href="p4-conditional.html#header.if-match" title="If-Match">Section 3.1</a> of <a href="#Part4" id="rfc.xref.Part4. 4"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>1385 <td class="left"><a href="p4-conditional.html#header.if-match" title="If-Match">Section 3.1</a> of <a href="#Part4" id="rfc.xref.Part4.5"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td> 1380 1386 </tr> 1381 1387 <tr> 1382 1388 <td class="left">If-None-Match</td> 1383 <td class="left"><a href="p4-conditional.html#header.if-none-match" title="If-None-Match">Section 3.2</a> of <a href="#Part4" id="rfc.xref.Part4. 5"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>1389 <td class="left"><a href="p4-conditional.html#header.if-none-match" title="If-None-Match">Section 3.2</a> of <a href="#Part4" id="rfc.xref.Part4.6"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td> 1384 1390 </tr> 1385 1391 <tr> 1386 1392 <td class="left">If-Modified-Since</td> 1387 <td class="left"><a href="p4-conditional.html#header.if-modified-since" title="If-Modified-Since">Section 3.3</a> of <a href="#Part4" id="rfc.xref.Part4. 6"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>1393 <td class="left"><a href="p4-conditional.html#header.if-modified-since" title="If-Modified-Since">Section 3.3</a> of <a href="#Part4" id="rfc.xref.Part4.7"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td> 1388 1394 </tr> 1389 1395 <tr> 1390 1396 <td class="left">If-Unmodified-Since</td> 1391 <td class="left"><a href="p4-conditional.html#header.if-unmodified-since" title="If-Unmodified-Since">Section 3.4</a> of <a href="#Part4" id="rfc.xref.Part4. 7"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>1397 <td class="left"><a href="p4-conditional.html#header.if-unmodified-since" title="If-Unmodified-Since">Section 3.4</a> of <a href="#Part4" id="rfc.xref.Part4.8"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td> 1392 1398 </tr> 1393 1399 <tr> … … 1448 1454 </table> 1449 1455 </div> 1450 <h2 id="rfc.section.5.5"><a href="#rfc.section.5.5">5.5</a> <a id="request. inform" href="#request.inform">Information</a></h2>1456 <h2 id="rfc.section.5.5"><a href="#rfc.section.5.5">5.5</a> <a id="request.context" href="#request.context">Context</a></h2> 1451 1457 <div id="rfc.table.u.7"> 1452 1458 <table class="tt full left" cellpadding="3" cellspacing="0"> … … 1503 1509 </p> 1504 1510 <h2 id="rfc.section.6.1"><a href="#rfc.section.6.1">6.1</a> <a id="overview.of.status.codes" href="#overview.of.status.codes">Overview of Status Codes</a></h2> 1505 <p id="rfc.section.6.1.p.1">The status codes listed below are defined in this specification, <a href="p4-conditional.html#status.code.definitions" title="Status Code Definitions">Section 4</a> of <a href="#Part4" id="rfc.xref.Part4. 8"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>, <a href="p5-range.html#status.code.definitions" title="Status Code Definitions">Section 3</a> of <a href="#Part5" id="rfc.xref.Part5.6"><cite title="HTTP/1.1, part 5: Range Requests">[Part5]</cite></a>, and <a href="p7-auth.html#status.code.definitions" title="Status Code Definitions">Section 3</a> of <a href="#Part7" id="rfc.xref.Part7.3"><cite title="HTTP/1.1, part 7: Authentication">[Part7]</cite></a>. The reason phrases listed here are only recommendations — they can be replaced by local equivalents without affecting the1511 <p id="rfc.section.6.1.p.1">The status codes listed below are defined in this specification, <a href="p4-conditional.html#status.code.definitions" title="Status Code Definitions">Section 4</a> of <a href="#Part4" id="rfc.xref.Part4.9"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>, <a href="p5-range.html#status.code.definitions" title="Status Code Definitions">Section 3</a> of <a href="#Part5" id="rfc.xref.Part5.6"><cite title="HTTP/1.1, part 5: Range Requests">[Part5]</cite></a>, and <a href="p7-auth.html#status.code.definitions" title="Status Code Definitions">Section 3</a> of <a href="#Part7" id="rfc.xref.Part7.3"><cite title="HTTP/1.1, part 7: Authentication">[Part7]</cite></a>. The reason phrases listed here are only recommendations — they can be replaced by local equivalents without affecting the 1506 1512 protocol. 1507 1513 </p> … … 1584 1590 <td class="left">304</td> 1585 1591 <td class="left">Not Modified</td> 1586 <td id="status.304" class="left"><a href="p4-conditional.html#status.304" title="304 Not Modified">Section 4.1</a> of <a href="#Part4" id="rfc.xref.Part4. 9"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>1592 <td id="status.304" class="left"><a href="p4-conditional.html#status.304" title="304 Not Modified">Section 4.1</a> of <a href="#Part4" id="rfc.xref.Part4.10"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td> 1587 1593 </tr> 1588 1594 <tr> … … 1659 1665 <td class="left">412</td> 1660 1666 <td class="left">Precondition Failed</td> 1661 <td id="status.412" class="left"><a href="p4-conditional.html#status.412" title="412 Precondition Failed">Section 4.2</a> of <a href="#Part4" id="rfc.xref.Part4.1 0"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>1667 <td id="status.412" class="left"><a href="p4-conditional.html#status.412" title="412 Precondition Failed">Section 4.2</a> of <a href="#Part4" id="rfc.xref.Part4.11"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td> 1662 1668 </tr> 1663 1669 <tr> … … 1787 1793 </p> 1788 1794 <p id="rfc.section.6.3.2.p.4">A 201 response <em class="bcp14">MAY</em> contain an <a href="p4-conditional.html#header.etag" class="smpl">ETag</a> response header field indicating the current value of the entity-tag for the representation of the resource identified by 1789 the <a href="#header.location" class="smpl">Location</a> header field or, in case the Location header field was omitted, by the Effective Request URI (see <a href="p4-conditional.html#header.etag" title="ETag">Section 2.3</a> of <a href="#Part4" id="rfc.xref.Part4.1 1"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>).1795 the <a href="#header.location" class="smpl">Location</a> header field or, in case the Location header field was omitted, by the Effective Request URI (see <a href="p4-conditional.html#header.etag" title="ETag">Section 2.3</a> of <a href="#Part4" id="rfc.xref.Part4.12"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>). 1790 1796 </p> 1791 1797 <div id="rfc.iref.29"></div> … … 1867 1873 <li> 1868 1874 <p>Other kinds of redirection, such as to a cached result (status code <a href="p4-conditional.html#status.304" class="smpl">304 1869 (Not Modified)</a>, see <a href="p4-conditional.html#status.304" title="304 Not Modified">Section 4.1</a> of <a href="#Part4" id="rfc.xref.Part4.1 2"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>).1875 (Not Modified)</a>, see <a href="p4-conditional.html#status.304" title="304 Not Modified">Section 4.1</a> of <a href="#Part4" id="rfc.xref.Part4.13"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>). 1870 1876 </p> 1871 1877 </li> … … 2196 2202 <tr> 2197 2203 <td class="left">ETag</td> 2198 <td class="left"><a href="p4-conditional.html#header.etag" title="ETag">Section 2.3</a> of <a href="#Part4" id="rfc.xref.Part4.1 3"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>2204 <td class="left"><a href="p4-conditional.html#header.etag" title="ETag">Section 2.3</a> of <a href="#Part4" id="rfc.xref.Part4.14"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td> 2199 2205 </tr> 2200 2206 <tr> … … 4310 4316 <p id="rfc.section.F.2.p.2">Other changes: </p> 4311 4317 <ul> 4312 <li>Move definitions of 304 and 412 condition codes to <a href="#Part4" id="rfc.xref.Part4.1 4"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a>4318 <li>Move definitions of 304 and 412 condition codes to <a href="#Part4" id="rfc.xref.Part4.15"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a> 4313 4319 </li> 4314 4320 </ul> … … 5112 5118 </ul> 5113 5119 </li> 5114 <li><em>Part4</em> <a href="#rfc.xref.Part4.1">3.2</a>, <a href="#rfc.xref.Part4.2">3.2</a>, <a href="#rfc.xref.Part4.3">4.3.1</a>, <a href="#rfc.xref.Part4.4">5.2</a>, <a href="#rfc.xref.Part4.5">5.2</a>, <a href="#rfc.xref.Part4.6">5.2</a>, <a href="#rfc.xref.Part4.7">5.2</a>, <a href="#rfc.xref.Part4.8"> 6.1</a>, <a href="#rfc.xref.Part4.9">6.1</a>, <a href="#rfc.xref.Part4.10">6.1</a>, <a href="#rfc.xref.Part4.11">6.3.2</a>, <a href="#rfc.xref.Part4.12">6.4</a>, <a href="#rfc.xref.Part4.13">7</a>, <a href="#Part4"><b>15.1</b></a>, <a href="#rfc.xref.Part4.14">F.2</a><ul>5120 <li><em>Part4</em> <a href="#rfc.xref.Part4.1">3.2</a>, <a href="#rfc.xref.Part4.2">3.2</a>, <a href="#rfc.xref.Part4.3">4.3.1</a>, <a href="#rfc.xref.Part4.4">5.2</a>, <a href="#rfc.xref.Part4.5">5.2</a>, <a href="#rfc.xref.Part4.6">5.2</a>, <a href="#rfc.xref.Part4.7">5.2</a>, <a href="#rfc.xref.Part4.8">5.2</a>, <a href="#rfc.xref.Part4.9">6.1</a>, <a href="#rfc.xref.Part4.10">6.1</a>, <a href="#rfc.xref.Part4.11">6.1</a>, <a href="#rfc.xref.Part4.12">6.3.2</a>, <a href="#rfc.xref.Part4.13">6.4</a>, <a href="#rfc.xref.Part4.14">7</a>, <a href="#Part4"><b>15.1</b></a>, <a href="#rfc.xref.Part4.15">F.2</a><ul> 5115 5121 <li><em>Section 2.2</em> <a href="#rfc.xref.Part4.2">3.2</a></li> 5116 <li><em>Section 2.3</em> <a href="#rfc.xref.Part4.1">3.2</a>, <a href="#rfc.xref.Part4.1 1">6.3.2</a>, <a href="#rfc.xref.Part4.13">7</a></li>5117 <li><em>Section 3.1</em> <a href="#rfc.xref.Part4. 4">5.2</a></li>5118 <li><em>Section 3.2</em> <a href="#rfc.xref.Part4. 5">5.2</a></li>5119 <li><em>Section 3.3</em> <a href="#rfc.xref.Part4. 6">5.2</a></li>5120 <li><em>Section 3.4</em> <a href="#rfc.xref.Part4. 7">5.2</a></li>5121 <li><em>Section 4</em> <a href="#rfc.xref.Part4. 8">6.1</a></li>5122 <li><em>Section 4.1</em> <a href="#rfc.xref.Part4. 9">6.1</a>, <a href="#rfc.xref.Part4.12">6.4</a></li>5123 <li><em>Section 4.2</em> <a href="#rfc.xref.Part4.1 0">6.1</a></li>5122 <li><em>Section 2.3</em> <a href="#rfc.xref.Part4.1">3.2</a>, <a href="#rfc.xref.Part4.12">6.3.2</a>, <a href="#rfc.xref.Part4.14">7</a></li> 5123 <li><em>Section 3.1</em> <a href="#rfc.xref.Part4.5">5.2</a></li> 5124 <li><em>Section 3.2</em> <a href="#rfc.xref.Part4.6">5.2</a></li> 5125 <li><em>Section 3.3</em> <a href="#rfc.xref.Part4.7">5.2</a></li> 5126 <li><em>Section 3.4</em> <a href="#rfc.xref.Part4.8">5.2</a></li> 5127 <li><em>Section 4</em> <a href="#rfc.xref.Part4.9">6.1</a></li> 5128 <li><em>Section 4.1</em> <a href="#rfc.xref.Part4.10">6.1</a>, <a href="#rfc.xref.Part4.13">6.4</a></li> 5129 <li><em>Section 4.2</em> <a href="#rfc.xref.Part4.11">6.1</a></li> 5124 5130 </ul> 5125 5131 </li> -
draft-ietf-httpbis/latest/p2-semantics.xml
r1852 r1853 1135 1135 <x:anchor-alias value="request-header"/> 1136 1136 <t> 1137 The request header fields allow the client to pass additional 1138 information about the request, and about the client itself, to the 1139 server. These fields act as request modifiers, with semantics 1140 equivalent to the parameters on a programming language method 1141 invocation. 1137 A client sends request header fields to provide more information about 1138 the request context, make the request conditional based on the target 1139 resource state, suggest preferred formats for the response, supply 1140 authentication credentials, or modify the expected request processing. 1141 These fields act as request modifiers, similar to the parameters on a 1142 programming language method invocation. 1142 1143 </t> 1143 1144 <section title="Controls" anchor="request.controls"> 1145 <t> 1146 Controls are request header fields that direct specific handling of the 1147 request. 1148 </t> 1144 1149 <texttable align="left"> 1145 1150 <ttcol>Header Field Name</ttcol> … … 1154 1159 1155 1160 <section title="Conditionals" anchor="request.conditionals"> 1161 <t> 1162 Conditionals are request header fields that indicate a precondition to be 1163 tested before applying the method semantics to the target resource. 1164 Each precondition is based on metadata that is expected to change if the 1165 selected representation of the target resource is changed. The HTTP/1.1 1166 conditional request mechanisms are defined in <xref target="Part4"/>. 1167 </t> 1156 1168 <texttable align="left"> 1157 1169 <ttcol>Header Field Name</ttcol> … … 1188 1200 </section> 1189 1201 1190 <section title=" Information" anchor="request.inform">1202 <section title="Context" anchor="request.context"> 1191 1203 <texttable align="left"> 1192 1204 <ttcol>Header Field Name</ttcol>
Note: See TracChangeset
for help on using the changeset viewer.