Changeset 800 for draft-ietf-httpbis/latest/p4-conditional.xml
- Timestamp:
- 01/04/10 13:37:58 (12 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
draft-ietf-httpbis/latest/p4-conditional.xml
r799 r800 21 21 <!ENTITY messaging "<xref target='Part1' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> 22 22 <!ENTITY caching "<xref target='Part6' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> 23 <!ENTITY header-accept-encoding "<xref target='Part3' x:rel='#header.accept-encoding' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> 23 24 <!ENTITY header-if-range "<xref target='Part5' x:rel='#header.if-range' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> 24 25 <!ENTITY header-range "<xref target='Part5' x:rel='#header.range' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> … … 26 27 <!ENTITY clockless "<xref target='Part1' x:rel='#clockless.origin.server.operation' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> 27 28 <!ENTITY full-date "<xref target='Part1' x:rel='#date.time.formats.full.date' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> 29 <!ENTITY transfer-codings "<xref target='Part1' x:rel='#transfer.codings' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> 30 <!ENTITY content-negotiation "<xref target='Part3' x:rel='#content.negotiation' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> 28 31 ]> 29 32 <?rfc toc="yes" ?> … … 340 343 entities. 341 344 </t> 345 346 <section title="Example: Entity Tags varying on Content-Negotiated Resources" anchor="example.entity.tag.vs.conneg"> 347 <t> 348 Consider a resource that is subject to content negotiation (&content-negotiation;), 349 and where the representations returned upon a GET request vary based on 350 the Accept-Encoding request header field (&header-accept-encoding;): 351 </t> 352 <figure><preamble>>> Request:</preamble><artwork type="message/http; msgtype="request"" x:indent-with=" "> 353 GET /index HTTP/1.1 354 Host: www.example.com 355 Accept-Encoding: gzip 356 357 </artwork></figure> 358 <t> 359 In this case, the response may use the gzip Content Coding or not. 360 If it does, it might look like that: 361 </t> 362 <figure><preamble>>> Response:</preamble><artwork type="message/http; msgtype="response"" x:indent-with=" "> 363 HTTP/1.1 200 OK 364 Date: Thu, 26 Mar 2010 00:05:00 GMT 365 ETag: "123-a" 366 Content-Length: <x:length-of target="exbody"/> 367 Vary: Accept-Encoding 368 Content-Type: text/plain 369 370 <x:span anchor="exbody">Hello World! 371 Hello World! 372 Hello World! 373 Hello World! 374 Hello World! 375 </x:span></artwork></figure> 376 <t> 377 A variant that does use gzip Content Coding would be: 378 </t> 379 <figure><preamble>>> Response:</preamble><artwork type="message/http; msgtype="response"" x:indent-with=" "> 380 HTTP/1.1 200 OK 381 Date: Thu, 26 Mar 2010 00:05:00 GMT 382 ETag: "123-b" 383 Content-Length: 43 384 Vary: Accept-Encoding 385 Content-Type: text/plain 386 Content-Encoding: gzip 387 388 <spanx>...binary data...</spanx></artwork></figure> 389 <x:note> 390 <t> 391 <x:h>Note:</x:h> Content Codings are a property of the response 392 entity, thus affect the Entity Tag. An alternative are Transfer 393 Codings (&transfer-codings;) which apply only to the transfer of 394 the message, and thus do not require assigning distinct entity tags. 395 </t> 396 </x:note> 397 </section> 342 398 </section> 343 399 … … 1200 1256 </reference> 1201 1257 1258 <reference anchor="Part3"> 1259 <front> 1260 <title abbrev="HTTP/1.1">HTTP/1.1, part 3: Message Payload and Content Negotiation</title> 1261 <author initials="R." surname="Fielding" fullname="Roy T. Fielding" role="editor"> 1262 <organization abbrev="Day Software">Day Software</organization> 1263 <address><email>fielding@gbiv.com</email></address> 1264 </author> 1265 <author initials="J." surname="Gettys" fullname="Jim Gettys"> 1266 <organization>One Laptop per Child</organization> 1267 <address><email>jg@laptop.org</email></address> 1268 </author> 1269 <author initials="J." surname="Mogul" fullname="Jeffrey C. Mogul"> 1270 <organization abbrev="HP">Hewlett-Packard Company</organization> 1271 <address><email>JeffMogul@acm.org</email></address> 1272 </author> 1273 <author initials="H." surname="Frystyk" fullname="Henrik Frystyk Nielsen"> 1274 <organization abbrev="Microsoft">Microsoft Corporation</organization> 1275 <address><email>henrikn@microsoft.com</email></address> 1276 </author> 1277 <author initials="L." surname="Masinter" fullname="Larry Masinter"> 1278 <organization abbrev="Adobe Systems">Adobe Systems, Incorporated</organization> 1279 <address><email>LMM@acm.org</email></address> 1280 </author> 1281 <author initials="P." surname="Leach" fullname="Paul J. Leach"> 1282 <organization abbrev="Microsoft">Microsoft Corporation</organization> 1283 <address><email>paulle@microsoft.com</email></address> 1284 </author> 1285 <author initials="T." surname="Berners-Lee" fullname="Tim Berners-Lee"> 1286 <organization abbrev="W3C/MIT">World Wide Web Consortium</organization> 1287 <address><email>timbl@w3.org</email></address> 1288 </author> 1289 <author initials="Y." surname="Lafon" fullname="Yves Lafon" role="editor"> 1290 <organization abbrev="W3C">World Wide Web Consortium</organization> 1291 <address><email>ylafon@w3.org</email></address> 1292 </author> 1293 <author initials="J. F." surname="Reschke" fullname="Julian F. Reschke" role="editor"> 1294 <organization abbrev="greenbytes">greenbytes GmbH</organization> 1295 <address><email>julian.reschke@greenbytes.de</email></address> 1296 </author> 1297 <date month="&ID-MONTH;" year="&ID-YEAR;"/> 1298 </front> 1299 <seriesInfo name="Internet-Draft" value="draft-ietf-httpbis-p3-payload-&ID-VERSION;"/> 1300 <x:source href="p3-payload.xml" basename="p3-payload"/> 1301 </reference> 1302 1202 1303 <reference anchor="Part5"> 1203 1304 <front>
Note: See TracChangeset
for help on using the changeset viewer.