现在单页 Web 项目很流行,使用各种 Js 框架,通过 Ajax 和服务器的 Api 进行交互,实现类似原生 app 效果,很酷,对 Flask 来说小菜一碟,是时候了解下 Flask-RESTful 了
开始前先了解下 RESTful,阮一峰老师有这样的解释:
网络应用程序,分为前端和后端两个部分。当前的发展趋势,就是前端设备层出不穷(手机、平板、桌面电脑、其他专用设备......)。因此,必须有一种统一的机制,方便不同的前端设备与后端进行通信。这导致API构架的流行,甚至出现"API First"的设计思想。RESTful API是目前比较成熟的一套互联网应用程序的API设计理论
也就是说 RESTful 一个框架和互联网应用的设计原则,遵循这个设计原则,可以让应用脱离前台展现的束缚,支持不同的前端设备。
安装
Flask 的 RESTful 模块是 flask-restful ,使用 pip 安装:
pip install flask-restful
如果安装顺利,可以在 Python Shell 环境下导入
>>> from flask_restful import Api>>>
小试牛刀
安装好后,简单试试。flask-restful 像之前的 bootstrop-flask 以及 flask-sqlalchamy 模块一样,使用前需要对 Flask 应用进行初始化,然后会得到当前应用的 api 对象,用 api 对象进行资源绑定和路由设置:
from flask import Flaskfrom flask_restful import Api, Resourceapp = Flask(__name__)api = Api(app) # 初始化得到 api 对象
上面代码中从 flask_restful 中引入的 Resource 类是用来定义资源的,具体资源必须是 Resource 的子类,下面定义一个 HelloRESTful 资源:
class HelloRESTful(Resource): def get(self): return {'greet': 'Hello Flask RESTful!'}
接着,给资源绑定 URI:
api.add_resource(HelloRESTful, '/')if __name__ == '__main__': # 别忘了启动应用的代码 app.run(debug=True)
在终端或者命令行下运行 python app.py
启动应用
访问 localhost:5000
或者 127.0.0.1:5000
查看效果,将会看到 JSON 格式的数据输出:
{
"greet": "Hello Flask RESTful!"}
也可以用 curl 工具在终端或者命令行下发送请求:
curl http://localhost:5000