上一節(jié)我們介紹了django視圖函數(shù)里面幾個常用的函數(shù),這節(jié)我們來看一下django為我們提供的一些通用視圖吧
在最后面有我自己的示例代碼,html部分太多了就不貼了
正如名字所言,簡單視圖函數(shù)封裝在django.views.generic.simple模塊里面,主要有direct_to_template和redirect_to兩個簡單視圖函數(shù),主要使用范圍是:沒有任何的視圖邏輯,僅僅需要重定向一個url
描述:使用從url中獲取的參數(shù)封裝而成的在模板中名為{{ params }}的一個字典去渲染一個給定的模板
必選參數(shù):
可選參數(shù):
from django.views.generic.simple import direct_to_templateurlpatterns = patterns('', (r'^foo/$', direct_to_template, {'template': 'foo_index.html'}), (r'^foo/(?P<id>/d+)/$', direct_to_template, {'template': 'foo_detail.html'}),)
第二個url里面?zhèn)鬟f的參數(shù)為{{ params.id }},對于/foo/15/這個請求來說,{{ params.id }}的值是15
描述:重定向到一個url
必選參數(shù)
可選參數(shù)
301(永久移動)請求的網(wǎng)頁已永久移動到新位置。服務(wù)器返回此響應(yīng)(對 GET 或 HEAD 請求的響應(yīng))時,會自動將請求者轉(zhuǎn)到新位置。302(臨時移動)服務(wù)器目前從不同位置的網(wǎng)頁響應(yīng)請求,但請求者應(yīng)繼續(xù)使用原有位置來響應(yīng)以后的請求。此代碼與響應(yīng) GET 和 HEAD 請求的 301 代碼類似,會自動將請求者轉(zhuǎn)到不同的位置,
from django.views.generic.simple import redirect_tourlpatterns = patterns('', ('^bar/$', redirect_to, {'url': '%%7Ejacob.', 'permanent': False}),)
需要注意的是,如果你想在url中使用%,必須使用%%來避免與python的字符串格式標記發(fā)送沖突
名字所言,用于顯示基于日期型數(shù)據(jù)的明細頁,包含在django.views.generic.date_based模塊里面
描述
一個頂級的索引頁按照時間顯示最新的對象,除非設(shè)置allow_future為真,否則不會顯示超前當(dāng)前日期的對象
archive是存檔的意思
必選參數(shù)
可選參數(shù)
Template name:
如果沒有給定template_name, 將會使用 默認模板<app_label>/<model_name>_archive.html
Template context:
除了可選參數(shù)的extra_context外, 模板上下文還包含以下變量:
date_list: queryset.dates(date_field, 'year')[::-1].包含所有的年份
latest: num_latest個按date_field降序排序的對象列表,默認變量名為latest,如果指定template_object_name,則變量名變?yōu)橹付ㄖ?/p>
描述
返回一個顯示給定一個年份中所有可用月份的年度存檔頁面,除非設(shè)置allow_future為真,否則不會顯示超前當(dāng)前日期的對象
必選參數(shù)
可選參數(shù)
Template name:
如果沒有給定template_name, 將會使用 默認模板<app_label>/<model_name>_archive_year.html
Template context:
除了可選參數(shù)的extra_context外, 模板上下文還包含以下變量
date_list: 類似上,包含所有的月份
year: 給定的年份(四位數(shù)字的字符串)
object_list: 如果make_object_list為真,列表中的所有對象將被封裝成一個模板變量object_list,否則 object_list為空,默認為假,需要注意的是,如果設(shè)置了template_object_name,那么object_list中的object將被替換成template_object_list的值,例如template_object_list='foo',那么object_list變?yōu)閒oo_list
描述
返回一個顯示給定月份的所有對象,除非設(shè)置allow_future為真,否則不會顯示超前當(dāng)前日期的對象
必選參數(shù)
可選參數(shù)
Template name:
如果沒有給定template_name, 將會使用 默認模板<app_label>/<model_name>_archive_month.html
Template context:
除了可選參數(shù)的extra_context外, 模板上下文還包含以下變量
描述
返回一個顯示給定星期的所有對象,除非設(shè)置allow_future為真,否則不會顯示超前當(dāng)前日期的對象
必選參數(shù)
可選參數(shù)
Template name:
如果沒有給定template_name, 將會使用 默認模板<app_label>/<model_name>_archive_week.html
Template context:
除了可選參數(shù)的extra_context外, 模板上下文還包含以下變量
描述
返回一個顯示給定日期的所有對象,除非設(shè)置allow_future為真,否則超前當(dāng)前日期的請求都會引發(fā)404的錯誤(不管那天是否存在對象)
必選參數(shù)
可選參數(shù)
Template name:
如果沒有給定template_name, 將會使用 默認模板<app_label>/<model_name>_archive_day.html
Template context:
除了可選參數(shù)的extra_context外, 模板上下文還包含以下變量
day: 一個 datetime.date 對象代表給定的日期
next_day: 一個datetime.date 代表下一天,如果下一天在今天之后,則被設(shè)為None
previous_day: 一個 datetime.date 對象代表前一天,這永遠不會設(shè)為None
描述
返回今天的所有對象的存檔頁面,除了沒有年月日的指定外,基本和archive_day一樣
描述
返回一個顯示特定對象的頁面,除非設(shè)置allow_future為真,否則若該對象超前當(dāng)前日期會引發(fā)404的錯誤
必選參數(shù)
可選參數(shù)
Template name:
如果沒有給定template_name, 將會使用 默認模板<app_label>/<model_name>_detail.html
Template context:
除了可選參數(shù)的extra_context外, 模板上下文還包含以下變量
這個通用視圖和基于日期的很像,位于django.views.generic.list_detail模塊,不過基于日期的通用視圖只有簡單的兩個頁面:對象的列表和特定對象的詳細頁面
描述
返回一個顯示一個列表的對象的頁面
必選參數(shù)
可選參數(shù)
Template name:
如果沒有給定template_name, 將會使用 默認模板<app_label>/<model_name>_list.html
Template context:
除了可選參數(shù)的extra_context外, 模板上下文還包含以下變量
如果is_paginated為真的話,下面兩個變量在模板中將可用
當(dāng)使用了paginated_by是,django會將結(jié)果分頁,所以我們在一個在url中使用page number
urlconf:(r'^objects/page(?P<page>[0-9]+)/$', 'object_list', dict(info_dict))
url:/objects/?page=3需要注意的是,page是從1開始,而不是從零開始的,如果page不合法,將促發(fā)404錯誤
亦可以使用last,如
/objects/?page=last
描述
返回一個顯示特定對象的頁面
必選參數(shù)
可選參數(shù)
Template name:
如果沒有給定template_name, 將會使用 默認模板<app_label>/<model_name>_detail.html
Template context:
除了可選參數(shù)的extra_context外, 模板上下文還包含以下變量
django.views.generic.create_update模塊封裝了生成/更新/刪除對象的一些函數(shù)
描述
描述返回一個顯示生成對象的表單頁面,提交表單后顯示提示錯誤(如果有的話)然后保存對象
必選參數(shù)
可選參數(shù)
post_save_redirect: 保存對象后跳轉(zhuǎn)的url,默認是該對象的object.get_absolute_url()方法
login_required: 一個布爾值決定是否需要登錄才能看到這個頁面并保存修改,默認是假;如果為真,若不登陸,將轉(zhuǎn)到登錄頁面(當(dāng)然了,這個適合django的認證系統(tǒng)綁定的)
Template name:
如果沒有給定template_name, 將會使用 默認模板<app_label>/<model_name>_form.html
Template context:
除了可選參數(shù)的extra_context外, 模板上下文還包含以下變量
描述
描述返回一個顯示編輯對象的表單頁面,提交表單后顯示提示錯誤(如果有的話)然后保存對象
必選參數(shù)
可選參數(shù)
post_save_redirect: 保存對象后跳轉(zhuǎn)的url,默認是該對象的object.get_absolute_url()方法
login_required: 一個布爾值決定是否需要登錄才能看到這個頁面并保存修改,默認是假;如果為真,若不登陸,將轉(zhuǎn)到登錄頁面(當(dāng)然了,這個適合django的認證系統(tǒng)綁定的)
Template name:
如果沒有給定template_name, 將會使用 默認模板<app_label>/<model_name>_form.html
Template context:
除了可選參數(shù)的extra_context外, 模板上下文還包含以下變量
描述
一個視圖,展示一個信息頁面然后刪除這個對象;僅當(dāng)request method是post的時候,對象才會被刪除;若是通過get請求該視圖函數(shù),將展示一個post到相同url的表單頁面(信息頁面)
必選參數(shù)
可選參數(shù)
post_save_redirect: 保存對象后跳轉(zhuǎn)的url,默認是該對象的object.get_absolute_url()方法
login_required: 一個布爾值決定是否需要登錄才能看到這個頁面并保存修改,默認是假;如果為真,若不登陸,將轉(zhuǎn)到登錄頁面(當(dāng)然了,這個適合django的認證系統(tǒng)綁定的)
Template name:
如果沒有給定template_name, 將會使用 默認模板<app_label>/<model_name>_confirm_delete.html
Template context:
除了可選參數(shù)的extra_context外, 模板上下文還包含以下變量
下面我們來看一些例子吧
models.py
from django.db import modelsfrom django.contrib import admin
from sysu.ThumbnailImageField import ThumbnailImageField# Create your models here.class Item(models.Model): """docstring for Item""" name = models.CharField(max_length=250) description = models.TextField() class Meta: ordering =['name'] def __unicode__(self): return self.name @models.permalink def get_absolute_url(self): return ('item_detail',None,{'object_id':self.id}) class Photo(models.Model): """docstring for Photo""" item = models.ForeignKey(Item) title = models.CharField(max_length=100) image = ThumbnailImageField(upload_to='photos') caption = models.CharField(max_length=250) class Meta: ordering = ['title'] def __unicode__(self): return self.title @models.permalink def get_absolute_url(self): return ('photo_detail',None,{'object_id':self.id})class PhotoInline(admin.StackedInline): """docstring for PhotoInline""" model = Photoclass ItemAdmin(admin.ModelAdmin): """docstring for ItemAdmin""" inlines = [PhotoInline]admin.site.register(Item,ItemAdmin)admin.site.register(Photo)import datetimefrom django.db import modelsfrom django.db.models import permalinkfrom django.contrib.auth.models import Userfrom django.contrib import adminfrom markdown import markdownVIEWABLES_STATUS = [3,4]class ViewableManager(models.Manager): """docstring for ViewableManager""" def get_query_set(self): default_queryset = super(ViewableManager, self).get_query_set() return default_queryset.filter(status__in=VIEWABLES_STATUS)class Category(models.Model): """docstring for Category""" label = models.CharField(blank=True,max_length=50) slug = models.SlugField() class Meta: verbose_name_plural = "categories" def __unicode__(self): return self.labelclass CategoryAdmin(admin.ModelAdmin): """docstring for CategoryAdmin""" prepopulated_fields = {'slug':('label',) }admin.site.register(Category,CategoryAdmin) class Stroy(models.Model): """docstring for Stroy""" STATUS_CHOICES = ( (1,"Needs Edit"), (2,"Needs Approval"), (3,"Published"), (4,"Archived"), ) title = models.CharField(max_length=100) slug = models.SlugField() category = models.ForeignKey(Category) markdown_content = models.TextField() html_content = models.TextField(editable=False) owner = models.ForeignKey(User) status = models.IntegerField(choices=STATUS_CHOICES,default=1) created = models.DateTimeField(default=datetime.datetime.now()) modified = models.DateTimeField(default=datetime.datetime.now()) class Meta: ordering = ['modified'] verbose_name_plural = "stories" def save(self): self.html_content = markdown(self.html_content) self.modified = datetime.datetime.now() super(Stroy, self).save() admin_objects = models.Manager() objects = ViewableManager() @permalink def get_absolute_url(self): return ("cms-story",None,{'slug':self.slug})class StroyAdmin(admin.ModelAdmin): """docstring for StroyAdmin""" list_display = ('title','owner','status','created','modified') search_fields = ('title','content') list_filter = ('status','owner','created','modified') prepopulated_fields = {'slug':('title',) } fieldsets = [ ("Title",{"fields":("title","slug","category")}), ("Content",{"fields":("markdown_content","owner")}), ("Status",{"classes":("monospace",),"fields":("status","created","modified")}) ]admin.site.register(Stroy,StroyAdmin)
ThumbnailImageField.py
# ThumbnailImageField.pyfrom django.db.models.fields.files import ImageField,ImageFieldFilefrom PIL import Imageimport osdef _add_thumb(s): parts = s.split(".") parts.insert(-1,"thumb") if parts[-1].lower() not in ['jpeg','jpg']: parts[-1]='jpg' return ".".join(parts)class ThumbnailImageFieldFile(ImageFieldFile): def _get_thumb_path(self): return _add_thumb(self.path) thumb_path = property(_get_thumb_path) def _get_thumb_url(self): return _add_thumb(self.url) thumb_url = property(_get_thumb_url) def save(self,name,content,save=True): super(ThumbnailImageFieldFile, self).save(name,content,save) img = Image.open(self.path) img.thumbnail( (self.field.thumb_width,self.field.thumb_height), Image.ANTIALIAS ) img.save(self.thumb_path,'JPEG') def delete(self,save=True): if os.path.exists(self.thumb_path): os.remove(self.thumb_path) super(ThumbnailImageFieldFile, self).delete(save) class ThumbnailImageField(ImageField): """docstring for ThumbnailImageField""" attr_class = ThumbnailImageFieldFile def __init__(self,thumb_width=128,thumb_height=128,*args,**kwargs): self.thumb_width = thumb_width self.thumb_height = thumb_height super(ThumbnailImageField, self).__init__(*args,**kwargs)
urls.py
from django.conf.urls import patterns, include, urlfrom sysu.models import Item,Photo,Stroy# Uncomment the next two lines to enable the admin:from django.contrib import adminadmin.autodiscover()info_dict = {'queryset':Stroy.objects.all()}urlpatterns =patterns('django.views.generic', url(r'^cms/search/$',search,name="cms-search"), url(r'^cms/(?P<slug>[-/w]+)/$', 'list_detail.object_detail', kwargs={ 'queryset':Stroy.objects.all(), 'template_name':'story_detail.html', 'template_object_name':'story' }, name="cms-story" ), url(r'^cms/$', 'list_detail.object_list', kwargs={ 'queryset':Stroy.objects.all(), 'template_name':'story_list.html', 'template_object_name':'story' }, name="cms-home" ), url(r'^cms/category/(?P<slug>[-/w]+)/$', category,name="cms-category"), # url(r'^gallery/$', 'simple.direct_to_template', # kwargs={ # 'template':'in.html', # 'extra_context':{'item_list':lambda:Item.objects.all()} # }, # name='index' # ), # url(r'^gallery/items/$', 'list_detail.object_list', # kwargs={ # 'queryset':Item.objects.all(), # 'template_name':'item_list.html', # 'allow_empty':True }, # name='item_list' # ), # url(r'^items/(?P<object_id>/d+)/$', 'list_detail.object_detail', # kwargs={ # 'queryset':Item.objects.all(), # 'template_name':'items_detail.html' # }, # name='item_detail' # ), # url(r'^gallery/photos/(?P<object_id>/d+)$', 'list_detail.object_detail', # kwargs={ # 'queryset':Photo.objects.all(), # 'template_name':'photos_detail.html' # }, # name='photo_detail' # ), # url(r'pages/', include('django.contrib.flatpages.urls')),)
都是以前寫過的代碼,僅供大家參考,有什么大家可以隨時交流
新聞熱點
疑難解答