Décorateurs de vueLien vers cette rubrique#

Méthodes HTTP autoriséesLien vers cette rubrique#

Les décorateurs présents dans django.views.decorators.http peuvent être utilisés pour restreindre l’accès à une vue en se basant sur la méthode utilisée lors de la requête. Ces décorateurs renvoient une instance de django.http.HttpResponseNotAllowed si les conditions ne sont pas remplies.

require_http_methods(request_method_list)Lien vers cette définition#

Décorateur exigeant que l’accès à une vue se fasse via certaines méthodes HTTP seulement. Exemple :

Code

from django.views.decorators.http import require_http_methods

@require_http_methods(["GET", "POST"])
def my_view(request):
    # I can assume now that only GET or POST requests make it this far
    # ...
    pass

Remarquez que les noms de méthodes HTTP doivent être en majuscules.

require_GET()Lien vers cette définition#

Décorateur exigeant que la vue n’accepte que la méthode GET.

require_POST()Lien vers cette définition#

Décorateur exigeant que la vue n’accepte que la méthode POST.

require_safe()Lien vers cette définition#

Décorateur exigeant que la vue n’accepte que les méthodes GET et HEAD. Ces méthodes sont généralement considérées « sans risque » car elles ne devraient rien faire d’autre mis à part retourner la ressource demandée.

Traitement conditionnel de vueLien vers cette rubrique#

Les décorateurs suivants présents dans django.views.decorators.http peuvent être utilisés pour contrôler le comportement du cache sur certaines vues.

condition(etag_func=None, last_modified_func=None)Lien vers cette définition#

etag(etag_func)Lien vers cette définition#

last_modified(last_modified_func)Lien vers cette définition#

Ces décorateurs peuvent être utilisés pour générer des en-têtes ETag et Last-Modified. Voir traitement conditionnel de vue.

Compression GZipLien vers cette rubrique#

Les décorateurs présents dans django.views.decorators.gzip contrôlent la compression du contenu vue par vue.

gzip_page()Lien vers cette définition#

Ce décorateur compresse le contenu si le navigateur autorise la compression gzip. Il déclare l’en-tête Vary en conséquence, de façon à ce que la mise en cache dépende de l’en-tête Accept-Encoding.

En-têtes VaryLien vers cette rubrique#

Les décorateurs présents dans django.views.decorators.vary peuvent être utilisés pour contrôler la mise en cache reposant sur certains en-têtes des requêtes.

vary_on_cookie(func)Lien vers cette définition#

vary_on_headers(*headers)Lien vers cette définition#

L’en-tête Vary définit quels en-têtes de requête un mécanisme de cache doit prendre en considération pour générer sa clé de cache.

Voir utilisation des en-têtes vary.

Mise en cacheLien vers cette rubrique#

Les décorateurs présents dans django.views.decorators.cache contrôlent la mise en cache aux niveaux serveur et client.

cache_control(**kwargs)Lien vers cette définition#

Ce décorateur complète l’en-tête Cache-Control de la réponse en y ajoutant tous les paramètres nommés. Voir patch_cache_control() pour les détails sur la transformation.

never_cache(view_func)Lien vers cette définition#

Ce décorateur ajoute un en-tête Cache-Control: max-age=0, no-cache, no-store, must-revalidate, private à une réponse pour indiquer que la page ne doit jamais être mise en cache.

CommunsLien vers cette rubrique#

Les décorateurs dans django.views.decorators.common permettent une personnalisation par vue du comportement de l’intergiciel CommonMiddleware.

no_append_slash()Lien vers cette définition#

Ce décorateur permet à des vues individuelles d’être exclues de la normalisation des URL par APPEND_SLASH.