Les fonctions raccourcis de DjangoLien vers cette rubrique#

Paramètres obligatoiresLien vers cette rubrique#

request

L’objet requête utilisé pour générer la réponse.

template_name

Le nom complet d’un gabarit à utiliser ou une liste de noms de gabarits. Si une liste est donnée, le premier gabarit de la liste qui est trouvé sera utilisé. Consultez la documentation du chargement de gabarits pour plus d’informations sur la façon dont les gabarits sont recherchés.

Paramètres facultatifsLien vers cette rubrique#

context

Un dictionnaire de valeurs à ajouter un contexte du gabarit. Par défaut, ce dictionnaire est vide. Si une des valeurs du dictionnaire est exécutable, la vue l’appellera immédiatement avant de faire le rendu du gabarit.

content_type

Le type MIME à utiliser pour le document produit. La valeur par défaut est 'text/html'.

status

Le code d’état de la réponse. La valeur par défaut est 200.

using

Le nom NAME d’un moteur de gabarit à utiliser pour charger le gabarit.

ExempleLien vers cette rubrique#

L’exemple suivant effectue le rendu du gabarit myapp/index.html avec le type MIME application/xhtml+xml:

from django.shortcuts import render


def my_view(request):
    # View code here...
    return render(
        request,
        "myapp/index.html",
        {
            "foo": "bar",
        },
        content_type="application/xhtml+xml",
    )

Cet exemple est équivalent à :

from django.http import HttpResponse
from django.template import loader


def my_view(request):
    # View code here...
    t = loader.get_template("myapp/index.html")
    c = {"foo": "bar"}
    return HttpResponse(t.render(c, request), content_type="application/xhtml+xml")

ExemplesLien vers cette rubrique#

La fonction redirect() peut être utilisée de différentes manières.

1. En lui passant un objet ; la méthode get_absolute_url() de l’objet est appelée pour produire l’URL de redirection :

   Code

   from django.shortcuts import redirect
   
   
   def my_view(request):
       ...
       obj = MyModel.objects.get(...)
       return redirect(obj)
   

2. En lui passant le nom d’une vue et, en option, des paramètres positionnels ou nommés ; l’URL sera résolue en utilisant la méthode reverse():

   Code

   def my_view(request):
       ...
       return redirect("some-view-name", foo="bar")
   

3. En lui passant une URL de redirection fixe :

   Code

   def my_view(request):
       ...
       return redirect("/some/url/")
   

   Cela fonctionne aussi avec des URL complètes :

   Code

   def my_view(request):
       ...
       return redirect("https://example.com/")
   

Par défaut, redirect() renvoie une redirection temporaire. Toutes les formes ci-dessus acceptent un paramètre permanent qui, s’il est défini à True, produit une redirection permanente :

def my_view(request):
    ...
    obj = MyModel.objects.get(...)
    return redirect(obj, permanent=True)

ParamètresLien vers cette rubrique#

klass

Une classe Model, un Manager ou une instance QuerySet comme source de l’objet.

*args

Objets Q.

**kwargs

Paramètres de recherche, dans un format accepté par get() et filter().

ExempleLien vers cette rubrique#

L’exemple suivant obtient l’objet``MyModel`` ayant la clé primaire 1 :

from django.shortcuts import get_object_or_404


def my_view(request):
    obj = get_object_or_404(MyModel, pk=1)

Cet exemple est équivalent à :

from django.http import Http404


def my_view(request):
    try:
        obj = MyModel.objects.get(pk=1)
    except MyModel.DoesNotExist:
        raise Http404("No MyModel matches the given query.")

Le cas le plus courant est de transmettre un Model, comme montré ci-dessus. Cependant, vous pouvez aussi transmettre une instance QuerySet:

queryset = Book.objects.filter(title__startswith="M")
get_object_or_404(queryset, pk=1)

L’exemple ci-dessus est un peu tiré par les cheveux, car il est équivalent à :

get_object_or_404(Book, title__startswith="M", pk=1)

mais cela reste utile dans les cas où vous recevez une variable queryset par un autre moyen.

Finalement, vous pouvez aussi utiliser un gestionnaire (Manager). C’est utile par exemple si vous avez un gestionnaire personnalisé

get_object_or_404(Book.dahl_objects, title="Matilda")

Il est aussi possible d’utiliser des gestionnaires de liaison:

author = Author.objects.get(name="Roald Dahl")
get_object_or_404(author.book_set, title="Matilda")

Note : comme pour get(), une exception MultipleObjectsReturned sera levée si plus d’un objet est renvoyé.

ParamètresLien vers cette rubrique#

klass

Une instance de Model, Manager ou QuerySet comme source de la liste d’objets.

*args

Objets Q.

**kwargs

Paramètres de recherche, dans un format accepté par get() et filter().

ExempleLien vers cette rubrique#

L’exemple suivant récupère tous les objets publiés de

from django.shortcuts import get_list_or_404


def my_view(request):
    my_objects = get_list_or_404(MyModel, published=True)

Cet exemple est équivalent à :

from django.http import Http404


def my_view(request):
    my_objects = list(MyModel.objects.filter(published=True))
    if not my_objects:
        raise Http404("No MyModel matches the given query.")