Skip to content

Commit 3f91d4c

Browse files
committed
QUERY: caching - mention GET alternative wrt caching (addresses #3120)
1 parent 64de84b commit 3f91d4c

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

draft-ietf-httpbis-safe-method-w-body.xml

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -434,7 +434,8 @@ q=foo&limit=10&sort=-published
434434
</t>
435435
<t>
436436
The cache key for a QUERY request (see <xref target="HTTP-CACHING" section="2"/>) &MUST;
437-
incorporate the request content.
437+
incorporate the request content (<xref target="HTTP-CACHING" section="6"/>) and related
438+
metadata (<xref target="HTTP-CACHING" section="8"/>).
438439
</t>
439440
<t>
440441
Caches <bcp14>MAY</bcp14> remove semantically insignificant differences first, thereby
@@ -460,6 +461,13 @@ q=foo&amp;limit=10&amp;sort=-published
460461
that they wish that no such transformation happens (but note that this directive is just
461462
advisory).
462463
</t>
464+
<t>
465+
Note that caching QUERY method responses is inherently more complex than caching responses
466+
to GET, as complete reading of the request's content is needed in order to determine
467+
the cache key. If a QUERY response supplies a Location response field (<xref target="location"/>)
468+
to indicate a URI for an equivalent resource (<xref target="equivalent-resource"/>), clients
469+
can switch to GET for subsequent requests, thereby simplifying processing.
470+
</t>
463471
</section>
464472

465473
<section title="Range Requests" anchor="range">

0 commit comments

Comments
 (0)