本篇所有操作均在基于 Ubuntu 16.04 LTS 的虚拟机下完成，且使用 Vagrant 来操作虚拟机系统，虚拟机系统 VirtualBox Version: 7.0
一、蓝图
环境准备：
Python 2.7.11+
pip==9.0.3
flask==0.11.1
httpie==0.9.4
werkzeug==0.11.10
1、背景
由于项目开发是一个非常耗时间和精力的工程，如果我们将所有的路由都写在同一个文件下的话，非常不便于代码管理和后期功能代码的添加。如下代码示例（manage_v1.py）：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# -*- coding: utf-8 -*-#
from flask import Flask
app = Flask(__name__)
@app.route('/')
def index():
return 'index'
@app.route('/admin/hello')
def hello():
return '/admin/hello'
@app.route('/admin/new')
def new():
return '/admin/new'
@app.route('/admin/edit')
def edit():
return '/admin/edit'
if __name__ == '__main__':
app.run(host='0.0.0.0', port=9000, debug=True)
2、使用蓝图示例
蓝图（BluePrint）实现了应用的模块化，使用蓝图让应用层次清晰，开发者可以更容易的开发和维护项目。
蓝图通常作用于相同的 URL 前缀，比如 /user/:id、/user/profile 这样的地址，这些地址都是以 /user 开头，那么它们就可以放在一个模块中。如以下的模块示例：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
# coding=utf-8
from flask import Blueprint
bp = Blueprint('user', __name__, url_prefix='/user') # 使用 url_prefix 来设置前缀
@bp.route('/')
def index():
return '/user/'
@bp.route('/profile')
def index():
return '/user/profile'
每个模块都会暴露一个全局变量 bp，之后在主程序中使用 register_blueprint 注册模块即可（如果想去掉模块只需要去掉对应的注册语句即可）。在主程序中注册模块的代码示例：
1
2
3
4
5
6
7
8
9
10
11
# coding=utf-8
from flask import Flask
import user
app = Flask(__name__)
app.register_blueprint(user.bp)
if __name__ == '__main__':
print app.url_map
app.run(host='0.0.0.0', port=9000)
执行主程序，访问结果如下：
- 访问 GET http://127.0.0.1:9000/user/
1 2 3 4 5 6 7
HTTP/1.0 200 OK Content-Length: 6 Content-Type: text/html; charset=utf-8 Date: Sat, 19 Nov 2022 14:58:23 GMT Server: Werkzeug/0.11.10 Python/2.7.11 /user/
- 访问 http://127.0.0.1:9000/user/profile
1 2 3 4 5 6 7
HTTP/1.0 200 OK Content-Length: 13 Content-Type: text/html; charset=utf-8 Date: Sat, 19 Nov 2022 14:58:30 GMT Server: Werkzeug/0.11.10 Python/2.7.11 /user/profile
二、蓝图基础实践
1、项目结构
项目 app_blueprint 由主程序文件和模块文件构成。
1
2
3
4
5
app_blueprint/
├── admin.py # admin 模块文件
├── manage_v1.py
├── manage_v2.py # 主程序文件
└── user.py # user 模块文件
2、模块文件
（1）user.py 模块文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# -*- coding: utf-8 -*-#
from flask import Blueprint
# 三个参数分别是：蓝图的名称（自定义）、蓝图所在的模块、URL 前缀
bp = Blueprint('user', __name__, url_prefix='/user')
@bp.route('/hello')
def hello():
return '/user/hello'
@bp.route('/new')
def new():
return '/user/new'
@bp.route('/edit')
def edit():
return '/user/edit'
（2）admin.py 模块文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# -*- coding: utf-8 -*-#
from flask import Blueprint
# 三个参数分别是：蓝图的名称（自定义）、蓝图所在的模块、URL 前缀
bp = Blueprint('admin', __name__, url_prefix='/admin')
@bp.route('/hello')
def hello():
return '/admin/hello'
@bp.route('/new')
def new():
return '/admin/new'
@bp.route('/edit')
def edit():
return '/admin/edit'
3、主程序文件
manage_v2.py 主程序文件
1
2
3
4
5
6
7
8
9
10
11
12
13
# -*- coding: utf-8 -*-#
from flask import Flask
import admin
import user
app = Flask(__name__)
app.register_blueprint(admin.bp)
app.register_blueprint(user.bp)
if __name__ == '__main__':
print app.url_map
app.run(host='0.0.0.0', port=2000, debug=True)
4、执行主程序
执行主程序：
1
> python manage_v2.py
在另一个终端中使用 httpie 来发送请求，请求结果如下：
- 访问 GET http://127.0.0.1:2000/user/hello
1 2 3 4 5 6 7
HTTP/1.0 200 OK Content-Length: 11 Content-Type: text/html; charset=utf-8 Date: Sat, 19 Nov 2022 15:20:08 GMT Server: Werkzeug/1.0.1 Python/2.7.11 /user/hello
- 访问 GET http://127.0.0.1:2000/admin/new
1 2 3 4 5 6 7 8
HTTP/ OK HTTP/1.0 200 OK Content-Length: 10 Content-Type: text/html; charset=utf-8 Date: Sat, 19 Nov 2022 15:19:48 GMT Server: Werkzeug/1.0.1 Python/2.7.11 /admin/new
相关链接：
Flask 蓝图
