Tampilan berdasarkan-kelas¶
Sebuah tampilan callable yang mengambil sebuah permintaan dan mengembalikan sebuah tanggapan. Ini dapat lebih dari sekedar fungsi, dan Django menyediakan sebuah contoh dari beberapa kelas yang dapat digunakan sebagai tampilan. Ini mengizinkan anda untuk membentuk tampilan anda dan menggunakan kembali kode dengan memanfaatkan warisan dan mixin. Ada juga beberapa tampilan umum untuk tugas sederhana yang akan bisa kemudian, tetpai anda mungkin ingin merancang bentuk anda sendiri dari tampilan digunakan kembali yang cocok dengan kasus anda. Untuk rincian penuh, lihat class-based views reference documentation.
Contoh dasar¶
Django menyediakan kelas-kelas tampilan dasar yang akan cocok jangkauan lebar dari aplikasi. Semua tampilan warisan dari kelas View
, yang menangani penautan tampilan kedalam URL, mengirimkan metode HTTP dan fitur-fitur sederhana lainnya. RedirectView
adalah untuk pengalihan HTTP sederhana, dan TemplateView
memperpanjang kelas dasar untuk membuat itu juga membangun sebuah cetakan.
Penggunaan sederhana di URLconf anda¶
Cara termudah menggunakan tampilan umum adalah membuat mereka langsung di URLconf anda. Jika anda hanya merubah sedikit atribut sederhana pada sebuah tampilan berdasarkan-kelas, anda dapat cukup melewatkan mereka kedalam pemanggilan metode as_view()
itu sendiri:
from django.urls import path
from django.views.generic import TemplateView
urlpatterns = [
path('about/', TemplateView.as_view(template_name="about.html")),
]
Apapun argumen dilewatkan ke as_view()
akan menimpa atribut disetel pada kelas. Dalam contoh ini, kami menyetel template_name` pada TemplateView
. Pola penibanan mirip dapat digunakan untuk atribut url
pada RedirectView
.
Mensubkelaskan tampilan umum¶
Kedua, cara lebih kuat menggunakan tampilan umum adalah mewarisi dari tampilan yang sudah ada dan menimpa atribut (seperti template_name
) atau metode (seperti get_context_data
) di subeklas anda untuk menyediakan nilai atau metode baru. Pertimbangkan, sebagai contoh, sebuah tampilan yang hanya memperlihatkan satu cetakan, about.html
. Django mempunyai tampilan umum untuk melakukan ini - TemplateView
- jadi kami dapat hanya mensubkelaskan itu, dan menimpa nama cetakan:
# some_app/views.py
from django.views.generic import TemplateView
class AboutView(TemplateView):
template_name = "about.html"
Kemudian kami hanya butuh menambah video baru ini kedalam URLconf kami. TemplateView
adalah sebuah kelas, bukan sebuah fungsi, jadi kami menunjuk URL ke metode kelas as_view()
sebagai gantinya, yang menyediakan sebuah seperti-fungsi masukan pada tampilan berdasarkan-kelas:
# urls.py
from django.urls import path
from some_app.views import AboutView
urlpatterns = [
path('about/', AboutView.as_view()),
]
Untuk informasi lebih pada bagaimana menggunakan tampilan umum siap pakai, obrolkan topik selanjutnya di generic class-based views.
mendukung cara HTTP lain¶
Misalkan seseorang ingin mengakses pustaka buku kami terhadap HTTP menggunakan tampilan sebagai sebuah klien API akan terhubung setiap sekarang kemudian dan mengunduh buku untuk buku diterbitkan sejak kunjugan terakhir. Tetapi jika tidak ada buku baru muncul sejak itu, itu adalah pembuangan dari waktu CPU dan lebar pita untuk mengambil buku-buku dari basisdata, mengirim tanggapan penuh dan mengirim itu ke klien. Itu mungkin lebih baik untuk menanyakan API ketika kebanyakan buku saat ini telah diterbitkan.
Kami memetakan UTL pada tampilan daftar buku di URLconf:
from django.urls import path
from books.views import BookListView
urlpatterns = [
path('books/', BookListView.as_view()),
]
Dan tampilan:
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
Jika tampilan diakses dari sebuah permintaan GET
, daftar obyek polos-dan-sederhana dikembalikan di tanggapan (menggunakan cetakan book_list.html
). Tetapi jika klien menerbitkan sebuah permintaan HEAD
, tanggapan mempunyai badan kosong dan kepala Last-Modified
menunjukkan ketika buku paling akhir telah diterbitkan. Berdasarkan pada informasi ini, klien mungkin atau tidak mungkin mengunduh daftar obyek penuh.