之前研究过一段时间Python,最近想做一个项目把它用起来,不然肯定又连基本语法都忘记了(这脑子😂),因为自己一直在做Java Web开发,想着就用Python做一个Web项目。
因为在摸索的过程中,比较跳跃,我发现在探索所有新技术的时候都有这个尴尬的问题,你在认真的看A,发现A的知识点依赖于B,你又去看B,发现B还依赖其它知识点,到最后脑子不知道飘逸到哪里去了。
基于以上:决定把过程通过简书做个笔记,方便自己整理思绪。
- 为什么选择Flask?
- RESTful。
- 一个简单的接口。
- 部署到服务器。
- 包和模块。
- 访问数据库。
- 该返回什么样的数据格式?
- Flask + marshmallow。
- RESTful web service的安全认证。
前面
Python+Flask+MySQL+Redis,实现一个RESTful风格的服务器端程序。
为什么选择Flask?
Django和Flask都有用过,Flask作者的核心思想就是,我要做一个简单的框架,实现核心的功能,剩下的开发者自己集成去;而Django连简单的权限都给你集成了,恨不得让开发者拿到框架就能上手开发一个程序系统。
好吧,我编不下去了,我就是小公鸡点到谁就选谁的~
RESTful
一种软件架构风格,设计风格而不是标准,只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存等机制。
比较喜欢简洁的东西,而RESTful很简洁。
一个简单的接口
部署到服务器
- Fabric是一个很有意思的部署工具
http://www.jianshu.com/p/a0abc3ae1a84
- 搭配Supervisor会更爽
http://www.jianshu.com/p/d6ed564f9e7d
包和模块
访问数据库
- SQLAlchemy
- Flask-SQLAlchemy 是一个为 Flask 应用增加 SQLAlchemy 支持的扩展。
它致力于简化在 Flask 中 SQLAlchemy 的使用,直接粘贴中文的文档地址(有详细的介绍):
http://www.pythondoc.com/flask-sqlalchemy/index.html
该返回什么样的数据格式?
- Flask + marshmallow for beautiful APIs
- Dictalchemy把Model转换成dict
https://pythonhosted.org/dictalchemy/#dictalchemy.utils.asdict
说明
JSON格式数据比较简洁易读,所以暂定所有接口返回数据为JSON格式。
Flask中要返回JSON格式数据,可以使用marshmallow把SQLAlchemy返回的结果集序列化为JSON格式。
还有一种方式就是使用Dictalchemy把SQLAlchemy中的Model转化为Python的dict数据类型,然后通过Flask自带的jsonify序列化为JSON。
我选择的是第二种方式,因为在返回的数据外层,还包裹一层接口状态数据,用dict方式比较方便自定义数据。
上面也有介绍到,项目中使用了Flask-SQLAlchemy扩展,所以以下介绍都是基于使用次扩展的,官网的介绍是基于SQLAlchemy扩展的,如果你的项目没有用到Flask-SQLAlchemy,请参考官网给出的案例。
安装
pip install dictalchemy
使用
使用make_class_dictable标记可被字典化的数据,这里就是Flask-SQLAlchemy中Model继承的基类db.Model
from dictalchemy import make_class_dictable
...
app = Flask(__name__)
app.debug = True
db = SQLAlchemy(app)
make_class_dictable(db.Model)
常用API
asdict()
# 简单示例
session.query(User).asdict()
# 排除主键
session.query(User).asdict(exclude_pk=True)
session.query(User).asdict(exclude=['id'])