innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

[4.0.x] Used :rfc: role in docs/topics/conditional-view-processing.txt. 

Backport of f8bab4e0dc from main
This commit is contained in:
Mariusz Felisiak 2021-09-21 06:28:28 +02:00
parent a077f10df4
commit f426df268b
1 changed files with 8 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
docs/topics/conditional-view-processing.txt
View File

@ -34,14 +34,12 @@ processing functions.
The ``condition`` decorator
===========================
Sometimes (in fact, quite often) you can create functions to rapidly compute the ETag_
value or the last-modified time for a resource, **without** needing to do all
the computations needed to construct the full view. Django can then use these
functions to provide an "early bailout" option for the view processing.
Telling the client that the content has not been modified since the last
request, perhaps.
.. _ETag: https://tools.ietf.org/html/rfc7232#section-2.3
Sometimes (in fact, quite often) you can create functions to rapidly compute
the :rfc:`ETag <7232#section-2.3>` value or the last-modified time for a
resource, **without** needing to do all the computations needed to construct
the full view. Django can then use these functions to provide an
"early bailout" option for the view processing. Telling the client that the
content has not been modified since the last request, perhaps.
These two functions are passed as parameters to the
``django.views.decorators.http.condition`` decorator. This decorator uses
@ -60,7 +58,8 @@ order, as the view function they are helping to wrap. The function passed
``last_modified_func`` should return a standard datetime value specifying the
last time the resource was modified, or ``None`` if the resource doesn't
exist. The function passed to the ``etag`` decorator should return a string
representing the `ETag`_ for the resource, or ``None`` if it doesn't exist.
representing the :rfc:`ETag <7232#section-2.3>` for the resource, or ``None``
if it doesn't exist.
The decorator sets the ``ETag`` and ``Last-Modified`` headers on the response
if they are not already set by the view and if the request's method is safe