The package django.shortcuts collects helper functions and classes that\n"span" multiple levels of MVC. In other words, these functions/classes\nintroduce controlled coupling for convenience's sake.
render()Link to this heading#Combines a given template with a given context dictionary and returns an\nHttpResponse object with that rendered text.
Django does not provide a shortcut function which returns a\nTemplateResponse because the constructor\nof TemplateResponse offers the same level\nof convenience as render().
requestObjek peminta digunakan untuk membangkitkan tanggapa ini.
\ntemplate_nameThe full name of a template to use or sequence of template names. If a\nsequence is given, the first template that exists will be used. See the\ntemplate loading documentation for more\ninformation on how templates are found.
\ncontextNilai 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.
\ncontent_typeJenis MIME digunakan untuk menghasilkan dokumen. Awalan menjadi 'text/html'.
statusKode status untuk tanggapan. Awalan menjadi 200.
usingNAME dari mesin cetakan untuk digunakan untuk memuat cetakan.
Contoh berikut membangun cetakan myapp/index.html dengan jenis MIME application/xhtml+xml:
from django.shortcuts import render\n\n\ndef my_view(request):\n # View code here...\n return render(\n request,\n "myapp/index.html",\n {\n "foo": "bar",\n },\n content_type="application/xhtml+xml",\n )\nContoh ini setara pada:
\nfrom django.http import HttpResponse\nfrom django.template import loader\n\n\ndef my_view(request):\n # View code here...\n t = loader.get_template("myapp/index.html")\n c = {"foo": "bar"}\n return HttpResponse(t.render(c, request), content_type="application/xhtml+xml")\nredirect()Link to this heading#Mengembalikan HttpResponseRedirect ke URL yang sesuai untuk argument dilewatkan.
Argumen dapat menjadi:
\nSebuah model: fungsi model's get_absolute_url() akan dipanggil.
Nama tampilan, kemungkinan dengan argumen: reverse() akan digunakan untuk membalikkan-menyelesaikan nama.
Sebuah URL mutlak atau relatif, yang akan digunakan dengan adanya untuk pengalihan lokasi.
Secara awalan menerbitkan pengalihan sementara; melewatkan permanent=True ke pengalihan tetap.
Anda dapat menggunakan fungsi redirect() dalam sejumlah cara.
Dengan melewatkan beberapa objek; metode objek get_absolute_url() akan dipanggil untuk mencari tahu URL pengalihan:
from django.shortcuts import redirect\n\n\ndef my_view(request):\n ...\n obj = MyModel.objects.get(...)\n return redirect(obj)\nDengan melewatkan nama dari tampilan dan pilihan beberapa popsisi atau argumen kata kunci; URL akan dibalikkan menggunakan metode reverse():
def my_view(request):\n ...\n return redirect("some-view-name", foo="bar")\nDengan melewatkan URL kode keras ke pengalihan pada:
\ndef my_view(request):\n ...\n return redirect("/some/url/")\nIni juga bekerja dengan URL penuh:
\ndef my_view(request):\n ...\n return redirect("https://example.com/")\nSecara awalan, redirect() mengembalikan peralihan sementara. Semua dari formulir diatas menerima argumen permanent; jika disetel menjadi True pengalihan tetap akan dikembalikan:
def my_view(request):\n ...\n obj = MyModel.objects.get(...)\n return redirect(obj, permanent=True)\nget_object_or_404()Link to this heading#Asynchronous version: aget_object_or_404()
Memanggil get() pada pengelola model diberikan, tetapi itu memunculkan Http404 daripada eksepsi model DoesNotExist.
Contoh berikut mendapatkan objek dengan primary key 1 dari MyModel:
from django.shortcuts import get_object_or_404\n\n\ndef my_view(request):\n obj = get_object_or_404(MyModel, pk=1)\nContoh ini setara pada:
\nfrom django.http import Http404\n\n\ndef my_view(request):\n try:\n obj = MyModel.objects.get(pk=1)\n except MyModel.DoesNotExist:\n raise Http404("No MyModel matches the given query.")\nKasus penggunaan paling umum adalah melewatkan Model, seperti ditunjukkan diatas. Bagaimanapun, anda dapat juga melewatkan instance QuerySet:
queryset = Book.objects.filter(title__startswith="M")\nget_object_or_404(queryset, pk=1)\nContoh di atas agak dibuat-buat karena setara dengan melakukan:
\nget_object_or_404(Book, title__startswith="M", pk=1)\ntetapi 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:
get_object_or_404(Book.dahl_objects, title="Matilda")\nAnda dapat juga menggunakan related managers:
author = Author.objects.get(name="Roald Dahl")\nget_object_or_404(author.book_set, title="Matilda")\nCatat: Seperti get(), eksepsi MultipleObjectsReturned akan dimunculkan jika lebih dari satu objek ditemukan.
get_list_or_404()Link to this heading#Asynchronous version: aget_list_or_404()
Mengembalikan hasil dari filter() pada pengelola model yang diberikan dilemparkan ke list, memunculkan Http404 jika menghasilkan list adalah kosong.
Contoh berikut mendapatkan semua objek diterbitkan dari MyModel:
from django.shortcuts import get_list_or_404\n\n\ndef my_view(request):\n my_objects = get_list_or_404(MyModel, published=True)\nContoh ini setara pada:
\nfrom django.http import Http404\n\n\ndef my_view(request):\n my_objects = list(MyModel.objects.filter(published=True))\n if not my_objects:\n raise Http404("No MyModel matches the given query.")\n