通用視圖
1. 前言
回想一下，在Django中view層起到的作用是相當(dāng)于controller的角色，在view中實(shí)施的
動(dòng)作，一般是取得請(qǐng)求參數(shù)，再?gòu)膍odel中得到數(shù)據(jù)，再通過(guò)數(shù)據(jù)創(chuàng)建模板，返回相應(yīng)
響應(yīng)對(duì)象。但在一些比較通用的功能中，比如顯示對(duì)象列表，顯示某對(duì)象信息，如果反復(fù)
寫(xiě)這么多流程的代碼，也是一件浪費(fèi)時(shí)間的事，在這里，Django同樣給我們提供了類(lèi)似的
"shortcut"捷徑--通用視圖。
2. 使用通用視圖
使用通用視圖的方法就是在urls.py這個(gè)路徑配置文件中進(jìn)行，創(chuàng)建字典配置信息，然后
傳入patterns里的元組的第三個(gè)參數(shù)(extra-parameter)，下面來(lái)看一個(gè)簡(jiǎn)單的例子：
from django.conf.urls.defaults import *
from django.views.generic.simple import direct_to_template
urlpatterns = patterns('',
url(r'^about/$', direct_to_template, {'template': 'about.html'}),
)
運(yùn)行結(jié)果：
可以看到，沒(méi)有view的代碼，也可以直接運(yùn)行。在這里direct_to_template，這個(gè)方法
，傳入第三個(gè)參數(shù)，然后直接進(jìn)行渲染。
?
?
同時(shí)因?yàn)閐irect_to_template是一個(gè)函數(shù)，我們又可以把它放在view中，下面把
上面的例子改成匹配about/*，任意子網(wǎng)頁(yè)。
#urls.py
from django.conf.urls.defaults import *
from django.views.generic.simple import direct_to_template
from mysite.books.views import about_pages
urlpatterns = patterns('',
(r'^about/$', direct_to_template, {
'template': 'about.html'
}),
(r'^about/(\w+)/$', about_pages),
)
# view.py
from django.http import Http404
from django.template import TemplateDoesNotExist
from django.views.generic.simple import direct_to_template
#由正則匹配的參數(shù)
def about_pages(request, page):
try:
return direct_to_template(request, template="about/%s.html" % page)#返回的HttpResponse
except TemplateDoesNotExist:
raise Http404()
運(yùn)行結(jié)果：
安全問(wèn)題的題外話
上面的例子中，有一個(gè)潛在的安全問(wèn)題，比較容易被忽略。那就是template="about/%s.html" % page這
句，這樣構(gòu)造路徑容易被名為directory traversal的手段攻擊，簡(jiǎn)單的說(shuō)就是利用"../"這樣的返回父目錄的
路徑操作，去訪問(wèn)原本不應(yīng)該被訪問(wèn)到的服務(wù)器上的文件，又被稱(chēng)為dot dot slash攻擊。比如
使用"http://www.cnblogs.com/../etc/passwd"路徑的話，有可能就能讀取到服務(wù)器上的passwd這個(gè)文件，從而獲取到
關(guān)鍵密碼。
?
發(fā)布這篇博文的時(shí)候，cnblogs會(huì)把連續(xù)的"../"轉(zhuǎn)義成"http://www.cnblogs.com",難道是在防止
dot dot slash攻擊？不信，你可以試試。
?
那在上面的例子中會(huì)不會(huì)有這個(gè)問(wèn)題呢？
答案：不會(huì)的。。。
因?yàn)閈w只會(huì)匹配數(shù)字，字母和下劃線，不會(huì)去匹配dot這個(gè)符號(hào)。所以可以安心使用。
回車(chē)后，會(huì)直接退回到主頁(yè)，無(wú)法匹配。
3. 用于顯示對(duì)象內(nèi)容的通用視圖
同樣，我們可以只需要model，urls.py文件就可以顯示對(duì)象的信息：
#model.py，之前例子中Publisher的定義
class Publisher(models.Model):
name = models.CharField(max_length=30)
address = models.CharField(max_length=50)
city = models.CharField(max_length=60)
state_province = models.CharField(max_length=30)
country = models.CharField(max_length=50)
website = models.URLField()
def __unicode__(self):
return self.name
#urls.py
from django.conf.urls.defaults import *
from django.views.generic import list_detail
from mysite.books.models import Publisher
publisher_info = {
'queryset': Publisher.objects.all(),
'template_name': 'publisher_list_page.html',
}
urlpatterns = patterns('',
url(r'^publishers/$', list_detail.object_list, publisher_info),
)
#publisher_list_page.html
Publishers
-
{% for publisher in object_list %}
- {{ publisher.name }} {% endfor %}
也是要構(gòu)造一個(gè)字典參數(shù)，包含數(shù)據(jù)源和模板信息，再傳給list_detail.object_list方法，
然后直接完成渲染的工作。運(yùn)行結(jié)果：
4. 通用視圖的幾種擴(kuò)展用法
4.1 自定義結(jié)果集的模板名
上面的例子中 ，模板文件中的變量名一直是object_list，如果有多個(gè)數(shù)據(jù)需要顯示，那就
會(huì)，通用視圖提供了一種解決這種沖突的命名方法，就是在字典類(lèi)型中加入template_object_name
變量，此變量+_list就組成模板文件中使用的變量名
publisher_info = {
'queryset': Publisher.objects.all(),
'template_name': 'publisher_list_page.html',
'template_object_name': 'publisher',
}
模板文件也要作相應(yīng)的修改：
Publishers
-
{% for publisher in publisher_list %}
- {{ publisher.name }} {% endfor %}
運(yùn)行結(jié)果同上。
4.2 增加額外的context
也是在字典變量中進(jìn)行修改，增加"extra_context"變量，它的值就是額外的對(duì)象數(shù)據(jù)的字典描述，
就可以用在模板文件中使用字典描述中的key來(lái)當(dāng)作變量名。
publisher_info = {
'queryset': Publisher.objects.all(),
'template_object_name': 'publisher',
'template_name': 'publisher_list_page.html',
'extra_context': {'book_list': Book.objects.all()}
}
模板文件也要做相應(yīng)的改：
Publishers
-
{% for publisher in publisher_list %}
- {{ publisher.name }} {% endfor %}
Book
-
{% for book in book_list %}
- {{ book.title }} {% endfor %}
運(yùn)行結(jié)果為：
上面的代碼又有一個(gè)問(wèn)題，那就是'book_list': Book.objects.all()，這段代碼因?yàn)?
在urls.py中，所以只會(huì)在第一次執(zhí)行此路徑的時(shí)候執(zhí)行一次，而不會(huì)因?yàn)锽ook的值
改變而改變，這是會(huì)使用到Django的緩存功能；而"queryset"中的值，Django是不會(huì)
緩存的，所以會(huì)隨著數(shù)據(jù)改變而改變。
?
解決方法就是使用函數(shù)引用來(lái)代替直接的返回值，任何在extra_context中的函數(shù)都會(huì)在
視圖每一次渲染的時(shí)候執(zhí)行一次。所以代碼可以改成：
def get_books():
return Book.objects.all()
publisher_info = {
'queryset': Publisher.objects.all(),
'template_object_name': 'publisher',
'template_name': 'publisher_list_page.html',
'extra_context': {'book_list': get_books},
}
或者改寫(xiě)成：
publisher_info = {
'queryset': Publisher.objects.all(),
'template_object_name': 'publisher',
'extra_context': {'book_list': Book.objects.all},
}
只要是引用參數(shù)就可以。
4.3 查看結(jié)果集的子集
方法很簡(jiǎn)單，就是在字典數(shù)據(jù)中使用manage有的方法進(jìn)行結(jié)果集操作，如filter等。
apress_books = {
'queryset': Book.objects.filter(publisher__name='Apress'),
'template_name': 'books/apress_list.html',
}
urlpatterns = patterns('',
url(r'^books/apress/$', list_detail.object_list, apress_books),
)
4.4 更靈活的結(jié)果集操作
上面的代碼可以看到，需要把publisher的名字硬編碼在urls.py文件中，如何才能處理
從用戶傳遞過(guò)來(lái)的任何publisher名字呢？
答案就是把list_detail.object_list方法放在views.py中調(diào)用，就可以使用從request傳遞過(guò)來(lái)
的參數(shù)。因?yàn)閘ist_detail.object_list也只不過(guò)是普通的python函數(shù)。
#urls.py
urlpatterns = patterns('',
url(r'^publishers/$', list_detail.object_list, publisher_info),
url(r'^books/(\w+)/$', books_by_publisher),
)
#views.py
from django.shortcuts import get_object_or_404
from django.views.generic import list_detail
from mysite.books.models import Book, Publisher
def books_by_publisher(request, name):
# Look up the publisher (and raise a 404 if it can't be found).
publisher = get_object_or_404(Publisher, name__iexact=name)
# Use the object_list view for the heavy lifting.
return list_detail.object_list(
request,
queryset = Book.objects.filter(publisher=publisher),
template_name = 'books_by_publisher.html',
template_object_name = 'book',
extra_context = {'publisher': publisher}
)
list_detail.object_list返回的也是HttpResponse，
4.5 利用通用視圖做額外工作
利用4.4的功能，在執(zhí)行完list_detail.object操作之后，不立即返回HttpResponse對(duì)象，而是
賦值給response變量，再進(jìn)行一些額外的處理，最后再返回HttpResponse對(duì)象，這樣就可以
在使用通用視圖功能之前或者之后做一些處理操作。下面例子的功能是在每一次訪問(wèn)作者之后
，都會(huì)更新作者的最后被訪問(wèn)時(shí)間。
#urls.py
from mysite.books.views import author_detail
urlpatterns = patterns('',
# ...
url(r'^authors/(?P
\d+)/$', author_detail),
# ...
)
#views.py
import datetime
from django.shortcuts import get_object_or_404
from django.views.generic import list_detail
from mysite.books.models import Author
def author_detail(request, author_id):
# 執(zhí)行通用視圖函數(shù)，但不立即返回HttpResponse對(duì)象
response = list_detail.object_list(
request,
queryset = Author.objects.all(),
object_id = author_id,
)
# 記錄訪問(wèn)該作者的時(shí)間
now = datetime.datetime.now()
Author.objects.filter(id=author_id).update(last_accessed=now)
# 返回通用視圖生成的HttpResponse對(duì)象
return response
我們還可以修改HttpResponse對(duì)象的相關(guān)參數(shù)來(lái)達(dá)到改變響應(yīng)信息的目的。比如
def author_list_plaintext(request):
response = list_detail.object_list(
request,
queryset = Author.objects.all(),
mimetype = 'text/plain',
template_name = 'author_list.txt'
)
#修改響應(yīng)格式，使其的內(nèi)容不直接顯示在網(wǎng)頁(yè)中，而是儲(chǔ)存在文件中，下載下來(lái)。
response["Content-Disposition"] = "attachment; filename=authors.txt"
return response
模板文件author_list.txt的內(nèi)容：
Author
-
{% for author in object_list %}
- {{ author.first_name }} {% endfor %}
運(yùn)行結(jié)果為生成authors.txt文件并提供下載：
文本內(nèi)容會(huì)保留HTML標(biāo)簽信息。
更多文章、技術(shù)交流、商務(wù)合作、聯(lián)系博主
微信掃碼或搜索：z360901061
微信掃一掃加我為好友
QQ號(hào)聯(lián)系： 360901061
您的支持是博主寫(xiě)作最大的動(dòng)力，如果您喜歡我的文章，感覺(jué)我的文章對(duì)您有幫助，請(qǐng)用微信掃描下面二維碼支持博主2元、5元、10元、20元等您想捐的金額吧，狠狠點(diǎn)擊下面給點(diǎn)支持吧，站長(zhǎng)非常感激您！手機(jī)微信長(zhǎng)按不能支付解決辦法：請(qǐng)將微信支付二維碼保存到相冊(cè)，切換到微信，然后點(diǎn)擊微信右上角掃一掃功能，選擇支付二維碼完成支付。
【本文對(duì)您有幫助就好】元
