Fungsi jalan pintas DjangoLink to this heading

The package django.shortcuts collects helper functions and classes that "span" multiple levels of MVC. In other words, these functions/classes introduce controlled coupling for convenience's sake.

render()Link to this heading

render(request, template_name, context=None, content_type=None, status=None, using=None)Link to this definition

Combines a given template with a given context dictionary and returns an HttpResponse object with that rendered text.

Django does not provide a shortcut function which returns a TemplateResponse because the constructor of TemplateResponse offers the same level of convenience as render().

Argumen dibutuhkanLink to this heading

request

The request object used to generate this response.

template_name

The full name of a template to use or sequence of template names. If a sequence is given, the first template that exists will be used. See the template loading documentation for more information on how templates are found.

Argumen pilihanLink to this heading

context

Nilai kamus untuk ditambah ke konteks cetakan. Secara awalan, ini adalah kamus kosong. Jika nilai di kamus adalah callable, tampilan akan memanggilnya sesaat sebelum membangun cetakan.

content_type

The MIME type to use for the resulting document. Defaults to 'text/html'.

status

Kode status untuk tanggapan. Awalan menjadi 200.

using

NAME dari mesin cetakan untuk digunakan untuk memuat cetakan.

ContohLink to this heading

Contoh berikut membangun cetakan myapp/index.html dengan jenis MIME application/xhtml+xml:

Code
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')

Contoh ini setara pada:

Code
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')

redirect()Link to this heading

redirect(to, *args, permanent=False, **kwargs)Link to this definition

Mengembalikan HttpResponseRedirect ke URL yang sesuai untuk argument dilewatkan.

Argumen dapat menjadi:

  • A model: the model's get_absolute_url() function will be called.

  • A view name, possibly with arguments: reverse() will be used to reverse-resolve the name.

  • An absolute or relative URL, which will be used as-is for the redirect location.

By default issues a temporary redirect; pass permanent=True to issue a permanent redirect.

ContohLink to this heading

You can use the redirect() function in a number of ways.

  1. By passing some object; that object's get_absolute_url() method will be called to figure out the redirect URL:

    Code
    from django.shortcuts import redirect
    
    def my_view(request):
        ...
        obj = MyModel.objects.get(...)
        return redirect(obj)
    
  2. By passing the name of a view and optionally some positional or keyword arguments; the URL will be reverse resolved using the reverse() method:

    Code
    def my_view(request):
        ...
        return redirect('some-view-name', foo='bar')
    
  3. By passing a hardcoded URL to redirect to:

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

    Ini juga bekerja dengan URL penuh:

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

By default, redirect() returns a temporary redirect. All of the above forms accept a permanent argument; if set to True a permanent redirect will be returned:

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

get_object_or_404()Link to this heading

get_object_or_404(klass, *args, **kwargs)Link to this definition

Calls get() on a given model manager, but it raises Http404 instead of the model's DoesNotExist exception.

Argumen dibutuhkanLink to this heading

klass

A Model class, a Manager, or a QuerySet instance from which to get the object.

**kwargs

Parameter pencarian, yang harus berupa dalam bentuk diterima oleh get() dan filter().

ContohLink to this heading

The following example gets the object with the primary key of 1 from MyModel:

Code
from django.shortcuts import get_object_or_404

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

Contoh ini setara pada:

Code
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.")

The most common use case is to pass a Model, as shown above. However, you can also pass a QuerySet instance:

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

The above example is a bit contrived since it's equivalent to doing:

Code
get_object_or_404(Book, title__startswith='M', pk=1)

tetapi itu dapat berguna jika anda melewati variabel queryset dari tempat lain.

Akhirnya, anda dapat juga menggunakan Manager. Ini berguna untuk contoh jika anda mempunyai custom manager:

Code
get_object_or_404(Book.dahl_objects, title='Matilda')

Anda dapat juga menggunakan related managers:

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

Note: As with get(), a MultipleObjectsReturned exception will be raised if more than one object is found.

get_list_or_404()Link to this heading

get_list_or_404(klass, *args, **kwargs)Link to this definition

Returns the result of filter() on a given model manager cast to a list, raising Http404 if the resulting list is empty.

Argumen dibutuhkanLink to this heading

klass

A Model, Manager or QuerySet instance from which to get the list.

**kwargs

Parameter pencarian, yang harus berupa dalam bentuk diterima oleh get() dan filter().

ContohLink to this heading

The following example gets all published objects from MyModel:

Code
from django.shortcuts import get_list_or_404

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

Contoh ini setara pada:

Code
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.")