Menulis aplikasi Jaringan dapat menjadi membosankan, karena kami mengulangi pola tertentu lagi dan lagi. Django mencoba mengambil beberapa dari kebosanan pada model dan lapisan cetakan, tetapi pengembang Jaringan juga mengalami kebosanan ini pada tingkat tampilan.
\ntampilan umum Django dikembangkan untuk memudahkan sakit itu. Mereka mengambil dialek umum tertentu dan pola ditemukan di pengembangan tampilan dan meringkaskan mereka sehingga anda dapat dengan cepat menulis tampilan umum dari data tanpa harus menulis kode terlalu banyak.
\nKami dapat mengenali tugas-tugas umum, seperti memperlihatkan daftar dari obyek, dan menulis kode yang memperlihatkan daftar dari obyek apapun. Kemudian model di pertanyaan dapat dilewatkan sebagai sebuah argumen tambahan pada URLconf.
\nDjango dibungkus dengan tampilan umum untuk melakukan berikut:
\nMemperlihatkan daftar dan halaman rincian untuk obyek tunggal. Jika kami sedang membuat sebuah aplikasi untuk mengelola pertemuan kemudian TalkListView dan RegisteredUserListView akan menjadi contoh dari daftar tampilan. Halaman percakapan tunggal adalah sebuah contoh dari apa kami sebut tampilan "detail".
Obyek berdasarkan-tanggal sekarang di halaman arsip tahun/bulan/hari, rincian terkait, dan halaman "latest".
Mengizinkan untuk membuat, memperbaharui, dan menghapus obyek -- dengan atau tanpa otorisasi.
Diambil bersama-sama, tampilan ini menyediakan antarmuka mudah untuk melakukan tugas-tugas paling umum pengembang hadapi.
\nTidak ada pertanyaan yang menggunakan tampilan umum yang dapat mempercepat pengembangan besar. Dalam kebanyakan proyek, bagaimanapun, ada datang saat ketika tampilan umum tidak lagi cukup. Memang, pertanyaan paling umum ditanyakan oleh pengembang Django baru adalah bagaimana membuat tampilan umum menangangi larik lebih lebar dari keadaan.
\nIni adalah satu dari alasan umtum tampilan dirancang kembali untuk terbitan 1.3 - sebelumnya, mereka hanya fungsi tampilan dengan membingungkan dari pilihan; sekarang daripada melewatkan di sejumlah besar konfigurasi di URLconf, cara dianjurkan untuk memperpanjang tampilan umum adalah dengan mensubkelaskan mereka, dan menimpa atribut dan metodenya.
\nItu dikatakan, tampilan umum akan mempunyai sebuah batasan. Jika anda menemukan anda sedang berjuang menerapkan tampilan anda sebagai sebuah subkelas dari tampilan umum, kemudian anda mungkin menemukan itu lebih efektif untuk menulis hanya kode anda butuhkan, menggunakan berdasarkan-kelas anda sendiri atau tampilan kegunaan.
\nContoh-contoh lebih dari tampilan umum tersedia di beberapa aplikasi pihak ketiga, atau anda dapat menulis anda sendiri sesuai kebutuhan.
\nTemplateView pasti sangat berguna, tetapi tampilan umum Django sangat bersinar ketika itu datang untuk membawakan tampilan dari isi basisdata anda. Karena itu adalah tugas umum, Django datang dengan sejumlah tampilan umum siap-pakai yang membuat membangkitkan daftar dan rincian tampilan dari obyek sangat mudah.
Mari kita mulai dengan mencari beberapa contoh dari menunjukkan daftar dari obyek atau obyek tersendiri.
\nKami akan menggunakan model ini
\n# models.py\nfrom django.db import models\n\nclass Publisher(models.Model):\n name = models.CharField(max_length=30)\n address = models.CharField(max_length=50)\n city = models.CharField(max_length=60)\n state_province = models.CharField(max_length=30)\n country = models.CharField(max_length=50)\n website = models.URLField()\n\n class Meta:\n ordering = ["-name"]\n\n def __str__(self): # __unicode__ on Python 2\n return self.name\n\nclass Author(models.Model):\n salutation = models.CharField(max_length=10)\n name = models.CharField(max_length=200)\n email = models.EmailField()\n headshot = models.ImageField(upload_to='author_headshots')\n\n def __str__(self): # __unicode__ on Python 2\n return self.name\n\nclass Book(models.Model):\n title = models.CharField(max_length=100)\n authors = models.ManyToManyField('Author')\n publisher = models.ForeignKey(Publisher, on_delete=models.CASCADE)\n publication_date = models.DateField()\nSekarang kami butuh menentukan sebuah tampilan:
\n# views.py\nfrom django.views.generic import ListView\nfrom books.models import Publisher\n\nclass PublisherList(ListView):\n model = Publisher\nAkhirnya kaitkan tampilan itu kedalam url anda
\n# urls.py\nfrom django.conf.urls import url\nfrom books.views import PublisherList\n\nurlpatterns = [\n url(r'^publishers/$', PublisherList.as_view()),\n]\nItu saja semua kode Python kami butuh tulis. Kami masih butuh menulis sebuah cetakan, bagaimanapun. Kami dapat dengan jelas memberitahu tampilan cetakan mana untuk digunakan dengan menambahkan atribut template_name, tetapi di kehadiran dari Django cetakan jelas akan mengambil kesimpulan satu dari nama obyek. Dalam kasus ini, cetakan kesimpulan akan menjadi "books/publisher_list.html" -- bagian "books" berasal dari nama dari aplikasi yang menentukan model, selagi sedikit "publisher" hanya versi huruf kecil dari nama model.
Cetakan ini akan dibangun terhadap konteks mengandung sebuah variabel disebut object_list yang mengandung semua obyek penerbit. Cetakan sangat sederhana mungkin terlihat seperti berikut:
{% extends "base.html" %}\n\n{% block content %}\n <h2>Publishers</h2>\n <ul>\n {% for publisher in object_list %}\n <li>{{ publisher.name }}</li>\n {% endfor %}\n </ul>\n{% endblock %}\nItu semua benar-benar ada adalah pada itu. Semua fitur-fitur keren dari tampilan umum datang dari merubah atribut disetel pada tampilan umum. generic views reference mendokumentasikan semua tampilan umum dan pilihan mereka di rincian; sisa dari dokumen ini akan dianggap beberapa dari cara umum anda mungkin menyesuaikan dan memperpanjang tampilan umum.
\nAnda mungkin telah memperhatikan bahwa contoh cetakan daftar penerbit kami menyimpan semua penerbit dalam sebuah variabel bernama object_list. Selagi ini bekerja baik, itu tidak semua yang "friendly" pada cetakan penulis: mereka harus "just know" bahwa mereka sedang berurusan dengan penerbit disini.
Baik, jika anda sedang berurusan dengan sebuah obyek model, ini sudah selesai untuk anda. Ketika anda sedang berurusan dengan sebuah obyek atau queryset, Django dapat mengumpulkan konteks menggunakan versi huruf kecil dari nama kelas model. Ini disediakan sebagai tambahan pada masukan object_list awalan, tetapi mengandung persisnya data sama, yaitu publisher_list.
Jika ini masih tidak kecocokan baik, anda dapat manual menyetel nama dari variabel konteks. Atribut context_object_name pada tampilan umum menentukan variabel konteks untuk digunakan:
# views.py\nfrom django.views.generic import ListView\nfrom books.models import Publisher\n\nclass PublisherList(ListView):\n model = Publisher\n context_object_name = 'my_favorite_publishers'\nMenyediakan sebuah context_object_name berguna selalu ide bagus. Rekan kerja anda yang merancang cetakan akan berterima kasih.
Sering anda cukup butuh menghadirkan beberapa informasi tambahan yang disediakan oleh tampilan umum. Sebagai contoh, berpikir dari menunjukkan daftar semua buku pada setiap halaman rincian penerbit. Tampilan umum DetailView menyediakan penerbit ke konteks, tetapi bagaimana kami mendapatkan informasi tambahan di cetakan itu?
Jawabannya adalah untuk mensubkelaskan DetailView dan menyediakan penerapan milik anda sendiri dari metode get_context_data. Penerapan awalan cukup menambahkan obyek sedang ditampilkan pada cetakan, tetapi anda dapat menimpanya untuk mengirim lagi:
from django.views.generic import DetailView\nfrom books.models import Publisher, Book\n\nclass PublisherDetail(DetailView):\n\n model = Publisher\n\n def get_context_data(self, **kwargs):\n # Call the base implementation first to get a context\n context = super(PublisherDetail, self).get_context_data(**kwargs)\n # Add in a QuerySet of all the books\n context['book_list'] = Book.objects.all()\n return context\nSekarang mari kita lebih dekat melihat pada argumen model kami telah sepanjang gunakan. Argumen model, yang menentukan model basisdata yang tampilan akan beroperasi, tersedia pada seua tampilan umum yang beroperasi pada obyek tunggal atau kumpulan dari obyek. Bagaimanapun, argumen model tidak hanya cara untuk menentukan obyek yang tampilan akan beroperasi -- anda dapat juga menentukan daftar dari obyek menggunakan argumen queryset:
from django.views.generic import DetailView\nfrom books.models import Publisher\n\nclass PublisherDetail(DetailView):\n\n context_object_name = 'publisher'\n queryset = Publisher.objects.all()\nMenentukan model = Publisher` adalah hanya tulisan cepat untuk mengatakan queryset = Publisher.objects.all(). Bagaimanapun, dengan menggunakan queryset untuk menentukan daftar disaring dari obyek anda dapat lebih khususkan tentang obyek yang akan muncul di tampilan (lihat Membuat query untuk informasi lebih tentang obyek QuerySet, dan lihat class-based views reference untuk rincian lengkap).
Untuk mengambil sebuah contoh sederhana, kami mungkin ingin mengurutkan daftar dari buku-buku dari tanggal terbit, dengan pertama paling terbaru:
\nfrom django.views.generic import ListView\nfrom books.models import Book\n\nclass BookList(ListView):\n queryset = Book.objects.order_by('-publication_date')\n context_object_name = 'book_list'\nItu adalah contoh sederhana cantik, tetapi itu menggambarkan ide sangat bagus. Tentu saja, anda akan biasanya ingin melakukan lebih daripada mengurutkan kembali obyek. Jika anda ingin menghadirkan daftar buku oleh penerbit tertentu, anda dapat menggunakan teknis sama:
\nfrom django.views.generic import ListView\nfrom books.models import Book\n\nclass AcmeBookList(ListView):\n\n context_object_name = 'book_list'\n queryset = Book.objects.filter(publisher__name='ACME Publishing')\n template_name = 'books/acme_list.html'\nikan bahwa selama dengan queryset disaring, kami juga menggunakan nama cetakan penyesuaian. Jika kami tidak, tampilan umum akan menggunakan cetakan sama seperti daftar obyek "vanilla", yang mungkin tidak kita inginkan.
Juga perharikan bahwa ini bukan cara sangat elegan dari melakukan buku khusus-penerbit. Jika kami ingin menambah halaman penerbit lain, kami butuh bantuan lain dari baris di URLconf, dan lebih dari sedikit penerbit akan mendapatkan alasan tidak masuk akal. Kami akan berurusan dengan masalah ini di bagian selanjutnya.
\n\nKebutuhan umum lain adalah menyaring kebawah obyek yang diberikan di halaman daftar dengan beberapa kunci di URL. Awalnya kami mengkode-keraskan nama penerbit di URLconf, tetapi apa jika kami ingin menulis sebuah tampilan yang menampilkan semua buku oleh beberapa penerbit berubah-ubah?
\nDengan mudah, ListView mempunyai sebuah metode get_queryset() kami dapat timpa. Sebelumnya, itu telah mengembalikan nilai dari atribut queryset, tetapi sekarang kami dapat menambah lebih logika.
Bagian kunci membiat ini bekerja adalah bahwa ketika tampilan berdasarkan-kelas dipanggil, beragam hal-hal berguna disimpan di self; sama halnya permintaan (self.request) ini menyertakan penempatan (self.args) dan argumen (self.kwargs) berdasarkan-nama menurut URLconf.
Disini, kami mempunyai URLconf dengan kelompok ditangkap tunggal:
\n# urls.py\nfrom django.conf.urls import url\nfrom books.views import PublisherBookList\n\nurlpatterns = [\n url(r'^books/([\\w-]+)/$', PublisherBookList.as_view()),\n]\nSelanjutnya, kami akan menulis tampilan PublisherBookList sendiri:
# views.py\nfrom django.shortcuts import get_object_or_404\nfrom django.views.generic import ListView\nfrom books.models import Book, Publisher\n\nclass PublisherBookList(ListView):\n\n template_name = 'books/books_by_publisher.html'\n\n def get_queryset(self):\n self.publisher = get_object_or_404(Publisher, name=self.args[0])\n return Book.objects.filter(publisher=self.publisher)\nSeperti anda dapat lihat, itu adalah sangat mudah menambah logika lebih pada pemilihan queryset; jika kami ingin, kami dapat menggunakan self.request.user pada penyaring menggunakan pengguna saat ini, atau lebih logika rumit lain.
Kami dapat juga menambahkan penerbit kedalam konteks pada waktu bersamaan, jadi kami dapat menggunakannya di cetakan:
\n# ...\n\ndef get_context_data(self, **kwargs):\n # Call the base implementation first to get a context\n context = super(PublisherBookList, self).get_context_data(**kwargs)\n # Add in the publisher\n context['publisher'] = self.publisher\n return context\nPola umum terakhir kami akan lihat pada melibatkan melakukan beberapa pekerjaan tambahan sebelum atau sesudah memanggil tampilan umum.
\nBayangkan kami mempunyai sebuah bidang last_accessed` di model Author` kami yang kami sedang gunakanuntuk menjaga lintas dari waktu terakhir siapapun mencari penulis itu:
\n# models.py\nfrom django.db import models\n\nclass Author(models.Model):\n salutation = models.CharField(max_length=10)\n name = models.CharField(max_length=200)\n email = models.EmailField()\n headshot = models.ImageField(upload_to='author_headshots')\n last_accessed = models.DateTimeField()\nKelas DetailView umum, tentu saja, kami tidak akan mengetahui apapun tentang bidang ini, tetapi sekali lagi kami dapat dengan menudah menulis tampilan penyesuaian untuk menjaga bidang itu terperbaharui.
Pertama, kami butuh menambah rincian seorang penulis sedikit dalam URLconf untuk menunjuk pada tampilan penyesuaian:
\nfrom django.conf.urls import url\nfrom books.views import AuthorDetailView\n\nurlpatterns = [\n #...\n url(r'^authors/(?P<pk>[0-9]+)/$', AuthorDetailView.as_view(), name='author-detail'),\n]\nKemudian kami akan menulis tampilan baru kami -- get_object adalah metode yang mengambil obyek -- jadi kami cukup menimpanya dan membungkus panggilan:
from django.views.generic import DetailView\nfrom django.utils import timezone\nfrom books.models import Author\n\nclass AuthorDetailView(DetailView):\n\n queryset = Author.objects.all()\n\n def get_object(self):\n # Call the superclass\n object = super(AuthorDetailView, self).get_object()\n # Record the last accessed date\n object.last_accessed = timezone.now()\n object.save()\n # Return the object\n return object\n