flask基础之AppContext应用上下文和RequestContext请求上下文(六)

前言

应用上下文和请求上下文存在的目的，官方文档讲的很清楚，可参考：html

http://www.pythondoc.com/flask/appcontext.htmlpython

应用上下文对象在没有请求的时候是能够单独存在的，可是请求上下文对象只有在收到请求后才会被建立。请求处理和应用上下文和请求上下文的关系是：json

接收请求--》建立请求上下文--》请求上下文入栈--》建立该请求的应用上下文--》应用上下文入栈--》处理逻辑--》请求上下文出栈--》应用上下文出栈flask

系列文章

请求上下文RequestContext

请求上下文管理着请求对象Request，会话对象Session，当前请求的app应用，为了保证在一个请求的周期内的任什么时候候任何地点访问到Request和Session,又不能发生循环导入的问题，flask使用代理对象request和session来代理当前请求的Request和Session。框架

request = LocalProxy(partial(_lookup_req_object, 'request'))
session = LocalProxy(partial(_lookup_req_object, 'session'))

RequestContext分析

flask框架处理请求的第一步就是收到请求后建立请求上下文RequestContext.

class RequestContext(object):
    def __init__(self, app, environ, request=None):
        self.app = app
        if request is None:
            request = app.request_class(environ) # 使用app的Request对象建立一个实例
        self.request = request # 请求上下文的request
        self.url_adapter = app.create_url_adapter(self.request)
        self.flashes = None
        self.session = None # 请求上下文的session
        self._implicit_app_ctx_stack = [] # 请求上下文的应用上下文临时存放点
        self.preserved = False
        self._preserved_exc = None
        self._after_request_functions = []
        self.match_request() # 提取请求的路由建立request对象的Rule对象

request

request做为一个代理对象，其指向的是当前的请求的请求上下文RequestContext对象的request属性，即在请求上下文初始化的时候建立的请求对象，它是程序处理逻辑频繁须要的对象，存储着几乎全部的请求数据信息，本质上是Request对象。生命周期为一次请求期间，当请求处理完成后被销毁；

class Request(RequestBase):
    url_rule = None # 记录本次请求的Rule对象
    view_args = None # 本次请求的参数，指的是用路由转化器获得的参数
    routing_exception = None # 若是路由匹配失败，记录错误对象

# 重要的属性
request.max_content_length # 获取该请求容许的数据包最大字节数
request.endpoint # 获取该请求的rule的标识符
request.url_charset # 获取url的编码
request.blueprint # 请求属于的蓝图

# 和路由相关的属性
print(request.url_root)
print(request.url)
print(request.url_rule)
print(request.host_url)
print(request.base_url)
print(request.path) # 路由路径，如/time
print(request.full_path) # 全路径，包括参数
print(request.script_root)
print(request.host) # 服务器的ip
print(request.access_route) # 全部转发的ip地址列表
print(request.remote_addr) # 客户端远程地址
# 结果
http://192.168.1.112:8000/
http://192.168.1.112:8000/time/time?a=1
/time/time
http://192.168.1.112:8000/
http://192.168.1.112:8000/time/time

# 获取请求数据
print(request.is_json) # 判断请求数据是不是json格式
print(request.get_json()) # 获取json数据
print(request.args) # 获取url中的参数做为字典返回,没有返回空对象
print(request.form) # 获取表单数据
print(request.values) # 同时获取表单数据和url参数
print(request.data) # 没有被其余格式解析成功的数据
print(request.files) # 获取上传的文件
print(request.cookies) # 获取cookie
print(request.headers) # 获取头部信息

session

session代理的是请求上下文RequestContext对象的session属性，其是在请求上下文被推送到栈的时候建立的session对象，相似一个字典的容器。每次请求建立的session实例都是新的，随着请求上下文被销毁而销毁。

关于flask的session实现机制和运用参考: flask基础之session机制详解

应用上下文AppContext

应用上下文对象AppContext会在必要时被建立和销毁，它不会在线程间移动，而且也不会在不一样的请求之间共享；所以它能够做为在一次请求中临时存放数据的地方，其主要管理本次请求的当前应用app对象和临时全局g对象。

current_app = LocalProxy(_find_app)
g = LocalProxy(partial(_lookup_app_object, 'g'))

AppContext分析

flask的应用上下文能够主动建立，在不须要发生http请求的状况下；当请求上下文被推送到栈后，该请求的应用上下文会跟着建立加入栈中。

class AppContext(object):
    def __init__(self, app):
        self.app = app
        self.url_adapter = app.create_url_adapter(None)
        self.g = app.app_ctx_globals_class() # app的全局变量

current_app

current_app代理的就是当前的应用，咱们能够在业务处理的任什么时候候经过current_app获取应用app的任何属性，之因此要这样作是为了不app对象被处处显性传递形成循环导入的错误。current_app存在于应用上下文活跃期间，会在请求处理完成后，随着应用上下文销毁而销毁

from flask import current_app

app = Flask(__name__)
with app.app_context():
    current_app.url_map

current_app必须在应用上下文被建立而且被推送后才能使用。

g

g通常的用法是在请求期间管理资源，其指向的是当前应用的app_ctx_globals_class属性，是一个_AppCtxGlobals对象；g对象是随着应用上下文生存或死亡。

class _AppCtxGlobals(object):
    # 从g中获取数据
    def get(self, name, default=None):
        pass
    # 获取数据而且弹出
    def pop(self, name, default=_sentinel):
        pass
    # 在g中添加键值对，若是存在则忽略
    def setdefault(self, name, default=None):
        pass

咱们能够将g对象看作dict的数据结构，它支持g.ab方式获取值和赋值。

with app.app_context():
    g.ab = 'name' # 将{‘ab’:'name'}键值对添加到g中
    x = g.ab # 获取ab的值，若是没有会报错，因此推荐使用g.get('ab')方法

总结

请求上下文面向开发者使用的对象主要是request和session；
应用上下文面向开发者使用的对象主要是current_app和g;
一次请求期间，请求上下文建立后会建立对应的本次请求的应用上下文；
请求上下文通常不能够单独存在，由于建立请求上下文须要请求数据做为参数；可是应用上下文能够单独存在而且能够手动推送；

参考

https://dormousehole.readthedocs.io/en/latest/appcontext.html#id3