1、Python Web开发基础教程(Django版)第5章 视图视图(View)是Django的MTV架构中的重要组成部分,它实现业务逻辑处理,决定如何处理用户请求和生成响应内容,并在Web页面或其他文档中显示响应结果。本章主要内容:定义视图 处理请求和响应 在视图中使用模型 基于类的视图5.1 定义视图 Django的视图也可称为视图函数,即用Python函数来定义视图。视图函数接受Web请求,函数返回值就是响应内容。响应的内容可以是网页的HTML代码、XML文档、图像或者其他格式的内容。视图函数代码文件称为视图文件,文件名按惯例使用views.py,当然也可以使用其他的文件名。视图文件放在项
2、目的同名子文件夹或项目的应用文件夹中。本节主要内容 定义和使用视图 返回错误 处理Http404异常5.1.15.1.1定义和使用视图定义和使用视图 定义视图指在视图文件中实现完成业务逻辑处理的函数。例如,下面代码中的showData函数在Web页面中显示当前日期和从URL路径中获取的数据。#chapter5chapter5views.py from django.http import HttpResponse from datetime import date def showData(request,urlData):d=date.today()s=URL路径中的数据:%s当前日期:%s
3、%(urlData,d)return HttpResponse(s)完成视图函数定义后,在URL配置文件中配置URL来访问该函数示例代码如下。#chapter5chapter5urls.py from django.urls import path from.import views#导入视图模块 urlpatterns=path(test,views.showData)#将URL 映射到视图函数 5.1.25.1.2返回错误返回错误Django可以返回HTTP状态码和状态描述信息。正常情况下,视图函数返回的HttpResponse对象的状态代码为200,表示服务器正确处理了响应。Django
4、还提供了一系列HttpResponse子类来返回各种HTTP响应,如表5-1所示。表5-1HttpResponse子类HttpResponse子类子类HTTP状态码状态码说明说明HttpResponseRedirect302重定向到指定URL。HttpResponsePermanentRedirect301返回永久重定向。HttpResponseNotModified304表示自上次请求以来未修改页面。HttpResponseBadRequest400表示请求有错误。HttpResponseNotFound404表示未找到请求的内容。HttpResponseForbidden403表示禁止访问
5、请求的内容。HttpResponseNotAllowed405表示禁止使用指定的请求方法。HttpResponseGone410表示访问请求的内容已经不存在。HttpResponseServerError500表示发生服务器内部错误。5.1.35.1.3处理处理Http404Http404异常异常 HTTP 404错误表示服务器未找到客户请求的内容,这是最常见的HTTP错误。为了方便用户处理HTTP 404错误,Django提供了一个Http404异常类。可在代码中用raise语句抛出Http404异常,示例代码如下。#chapter5chapter5views.py from django.
6、http import Http404 from django.http import HttpResponse def testHttp404(request):raise Http404(亲:没有找到你需要的内容!)return HttpResponse(ok)相应的URL配置如下:path(test404,views.testHttp404),5.2处理请求和响应 Django使用HttpRequest对象处理HTTP请求,使用HttpResponse对象处理HTTP响应。HttpRequest和HttpResponse类在django.http模块中定义。接收到客户端响应时,Djang
7、o首先创建一个HttpRequest对象,该对象封装了请求相关的数据。然后Django调用匹配的视图函数,将HttpRequest对象传递给视图函数的第一个参数。视图函数负责返回一个HttpResponse对象,该对象封装了响应相关的数据。本节主要内容 获取请求数据 处理响应内容 文件附件 生成CSV文件 生成PDF文件 返回JSON字符串 使用响应模板 重定向5.2.1获取请求数据 可用HttpRequest对象的下列属性获取客户端的请求数据。GET:返回一个类字典的对象,它封装了客户端使用GET方法上传的数据。POST:返回一个类字典的对象,它封装了客户端使用POST方法上传的数据。FIL
8、ES:返回一个类字典的对象,它封装了客户端上传的所有文件。例如,下面的代码在浏览器中输出URL中包含的数据。#chapter5chapter5views.py from django.http import HttpResponse def showGetData(request):s=请求上传的数据:姓名=%s,年龄=%s%(request.GETname,request.GETage)return HttpResponse(s)5.2.25.2.2处理响应内容处理响应内容 HttpResponse构造函数使用一个字符串参数来构造响应内容,示例代码如下。return HttpResponse
9、(一级标题)默认情况下,响应内容为HTML格式。如果想返回其他格式的响应内容,可用content_type参数设置内容类型以及字符集,示例代码如下。return HttpResponse(一级标题,content_type=text/plain;charset=utf-8)“text/plain”表示内容为纯文本,“charset=utf-8”设置了内容的字符集。以使用write()函数向HttpResponse对象添加内容,示例代码如下。#chapter5chapter5views.py from django.http import HttpResponse def showSomethi
10、ng(request):r=HttpResponse(一级标题,content_type=text/plain;charset=utf-8)r.write(第二段)r.write(three)return r5.2.35.2.3文件附件文件附件 Django允许将响应内容以文件附件的形式返回。要返回文件附件,需要设置content_type参数和Content-Disposition标头,示例代码如下。#chapter5chapter5views.py def downloadFile(request):r=HttpResponse(文件内容,content_type=text/text;ch
11、arset=utf-8)rContent-Disposition=attachment;filename=test.txt r.write(ntest)return r Content-Disposition标头中的attachment表示内容作为附件传递,filename设置默认文件名。相应的URL配置如下:path(down,views.downloadFile),5.2.45.2.4生成生成CSVCSV文件文件使用Python的csv库,可以生成CSV格式的文件。生成CSV文件的基本步骤如下。(1)创建HttpResponse对象,并设置content_type和Content-Disp
12、osition。(2)将HttpResponse对象作为csv.writer()的参数,创建CSV生成器。(3)调用CSV生成器的writerow()、writerows()等方法向HttpResponse对象写入数据。(4)返回HttpResponse对象。5.2.55.2.5生成生成PDFPDF文件文件 使用第三方的开源Python库ReportLab,可以在Django视图中动态生成PDF文件。在Windows命令窗口中执行下面的命令安装ReportLab库。D:pip install reportlab面的代码使用ReportLab库生成PDF文件。#chapter5chapter5v
13、iews.pydef writepdf(request):from reportlab.lib.units import cm from reportlab.pdfbase.ttfonts import TTFont from reportlab.pdfbase import pdfmetrics from reportlab.pdfgen import canvas from reportlab.lib.colors import red response=HttpResponse(content_type=application/pdf)responseContent-Dispositio
14、n=attachment;filename=data.pdf pdfmetrics.registerFont(TTFont(songti,simsun.ttc)#注册中文字体,其文件在当前视图文件目录 c=canvas.Canvas(response,pagesize=(10*cm,5*cm)#生成指定大小的PDF画布 c.setFont(songti,18)#设置注册的中文字体,以便正常显示汉字 c.setFillColor(red)#设置颜色 c.drawString(0.5*cm,4*cm,Python Django Web简明教程)#在指定位置输出字符串 c.showPage()#结束
15、当前页面 c.save()#保存画布 return response5.2.65.2.6返回返回JSONJSON字符串字符串 JsonResponse是HttpResponse的子类,用于封装JSON字符串响应,它将Content-Type的标头设置为application/json。例如,下面的代码向客户端返回一个JSON字符串。#chapter5chapter5views.py def writejson(request):r=HttpResponse(content_type=application/json;charset=utf-8)r.write(name:张三,data:123,
16、abc)return r 修改writejson函数,使用JsonResponse封装响应 代码如下。from django.http import JsonResponse def writejson(request):return JsonResponse(name:张三,data:123,abc)5.2.75.2.7使用响应模板使用响应模板直接在视图中通过代码将内容写入响应,如果后期需要更改输出布局,则需要重新修改视图代码。这显然不利于代码维护。使用django.template.response模块中的TemplateResponse类,可以使用模板来定义输出布局。5.2.85.2.8
17、重定向重定向 django.shortcuts模块中的redirect()方法用于快速创建重定向,其基本格式为:redirect(to,*args)参数to可以是模型中返回URL的方法、视图名称或URL。例如:#chapter5chapter5views.py from django.shortcuts import redirect def useRedirect(request):return redirect(showData,urlData=123)#重定向到5.1.1中定义的视图函数showData5.3 在视图中使用模型视图不仅可以获取客户端上传的数据,还可以通过模型访问后台的数据
18、库本节主要内容 在视图中输出模型数据 数据分页5.3.15.3.1在视图中输出模型数据在视图中输出模型数据 具体操作步骤如下。(1)在项目子文件夹chapter5中添加一个文件,命名为modes.py,在其中定义模型,代码如下。(2)在Windows命令窗口中执行下面的命令完成数据库迁移操作。(3)修改视图文件,定义一个函数将URL中的数据添加到数据库的user表,并将user表中的全部数据返回客户端,代码如下。(4)修改urls.py,添加访问视图的URL配置,代码如下。(5)启动开发服务器。5.3.25.3.2数据分页数据分页django.core.paginator模块中的Paginat
19、or类用于实现数据分页。1 1PaginatorPaginator对象对象 Paginator()构造函数用于创建Paginator对象(称为分页器),其基本格式如下。from django.core.paginator import Paginator paginator=Paginator(object_list,per_page,orphans=0,allow_empty_first_page=True)各参数含义如下:object_list:用于分页的对象集合,可以是查询集、元组、列表或者其他可分片对象(带有count()或_len_()方法的对象)。必选参数。per_page:每页中
20、允许的最大对象数。必选参数。orphans:用于控制最后一页的对象数。如果剩余的对象数小于或等于orphans值,则这些对象将被添加到上一页面,并使其成为最后一页。可选参数,默认值为0。allow_empty_first_page:是否允许第一页为空。可选参数,默认值为True,即允许第一页为空。Paginator对象的常用属性如下。count:返回所有页面中的对象总数。num_pages:返回总页数。page_range:返回页码迭代器,页码从1开始。例如:from django.core.paginator import Paginator objects=abc,def,ghi,123,
21、456,789#待分页对象集合 p=Paginator(objects,2)#构造分页器,每页2个对象 p.count 6 p.num_pages 3 p.page_range range(1,4)Paginator对象的常用方法如下。get_page(页码):返回指定页的Page对象,页码从1开始。该方法可处理超出范围或无效的页码。如果给定页码不是数字,则返回第一页。如果给定页码小于1或大于总页数,则返回最后一页。page(页码):返回指定页的Page对象,它不处理超出范围或无效页码。指定的页码无效时会触发InvalidPage异常。例如:page1=p.get_page(1)#获取Page
22、对象 page2=p.page(2)#获取Page对象2 2PagePage对象对象 Page对象用于处理指定页。通常调用分页器的page()或get_page()方法获得Page对象。Page对象的属性如下。object_list:返回当前页的对象列表。number:返回当前页的页码。paginator:返回关联的Paginator对象。Page对象的方法如下。has_next():有下一页时返回True,否则返回False。has_previous():有上一页时返回True,否则返回False。has_other_pages():有上一页或下一页时返回True,否则返回False。nex
23、t_page_number():返回下一页的页码。previous_page_number():返回上一页的页码。start_index():返回当前页中第一个对象在所有对象中的索引,索引从1开始。例如,总对象数为6,每页包含2个对象,则第二页的start_index()返回3。end_index():返回当前页中最后一个对象在所有对象中的索引。例如,总对象数为6,每页包含2个对象,则第二页的end_index()返回4。3 3对模型数据分页对模型数据分页5.3.1节中创建了user模型,其对应的user表数据如图5.4 基于类的视图基于类的视图指用类实现的视图,可通过定义其子类进行扩展。所有
24、基于类的视图都是django.views.View的子类。本节主要内容 使用基于类的视图 设置视图类属性 扩展视图类5.4.15.4.1使用基于类的视图使用基于类的视图典型的基于类的视图通常由HTTP请求处理方法实现,其基本结构如下。from django.http import HttpResponsefrom django.views import Viewclass MyViewName(View):#继承View类#类的属性定义#类的方法定义 def get(self,request):#HTTP GET请求处理方法#业务逻辑处理代码 return HttpResponse(resul
25、t)def post(self,request):#HTTP POST请求处理方法#业务逻辑处理代码 return HttpResponse(result)其中,MyViewName是自定义类的名称,它继承了django.views.View。get()方法用于处理HTTP GET请求,post()方法用于处理HTTP POST请求。注意,get()和post()的名称必须小写。用视图函数来处理HTTP请求,其基本结构如下。from django.http import HttpResponse def MyFuncionName(request):#变量定义 if request.metho
26、d=GET:#处理HTTP GET请求#业务逻辑处理代码 return HttpResponse(result)if request.method=POST:#处理HTTP POST请求#业务逻辑处理代码 return HttpResponse(result)Django在解析URL时,如果URL与模式匹配,则调用相应的视图函数。在配置基于类的视图时,需将URL模式映射到视图类的as_view()方法。Django处理视图类的基本步骤如下。第一步:执行as_view()方法,创建一个类的实例。第二步:调用setup()方法初始化实例的属性。第三步:调用dispatch()方法,根据HTTP请求
27、方式(GET或POST等)调用匹配的实例方法。如果没有匹配的实例方法,则返回HttpResponseNotAllowed响应。5.4.25.4.2设置视图类属性设置视图类属性 Django允许在配置基于类的视图时,在as_view()方法中设置视图类的属性 示例代码如下。#chapter5chapter5urls.py urlpatterns=path(useviewpara,csrf_exempt(views.useClassView.as_view(news=news=用指定属性值访用指定属性值访问视图类问视图类),5.4.35.4.3扩展视图类扩展视图类 对视图类进行扩展,可重载类的属性
28、和方法,示例代码如下。#chapter5chapter5views.py from django.views import View class useClassView(View):class subClassView(useClassView):news=这是视图类useClassView的扩展类!def get(self,request):#重载get()方法 out=self.news+重载get()方法输出:请在输入数据后提交!+self.form return HttpResponse(out)5.5 内置通用视图本节主要内容通用视图DetailView通用视图ListView5.
29、5.15.5.1通用视图通用视图DetailViewDetailView DetailView用于显示单个模型对象的数据。通常情况下,在URL中向视图提交对象的id,视图使用id获得模型对象,并将模型对象传递给模板。例如,使用DetailView显示user表中特定用户的数据。首先,扩展DetailView类,代码如下。其次,定义模板。默认情况下,DetailView子类使用的模板文件名为“模型名称_detail.html”。本例中使用的模型名称为user,所以默认的模板文件名称为user_detail.html。本例中,项目名称为chapter5,Django默认在“chapter5chap
30、ter5templateschapter5chapter5chapter5templateschapter5”目录中搜索user_detail.html文件。最后,配置URL访问userDetailView视图5.5.25.5.2通用视图通用视图ListViewListView ListView用于显示多个模型对象的数据,数据显示格式由模板定义。本节在实例中使用ListView显示user表的全部数据。首先,扩展ListView类,代码如下:其次,定义模板。本例中,userListView视图默认使用的模板文件名称为user_list.html,其代码如下:最后,配置URL访问userListView视图5.6 实践:图形校验码本节主要内容