ビルトインのクラスベースビュー API¶
クラスベースビュー API のリファレンスです。前置きとして、トピックガイドの Class-based views をご覧ください。
仕様¶
クラスベースビューによって提供される各リクエストは、独立した状態を持っています。そのため、状態変数をインスタンスに格納するのは安全です (例: self.foo = 3 はスレッドセーフな操作です) 。
クラスベースビューは as_view() クラスメソッドを使って URL パターンに記述されます。
urlpatterns = [
url(r'^view/$', MyView.as_view(size=42)),
]
Thread safety with view arguments
Arguments passed to a view are shared between every instance of a view. This means that you shouldn’t use a list, dictionary, or any other mutable object as an argument to a view. If you do and the shared object is modified, the actions of one user visiting your view could have an effect on subsequent users visiting the same view.
Arguments passed into as_view() will
be assigned onto the instance that is used to service a request. Using the
previous example, this means that every request on MyView is able to use
self.size. Arguments must correspond to attributes that already exist on
the class (return True on a hasattr check).
Base vs Generic views¶
Base class-based views can be thought of as parent views, which can be used by themselves or inherited from. They may not provide all the capabilities required for projects, in which case there are Mixins which extend what base views can do.
Django’s generic views are built off of those base views, and were developed as a shortcut for common usage patterns such as displaying the details of an object. They take certain common idioms and patterns found in view development and abstract them so that you can quickly write common views of data without having to repeat yourself.
Most generic views require the queryset key, which is a QuerySet
instance; see Making queries for more information about QuerySet
objects.
