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):
"""
回傳一個 接受請求 并 回傳回應 的 可呼叫視圖(view)
流程：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)
轉載請註明出處，本文鏈接：https://www.uj5u.com/qita/5218.html
標籤：其他
下一篇：【計算機網路】TCP基礎知識詳解