前言
应用上下文和请求上下文存在的目的,官方文档讲的很清楚,可参考:
http://www.pythondoc.com/flask/appcontext.html
应用上下文对象在没有请求的时候是可以单独存在的,但是请求上下文对象只有在收到请求后才会被创建。请求处理和应用上下文和请求上下文的关系是:
接收请求--》创建请求上下文--》请求上下文入栈--》创建该请求的应用上下文--》应用上下文入栈--》处理逻辑--》请求上下文出栈--》应用上下文出栈
系列文章
请求上下文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;
-
一次请求期间,请求上下文创建后会创建对应的本次请求的应用上下文;
-
请求上下文一般不可以单独存在,因为创建请求上下文需要请求数据作为参数;但是应用上下文可以单独存在并且可以手动推送;