资源:
Flakl-SQLAlchemy快速入门
Flask中文文档网页
Tornado中文文档网页
1. Flask介绍
2. 安装flask
3. 基于flask的最小的应用
4. 管理启动项目 Manager
5. Blueprint(蓝图)
6. 请求与响应
7. 异常捕获
8. 路径(route)规则
1. Flask介绍
Flask是一个基于Python实现的web开发的'微'框架
Flask和Django一样,也是一个基于MVC设计模式的Web框架
flask流行的主要原因:
a. 有非常齐全的官方文档,上手非常方便
b. 有非常好的拓展机制和第三方的拓展环境,工作中常见的软件都有对应的拓展,自己动手实现拓展也很容易
c. 微型框架的形式给了开发者更大的选择空间
2. 安装flask
2.1. 虚拟环境搭建
virtualenv --no-site-packages flaskenv
激活windows下虚拟环境
cd Scripts
activate
2.2. 安装
pip install flask
2.3.使用
用PyCharm 项目文件夹,选择配置的虚拟环境
3. 基于flask的最小的应用
创建hello.py
文件
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello_world():
return 'Hello World'
if __name__ == '__main__':
app.run()
运行:python hello.py
3.1. 初始化
app = Flask(__name__)
Flask类构造函数唯一需要的参数就是应用程序的主模块或包。对于大多数应用程序,Python的__name__变量就是那个正确的、你需要传递的值。Flask使用这个参数来确定应用程序的根目录,这样以后可以相对这个路径来找到资源文件。
3.2. 路由
@app.route('/')
客户端例如web浏览器发送 请求 给web服务,进而将它们发送给Flask应用程序实例。应用程序实例需要知道对于各个URL请求需要运行哪些代码,所以它给Python函数建立了一个URLs映射。这些在URL和函数之间建立联系的操作被称之为 路由 。
在Flask应程序中定义路由的最便捷的方式是通过显示定义在应用程序实例之上的app.route装饰器,注册被装饰的函数来作为一个路由
3.3 视图函数
在上一个示例给应用程序的根URL注册hello_world()函数作为事件的处理程序。如果这个应用程序被部署在服务器上并绑定了 www.example.com 域名,然后在你的浏览器地址栏中输入 http://www.example.com 将触发gello_world()来运行服务。客户端接收到的这个函数的返回值被称为 响应 。如果客户端是web浏览器,响应则是显示给用户的文档。
类似于hello_world()的函数被称作: 视图函数 。
3.4. 动态名称组件路由
你的Facebook个人信息页的URL是 http://www.facebook.com/<username> ,所以你的用户名是它的一部分。Flask在路由装饰器中使用特殊的语法支持这些类型的URLs。下面的示例定义了一个拥有动态名称组件的路由:
@app.route('/hello/<name>')
def gello_world(name):
return 'Hello World %s' % name
用尖括号括起来的部分是动态的部分,所以任何URLs匹配到静态部分都将映射到这个路由。当视图函数被调用,Flask发送动态组件作为一个参数。在前面的示例的视图函数中,这个参数是用于生成一个个性的问候作为响应。
在路由中动态组件默认为字符串,但是可以定义为其他类型。例如,路由/user/<int:id>只匹配有一个整数在id动态段的URLs。Flask路由支持int、float
3.5. 服务启动
if __name__ == '__main__':
app.run()
注意: __name__ == '__main__'在此处使用是用于确保web服务已经启动当脚本被立即执行。当脚本被另一个脚本导入,它被看做父脚本将启动不同的服务,所以app.run()调用会被跳过。
一旦服务启动,它将进入循环等待请求并为之服务。这个循环持续到应用程序停止,例如通过按下Ctrl-C。
有几个选项参数可以给app.run()配置web服务的操作模式。在开发期间,可以很方便的开启debug模式,将激活 debugger 和 reloader 。这样做是通过传递debug为True来实现的。
run()中参数有如下:
debug 是否开启调试模式,开启后修改python的代码会自动重启
port 启动指定服务器的端口号
host主机,默认是127.0.0.1
a. 运行默认IP == 127.0.0.1:5000
b. app.run(port=8080, host= '0.0.0.0', debug=True)
4. 管理启动项目 Manager
4.1. 安装插件
pip install flask-script
调整代码
from flask_script import Manager
manager = Manager(app=‘自定义的flask对象’)
if __name__ == '__main__':
manager.run()
4.2. 启动命令
python hellow.py runserver -h 地址 -p 端口 -d -r
其中:-h表示地址。-p表示端口。-d表示debug模式。-r表示自动重启
5. Blueprint(蓝图)
5.1. 什么是蓝图
在Flask项目中可以用Blueprint(蓝图)实现模块化的应用,使用蓝图可以让应用层次更清晰,开发者更容易去维护和开发项目。蓝图将作用于相同的URL前缀的请求地址,将具有相同前缀的请求都放在一个模块中,这样查找问题,一看路由就很快的可以找到对应的视图,并解决问题了。
5.2. 使用蓝图
a. 安装
`pip install flask_blueprint`
b 实例化蓝图应用
from flask import Blueprint
blue = Blueprint(‘first’,__name__)
注意:Blueprint中传入了两个参数,第一个是蓝图的名称,第二个是蓝图所在的包或模块,name代表当前模块名或者包名
c 注册
app = Flask(__name__)
app.register_blueprint(blue, url_prefix='/user')
注意:第一个参数即我们定义初始化定义的蓝图对象,第二个参数url_prefix表示该蓝图下,所有的url请求必须以/user开始。这样对一个模块的url可以很好的进行统一管理
5.3 使用蓝图
修改视图上的装饰器,修改为@blue.router(‘/’)
@blue.route('hello/', methods=['GET', 'POST'])
def hello():
# 视图函数
return 'Hello World'
url为127.0.0.1:5000/user/hello/
5.4 跳转路径
from flask import render_template, redirect, url_for
a. 跳转到template中html文件
return render_template('xxx.html', name1=value1, name2=value2)
b. 目标路径 path
return redirect('/app/hello_world/')
c. 反向解析
url_for('蓝图的第一个参数.跳转到某个函数的函数名')
return redirect(url_for('first.hello'))
6. 请求与响应
常用的请求类型有如下几种
类型 | 说明 |
---|---|
GET | 获取 |
POST | 创建 |
PUT | 修改(全部属性都修改) |
DELETE | 删除 |
PATCH | 修改(修改部分属性) |
6.1. 请求: 客户端传到服务端
request
如果是GET请求: 获取get请求中的参数,使用request.args.get('key')
如果是POST / PUT / PATCH / DELETE 请求: 获取请求中的参数,使用request.form.get('key');
getlist('key') - 获取key重复的value值,结果是列表
@blueprint.route('request/', methods=['GET', 'POST', 'PUT', 'PATCH', 'DELETE'])
def get_request():
request
return 'i am request'
6.2. 响应: 是服务端返回给客户端的
比如设置cookie值
from flask import make_response
make_response
@blueprint.route('response/', methods=['GET'])
def get_response():
res = make_response('<h2>i am response</h2>', 200)
return res
7. 异常捕获
7.1. abort() - 抛出异常
from flask import abort
@blueprint.route('error/', methods=['get'])
def error():
a = 9
b = 0
try:
c = a / b
except:
abort(500)
return '%s/%s=%s'(a, b, c)
7.2. errohandler() - 捕获异常
@blueprint.errorhandler(500)
def handler_500(exception):
return '捕捉异常信息: %s' % exception
8. 路径(route)规则
8.1. 规则
写法:<converter:variable_name>
类型 | 说明 |
---|---|
string | 字符串 |
int | 整形 |
float | 浮点型 |
path | 接受路径,接收的时候是str,/也当做字符串的一个字符 |
uuid | 只接受uuid字符串 |
any | 可以同时指定多种路径,进行限定 |
例子:
# route匹配规则
# 1. <string:xxx> 获取到xxx的参数的值为字符串类型
# 2. <xxx> 默认获取到xxx的参数的值为字符串类型
# 3. <int:xxx> 获取到的xxx的参数的值为整型类型
# 4. <float:xxx> 获取到的xxx的参数的值为浮点型
# 5. <path:xxx> 获取到的xxx的参数的值为路径后面的全部url地址
# 6. <uuid:xxx> 获取到的xxx的参数的值为uuid格式: 06c2a195-13ce-44a0-2453-cc6b0e7e08c4
@blueprint.route('name/<string:s_name>/')
def get_name(s_name):
return '姓名:%s' % s_name
@blueprint.route('age/<age>/')
def get_age(age):
return 'age:%s' % age
@blueprint.route('int_age/<int:age>')
def get_int_age(age):
return '年龄:%s' % age
@blueprint.route('float/<float:number>')
def get_float_number(number):
return '浮点型:%.2f' % number
# 获取path后面的所有路径: /s3r/324/sff/..
@blueprint.route('path/<path:s_path>')
def get_path(s_path):
return '路径: %s' % s_path
@blueprint.route('get_uuid/')
def get_uuid():
a = uuid.uuid4()
return 'uuid: %s' % str(a)
@blueprint.route('uuid/<uuid:s_uuid>')
def get_by_uuid(s_uuid):
return '获取uuid: %s' % s_uuid