1. GET请求:GET请求通常用来向服务器索取数据,但不会向服务器提交数据,不会对服务器的状态进行更改。好比向服务器获取某篇文章的详情。javascript
2. POST请求 :POST请求通常是用来向服务器提交数据,会对服务器的状态进行更改。好比提交一篇文章给服务器。css
Django
内置的视图装饰器能够给视图提供一些限制。好比这个视图只能经过GET
的method
访问等。如下将介绍一些经常使用的内置视图装饰器。html
1. django.http.decorators.http.require_http_methods
:这个装饰器须要传递一个容许访问的方法的列表。好比只能经过GET
的方式访问。那么示例代码以下:java
from django.views.decorators.http import require_http_methods @require_http_methods(["GET"]) def my_view(request): pass
2. django.views.decorators.http.require_GET
:这个装饰器至关因而require_http_methods(['GET'])
的简写形式,只容许使用GET
的method
来访问视图。示例代码以下:python
from django.views.decorators.http import require_GET @require_GET def my_view(request): pass
3. django.views.decorators.http.require_POST
:这个装饰器至关因而require_http_methods(['POST'])
的简写形式,只容许使用POST
的method
来访问视图。示例代码以下:nginx
from django.views.decorators.http import require_POST @require_POST def my_view(request): pass
4. django.views.decorators.http.require_safe
:这个装饰器至关因而require_http_methods(['GET','HEAD'])
的简写形式,只容许使用相对安全的方式来访问视图。由于GET
和HEAD
不会对服务器产生增删改的行为。所以是一种相对安全的请求方式。示例代码以下:ajax
from django.views.decorators.http import require_safe @require_safe def my_view(request): pass
重定向分为永久性重定向和暂时性重定向,在页面上体现的操做就是浏览器会从一个页面自动跳转到另一个页面。好比用户访问了一个须要权限的页面,可是该用户当前并无登陆,所以咱们应该给他重定向到登陆页面。django
在Django
中,重定向是使用redirect(to, *args, permanent=False, **kwargs)
来实现的。to
是一个url
,permanent
表明的是这个重定向是不是一个永久的重定向,默认是False
。关于重定向的使用。请看如下例子:json
from django.shortcuts import reverse,redirect def profile(request): if request.GET.get("username"): return HttpResponse("%s,欢迎来到我的中心页面!") else: return redirect(reverse("user:login"))
Django在接收到http请求以后,会根据http请求携带的参数以及报文信息建立一个WSGIRequest
对象,而且做为视图函数第一个参数传给视图函数。也就是咱们常常看到的request
参数。在这个对象上咱们能够找到客户端上传上来的全部信息。这个对象的完整路径是django.core.handlers.wsgi.WSGIRequest
。浏览器
WSGIRequest
对象上大部分的属性都是只读的。由于这些属性是从客户端上传上来的,不必作任何的修改。如下将对一些经常使用的属性进行讲解:
http://www.baidu.com/xxx/yyy/
,那么path
就是/xxx/yyy/
。http
方法。好比是GET
仍是POST
。django.http.request.QueryDict
对象。操做起来相似于字典。这个属性中包含了全部以?xxx=xxx
的方式上传上来的参数。django.http.request.QueryDict
对象。这个属性中包含了全部以POST
方式上传上来的参数。django.http.request.QueryDict
对象。这个属性中包含了全部上传的文件。cookie
,键值对都是字符串类型。session
。header
信息。HTTP_ACCEPT_ENCODING
:响应可接收的编码。HTTP_ACCEPT_LANGUAGE
: 响应可接收的语言。HTTP_HOST
:客户端发送的HOST值。HTTP_REFERER
:在访问这个页面上一个页面的url。QUERY_STRING
:单个字符串形式的查询字符串(未解析过的形式)。REMOTE_ADDR
:客户端的IP地址。若是服务器使用了nginx
作反向代理或者负载均衡,那么这个值返回的是127.0.0.1
,这时候可使用HTTP_X_FORWARDED_FOR
来获取,因此获取ip
地址的代码片断以下:if request.META.has_key('HTTP_X_FORWARDED_FOR'): ip = request.META['HTTP_X_FORWARDED_FOR'] else: ip = request.META['REMOTE_ADDR']
REMOTE_HOST
:客户端的主机名。REQUEST_METHOD
:请求方法。一个字符串相似于GET
或者POST。
SERVER_NAME
:服务器域名。SERVER_PORT
:服务器端口号,是一个字符串类型。is_secure()
:是不是采用https
协议。is_ajax()
:是否采用ajax
发送的请求。原理就是判断请求头中是否存在X-Requested-With:XMLHttpRequest。
get_host()
:服务器的域名。若是在访问的时候还有端口号,那么会加上端口号。好比www.baidu.com:9000。
get_full_path()
:返回完整的path。若是有查询字符串,还会加上查询字符串。好比/music/bands/?print=True。
get_raw_uri()
:获取请求的完整url。
咱们平时用的request.GET
和request.POST
都是QueryDict
对象,这个对象继承自dict
,所以用法跟dict
相差无几。其中用得比较多的是get
方法和getlist
方法。
get
方法:用来获取指定key
的值,若是没有这个key
,那么会返回None
。getlist
方法:若是浏览器上传上来的key
对应的值有多个,那么就须要经过这个方法获取。
Django服务器接收到客户端发送过来的请求后,会将提交上来的这些数据封装成一个HttpRequest
对象传给视图函数。那么视图函数在处理完相关的逻辑后,也须要返回一个响应给浏览器。而这个响应,咱们必须返回HttpResponseBase
或者他的子类的对象。而HttpResponse
则是HttpResponseBase
用得最多的子类。那么接下来就来介绍一下HttpResponse
及其子类。
text/html
。浏览器会根据这个属性,来显示数据。若是是text/html
,那么就会解析这个字符串,若是text/plain
,那么就会显示一个纯文本。经常使用的Content-Type
以下
response['X-Access-Token'] = 'xxxx'。
cookie
信息。后面讲到受权的时候会着重讲到。cookie
信息。HttpResponse
是一个相似于文件的对象,能够用来写入数据到数据体(content)中。
用来对象dump
成json
字符串,而后返回将json
字符串封装成Response
对象返回给浏览器。而且他的Content-Type
是application/json
。示例代码以下:
from django.http import JsonResponse def index(request): return JsonResponse({"username":"zhiliao","age":18})
默认状况下JsonResponse
只能对字典进行dump
,若是想要对非字典的数据进行dump
,那么须要给JsonResponse
传递一个safe=False
参数。示例代码以下:
from django.http import JsonResponse def index(request): persons = ['张三','李四','王五'] return HttpResponse(persons)
以上代码会报错,应该在使用HttpResponse
的时候,传入一个safe=False
参数,示例代码以下:
return HttpResponse(persons,safe=False)
有时候咱们作的网站,须要将一些数据,生成有一个CSV
文件给浏览器,而且是做为附件的形式下载下来。如下将讲解如何生成CSV
文件。
这里将用一个生成小的CSV
文件为例,来把生成CSV
文件的技术要点讲到位。咱们用Python
内置的csv
模块来处理csv
文件,而且使用HttpResponse
来将csv
文件返回回去。示例代码以下:
import csv from django.http import HttpResponse def csv_view(request): response = HttpResponse(content_type='text/csv') response['Content-Disposition'] = 'attachment; filename="somefilename.csv"' writer = csv.writer(response) writer.writerow(['username', 'age', 'height', 'weight']) writer.writerow(['zhiliao', '18', '180', '110']) return response
这里再来对每一个部分的代码进行解释:
HttpResponse
的时候,指定了Content-Type
为text/csv
,这将告诉浏览器,这是一个csv
格式的文件而不是一个HTML
格式的文件,若是用默认值,默认值就是html
,那么浏览器将把csv
格式的文件按照html
格式输出,这确定不是咱们想要的。response
中添加一个Content-Disposition
头,这个东西是用来告诉浏览器该如何处理这个文件,咱们给这个头的值设置为attachment;
,那么浏览器将不会对这个文件进行显示,而是做为附件的形式下载,第二个filename="somefilename.csv"
是用来指定这个csv
文件的名字。csv
模块的writer
方法,将相应的数据写入到response
中。csv
文件定义成模板 咱们还能够将csv
格式的文件定义成模板,而后使用Django
内置的模板系统,并给这个模板传入一个Context
对象,这样模板系统就会根据传入的Context
对象,生成具体的csv
文件。示例代码以下:
模板文件:
{% for row in data %}"{{ row.0|addslashes }}", "{{ row.1|addslashes }}", "{{ row.2|addslashes }}", "{{ row.3|addslashes }}", "{{ row.4|addslashes }}" {% endfor %}
视图函数:
from django.http import HttpResponse from django.template import loader, Context def some_view(request): response = HttpResponse(content_type='text/csv') response['Content-Disposition'] = 'attachment; filename="somefilename.csv"' csv_data = ( ('First row', 'Foo', 'Bar', 'Baz'), ('Second row', 'A', 'B', 'C', '"Testing"', "Here's a quote"), ) t = loader.get_template('my_template_name.txt') response.write(t.render({"data": csv_data})) return response
以上的例子是生成的一个小的csv
文件,若是想要生成大型的csv
文件,那么以上方式将有可能会发生超时的状况(服务器要生成一个大型csv文件,须要的时间可能会超过浏览器默认的超时时间)。这时候咱们能够借助另一个类,叫作StreamingHttpResponse
对象,这个对象是将响应的数据做为一个流返回给客户端,而不是做为一个总体返回。示例代码以下:
class Echo: """ 定义一个能够执行写操做的类,之后调用csv.writer的时候,就会执行这个方法 """ def write(self, value): return value def large_csv(request): rows = (["Row {}".format(idx), str(idx)] for idx in range(655360)) pseudo_buffer = Echo() writer = csv.writer(pseudo_buffer) response = StreamingHttpResponse((writer.writerow(row) for row in rows),content_type="text/csv") response['Content-Disposition'] = 'attachment; filename="somefilename.csv"' return response
这里咱们构建了一个很是大的数据集rows
,而且将其变成一个迭代器。而后由于StreamingHttpResponse
的第一个参数只能是一个生成器,所以咱们使用圆括号(writer.writerow(row) for row in rows)
,而且由于咱们要写的文件是csv
格式的文件,所以须要调用writer.writerow
将row
变成一个csv
格式的字符串。而调用writer.writerow
又须要一个中间的容器,所以这里咱们定义了一个很是简单的类Echo
,这个类只实现一个write
方法,之后在执行csv.writer(pseudo_buffer)
的时候,就会调用Echo.writer
方法。
注意:StreamingHttpResponse
会启动一个进程来和客户端保持长链接,因此会很消耗资源。因此若是不是特殊要求,尽可能少用这种方法。
这个类是专门用来处理流数据的。使得在处理一些大型文件的时候,不会由于服务器处理时间过长而到时链接超时。这个类不是继承自HttpResponse
,而且跟HttpResponse
对比有如下几点区别:
content
,相反是streaming_content。
streaming_content
必须是一个能够迭代的对象。write
方法,若是给这个类的对象写入数据将会报错。注意:StreamingHttpResponse
会启动一个进程来和客户端保持长链接,因此会很消耗资源。因此若是不是特殊要求,尽可能少用这种方法。
在写视图的时候,Django
除了使用函数做为视图,也可使用类做为视图。使用类视图可使用类的一些特性,好比继承等。
django.views.generic.base.View是主要的类视图,全部的类视图都是继承自他。若是咱们写本身的类视图,也能够继承自他。而后再根据当前请求的method
,来实现不一样的方法。好比这个视图只能使用get
的方式来请求,那么就能够在这个类中定义get(self,request,*args,**kwargs)
方法。以此类推,若是只须要实现post
方法,那么就只须要在类中实现post(self,request,*args,**kwargs)
。示例代码以下:
from django.views import View class BookDetailView(View): def get(self,request,*args,**kwargs): return render(request,'detail.html')
类视图写完后,还应该在urls.py
中进行映射,映射的时候就须要调用View
的类方法as_view()
来进行转换。示例代码以下:
urlpatterns = [ path("detail/<book_id>/",views.BookDetailView.as_view(),name='detail') ]
除了get
方法,View
还支持如下方法['get','post','put','patch','delete','head','options','trace']
若是用户访问了View
中没有定义的方法。好比你的类视图只支持get
方法,而出现了post
方法,那么就会把这个请求转发给http_method_not_allowed(request,*args,**kwargs)
。示例代码以下:
class AddBookView(View): def post(self,request,*args,**kwargs): return HttpResponse("书籍添加成功!") def http_method_not_allowed(self, request, *args, **kwargs): return HttpResponse("您当前采用的method是:%s,本视图只支持使用post请求!" % request.method)
urls.py
中的映射以下:
path("addbook/",views.AddBookView.as_view(),name='add_book')
若是你在浏览器中访问addbook/
,由于浏览器访问采用的是get
方法,而addbook
只支持post
方法,所以以上视图会返回您当前采用的method
是:GET
,本视图只支持使用post
请求!。
其实不论是get
请求仍是post
请求,都会走dispatch(request,*args,**kwargs)
方法,因此若是实现这个方法,将可以对全部请求都处理到。
django.views.generic.base.TemplateView,这个类视图是专门用来返回模版的。在这个类中,有两个属性是常常须要用到的,一个是template_name
,这个属性是用来存储模版的路径,TemplateView
会自动的渲染这个变量指向的模版。另一个是get_context_data
,这个方法是用来返回上下文数据的,也就是在给模版传的参数的。示例代码以下:
from django.views.generic.base import TemplateView class HomePageView(TemplateView): template_name = "home.html" def get_context_data(self, **kwargs): context = super().get_context_data(**kwargs) context['username'] = "黄勇" return context
在urls.py
中的映射代码以下:
from django.urls import path from myapp.views import HomePageView urlpatterns = [ path('', HomePageView.as_view(), name='home'), ]
若是在模版中不须要传递任何参数,那么能够直接只在urls.py
中使用TemplateView
来渲染模版。示例代码以下:
from django.urls import path from django.views.generic import TemplateView urlpatterns = [ path('about/', TemplateView.as_view(template_name="about.html")), ]
在网站开发中,常常会出现须要列出某个表中的一些数据做为列表展现出来。好比文章列表,图书列表等等。在Django
中可使用ListView
来帮咱们快速实现这种需求。示例代码以下:
class ArticleListView(ListView): model = Article template_name = 'article_list.html' paginate_by = 10 context_object_name = 'articles' ordering = 'create_time' page_kwarg = 'page' def get_context_data(self, **kwargs): context = super(ArticleListView, self).get_context_data(**kwargs) print(context) return context def get_queryset(self): return Article.objects.filter(id__lte=89)
对以上代码进行解释:
ArticleListView
是继承自ListView
model
:重写model
类属性,指定这个列表是给哪一个模型的template_name
:指定这个列表的模板paginate_by
:指定这个列表一页中展现多少条数据context_object_name
:指定这个列表模型在模板中的参数名称ordering
:指定这个列表的排序方式page_kwarg
:获取第几页的数据的参数名称。默认是page
get_context_data
:获取上下文的数据get_queryset
:若是你提取数据的时候,并非要把全部数据都返回,那么你能够重写这个方法。将一些不须要展现的数据给过滤掉
Paginator
和Page
类都是用来作分页的。他们在Django
中的路径为django.core.paginator.Paginator
和django.core.paginator.Page
。如下对这两个类的经常使用属性和方法作解释:
count
:总共有多少条数据num_pages
:总共有多少页page_range
:页面的区间。好比有三页,那么就range(1,4)
has_next
:是否还有下一页has_previous
:是否还有上一页next_page_number
:下一页的页码previous_page_number
:上一页的页码number
:当前页start_index
:当前这一页的第一条数据的索引值end_index
:当前这一页的最后一条数据的索引值1)定义视图类
from django.views.generic import ListView,View from django.core.paginator import Paginator,Page class ArticleListView(ListView): model = Article template_name = 'article_list1.html' context_object_name = 'articles' paginate_by = 10 ordering = 'create_time' page_kwarg = 'p' def get_context_data(self, **kwargs): context = super(ArticleListView, self).get_context_data(**kwargs) context['username'] = 'zhiliao' paginator = context.get('paginator') page_obj = context.get('page_obj') pagination_data = self.get_pagination_data(paginator, page_obj, 3) context.update(pagination_data) return context def get_pagination_data(self,paginator,page_obj,around_count=2): current_page = page_obj.number num_pages = paginator.num_pages left_has_more = False right_has_more = False if current_page <= around_count + 2: left_pages = range(1,current_page) else: left_has_more = True left_pages = range(current_page-around_count,current_page) if current_page >= num_pages - around_count - 1: right_pages = range(current_page+1,num_pages+1) else: right_has_more = True right_pages = range(current_page+1,current_page+around_count+1) return { 'left_pages': left_pages, 'right_pages': right_pages, 'current_page': current_page, 'left_has_more': left_has_more, 'right_has_more': right_has_more, 'num_pages': num_pages }
2)模板页面
<ul> {% for article in articles %} <li>{{ article.title }}</li> {% endfor %} <ul class="pagination"> {# 上一页#} {% if page_obj.has_previous %} <li><a href="{% url 'front:article_list' %}?p={{ page_obj.previous_page_number }}">上一页</a></li> {% else %} <li class="disabled"><a href="javascript:void(0);">上一页</a></li> {% endif %} {% if left_has_more %} <li><a href="{% url 'front:article_list' %}?p=1">1</a></li> <li><a href="javascript:void(0);">...</a></li> {% endif %} {# 左边的页码 #} {% for left_page in left_pages %} <li><a href="{% url 'front:article_list' %}?p={{ left_page }}">{{ left_page }}</a></li> {% endfor %} {# 当前的页面 #} <li class="active"><a href="{% url 'front:article_list' %}?p={{ current_page }}">{{ current_page }}</a></li> {# 右边的页码 #} {% for right_page in right_pages %} <li><a href="{% url 'front:article_list' %}?p={{ right_page }}">{{ right_page }}</a></li> {% endfor %} {% if right_has_more %} <li><a href="javascript:void(0);">...</a></li> <li><a href="{% url 'front:article_list' %}?p={{ num_pages }}">{{ num_pages }}</a></li> {% endif %} {# 下一页#} {% if page_obj.has_next %} <li><a href="{% url 'front:article_list' %}?p={{ page_obj.next_page_number }}">下一页</a></li> {% else %} <li class="disabled"><a href="javascript:void(0);">下一页</a></li> {% endif %} </ul> </ul>
在开发中,有时候须要给一些视图添加装饰器。若是用函数视图那么很是简单,只要在函数的上面写上装饰器就能够了。可是若是想要给类添加装饰器,那么能够经过如下两种方式来实现:
from django.utils.decorators import method_decorator def login_required(func): def wrapper(request,*args,**kwargs): if request.GET.get("username"): return func(request,*args,**kwargs) else: return redirect(reverse('index')) return wrapper class IndexView(View): def get(self,request,*args,**kwargs): return HttpResponse("index") @method_decorator(login_required) def dispatch(self, request, *args, **kwargs): super(IndexView, self).dispatch(request,*args,**kwargs)
from django.utils.decorators import method_decorator def login_required(func): def wrapper(request,*args,**kwargs): if request.GET.get("username"): return func(request,*args,**kwargs) else: return redirect(reverse('login')) return wrapper @method_decorator(login_required,name='dispatch') class IndexView(View): def get(self,request,*args,**kwargs): return HttpResponse("index") def dispatch(self, request, *args, **kwargs): super(IndexView, self).dispatch(request,*args,**kwargs)
在一些网站开发中。常常会须要捕获一些错误,而后将这些错误返回比较优美的界面,或者是将这个错误的请求作一些日志保存。那么咱们本节就来说讲如何实现。
400
:bad request
,请求的参数错误403
:没有权限访问相关的数据404
:服务器没有指定的url405
:请求的method
错误500
:服务器内部错误,通常是代码出bug了502
:通常部署的时候见得比较多,通常是nginx
启动了,而后uwsgi
有问题
在碰到好比404
,500
错误的时候,想要返回本身定义的模板。那么能够直接在templates
文件夹下建立相应错误代码的html
模板文件。那么之后在发生相应错误后,会将指定的模板返回回去。
对于404
和500
这种自动抛出的错误。咱们能够直接在templates
文件夹下新建相应错误代码的模板文件。而对于其余的错误,咱们能够专门定义一个app
,用来处理这些错误。