异想天开: 想通过一个视图函数模板,实现「视图函数工厂」,然后实现动态生成接口的路由。
用途: 为什么要这么做呢?
大家都知道 Flask 维护了一个路由映射字典,用来管理路由路径和视图函数的映射关系,通过动态生成接口,可以实现动态注入视图函数的「描述信息」,通过这些描述信息来生成接口的描述文档,利用 Swagger UI 生成标准的接口文档。
原始方案: 在url规则中添加变量api_name实现动态路由,的缺点是:只有一个视图函数,函数的描述信息和函数的名字是同样的值
@app.route('/test/<api_name>')
def greet(name):
"""
函数的描述信息
"""
return ifr
代替方案: 通过通过动态生成视图函数,动态注入 doc和 name 信息
from flask import Flask, request
app = Flask(__name__)
# 视图函数模板
def test_api(data):
# 根据 request.url 进行能力路由
pass
# 动态注册 API
# 动态生成视图函数 test1,从模板函数中拷贝代码逻辑
test1 = FunctionType(test_api.__code__, {}, closure=test_api.__closure__)
test1.__doc__ = '测试1 \n\t 牛1' # 函数文档
test1.__name__ = 'test1' # 函数名称
app.add_url_rule('/test/test1', view_func=test1)
test2 = FunctionType(test_api.__code__, {}, closure=test_api.__closure__)
test2.__doc__ = '测试2 \n\t 牛2'
test2.__name__ = 'test2'
app.add_url_rule('/test/test2', view_func=test2)
ToDo: 这里仅仅注入了 doc 和 name,schema 信息需要通过 doc 的内容进一步解析实现。