Python学习笔记——0003 用Flask写简易API

Tag:PyCharmFlaskflask_sqlalchemyFlask-Restless

[TOC]

笔者使用PyCharm来进行开发操作。

一、在PyCharm中新建Flask项目

image

新建项目时,将会联网(外网)下载并安装flaskjinja2等。如果有错误提示,请自行解决网络问题。

二、在PyCharm中的终端,下载所需的包

因为新建项目的时候使用了Virtualenv,所以安装相关依赖,只需要在终端中,正常安装就可以了。此时pip3安装的包,都不是全局的,而只在当前虚拟环境中起作用。

pip3 install flask_sqlalchemy
pip3 install flask_restful
pip3 install flask-cors
pip3 install flask-restless
pip3 install flask-httpauth
pip3 install passlib

本例中,使用flask_sqlalchemyFlask-Restless

pip3 install flask_sqlalchemy
pip3 install flask-restless

关于virtualenv的相关信息,可以参考:virtualenv介绍及基本使用

image

三、导入包

在主文件上方,导入相关的包

import os
from flask import Flask

from flask_sqlalchemy import SQLAlchemy
from flask_restless import APIManager
image

四、初始配置

# 创建Flask应用
app = Flask(__name__)


# 获取项目的基地址
basedir = os.path.abspath(os.path.dirname(__file__))


# 格式为mysql://{用户名}:{密码}@{host}:{端口}/{数据库名}
app.config['SQLALCHEMY_DATABASE_URI']='mysql://root:@172.17.0.17:3307/flaskdb'

# 或者使用SQLite项目文件下的SQLite数据库。
# app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///' + os.path.join(basedir, 'SQL/testSQL.db')

#这个提示你设为true
app.config['SQLALCHEMY_TRACK_MODIFICATIONS']='true'

# 创建Flask-SQLAlchemy对象
db = SQLAlchemy(app)

这里使用SQLAlchemy来连接一个172.17.0.17上3307端口,用户名是root,密码为空,数据库名是flaskdb的MariaDB数据库。

根据官方教程, Flask中常见Config用法有以下几种。

  1. 直接赋值。
  2. 通过config的update方法一次更新多个属性值。
  3. 部分配置值可以通过属性赋值。
  4. 通过文件读取初始化config信息。

关于config的部分,可以参考:读Flask源代码学习Python--config原理,这里不多加赘述。

四、创建数据模型

创建Flask-SQLAlchemy模型(亦有成为bean的),但是要遵守下列两点(合理)限制:
1.必须有一个主键类型是sqlalchemy.Integer或sqlalchemy.Unicode;
2.必须有init方法,用来初始化数据(flask.ext.sqlalchemy.SQLAlchemy.Model已经提供)。

class Person(db.Model):
  id = db.Column(db.Integer, primary_key=True)
  name = db.Column(db.Unicode, unique=True)
  birth_date = db.Column(db.Date)


class Computer(db.Model):
  id = db.Column(db.Integer, primary_key=True)
  name = db.Column(db.Unicode, unique=True)
  vendor = db.Column(db.Unicode)
  purchase_time = db.Column(db.DateTime)
  owner_id = db.Column(db.Integer, db.ForeignKey('person.id'))
  owner = db.relationship('Person', backref=db.backref('computers', lazy='dynamic'))
    
db.create_all()

flask-sqlalchemy中的SQLAlchemy可以用orm处理数据库,告别繁琐的sql语句。文档链接:http://flask-sqlalchemy.pocoo.org/2.3/

五、创建数据库表

创建API端点,这些端点默认在/api/<tablename>可获取。指定允许的HTTP方法也能被这样配置。

# 创建Flask-Restless API管理器
manager = APIManager(app, flask_sqlalchemy_db=db)

# 创建api的endpoint,并指定调用方法
manager.create_api(Person, methods=['GET', 'POST', 'DELETE'])
manager.create_api(Computer, methods=['GET'])

更多关于Flask-Restless的内容,请查阅官方文档,本文不在赘述。文档链接:https://flask-restless.readthedocs.io/en/latest/index.html

六、主程序入口

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=6789)

在浏览器中输入地址即ip加端口进行访问验证:

http://127.0.0.1:6789/api/person
http://127.0.0.1:6789/api/computer
或者
http://172.17.0.38:6789/api/person
http://172.17.0.38:6789/api/computer

此时应该得到一个json的response。

{"num_results":2,"objects":[{"birth_date":"2018-08-20","computers":[{"id":1,"name":"tt01","owner_id":1,"purchase_time":"2018-08-20T11:58:17","vendor":"dd"},{"id":3,"name":"tt03","owner_id":1,"purchase_time":"2018-08-20T11:58:12","vendor":"22"}],"id":1,"name":"wolf"},{"birth_date":"2018-08-20","computers":[{"id":2,"name":"tt02","owner_id":2,"purchase_time":"2018-08-20T11:58:21","vendor":"33"}],"id":2,"name":"tst"}],"page":1,"total_pages":1}

七、完整文件

完整的flaskAPI.py如下所示:

import os
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_restless import APIManager

app = Flask(__name__)

'''
根据官方教程, Flask中常见Config用法有以下几种。

    1.直接赋值。
    2.通过config的update方法一次更新多个属性值。
    3.部分配置值可以通过属性赋值。
    4.通过文件读取初始化config信息。
'''
# 获取项目的基地址
basedir = os.path.abspath(os.path.dirname(__file__))

# 格式为mysql://{用户名}:{密码}@{host}:{端口}/{数据库名}
# app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql://root:@172.17.0.17:3307/flaskdb'
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///' + os.path.join(basedir, 'SQL/testSQL.db')

# 这个提示你设为true
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = 'true'

# 创建Flask-SQLAlchemy对象
db = SQLAlchemy(app)

# 像往常一样创建Flask-SQLAlchemy模型,但是要遵守下列两点(合理)限制:
#  1.必须有一个主键类型是sqlalchemy.Integer或sqlalchemy.Unicode。
#  2.必须有__init__方法,用来初始化数据(flask.ext.sqlalchemy.SQLAlchemy.Model已经提供)。
class Person(db.Model):
  id = db.Column(db.Integer, primary_key=True)
  name = db.Column(db.Unicode, unique=True)
  birth_date = db.Column(db.Date)

class Computer(db.Model):
  id = db.Column(db.Integer, primary_key=True)
  name = db.Column(db.Unicode, unique=True)
  vendor = db.Column(db.Unicode)
  purchase_time = db.Column(db.DateTime)
  owner_id = db.Column(db.Integer, db.ForeignKey('person.id'))
  owner = db.relationship('Person', backref=db.backref('computers', lazy='dynamic'))

# 创建数据库表。
manager = APIManager(app, flask_sqlalchemy_db=db)

# 创建API端点,这些端点默认在'/api/<tablename>'可获取。
# 指定允许的HTTP方法也能被这样配置。
manager.create_api(Person, methods=['GET', 'POST', 'DELETE'])
manager.create_api(Computer, methods=['GET'])

@app.route('/')
def hello_world():
    return 'Hello WOLF!'

if __name__ == '__main__':
    db.create_all()
    app.run(host='0.0.0.0', port=6789)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,530评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 86,403评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,120评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,770评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,758评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,649评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,021评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,675评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,931评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,659评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,751评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,410评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,004评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,969评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,042评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,493评论 2 343

推荐阅读更多精彩内容