Changeset 1571 for draft-ietf-httpbis


Ignore:
Timestamp:
09/03/12 09:35:34 (10 years ago)
Author:
fielding@…
Message:

#330 ETag and Last-Modified are metadata for the selected representation,
which is not always the same as the representation enclosed in the response.
Define those terms from p4 and use a separate table to referenve the fields.

Location:
draft-ietf-httpbis/latest
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • draft-ietf-httpbis/latest/p3-payload.html

    r1567 r1571  
    460460  }
    461461  @bottom-center {
    462        content: "Expires September 9, 2012";
     462       content: "Expires September 10, 2012";
    463463  }
    464464  @bottom-right {
    … …  
    511511      <meta name="dct.creator" content="Reschke, J. F.">
    512512      <meta name="dct.identifier" content="urn:ietf:id:draft-ietf-httpbis-p3-payload-latest">
    513       <meta name="dct.issued" scheme="ISO8601" content="2012-03-08">
     513      <meta name="dct.issued" scheme="ISO8601" content="2012-03-09">
    514514      <meta name="dct.replaces" content="urn:ietf:rfc:2616">
    515515      <meta name="dct.abstract" content="The Hypertext Transfer Protocol (HTTP) is an application-level protocol for distributed, collaborative, hypertext information systems. HTTP has been in use by the World Wide Web global information initiative since 1990. This document is Part 3 of the seven-part specification that defines the protocol referred to as &#34;HTTP/1.1&#34; and, taken together, obsoletes RFC 2616. Part 3 defines HTTP message content, metadata, and content negotiation.">
    … …  
    537537            </tr>
    538538            <tr>
    539                <td class="left">Expires: September 9, 2012</td>
     539               <td class="left">Expires: September 10, 2012</td>
    540540               <td class="right">J. Mogul</td>
    541541            </tr>
    … …  
    594594            <tr>
    595595               <td class="left"></td>
    596                <td class="right">March 8, 2012</td>
     596               <td class="right">March 9, 2012</td>
    597597            </tr>
    598598         </tbody>
    … …  
    622622         in progress”.
    623623      </p>
    624       <p>This Internet-Draft will expire on September 9, 2012.</p>
     624      <p>This Internet-Draft will expire on September 10, 2012.</p>
    625625      <h1><a id="rfc.copyrightnotice" href="#rfc.copyrightnotice">Copyright Notice</a></h1>
    626626      <p>Copyright © 2012 IETF Trust and the persons identified as the document authors. All rights reserved.</p>
    … …  
    764764         </li>
    765765      </ul>
     766      <p id="rfc.section.1.1.p.3"> <span id="rfc.iref.s.1"></span>  <dfn>selected representation</dfn> 
     767      </p>
     768      <ul class="empty">
     769         <li>The current representation of the target resource that would have been selected in a successful response if the same request
     770            had used the method GET and excluded any conditional request header fields.
     771         </li>
     772      </ul>
    766773      <h2 id="rfc.section.1.2"><a href="#rfc.section.1.2">1.2</a>&nbsp;<a id="intro.conformance.and.error.handling" href="#intro.conformance.and.error.handling">Conformance and Error Handling</a></h2>
    767774      <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"
    … …  
    10181025                  <td class="left"><a href="p6-cache.html#header.expires" title="Expires">Section 3.3</a> of <a href="#Part6" id="rfc.xref.Part6.1"><cite title="HTTP/1.1, part 6: Caching">[Part6]</cite></a></td>
    10191026               </tr>
     1027            </tbody>
     1028         </table>
     1029      </div>
     1030      <p id="rfc.section.4.1.p.3">Additional header fields define metadata about the selected representation, which might differ from the representation included
     1031         in the message for responses to some state-changing methods. The following header fields are defined as selected representation
     1032         metadata:
     1033      </p>
     1034      <div id="rfc.table.u.3">
     1035         <table class="tt full left" cellpadding="3" cellspacing="0">
     1036            <thead>
     1037               <tr>
     1038                  <th>Header Field Name</th>
     1039                  <th>Defined in...</th>
     1040               </tr>
     1041            </thead>
     1042            <tbody>
     1043               <tr>
     1044                  <td class="left">ETag</td>
     1045                  <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"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
     1046               </tr>
    10201047               <tr>
    10211048                  <td class="left">Last-Modified</td>
    1022                   <td class="left"><a href="p4-conditional.html#header.last-modified" title="Last-Modified">Section 2.2</a> of <a href="#Part4" id="rfc.xref.Part4.1"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
     1049                  <td class="left"><a href="p4-conditional.html#header.last-modified" title="Last-Modified">Section 2.2</a> of <a href="#Part4" id="rfc.xref.Part4.2"><cite title="HTTP/1.1, part 4: Conditional Requests">[Part4]</cite></a></td>
    10231050               </tr>
    10241051            </tbody>
    … …  
    11961223          text/html;level=2;q=0.4, */*;q=0.5
    11971224</pre><p id="rfc.section.6.1.p.18">would cause the following values to be associated:</p>
    1198       <div id="rfc.table.u.3">
     1225      <div id="rfc.table.u.4">
    11991226         <table class="tt full left" cellpadding="3" cellspacing="0">
    12001227            <thead>
    … …  
    14111438         server is informing recipients that this representation has its own, presumably more specific, identifier. For a GET or HEAD
    14121439         request, this is an indication that the effective request URI identifies a resource that is subject to content negotiation
    1413          and the representation selected for this response can also be found at the identified URI. For other methods, such a Content-Location
     1440         and the selected representation for this response can also be found at the identified URI. For other methods, such a Content-Location
    14141441         indicates that this representation contains a report on the action's status and the same report is available (for future access
    14151442         with GET) at the given URI. For example, a purchase transaction made via a POST request might include a receipt document as
    … …  
    21612188      </ul>
    21622189      <h1 id="rfc.index"><a href="#rfc.index">Index</a></h1>
    2163       <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>
     2190      <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>
    21642191      </p>
    21652192      <div class="print2col">
    … …  
    22702297                     </ul>
    22712298                  </li>
    2272                   <li><em>Part4</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.1">4.1</a>, <a href="#Part4"><b>10.1</b></a><ul>
    2273                         <li><em>Section 2.2</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.1">4.1</a></li>
     2299                  <li><em>Part4</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.1">4.1</a>, <a href="#rfc.xref.Part4.2">4.1</a>, <a href="#Part4"><b>10.1</b></a><ul>
     2300                        <li><em>Section 2.2</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.2">4.1</a></li>
     2301                        <li><em>Section 2.3</em>&nbsp;&nbsp;<a href="#rfc.xref.Part4.1">4.1</a></li>
    22742302                     </ul>
    22752303                  </li>
    … …  
    23432371               </ul>
    23442372            </li>
     2373            <li><a id="rfc.index.S" href="#rfc.index.S"><b>S</b></a><ul>
     2374                  <li>selected representation&nbsp;&nbsp;<a href="#rfc.iref.s.1"><b>1.1</b></a></li>
     2375               </ul>
     2376            </li>
    23452377         </ul>
    23462378      </div>

  • draft-ietf-httpbis/latest/p3-payload.xml

    r1567 r1571  
    2626  <!ENTITY header-content-length    "<xref target='Part1' x:rel='#header.content-length' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    2727  <!ENTITY header-content-range     "<xref target='Part5' x:rel='#header.content-range' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
     28  <!ENTITY header-etag              "<xref target='Part4' x:rel='#header.etag' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    2829  <!ENTITY header-expires           "<xref target='Part6' x:rel='#header.expires' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    2930  <!ENTITY header-last-modified     "<xref target='Part4' x:rel='#header.last-modified' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    … …  
    269270  </list>
    270271</t>
     272<t>
     273  <iref primary="true" item="selected representation"/>
     274  <x:dfn>selected representation</x:dfn>
     275  <list>
     276    <t>
     277      The current representation of the target resource that would have been
     278      selected in a successful response if the same request had used the
     279      method GET and excluded any conditional request header fields.
     280    </t>
     281  </list>
     282</t>
    271283</section>
    272284
    … …  
    709721  <c>Content-Type</c> <c><xref target="header.content-type"/></c>
    710722  <c>Expires</c> <c>&header-expires;</c>
     723</texttable>
     724<t>
     725   Additional header fields define metadata about the selected
     726   representation, which might differ from the representation included
     727   in the message for responses to some state-changing methods.
     728   The following header fields are defined as selected representation
     729   metadata:
     730</t>
     731<texttable align="left">
     732  <ttcol>Header Field Name</ttcol>
     733  <ttcol>Defined in...</ttcol>
     734
     735  <c>ETag</c> <c>&header-etag;</c>
    711736  <c>Last-Modified</c> <c>&header-last-modified;</c>
    712737</texttable>
    … …  
    14001425   more specific, identifier.  For a GET or HEAD request, this is an
    14011426   indication that the effective request URI identifies a resource that
    1402    is subject to content negotiation and the representation selected for
     1427   is subject to content negotiation and the selected representation for
    14031428   this response can also be found at the identified URI.  For other
    14041429   methods, such a Content-Location indicates that this representation
Note: See TracChangeset for help on using the changeset viewer.