ウェブアプリケーションを書くのは、特定のパターンを何度も繰り返すことになるため、単調になりがちです。Django はモデルとテンプレート層で単調さを取り除くことを試みてきましたが、ウェブ開発者はビューレベルでもこの種の退屈な繰り返しを経験してきました。
\nDjango の ジェネリックビュー は、この苦痛を軽減するために開発されました。ビューの開発には共通のイディオムとパターンが存在するため、それらを抽象化することで、共通のビューデータを少ないコードで素早く記述することができます。
\n私たちはオブジェクトのリスト表示のような特定の共通タスクを認識することで、任意の オブジェクトのリストを表示するコードを書きます。そして、対象のモデルを URLconf から追加の引数として渡します。
\nDjango のジェネリックビューを使うと、以下のことが可能になります。
\nオブジェクトのリストと、1つのオブジェクトに対する詳細ページの表示。カンファレンスを管理するアプリケーションを作っている場合、リストビューの例としては、TalkListView や RegisteredUserListView といったものが考えられます。1つのトークの情報を表示するページが、いわゆる「詳細」ビューの一例です。
日付を基本とするオブジェクトと、年・月・日のアーカイブページ、関連する詳細ページと「最新」ページの表示。
ユーザーにオブジェクトの作成、更新、削除を可能にする (認証のあり・なしいずれでも)。
これらのビューを総合すると、開発者が遭遇する最も一般的なタスクを実行するためのインターフェースが提供されます。
\n言うまでもなく、ジェネリックビューは実質的に開発をスピードアップさせてくれます。しかし、多くのプロジェクトでは遅かれ早かれジェネリックビューだけでは十分ではなくなる瞬間が訪れます。実際、新しい Django 開発者から最もよく聞かれる質問は、幅広い状況に対処するためにジェネリックビューを拡張するにはどうすれば良いのか、というものです。
\nこれは、ジェネリックビューが1.3リリースで再設計された理由の一つです。以前は、ジェネリックビューはビュー関数でありながらも、多くのオプションが用意されていました。
\n上で述べたように、ジェネリックビューには限界があります。自作のビューをジェネリックビューのサブクラスとして実装することに四苦八苦していると、それよりも自作のクラスベースまたは関数ベースのビューを使った方が効率的なのではないかと思うかもしれません。
\nジェネリックビューの例はサードパーティアプリケーションでも利用できます。あるいは、自分で必要に応じてアプリケーションを作ることもできます。
\nTemplateView は確かに便利ですが、データベースコンテンツのビューを表示する場合、Djangoの汎用ビューは非常に優れています。
オブジェクトのリストや個々のオブジェクトを表示する例から見てみましょう。
\nここでは、以下のようなモデルを使用します。
\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):\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):\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()\n次に、ビューを定義しましょう。
\n# views.py\nfrom django.views.generic import ListView\nfrom books.models import Publisher\n\nclass PublisherList(ListView):\n model = Publisher\n最後に、このビューを URL にフックさせます。
\n# urls.py\nfrom django.urls import path\nfrom books.views import PublisherList\n\nurlpatterns = [\n path('publishers/', PublisherList.as_view()),\n]\n以上でPythonのコードを書く必要があります。しかし、テンプレートを書く必要があります。ビューに template_name 属性を追加することで、どのテンプレートを使うかを明示的に指示することができますが、明示的なテンプレートがない場合、Django はオブジェクトの名前からテンプレートを推測します。この場合、推測されるテンプレートは "books/publisher_list.html" となります -- "books" の部分はモデルを定義しているアプリの名前から来ており、"publisher" のビットはモデル名の小文字版です。
このテンプレートは、すべてのパブリッシャーオブジェクトを含むobject_listという変数を含むコンテキストに対してレンダリングされます。テンプレートは次のようになります。
\n{% 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 %}\nジェネリックビューの優れた機能はすべて、ジェネリックビューに設定された属性を変更することで得られます。この generic views reference のドキュメントの残りの部分では、ジェネリックビューをカスタマイズしたり拡張したりする一般的な方法のいくつかを検討します。本当にそれだけです。
\nコード例の出版社をリストするテンプレートが、すべての出版社を``object_list`` という名前の変数に格納していたことに気づいたかもしれません。これでもたしかに機能的には正しく動作しますが、テンプレートを書く人にとっては、とてもではありませんが「親切」とは言えません。ここではこの変数には出版社のリストが入っているのだと「事実として知らなければならない」わけです。
\nまあ、モデルオブジェクトを扱っているのであれば、これは既に行われています。オブジェクトやクエリセットを扱う場合、Django はモデルクラス名の小文字バージョンを使ってコンテキストを入力することができます。これはデフォルトの object_list エントリに加えて提供されますが、全く同じデータ、つまり publisher_list を含んでいます。
しかし、この名前でも良くないと感じるなら、コンテキストの変数名を手動で設定することもできます。次のように、ジェネリックビューの context_object_name 属性を設定すると、コンテキスト変数の名前として使えるようになります。
# 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'\n分かりやすい context_object_name を設定するのはいつでも良い考えです。テンプレートのデザイン担当の同僚に、きっと感謝されるでしょう。
多くの場合、一般的なビューによって提供される情報以外の追加情報を提示する必要があります。たとえば、各出版社の詳細ページにすべての本のリストを表示することを考えてみてください。DetailView ジェネリックビューはパブリッシャーにコンテキストを提供しますが、そのテンプレートで追加情報を取得するにはどうすればよいですか？
答えは、 DetailView をサブクラス化し、get_context_dataメソッドの独自の実装を提供することです。デフォルトの実装では、表示されているオブジェクトがテンプレートに追加されますが、それをオーバーライドしてさらに送信することができます。
from django.views.generic import DetailView\nfrom books.models import Book, Publisher\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().get_context_data(**kwargs)\n # Add in a QuerySet of all the books\n context['book_list'] = Book.objects.all()\n return context\nそれでは次に、すべての場所で使っていた model 引数について詳しく見ていきましょう。model 引数は、ビューの操作対象となるデータベースのモデルを指定します。この引数は、1オブジェクトまたは複数オブジェクトを操作するすべてのジェネリックビューで使用可能です。しかし、model 引数は操作対象のオブジェクトを指定する唯一の方法ではありません。次のように、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()\nmodel = Publisher``と指定することは、`queryset = Publisher.objects.all()`と言うことです。しかし、フィルタリングされたオブジェクトのリストを定義するために queryset を使用することで、ビューに表示されるオブジェクトをより具体的に指定することができます (QuerySet オブジェクトの詳細については クエリを作成する を、詳細についてはクラスベースの:doc:`class-based views reference</ref/class-based-views/index> を参照してください)。
\n例を挙げれば、出版日ごとに本のリストを並べ替えることができます。最新のものが最初になります:
\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'\nこれはごくわずかな例ですが、アイデアをうまく示しています。通常、オブジェクトを並べ替えるだけでは不十分です。特定の出版社の本のリストを提示したい場合は、同じ手法を使用できます:
\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'\nqueryset がフィルタリングされただけではなく、テンプレート名も変更されているのがわかります。そうしないと、ジェネリックビューは「素の」オブジェクトリストと同じテンプレートを使ってしまいます。しかし、それは意図したものではないはずです。
同時に注意しておきたいのは、この方法は特定の出版社の本をリストアップするにはあまりエレガントな方法ではないということです。新しく出版社のページを追加する必要が生じるたびにURLconf に数行を追加する必要があるので、これでは数社以上追加するとなるとすでに無理があると分かるでしょう。この問題の解決策は、次のセクションで議論します。
\n\nもう一つのよくあるニーズは、リストページの URL に指定した何らかのキーを使って、表示するオブジェクトをフィルタリングすることです。上の例では、出版社名を URLconf にハードコーディングしてしまっていましたが、もし任意の出版社に対するすべての書籍を表示するようなビューを書きたい場合には、どうすればいいでしょうか？
\n便利なことに、 ListView にはオーバーライドできる meth:~django.views.generic.list.MultipleObjectMixin.get_queryset`メソッドがあります。デフォルトでは、 ``queryset` 属性の値を返しますが、これを使用してロジックを追加できます。
この機能がうまく動作するキーポイントは、クラスベースのビューが呼ばれる段階で self 内には様々な便利な値が格納されていることです。request (self.request)、位置引数 (self.args)、そして、キーワード引数 (self.kwargs) が、URLconf からキャプチャされてきています。
ここでは、次のように URLconf に1つのキャプチャグループがあるとしましょう。
\n# urls.py\nfrom django.urls import path\nfrom books.views import PublisherBookList\n\nurlpatterns = [\n path('books/<publisher>/', PublisherBookList.as_view()),\n]\n次に、PublisherBookList ビュー本体を書きます。
# 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.kwargs['publisher'])\n return Book.objects.filter(publisher=self.publisher)\nUsing get_queryset to add logic to the queryset selection is as convenient\nas it is powerful. For instance, if we wanted, we could use\nself.request.user to filter using the current user, or other more complex\nlogic.
次のようにすれば、テンプレートで使えるように、出版社の情報を同時にコンテキストに追加することもできます。
\n# ...\n\ndef get_context_data(self, **kwargs):\n # Call the base implementation first to get a context\n context = super().get_context_data(**kwargs)\n # Add in the publisher\n context['publisher'] = self.publisher\n return context\n最後に見る共通パタンは、ジェネリックビューの呼び出しの前後で追加の処理を実行するというものです。
\nAuthor モデルに last_accessed フィールドがあり、誰かが最後に著者の情報を見た時刻をトラッキングするのに使用しているとします。
# 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()\n汎用の DetailView クラスはこのフィールドについて何も知りませんが、このフィールドを最新の状態に保つためのカスタムビューをもう一度作成できます。
まず、著者の詳細ビューを追加して、URLconf にカスタムビューを使うようにする必要があります。
\nfrom django.urls import path\nfrom books.views import AuthorDetailView\n\nurlpatterns = [\n #...\n path('authors/<int:pk>/', AuthorDetailView.as_view(), name='author-detail'),\n]\n次に、新しいビューを記述します（ get_object はオブジェクトを取得するメソッドです）。そのため、オブジェクトをオーバーライドして、呼び出しをラップします:
from django.utils import timezone\nfrom django.views.generic import DetailView\nfrom books.models import Author\n\nclass AuthorDetailView(DetailView):\n\n queryset = Author.objects.all()\n\n def get_object(self):\n obj = super().get_object()\n # Record the last accessed date\n obj.last_accessed = timezone.now()\n obj.save()\n return obj\n