Django fournit plusieurs décorateurs afin de permettre aux vues de prendre en charge différentes fonctionnalités HTTP.
\nVoir Décoration de la classe pour savoir comment utiliser ces décorateurs avec les vues fondées sur des classes.
\nLes 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.
Décorateur exigeant que l’accès à une vue se fasse via certaines méthodes HTTP seulement. Exemple :
\nfrom django.views.decorators.http import require_http_methods\n\n\n@require_http_methods(["GET", "POST"])\ndef my_view(request):\n # I can assume now that only GET or POST requests make it this far\n # ...\n pass\nRemarquez que les noms de méthodes HTTP doivent être en majuscules.
\nDécorateur exigeant que la vue n’accepte que la méthode GET.
\nDécorateur exigeant que la vue n’accepte que la méthode POST.
\nDé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.
\n\nLes décorateurs suivants présents dans django.views.decorators.http peuvent être utilisés pour contrôler le comportement du cache sur certaines vues.
Ces décorateurs peuvent être utilisés pour générer des en-têtes ETag et Last-Modified. Voir traitement conditionnel de vue.
Les décorateurs présents dans django.views.decorators.gzip contrôlent la compression du contenu vue par vue.
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.
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.
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.
Les décorateurs présents dans django.views.decorators.cache contrôlent la mise en cache aux niveaux serveur et client.
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.
Ce décorateur ajoute un en-tête Expires à la date actuelle.
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.
Chaque en-tête n’est ajouté que s’il n’est pas déjà présent.
\nLes décorateurs dans django.views.decorators.common permettent une personnalisation par vue du comportement de l’intergiciel CommonMiddleware.
Ce décorateur permet à des vues individuelles d’être exclues de la normalisation des URL par APPEND_SLASH.