用蓝图实现模块化的应用¶
0.7 新版功能.
Flask用蓝图的概念来在一个应用中或跨应用制作应用组件和支持通用的模式。 蓝图很好地简化了大型应用工作的方式，并提供给 Flask 扩展在应用 上注册操作的核心方法。 一个Blueprint对象与Flask应用对象的工作方式很像，但它确实不是一个应用。相反，它是一个描述如何构建或扩展应用的蓝图。
为什么使用蓝图？¶
Flask 中的蓝图为这些情况设计:
- 把一个应用分解为一个蓝图的集合。 这对大型应用是理想的；一个项目可以实例化 一个应用对象，初始化几个扩展，并注册一集合的蓝图。
- 以 URL 前缀和/或子域名，在应用上注册一个蓝图。 URL 前缀/子域名中的参数即 成为这个蓝图下的所有视图函数的共同的视图参数（默认情况下）。
- 在一个应用中用不同的 URL 规则多次注册一个蓝图。
- 通过蓝图提供模板过滤器、静态文件、模板和其它功能。 一个蓝图不一定要实现应 用或者视图函数。
- 初始化一个 Flask 扩展时，在这些情况中注册一个蓝图。
Flask 中的蓝图不是即插应用，因为它实际上并不是一个应用——它是可以注册，甚至 可以多次注册到应用上的操作集合。 为什么不使用多个应用对象？ 你可以做到那样 （见 应用调度 ），但是你的应用的配置是分开的，并在 WSGI 层管理。
蓝图作为 Flask 层提供分割的替代，共享应用配置，并且在必要情况下可以更改所 注册的应用对象。 它的缺点是你不能在应用创建后撤销注册一个蓝图而不销毁整个应用对象。
蓝图的概念¶
蓝图的基本设想是当它们注册到应用上时，它们记录将会被执行的操作。 当分派请求和生成从一个端点到另一个的 URL 时，Flask 会关联蓝图中的视图函数。
我的第一个蓝图¶
这看起来像是一个非常基本的蓝图。 在这个案例中，我们想要实现一个简单渲染静态 模板的蓝图:
from flask import Blueprint, render_template, abort
from jinja2 import TemplateNotFound
simple_page = Blueprint('simple_page', __name__,
template_folder='templates')
@simple_page.route('/', defaults={'page': 'index'})
@simple_page.route('/<page>')
def show(page):
try:
return render_template('pages/%s.html' % page)
except TemplateNotFound:
abort(404)
当我们使用 @simple_page.route 装饰器绑定函数时，在蓝图之后被注册时它 会记录把 show 函数注册到应用上的意图。 此外，它会给函数的端点加上由Blueprint 的构造函数中给出的蓝图的名称作为前缀（在此例中是simple_page）。
注册蓝图¶
那么你如何注册蓝图？ 像这样：
from flask import Flask
from yourapplication.simple_page import simple_page
app = Flask(__name__)
app.register_blueprint(simple_page)
如果你检查已经注册到应用的规则，你会发现这些:
[<Rule '/static/<filename>' (HEAD, OPTIONS, GET) -> static>,
<Rule '/<page>' (HEAD, OPTIONS, GET) -> simple_page.show>,
<Rule '/' (HEAD, OPTIONS, GET) -> simple_page.show>]
第一个显然是来自应用自身，用于静态文件。 其它的两个用于 simple_page 蓝图中的 show 函数。 如你所见，它们的前缀是蓝图的名称，并且用一个点 （ . ）来分割。 ）。
不过，蓝图也可以在不同的位置挂载:
app.register_blueprint(simple_page, url_prefix='/pages')
那么，这些果然是生成出的规则:
[<Rule '/static/<filename>' (HEAD, OPTIONS, GET) -> static>,
<Rule '/pages/<page>' (HEAD, OPTIONS, GET) -> simple_page.show>,
<Rule '/pages/' (HEAD, OPTIONS, GET) -> simple_page.show>]
在此之上，你可以多次注册蓝图，虽然不是每个蓝图都会正确地响应这些。 实际上， 蓝图能否被多次挂载，取决于蓝图是怎样实现的。
蓝图资源¶
蓝图也可以提供资源。 有时候你会只为它提供的资源而引入一个蓝图。
蓝图资源文件夹¶
像常规的应用一样，蓝图被设想为包含在一个文件夹中。 当多个蓝图源于同一个文件 夹时，可以不必考虑上述情况，但也这通常不是推荐的做法。
这个文件夹会从Blueprint的第二个参数中推断出来，通常是__name__。 这个参数决定对应蓝图的是哪个逻辑的 Python 模块或包。 如果它指向一个存在的 Python 包，这个包（通常是文件系统中的文件夹）就是资源文件夹。 如果是一个模块， 模块所在的包就是资源文件夹。 你可以访问 Blueprint.root_path 属性来查看 资源文件夹是什么:
>>> simple_page.root_path
'/Users/username/TestProject/yourapplication'
可以使用open_resource()函数来快速从这个文件夹打开源文件：
with simple_page.open_resource('static/style.css') as f:
code = f.read()
静态文件¶
一个蓝图可以通过 static_folder 关键字参数提供一个指向文件系统上文件夹的路 径，来暴露一个带有静态文件的文件夹。 这可以是一个绝对路径，也可以是相对于蓝图 文件夹的路径:
admin = Blueprint('admin', __name__, static_folder='static')
默认情况下，路径最右边的部分就是它在 web 上所暴露的地址。 因为这里这个文件夹叫做static，它会在蓝图 + /static的位置上可用。 也就是说，蓝图为 /admin 把静态文件夹注册到 /admin/static 。
最后是命名的 blueprint_name.static ，这样你可以生成它的 URL ，就像你对应用 的静态文件夹所做的那样:
url_for('admin.static', filename='style.css')
模板¶
如果你想要蓝图暴露模板，你可以提供Blueprint构造函数中的template_folder参数来实现：
admin = Blueprint('admin', __name__, template_folder='templates')
像对待静态文件一样，路径可以是绝对的或是相对蓝图资源文件夹的。
模板文件夹会 被加入到模板的搜索路径中，但是比实际的应用模板文件夹优先级低。 这样，你可以 容易地在实际的应用中覆盖蓝图提供的模板。 这也意味着，如果不想意外覆盖蓝图模板，请确保没有其他蓝图或实际应用程序模板具有相同的相对路径。当多个蓝图提供相同的相对模板路径时，注册的第一个蓝图优先于其他蓝图。
因此，如果您在文件夹yourapplication/admin中有一个蓝图，并且想渲染模板'admin/index.html'，同时已经提供将templates 作为 template_folder ，那么您将需要创建一个如下的文件：yourapplication/admin/templates/admin/index.html。 额外admin文件夹的原因是为了避免在实际应用程序模板文件夹中使用名为index.html的模板覆盖我们的模板。
要进一步重申这一点：如果您有一个名为admin的蓝图，并且要渲染一个名为index.html的模板，该模板特定于此蓝图，最好的想法是像这样放置您的模板：
yourpackage/
blueprints/
admin/
templates/
admin/
index.html
__init__.py
然后，当您想要呈现模板时，使用admin/index.html作为查找模板的名称。如果加载正确的模板时启用了EXPLAIN_TEMPLATE_LOADING配置变量，它将指示Flask打印出每个render_template调用中定位模板的步骤。