Django 類視圖

引文

有朋友反映說對於 Django 的 Class-Based-View(基於類的通用視圖)還有不少不明白的地方,所以接下來我會在文章中講解幾個經常使用的具備表明性的基於類的視圖用法,並在適當的源碼層面下講解其機理和如何按照咱們的須要拓展它。html

全部的類視圖都繼承django.views.generic.base.View類。數據庫

TemplateView

這多是最簡單的通用類視圖。通常在僅僅渲染一個模板時派上用場。可直接在URLconf中使用as_view()方法,以下所示:django

from django.urls import path
from django.views.generic import TemplateView

urlpatterns = [
    path('about/', TemplateView.as_view(template_name="about.html")),
]

 ListView

從名字咱們能夠對其功能略窺一二,ListView 用於列出一系列 Model 對象集合(好比文章列表)。markdown

在開發一個網站時,咱們經常須要獲取存儲在數據庫中的某個 Model 的列表,好比 Blog 要獲取文章(Article)列表以顯示到首頁,一般咱們都會寫以下的視圖函數來知足咱們的需求:函數

固然這僅僅是一個最爲基本的視圖函數的例子,Django 開發者發現,若是項目裏有大量的視圖都是實現相似於上面這種獲取存儲在數據庫中的某個 Model 的列表的功能的話,會不斷地重複書寫諸以下面的代碼:網站

就是不斷地獲取 Model 列表而後渲染模板文件,Django 說寫多了開發人員就以爲無聊了,那咱們何不把這些邏輯抽象出來放到一個類裏?因而 Django 幫咱們寫好了一個類,專門用於處理上面的狀況,這就是 ListView,將上面的視圖函數轉寫成類視圖以下:url

首先看看 get_queryset() 方法,它完成的功能和 article_list = Article.objects.all() 這句代碼相似,獲取某個 Model 的列表(這裏是文章列表),其中 article_list 就是 context_object_name 屬性值。spa

同時咱們加入了本身的邏輯,即對 article_list 中的各個 article 進行了 markdwon 拓展。假如僅僅只須要獲取 article_list ,則甚至能夠不用複寫 get_queryset 方法,只需指定一個 model 屬性,告訴 Django 去獲取哪一個 model 的列表就能夠了,像這樣:3d

第二個複寫的方法是 get_context_data() 方法,這個方法是用來給傳遞到模板文件的上下文對象(context)添加額外的內容的(context 的概念在前面的教程中已有介紹,若是這裏不懂的話我再簡單解釋一下,咱們在模板文件中會使用 {{ }} 這樣的標籤來包裹模板變量,這些變量哪裏來的?就是視圖函數經過 context 傳遞到模板的)。code

咱們這裏由於首頁須要顯示分類信息,所以咱們把 category_list 經過 get_context_data 方法加入了 context 對象,視圖函數再幫咱們把 context 傳遞給模板。return super(IndexView, self).get_context_data(**kwargs) 語句的做用是添加了 category_list 到上下文中,還要把默認的一些上下文變量也返回給視圖函數,以便其後續處理。

如今有了 model 列表,context,按照視圖函數的邏輯應該是把這些傳遞給模板了,ListView 經過指定 template_name 屬性來指定須要渲染的模板,而 context_object_name 是給 get_queryset 方法返回的 model 列表從新命名的,由於默認返回的 model 列表其名字是 object_list,爲了可讀性,咱們能夠經過 context_object_name 來從新指定,例如咱們這裏指定爲 article_list。

return render_to_response(‘blog/index.html’,context) 的功能在 ListView 中 Django 已經默認幫咱們作了,翻看其源代碼就會知道:

若是你改變渲染模板的一些行爲,經過複寫 render_to_response 方法便可。

以上方法在類視圖調用 as_view() 方法後會被自動調用。

ListView總結

  • ListView 主要用在獲取某個 model 列表中

  • 經過 template_name 屬性來指定須要渲染的模板,經過 context_object_name 屬性來指定獲取的 model 列表的名字,不然只能經過默認的 object_list 獲取

  • 複寫 get_queryset 方法以增長獲取 model 列表的其餘邏輯

  • 複寫 get_context_data 方法來爲上下文對象添加額外的變量以便在模板中訪問

DetailView

前面的 ListView 用於獲取某個 model 的列表,獲取的是一系列對象,但獲取單個mdoel對象也是很常見的,好比 Blog 裏點擊某篇文章後進入文章的詳情頁,這裏獲取的就是點擊這篇文章。咱們一般會寫以下視圖函數:

一樣的,若是這種需求多的話,開發人員就須要枯燥而乏味地大量重複寫 article = get_object_or_404(Article,pk=article_id) 這樣的句子,Django 經過 DetailView 來把這種邏輯抽象出來,把上面的視圖函數轉成類視圖:

model 屬性告訴 Django 是獲取哪一個 model 對應的單個對象,template_namecontext_object_name 屬性和 ListView 中是同樣的做用,pk_url_kwarg 至關於視圖函數中的 article_id 參數(也是URLconf中的id參數),已告訴 Django 獲取的是 id 爲多少的 model 實例。

get_object() 方法默認狀況下獲取 id 爲pk_url_kwarg 的對象,若是須要在獲取過程當中對獲取的對象作一些處理,好比對文章作 markdown 拓展,經過複寫 get_object 便可實現。

以後的處理就和 ListView 相似了,已經實現了 render_to_response 方法來渲染模板。

以上方法在類視圖調用 as_view() 方法後會被自動調用。

DetailView 總結

  • DetailView主要用在獲取某個 model 的單個對象中

  • 經過 template_name 屬性來指定須要渲染的模板,經過 context_object_name 屬性來指定獲取的 model 對象的名字,不然只能經過默認的 object 獲取

  • 複寫 get_object 方法以增長獲取單個 model 對象的其餘邏輯

  • 複寫 get_context_data 方法來爲上下文對象添加額外的變量以便在模板中訪問

使用類的通用視圖的好處

經過上面的例子你可能並未體會到使用類的通用視圖的好處,畢竟咱們寫的基於函數的視圖彷佛代碼量更短,但這僅僅是由於例子簡單而已。

同時別忘了,類是能夠被繼承的,假如咱們已經寫好了一個基於類的通用視圖,要對其拓展功能,只需繼承本來這個類視圖便可,而若是寫的是函數呢?拓展性就沒有這麼靈活,可能須要使用到裝飾器等高級技巧,或甚至不得不重複一段代碼到新拓展的視圖函數中。

但本質上而言,基於類的通用視圖依然是一個視圖函數,由於最終調用時咱們會經過 genericview.as_view() 方法把類視圖轉換成通常的視圖,url 配置是這樣的:

所以,基於類的視圖並不是什麼新的東西,只是爲了方便而對通常的視圖另外一種形式的改寫而已,理解了通常的視圖寫法後,經過閱讀其官方文檔和類視圖的源碼,很快就能掌握如何寫好類視圖了。

 

  至此。轉載請註明出處。

[參考:Django官方文檔 https://docs.djangoproject.com/zh-hans/2.0]

相關文章
相關標籤/搜索