Les trois classes suivantes fournissent la plupart des fonctionnalités nécessaires à la création de vues Django. Vous pouvez les considérer comme des vues parentes qui peuvent être utilisées telles quelles ou comme classe parente. Elles ne contiennent pas toutes les fonctionnalités requises par les projets, c’est pour cela qu’il y a des vues basées sur des classes de type Mixin et d’autres génériques.
La plupart des vues fondées sur les classes intégrées à Django héritent d’autres vues fondées sur les classes ou de différentes classes mixin. En raison de l’importance de cette chaîne d’héritage, les classes parentes sont documentées sous la section Ancêtres (MRO). MRO est un acronyme pour Method Resolution Order (ordre de résolution des méthodes).
\nViewLien vers cette rubrique#La principale vue basée sur des classes. Toutes les autres héritent de cette classe de base. Il ne s’agit pas strictement d’une vue générique et elle peut donc être importée à partir de django.views.
Index des méthodes
\n\nExemple de fichier views.py:
\nfrom django.http import HttpResponse\nfrom django.views import View\n\nclass MyView(View):\n\n def get(self, request, *args, **kwargs):\n return HttpResponse('Hello, World!')\nExemple de fichier urls.py:
\nfrom django.urls import path\n\nfrom myapp.views import MyView\n\nurlpatterns = [\n path('mine/', MyView.as_view(), name='my-view'),\n]\nAttributs
\nLa liste des noms de méthodes HTTP que cette vue accepte.
\nValeur par défaut :
\n['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace']\nMéthodes
\nRenvoie une vue exécutable acceptant une requête et renvoyant une réponse :
\nresponse = MyView.as_view()(request)\nLa vue renvoyée possède les attributs view_class et view_initkwargs.
Lorsque la vue est appelée pendant le cycle requête/réponse, l’attribut request de la vue correspond à l’objet HttpRequest. Tout paramètre positionnel ou nommé capturé à partir du motif d’URL est accessible par les attributs args et kwargs de la vue. Puis, dispatch() est appelée.
La partie view de la vue, la méthode qui accepte un paramètre request ainsi que d’autres paramètres et qui renvoie une réponse HTTP.
L’implémentation par défaut examine la méthode HTTP et essaie de déléguer l’exécution à une méthode qui correspond à la méthode HTTP ; une requête GET sera déléguée à get(), une requête POST à post(), et ainsi de suite.
Par défaut, une requête HEAD sera déléguée à get(). Si vous avez besoin de traiter différemment les requêtes HEAD, vous pouvez surcharger la méthode head(). Voir l’exemple dans Prise en charge de méthodes HTTP alternatives.
Si la vue a été appelée par une méthode HTTP qu’elle ne prend pas en charge, c’est cette méthode qui sera appelée.
\nL’implémentation par défaut renvoie HttpResponseNotAllowed avec une liste de méthodes autorisées en texte brut.
Traite la réponse aux requêtes du verbe HTTP OPTIONS. Renvoie une réponse avec l’en-tête Allow contenant une liste des noms de méthodes HTTP autorisées pour la vue.
TemplateViewLien vers cette rubrique#Effectue le rendu d’un gabarit donné, avec le contexte contenant les paramètres capturés dans l’URL.
\nAncêtres (MRO)
\nCette vue hérite des méthodes et des attributs des vues suivantes :
\nIndex des méthodes
\n\nExemple de fichier views.py:
\nfrom django.views.generic.base import TemplateView\n\nfrom articles.models import Article\n\nclass HomePageView(TemplateView):\n\n template_name = "home.html"\n\n def get_context_data(self, **kwargs):\n context = super().get_context_data(**kwargs)\n context['latest_articles'] = Article.objects.all()[:5]\n return context\nExemple de fichier urls.py:
\nfrom django.urls import path\n\nfrom myapp.views import HomePageView\n\nurlpatterns = [\n path('', HomePageView.as_view(), name='home'),\n]\nContexte
\nComplété (via ContextMixin) par les paramètres nommés capturés par le motif d’URL qui a servi à appeler la vue.
Il est aussi possible d’ajouter du contexte en utilisant le paramètre nommé extra_context de as_view().
RedirectViewLien vers cette rubrique#Redirection vers l’URL donnée.
\nL’URL donnée peut contenir des chaînes de format de type dictionnaire, qui seront interpolées par les paramètres capturés dans l’URL. Comme l’interpolation par mot-clé a toujours lieu (même si aucun paramètre n’est capturé), tout caractère "%" dans l’URL doit être doublé ("%%") de sorte que Python convertit ces séquences en caractère pourcent unique lors de l’affichage.
Si l’URL indiquée vaut None, Django renvoie une réponse HttpResponseGone (410).
Ancêtres (MRO)
\nCette vue hérite des méthodes et des attributs de la vue suivante :
\n\nIndex des méthodes
\n\nExemple de fichier views.py:
\nfrom django.shortcuts import get_object_or_404\nfrom django.views.generic.base import RedirectView\n\nfrom articles.models import Article\n\nclass ArticleCounterRedirectView(RedirectView):\n\n permanent = False\n query_string = True\n pattern_name = 'article-detail'\n\n def get_redirect_url(self, *args, **kwargs):\n article = get_object_or_404(Article, pk=kwargs['pk'])\n article.update_counter()\n return super().get_redirect_url(*args, **kwargs)\nExemple de fichier urls.py:
\nfrom django.urls import path\nfrom django.views.generic.base import RedirectView\n\nfrom article.views import ArticleCounterRedirectView, ArticleDetail\n\nurlpatterns = [\n path('counter/<int:pk>/', ArticleCounterRedirectView.as_view(), name='article-counter'),\n path('details/<int:pk>/', ArticleDetail.as_view(), name='article-detail'),\n path('go-to-django/', RedirectView.as_view(url='https://djangoproject.com'), name='go-to-django'),\n]\nAttributs
\nL’URL vers laquelle rediriger, sous forme textuelle. Ou None pour générer une erreur HTTP 410 (Gone).
Le nom du motif d’URL vers lequel rediriger. La résolution inverse est effectuée à l’aide des mêmes paramètres positionnels et nommés (args/kwargs) que ceux transmis à cette vue.
\nIndique si la redirection doit être permanente. La seule différence est le code de statut HTTP qui est renvoyé. Si True, la redirection produit un code de statut 301. Si False, la redirection produit un code de statut 302. Par défaut, permanent vaut False.
Indique s’il faut transférer la chaîne de requête GET vers le nouvel emplacement. Si True, la chaîne de requête est ajoutée à l’URL. Si False, la chaîne de requête n’est pas considérée. Par défaut, query_string vaut False.
Méthodes
\nConstruit l’URL cible de la redirection.
\nL’implémentation par défaut utilise url comme chaîne de départ et effectue la substitution des paramètres nommés % dans cette chaîne en utilisant les groupes nommés capturés dans l’URL.
Si url n’est pas défini, get_redirect_url() essaie de résoudre pattern_name en utilisant les éléments capturés dans l’URL (aussi bien les groupes nommés qu’anonymes).
Si la requête contenait une chaîne de paramètres query_string, celle-ci est aussi ajoutée à l’URL générée. Les sous-classes peuvent implémenter le comportement qu’elles souhaitent pour autant que la méthode renvoie une chaîne d’URL prête pour la redirection.