Changeset 1728 for draft-ietf-httpbis


Ignore:
Timestamp:
05/07/12 17:20:04 (8 years ago)
Author:
julian.reschke@…
Message:

add idempotency to the registration fields for new methods (see #364)

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

Legend:

Unmodified
Added
Removed

  • draft-ietf-httpbis/latest/extract-method-defs.xslt

    r1561 r1728  
    1313      <ttcol>Method</ttcol>
    1414      <ttcol>Safe</ttcol>
     15      <ttcol>Idempotent</ttcol>
    1516      <ttcol>Reference</ttcol>
    1617      <xsl:apply-templates select="//section[iref/@item='Methods']">
    … …  
    8485  </xsl:variable>
    8586
     87  <xsl:variable name="idempotent" xmlns:p2="urn:ietf:id:draft-ietf-httpbis-p2-semantics#">
     88    <xsl:choose>
     89      <xsl:when test="rdf:Description/p2:idempotent='yes'">yes</xsl:when>
     90      <xsl:otherwise>no</xsl:otherwise>
     91    </xsl:choose>
     92  </xsl:variable>
     93
    8694  <xsl:text>&#10;</xsl:text>
    8795  <c><xsl:value-of select="$text"/></c>
    8896  <c><xsl:value-of select="$safe"/></c>
     97  <c><xsl:value-of select="$idempotent"/></c>
    8998  <c><xref target="{@anchor}"/></c>
    9099</xsl:template>

  • draft-ietf-httpbis/latest/p2-semantics.html

    r1727 r1728  
    922922         <li>Safe ("yes" or "no", see <a href="#safe.methods" title="Safe Methods">Section&nbsp;2.1.1</a>)
    923923         </li>
     924         <li>Idempotent ("yes" or "no", see <a href="#safe.methods" title="Safe Methods">Section&nbsp;2.1.1</a>)
     925         </li>
    924926         <li>Pointer to specification text</li>
    925927      </ul>
    … …  
    10311033      <p id="rfc.section.2.3.4.p.6">Note that POST caching is not widely implemented. However, the <a href="#status.303" class="smpl">303 (See Other)</a> response can be used to direct the user agent to retrieve a cacheable representation of the resource.
    10321034      </p>
     1035      <h3 id="rfc.section.2.3.5"><a href="#rfc.section.2.3.5">2.3.5</a>&nbsp;<a id="PUT" href="#PUT">PUT</a></h3>
    10331036      <div id="rfc.iref.p.2"></div>
    10341037      <div id="rfc.iref.m.5"></div>
    1035       <h3 id="rfc.section.2.3.5"><a href="#rfc.section.2.3.5">2.3.5</a>&nbsp;<a id="PUT" href="#PUT">PUT</a></h3>
    10361038      <p id="rfc.section.2.3.5.p.1">The PUT method requests that the state of the target resource be created or replaced with the state defined by the representation
    10371039         enclosed in the request message payload. A successful PUT of a given representation would suggest that a subsequent GET on
    … …  
    10901092         for the effective request URI, those stored responses will be invalidated (see <a href="p6-cache.html#invalidation.after.updates.or.deletions" title="Request Methods that Invalidate">Section 2.6</a> of <a href="#Part6" id="rfc.xref.Part6.5"><cite title="HTTP/1.1, part 6: Caching">[Part6]</cite></a>).
    10911093      </p>
     1094      <h3 id="rfc.section.2.3.6"><a href="#rfc.section.2.3.6">2.3.6</a>&nbsp;<a id="DELETE" href="#DELETE">DELETE</a></h3>
    10921095      <div id="rfc.iref.d.1"></div>
    10931096      <div id="rfc.iref.m.6"></div>
    1094       <h3 id="rfc.section.2.3.6"><a href="#rfc.section.2.3.6">2.3.6</a>&nbsp;<a id="DELETE" href="#DELETE">DELETE</a></h3>
    10951097      <p id="rfc.section.2.3.6.p.1">The DELETE method requests that the origin server delete the target resource. This method <em class="bcp14">MAY</em> be overridden by human intervention (or other means) on the origin server. The client cannot be guaranteed that the operation
    10961098         has been carried out, even if the status code returned from the origin server indicates that the action has been completed
    … …  
    31083110                  <th>Method</th>
    31093111                  <th>Safe</th>
     3112                  <th>Idempotent</th>
    31103113                  <th>Reference</th>
    31113114               </tr>
    … …  
    31153118                  <td class="left">CONNECT</td>
    31163119                  <td class="left">no</td>
     3120                  <td class="left">no</td>
    31173121                  <td class="left"> <a href="#CONNECT" id="rfc.xref.CONNECT.1" title="CONNECT">Section&nbsp;2.3.8</a>
    31183122                  </td>
    … …  
    31213125                  <td class="left">DELETE</td>
    31223126                  <td class="left">no</td>
     3127                  <td class="left">yes</td>
    31233128                  <td class="left"> <a href="#DELETE" id="rfc.xref.DELETE.1" title="DELETE">Section&nbsp;2.3.6</a>
    31243129                  </td>
    … …  
    31273132                  <td class="left">GET</td>
    31283133                  <td class="left">yes</td>
     3134                  <td class="left">yes</td>
    31293135                  <td class="left"> <a href="#GET" id="rfc.xref.GET.1" title="GET">Section&nbsp;2.3.2</a>
    31303136                  </td>
    … …  
    31333139                  <td class="left">HEAD</td>
    31343140                  <td class="left">yes</td>
     3141                  <td class="left">yes</td>
    31353142                  <td class="left"> <a href="#HEAD" id="rfc.xref.HEAD.1" title="HEAD">Section&nbsp;2.3.3</a>
    31363143                  </td>
    … …  
    31393146                  <td class="left">OPTIONS</td>
    31403147                  <td class="left">yes</td>
     3148                  <td class="left">yes</td>
    31413149                  <td class="left"> <a href="#OPTIONS" id="rfc.xref.OPTIONS.2" title="OPTIONS">Section&nbsp;2.3.1</a>
    31423150                  </td>
    … …  
    31453153                  <td class="left">POST</td>
    31463154                  <td class="left">no</td>
     3155                  <td class="left">no</td>
    31473156                  <td class="left"> <a href="#POST" id="rfc.xref.POST.1" title="POST">Section&nbsp;2.3.4</a>
    31483157                  </td>
    … …  
    31513160                  <td class="left">PUT</td>
    31523161                  <td class="left">no</td>
     3162                  <td class="left">yes</td>
    31533163                  <td class="left"> <a href="#PUT" id="rfc.xref.PUT.1" title="PUT">Section&nbsp;2.3.5</a>
    31543164                  </td>
    … …  
    31563166               <tr>
    31573167                  <td class="left">TRACE</td>
     3168                  <td class="left">yes</td>
    31583169                  <td class="left">yes</td>
    31593170                  <td class="left"> <a href="#TRACE" id="rfc.xref.TRACE.2" title="TRACE">Section&nbsp;2.3.7</a>
    … …  
    47274738         </li>
    47284739         <li> &lt;<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/361">http://tools.ietf.org/wg/httpbis/trac/ticket/361</a>&gt;: "ABNF requirements for recipients"
     4740         </li>
     4741         <li> &lt;<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/364">http://tools.ietf.org/wg/httpbis/trac/ticket/364</a>&gt;: "Capturing more information in the method registry"
    47294742         </li>
    47304743      </ul>

  • draft-ietf-httpbis/latest/p2-semantics.xml

    r1727 r1728  
    454454    <t>Method Name (see <xref target="methods"/>)</t>
    455455    <t>Safe ("yes" or "no", see <xref target="safe.methods"/>)</t>
     456    <t>Idempotent ("yes" or "no", see <xref target="safe.methods"/>)</t>
    456457    <t>Pointer to specification text</t>
    457458  </list>
    … …  
    502503  <rdf:Description>
    503504    <safe xmlns="urn:ietf:id:draft-ietf-httpbis-p2-semantics#">yes</safe>
     505    <idempotent xmlns="urn:ietf:id:draft-ietf-httpbis-p2-semantics#">yes</idempotent>
    504506  </rdf:Description>
    505507  <iref primary="true" item="OPTIONS method" x:for-anchor=""/>
    … …  
    562564  <rdf:Description>
    563565    <safe xmlns="urn:ietf:id:draft-ietf-httpbis-p2-semantics#">yes</safe>
     566    <idempotent xmlns="urn:ietf:id:draft-ietf-httpbis-p2-semantics#">yes</idempotent>
    564567  </rdf:Description>
    565568  <iref primary="true" item="GET method" x:for-anchor=""/>
    … …  
    610613  <rdf:Description>
    611614    <safe xmlns="urn:ietf:id:draft-ietf-httpbis-p2-semantics#">yes</safe>
     615    <idempotent xmlns="urn:ietf:id:draft-ietf-httpbis-p2-semantics#">yes</idempotent>
    612616  </rdf:Description>
    613617  <iref primary="true" item="HEAD method" x:for-anchor=""/>
    … …  
    692696
    693697<section title="PUT" anchor="PUT">
     698  <rdf:Description>
     699    <idempotent xmlns="urn:ietf:id:draft-ietf-httpbis-p2-semantics#">yes</idempotent>
     700  </rdf:Description>
    694701  <iref primary="true" item="PUT method" x:for-anchor=""/>
    695702  <iref primary="true" item="Methods" subitem="PUT" x:for-anchor=""/>
    … …  
    814821
    815822<section title="DELETE" anchor="DELETE">
     823  <rdf:Description>
     824    <idempotent xmlns="urn:ietf:id:draft-ietf-httpbis-p2-semantics#">yes</idempotent>
     825  </rdf:Description>
    816826  <iref primary="true" item="DELETE method" x:for-anchor=""/>
    817827  <iref primary="true" item="Methods" subitem="DELETE" x:for-anchor=""/>
    … …  
    849859  <rdf:Description>
    850860    <safe xmlns="urn:ietf:id:draft-ietf-httpbis-p2-semantics#">yes</safe>
     861    <idempotent xmlns="urn:ietf:id:draft-ietf-httpbis-p2-semantics#">yes</idempotent>
    851862  </rdf:Description>
    852863  <iref primary="true" item="TRACE method" x:for-anchor=""/>
    … …  
    39833994   <ttcol>Method</ttcol>
    39843995   <ttcol>Safe</ttcol>
     3996   <ttcol>Idempotent</ttcol>
    39853997   <ttcol>Reference</ttcol>
    39863998   <c>CONNECT</c>
     3999   <c>no</c>
    39874000   <c>no</c>
    39884001   <c>
    … …  
    39914004   <c>DELETE</c>
    39924005   <c>no</c>
     4006   <c>yes</c>
    39934007   <c>
    39944008      <xref target="DELETE"/>
    39954009   </c>
    39964010   <c>GET</c>
     4011   <c>yes</c>
    39974012   <c>yes</c>
    39984013   <c>
    … …  
    40014016   <c>HEAD</c>
    40024017   <c>yes</c>
     4018   <c>yes</c>
    40034019   <c>
    40044020      <xref target="HEAD"/>
    40054021   </c>
    40064022   <c>OPTIONS</c>
     4023   <c>yes</c>
    40074024   <c>yes</c>
    40084025   <c>
    … …  
    40114028   <c>POST</c>
    40124029   <c>no</c>
     4030   <c>no</c>
    40134031   <c>
    40144032      <xref target="POST"/>
    … …  
    40164034   <c>PUT</c>
    40174035   <c>no</c>
     4036   <c>yes</c>
    40184037   <c>
    40194038      <xref target="PUT"/>
    40204039   </c>
    40214040   <c>TRACE</c>
     4041   <c>yes</c>
    40224042   <c>yes</c>
    40234043   <c>
    … …  
    68276847      "ABNF requirements for recipients"
    68286848    </t>
     6849    <t>
     6850      <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/364"/>:
     6851      "Capturing more information in the method registry"
     6852    </t>
    68296853  </list>
    68306854</t>
Note: See TracChangeset for help on using the changeset viewer.