本地代理

当请求到来时应用上下文和程序上下文被推入本地栈中，全局变量current_app,request,g,session都可以使用了。以current_app为例，current_app代表的是app这个程序实例，但和app并不是同一个类型。current_app和app都有同样的功能，但是current_app和app不是一个对象。

from flask import Flask, current_app

app = Flask(__name__)

@app.route('/')
def hello_world():
    print(f"{app}  {type(app)}")
    print(f"{current_app}  {type(current_app)}")
    return f"Hello world!"

if __name__ == '__main__':
    app.run()

<Flask 'flask_demo'>  <class 'flask.app.Flask'>
<Flask 'flask_demo'>  <class 'werkzeug.local.LocalProxy'>

可以看出app和current_app都是flask的实例，但是两者的类型是不一样的。app就是flask实例本尊，是真的美猴王，而current_app是werkzeug模块里的本地代理对象，一个假美猴王。

为了探究这个问题，可以从current_app的定义入手。
从current_app的定义来就能知道，不光是current_app是本地代理对象，request，session，g等都是代理对象。

def _lookup_req_object(name):
    top = _request_ctx_stack.top
    if top is None:
        raise RuntimeError(_request_ctx_err_msg)
    return getattr(top, name)


def _lookup_app_object(name):
    top = _app_ctx_stack.top
    if top is None:
        raise RuntimeError(_app_ctx_err_msg)
    return getattr(top, name)
    
def _find_app():
    top = _app_ctx_stack.top
    if top is None:
        raise RuntimeError(_app_ctx_err_msg)
    return top.app
    
_request_ctx_stack = LocalStack()
_app_ctx_stack = LocalStack()

current_app = LocalProxy(_find_app)
request = LocalProxy(partial(_lookup_req_object, 'request'))
session = LocalProxy(partial(_lookup_req_object, 'session'))
g = LocalProxy(partial(_lookup_app_object, 'g'))

这里出现一个重要的概念本地代理，首先要搞明白什么是本地代理。

LocalProxy 介绍

LocalProxy 中文本地代理，和前面介绍的本地线程和本地栈类似，都可以根据线程隔离变量，同时还有代理的功能。
代理在生活中及其常见，比如现在的美团跑腿，你上班时间时间需要送一份文件给朋友，自己又抽不开身，这时可以预约一个全城送，付钱让他给你送文件。这个代送小哥就是一个代理。

广义的代理就是访问对象无法直接访问目标对象，代理对象作为中介，将访问传递给目标对象。

不使用代理
localstack获取栈顶元素的方法就是通过一个函数返回localstack的top。current_app的定义中的_find_app就是获取栈顶元素的函数。首先模拟不使用代理的方法来获取栈顶元素。

from werkzeug.local import LocalStack, LocalProxy
test_stack = LocalStack()
test_stack.push({'abc': '123'})

def get_stack_top():
    return test_stack.top


item = get_stack_top()
print(item)

# 有新的元素入栈
test_stack.push({'abc': '1234'})
print(item)

{'abc': '123'}
{'abc': '123'}

当调用get_stack_top时，获取的最新的栈顶元素item。有元素入栈之后，item就不再是栈顶元素了。根据flask中current_app的使用，无论何时current_app，都是获取栈顶元素。所以需要再次调用函数去获取栈顶元素。

使用本地代理
使用本地代理就不需要每次调用函数去获取栈顶元素，可以做到在app1入栈时current_app栈顶是app1，app2入栈时栈顶是app2。

from werkzeug.local import LocalStack, LocalProxy
test_stack = LocalStack()
test_stack.push({'abc': '123'})

def get_stack_top():
    return test_stack.top

item = LocalProxy(get_stack_top)
print(item)

# 当栈发生变化时，再次使用使用代理对象，仍然可以获取到栈顶元素。
# 原理时每次访问item时，localproxy都会调用get_stack_top去获取栈顶
test_stack.push({'abc': '1234'})
print(item)