• en
  • Langue : fr

Vues fondées sur les classes

Une vue est un exécutable acceptant une requête et renvoyant une réponse. Ce n’est pas forcément une simple fonction et Django fournit des exemples de classes qui peuvent être utilisées comme des vues. Celles-ci vous permettent de structurer vos vues et de réutiliser du code en exploitant l’héritage et les « mixins ». Il existe également des vues génériques pour des tâches simples (nous y reviendrons plus tard), mais vous pouvez tout à fait concevoir votre propre structure de vues réutilisables en fonction de votre cas d’utilisation. Pour des détails plus complets, consultez la documentation de référence des vues fondées sur les classes.

Exemples de base

Django fournit des classes de vues basiques qui conviennent à une large palette d’applications. Toutes ces vues héritent de la classe View, qui gère la liaison de la vue aux URL, la distribution en fonction de la méthode HTTP et d’autres fonctionnalités de base. RedirectView est utile pour de simples redirections HTTP alors que TemplateView étend la classe de base afin d’être capable d’afficher un gabarit.

Utilisation simple dans une configuration d’URL

La manière la plus simple d’utiliser des vues génériques est de les créer directement dans votre configuration d’URL. Si vous ne devez changer qu’un nombre restreint d’attributs simples d’une vue fondée sur une classe, il suffit de les transmettre directement dans l’appel de méthode as_view():

from django.conf.urls import url
from django.views.generic import TemplateView

urlpatterns = [
    url(r'^about/', TemplateView.as_view(template_name="about.html")),
]

Tout paramètre transmis à as_view() surcharge l’attribut de même nom de la classe. Dans cet exemple, nous définissons template_name de la vue TemplateView. Le même système de surcharge peut être utilisé pour l’attribut url de RedirectView.

Héritage des vues génériques

L’autre façon, plus puissante, d’utiliser les vues génériques est d’hériter d’une vue existante et de surcharger ses attributs (comme template_name) ou ses méthodes (comme get_context_data) dans votre sous-classe pour fournir d’autres valeurs ou méthodes. Considérez par exemple une vue qui ne fait qu’afficher un gabarit, about.html. Django possède une vue générique pour faire cela, TemplateView, il nous suffit donc d’en hériter et de surcharger la variable du nom du gabarit :

# some_app/views.py
from django.views.generic import TemplateView

class AboutView(TemplateView):
    template_name = "about.html"

Puis, il suffit d’ajouter cette nouvelle vue dans notre configuration d’URL. Comme TemplateView est une classe, pas une fonction, il est nécessaire de faire correspondre l’URL avec la méthode de classe as_view() qui constitue un point d’entrée de type fonction pour les vues fondées sur les classes :

# urls.py
from django.conf.urls import url
from some_app.views import AboutView

urlpatterns = [
    url(r'^about/', AboutView.as_view()),
]

Pour plus d’informations sur la façon d’utiliser les vues génériques intégrées dans Django, consultez le prochain thème sur les vues génériques fondées sur les classes.

Prise en charge de méthodes HTTP alternatives

Supposons que quelqu’un veuille accéder à notre bibliothèque de livres par HTTP en utilisant les vues comme API. Le client de cette API se connecte de temps à autre et télécharge les données des livres publiés depuis sa dernière visite. Mais si aucune publication n’a eu lieu dans l’intervalle, ce serait une perte de temps processeur et de bande passante que de récupérer les livres de la base de données, de produire une réponse complète et de l’envoyer au client. Il pourrait être préférable d’interroger l’API au sujet de la date de publication la plus récente.

Nous faisons correspondre l’URL à la vue de la liste des livres dans la configuration d’URL :

from django.conf.urls import url
from books.views import BookListView

urlpatterns = [
    url(r'^books/$', BookListView.as_view()),
]

Et la vue :

from django.http import HttpResponse
from django.views.generic import ListView
from books.models import Book

class BookListView(ListView):
    model = Book

    def head(self, *args, **kwargs):
        last_book = self.get_queryset().latest('publication_date')
        response = HttpResponse('')
        # RFC 1123 date format
        response['Last-Modified'] = last_book.publication_date.strftime('%a, %d %b %Y %H:%M:%S GMT')
        return response

Si on accède à la vue par une requête GET, une simple liste d’objets est renvoyée dans la réponse (en utilisant le gabarit book_list.html). Mais si le client lance une requête HEAD, le corps de la réponse sera vide et l’en-tête Last-Modified indiquera la date de publication de livre la plus récente. Sur la base de cette information, le client peut décider de charger ou non la liste complète des objets.

Gabarits
Introduction aux vues fondées sur les classes
Back to Top