Django 源码阅读笔记(基础视图)
django源码解读之 View View
、 ContextMixin
、TemplateResponseMixin
、TemplateView
、RedirectView
View
class View(object):
"""
所有视图的基类
1 简答的请求方啊过滤 所有的请求都应该在被允许的 请求列表 http_method_names 中
2 实现请求的分发,即按照请求的方法,调用对应的视图函数。<eg: get请求 执行self.get()>
"""
# "被允许的请求方式列表"
http_method_names = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace']
def __init__(self, **kwargs):
"""
视图的构造函数,kwargs 接受所有的额外的参数
"""
# 遍历所有的关键字参数,并将键作为实例的属性,值作为实例对象的值
for key, value in six.iteritems(kwargs):
setattr(self, key, value)
@classonlymethod # 限制该方法只允许类本身调用 不允许实例对象调用
def as_view(cls, **initkwargs):
"""
返回一个接受请求并返回响应的可调用视图
流程:1 过滤传入的参数是否在http_method_names
2 查看传入的参数是否是self 本身拥有的属性,只允许传入本身拥有的属性,例如:query_set对象
eg: View.as_view(query_set=User.object.all())
在URLconf中指定查询数据集为 User的所有实例
"""
for key in initkwargs: # 遍历所有的传入字段
if key in cls.http_method_names:
# 不允许传入的参数名为 http请求方法名 即http_method_names中定义的
raise TypeError("You tried to pass in the %s method name as a "
"keyword argument to %s(). Don't do that."
% (key, cls.__name__))
if not hasattr(cls, key):
# 不允许传入的参数名为Response/Request没有的属性
raise TypeError("%s() received an invalid keyword %r. as_view "
"only accepts arguments that are already "
"attributes of the class." % (cls.__name__, key))
def view(request, *args, **kwargs):
""" 创建视图函数 初始化视图信息 """
self = cls(**initkwargs) # 实例化视图对象 initkwargs 为as_view()方法传入的参数字典
if hasattr(self, 'get') and not hasattr(self, 'head'):
self.head = self.get # 绑定了get方法的请求对象
self.request = request # WSGI请求对象 <django.core.handlers.wsgi.WSGIRequest>
self.args = args # 位置参数 URL传入的
self.kwargs = kwargs # 关键字参数 URL传入的关键字参数
return self.dispatch(request, *args, **kwargs) # 调用dispatch方法 分发
# 为视图函数添加 view_class 属性 和 view_initkwargs 属性
view.view_class = cls
view.view_initkwargs = initkwargs # <as_view()接收的参数>
# take name and docstring from class
update_wrapper(view, cls, updated=())
# and possible attributes set by decorators
# like csrf_exempt from dispatch
update_wrapper(view, cls.dispatch, assigned=())
return view
def dispatch(self, request, *args, **kwargs):
# Try to dispatch to the right method; if a method doesn't exist,
# defer to the error handler. Also defer to the error handler if the
# request method isn't on the approved list.
# 如果方法被允许
if request.method.lower() in self.http_method_names: # 判断请求WSGIRequest方法是否在允许的方法中。
# 查看实例化对象是否拥有get/post... 或 被 http_method_names 包含的同名属性(方法)。(也就 是说如果继承 View 则需要实现 http_method_names 方法中的一个或多个)
handler = getattr(self, request.method.lower(), self.http_method_not_allowed)
else:
# 否则 抛出警告信息 `Method Not Allowed...`<self.http_method_not_allowed 方法中定义>
handler = self.http_method_not_allowed
# 返回结果
return handler(request, *args, **kwargs)
def http_method_not_allowed(self, request, *args, **kwargs):
# 抛出 警告
logger.warning(
'Method Not Allowed (%s): %s', request.method, request.path,
extra={'status_code': 405, 'request': request}
)
return http.HttpResponseNotAllowed(self._allowed_methods())
def options(self, request, *args, **kwargs):
"""
options(request,* args,** kwargs)¶
处理对OPTIONS HTTP动词的请求的响应。返回一个响应,该响应的Allow标头包含视图的允许的HTTP方法名称的列表。
Handles responding to requests for the OPTIONS HTTP verb.
"""
response = http.HttpResponse()
response['Allow'] = ', '.join(self._allowed_methods())
response['Content-Length'] = '0'
return response
def _allowed_methods(self):
# 列表生成式 如果继承View的类 实现了 http_method_names 中的方法,则会返回大写的方法名列表
# 没有 在 hasattr 不成立。不会反回。
# 也就是说返回的应该是一个 全部被允许的<均实现的>大写的方法列表
return [m.upper() for m in self.http_method_names if hasattr(self, m)]
ContextMixin
class ContextMixin(object):
"""
将接收到的关键字参数 放入上下文中
通常来说继承该类,会重写该方法,更新或添加一些其他的信息,用于模版的渲染
返回 字典类型对象,包含上下文需要的信息。
"""
def get_context_data(self, **kwargs):
# 所有基于类的通用视图的模板上下文都包含一个 view 它是View的实例。
if 'view' not in kwargs:
kwargs['view'] = self
return kwargs
# demo
def get_context_data(**kwargs)
context = super().get_context_data(**kwargs)
context.update({"name": "monkey",
"gender": "male"})
return context
TemplateResponseMixin
class TemplateResponseMixin(object):
"""
为视通指定模板,使得它成为一种可配置的选项,并且可以由子类进一步自定义。
我觉得这是 django 非常高明的设计
"""
template_name = None # 使用的模版名称 HTML文档名 需要写明路径 如果是None django.core.exceptions.ImproperlyConfigured异常。它没有被明确的定义出来在 1.18 版本中
template_engine = None # 渲染模版的引擎 可以指定,在settings中设置的
# 一般是Django自己的或者jinja2
# 1 'django.template.backends.django.DjangoTemplates'
# 2 'django.template.backends.jinja2.Jinja2'
response_class = TemplateResponse # 响应类 通常是默认的TemplateResponse 或其子类 它由
# render_to_response 方法返回 如果需要自定义响应类,可以创建子类,然后指定给 respone_class
content_type = None # 用于响应的MIME。content_type作为关键字参数传递给response_class。默认值为None-表示Django使用'text/html'
def render_to_response(self, context, **response_kwargs):
"""
这个方法的作用是将 HTML 模版和传入的上下文字典 response_kwargs 渲染成为期望的响应对象。最终形成(响应字节流数据) 这一步在HttpRespone中完成。<参看HttpResponseBase 源码解析>
任何额外的参数都将传递给响应类的构造函数。
注意:修改 上下文的 context
因为这需要传入上下文参数字典 context 因此也可以在此时操作 context 来管理上下文中的信息
重写get_context_data()方法和重写此方法都可以,但是重写此方法可定制的东西会更多更灵活也更直接,并且一定不会被覆盖掉。
"""
response_kwargs.setdefault('content_type', self.content_type)
return self.response_class(
request=self.request,
template=self.get_template_names(),
context=context,
using=self.template_engine,
**response_kwargs
)
def get_template_names(self):
"""
返回用于请求的模板名称的列表,必须返回一个列表。
因为此方法在 render_to_response 中 实例化response_class时调用,因此
如果render_to_response被覆盖,则可能不会被调用。
"""
if self.template_name is None: # 如果没有值 报错~
raise ImproperlyConfigured(
"TemplateResponseMixin requires either a definition of "
"'template_name' or an implementation of 'get_template_names()'")
else:
return [self.template_name] # 必须返回列表
TemplateView
# 推荐用户继承的类
# 遵从 View中 对方法的约束,实现了get方法 它接受URLconf中所有的关键字参数 更新到上下文模版中
# 继承该类需要显示的指定 TemplateResponseMixin 定义的 template_name 的值 否则报错
# 其他属性或方法根据实际需求覆盖
class TemplateView(TemplateResponseMixin, ContextMixin, View):
"""
主要的功能都在父类中实现,自己实现get方法 <View中要求需要实现http_method_names 方法中的一种>。
"""
def get(self, request, *args, **kwargs):
context = self.get_context_data(**kwargs)
return self.render_to_response(context)
RedirectView
# 继承自 View 实现了 get方法, 其他所有的方法来 都会调用get <:感觉调用 写的好繁琐的样子 ~ ~ >
class RedirectView(View):
"""
重定向的类视图,要求是一个GET请求 其他请求都会调用get 来处理
"""
permanent = False # 重定向是否应该是永久的。唯一的区别是返回的HTTP状态代码。如果为True,则重定向将使用状态代码301。如果为False,则重定向将使用状态代码302。默认情况下permanent为False。
url = None # 重定向到的URL
pattern_name = None # 用于反向解析 url别名
query_string = False # 是否将URL携带的查询参数 传递给重定向的 URL True 则传递 否则 丢弃 默认是丢弃的
def get_redirect_url(self, *args, **kwargs):
"""
返回重定向到的URL (会按照query_string来选择是否拼接参数在URL后面)
"""
if self.url: # 如果写了url 拼接参数后直接赋值
url = self.url % kwargs
elif self.pattern_name: # 如果没有 但是写了URL别名 则反向解析路径并填充参数
try:
url = reverse(self.pattern_name, args=args, kwargs=kwargs)
except NoReverseMatch:
return None
else:
return None # 当 url 和 pattern_name 都显示的指定 则返回None
args = self.request.META.get('QUERY_STRING', '') # 去请求中提取get方法的 'QUERY_STRING'字段,没有则为 ''
if args and self.query_string: # 如果拿到了 并且 query_string 为真 则拼接查询字符串 否则 直接返回上一步 拼接好的url 不带查询参数
url = "%s?%s" % (url, args)
return url
def get(self, request, *args, **kwargs):
# get 方法 拿到url 调用 get_redirect_url
url = self.get_redirect_url(*args, **kwargs)
if url: # 如果拿到了URL
if self.permanent: # 永久重定向为 True 则返回 301 False 返回 302
return http.HttpResponsePermanentRedirect(url) # <父类添加 status_code = 301 其父类是 HttpResponse 的子类 本质上是一个 重定向的 响应对象>
else:
return http.HttpResponseRedirect(url) # < 父类添加 status_code = 302 >
else: # 没拿到URL 警告!410 <被请求的资源在服务器上已经不再可用,而且没有任何已知的转发地址。这样的状况应当被认为是永久性的>
logger.warning(
'Gone: %s', request.path,
extra={'status_code': 410, 'request': request}
)
return http.HttpResponseGone() # 返回410
# 所有的请求方式都 调用get方法来处理 <感觉这里的源码好别扭 , 3.x版本还是这样子~ 查阅文档中和资料也没有人提到 大胆的改了改源码 重写了 disptch 方法能 发现 没什么毛病 ~ 一切都很完美 不晓得框架这样写的目的 可能为了后期维护和扩展吧>
def head(self, request, *args, **kwargs):
return self.get(request, *args, **kwargs)
def post(self, request, *args, **kwargs):
return self.get(request, *args, **kwargs)
def options(self, request, *args, **kwargs):
return self.get(request, *args, **kwargs)
def delete(self, request, *args, **kwargs):
return self.get(request, *args, **kwargs)
def put(self, request, *args, **kwargs):
return self.get(request, *args, **kwargs)
def patch(self, request, *args, **kwargs):
return self.get(request, *args, **kwargs)
Django 源码阅读笔记(基础视图)的更多相关文章
- mxnet源码阅读笔记之include
写在前面 mxnet代码的规范性比Caffe2要好,看起来核心代码量也小很多,但由于对dmlc其它库的依赖太强,代码的独立性并不好.依赖的第三方库包括: cub dlpack dmlc-core go ...
- CI框架源码阅读笔记4 引导文件CodeIgniter.php
到了这里,终于进入CI框架的核心了.既然是“引导”文件,那么就是对用户的请求.参数等做相应的导向,让用户请求和数据流按照正确的线路各就各位.例如,用户的请求url: http://you.host.c ...
- libevent源码阅读笔记(一):libevent对epoll的封装
title: libevent源码阅读笔记(一):libevent对epoll的封装 最近开始阅读网络库libevent的源码,阅读源码之前,大致看了张亮写的几篇博文(libevent源码深度剖析 h ...
- jdk源码阅读笔记-LinkedHashMap
Map是Java collection framework 中重要的组成部分,特别是HashMap是在我们在日常的开发的过程中使用的最多的一个集合.但是遗憾的是,存放在HashMap中元素都是无序的, ...
- CopyOnWriteArrayList源码阅读笔记
简介 ArrayList是开发中使用比较多的集合,它不是线程安全的,CopyOnWriteArrayList就是线程安全版本的ArrayList.CopyOnWriteArrayList同样是通过数组 ...
- guavacache源码阅读笔记
guavacache源码阅读笔记 官方文档: https://github.com/google/guava/wiki/CachesExplained 中文版: https://www.jianshu ...
- CI框架源码阅读笔记5 基准测试 BenchMark.php
上一篇博客(CI框架源码阅读笔记4 引导文件CodeIgniter.php)中,我们已经看到:CI中核心流程的核心功能都是由不同的组件来完成的.这些组件类似于一个一个单独的模块,不同的模块完成不同的功 ...
- CI框架源码阅读笔记3 全局函数Common.php
从本篇开始,将深入CI框架的内部,一步步去探索这个框架的实现.结构和设计. Common.php文件定义了一系列的全局函数(一般来说,全局函数具有最高的加载优先权,因此大多数的框架中BootStrap ...
- CI框架源码阅读笔记2 一切的入口 index.php
上一节(CI框架源码阅读笔记1 - 环境准备.基本术语和框架流程)中,我们提到了CI框架的基本流程,这里再次贴出流程图,以备参考: 作为CI框架的入口文件,源码阅读,自然由此开始.在源码阅读的过程中, ...
随机推荐
- 201771010128王玉兰《面向对象程序设计(Java)第十四周学习总结》
第一部分:理论知识总结: (1)Swing 设计模式(Design pattern)是设计者一种流行的 思考设计问题的方法,是一套被反复使用,多数人 知晓的,经过分类编目的,代码设计经验的总结. 使用 ...
- Pyqt5_实例1
#coding=utf-8 ''' Created on 2018年11月2日 @author: yanerfree ''' import sys from PyQt5.QtWidgets impor ...
- python常见面试题讲解(二)计算字符个数
题目描述 写出一个程序,接受一个由字母和数字组成的字符串,和一个字符,然后输出输入字符串中含有该字符的个数.不区分大小写. 输入描述: 第一行输入一个有字母和数字以及空格组成的字符串,第二行输入一个字 ...
- vue中生命周期
1,说器生命周期,总觉得有熟悉,又陌生,直到看到一道面试题,问父子组件的生命周期的执行顺序,我擦,真没太注意啊,不知道. 2,网上搜了一下,说法是有点像洋葱圈的形式,由外到内,在到外,因为就像一个盒子 ...
- python之robotframework+pycharm测试框架
一.robotframework简介 Robot Framework是一款python编写的功能自动化测试框架.具备良好的可扩展性,支持关键字驱动,可以同时测试多种类型的客户端或者接口,可以进行分布式 ...
- Javascript函数闭包详解(通俗易懂
许多书上闭包过于复杂讲解难懂,自己理解了一下并总结啦~ 讲闭包之前,需要先明白以下几个概念. 总之,函数执行时所在的作用域,是定义时的作用域,而不是调用时所在的作用域. 1.执行上下文(executi ...
- Linux passwd 提权
利用条件,passwd 可写 ls -al /etc/passwd 利用方式: 生成密钥 openssl passwd -1 -salt test 123456 写入passwd echo 'tes ...
- Beta冲刺——测试随笔
这个作业属于哪个课程 软件工程 这个作业要求在哪里 团队作业第五次--Beta冲刺 这个作业的目标 Beta冲刺 作业正文 正文 github链接 项目地址 其他参考文献 无 一.测试工作安排 项目 ...
- Chisel3 - 参考资料汇总
https://mp.weixin.qq.com/s/mIexKCFA1MQNOl4M_iVkjg 1. 官方网站 https://chisel.eecs.berkeley.edu/ ...
- Java实现 蓝桥杯 算法提高 快乐司机
算法提高 快乐司机 时间限制:1.0s 内存限制:256.0MB 问题描述 "嘟嘟嘟嘟嘟嘟 喇叭响 我是汽车小司机 我是小司机 我为祖国运输忙 运输忙" 这是儿歌"快乐的 ...