把一個應(yīng)用分解為一套藍圖。這是針對大型應(yīng)用的理想方案：一個項目可以實例化一個應(yīng)用，初始化多個擴展，并注冊許多藍圖。
在一個應(yīng)用的 URL 前綴和（或）子域上注冊一個藍圖。 URL 前綴和（或）子域的參數(shù) 成為藍圖中所有視圖的通用視圖參數(shù)（缺省情況下）。
使用不同的 URL 規(guī)則在應(yīng)用中多次注冊藍圖。
通過藍圖提供模板過濾器、靜態(tài)文件、模板和其他工具。藍圖不必執(zhí)行應(yīng)用或視圖函數(shù)。
當初始化一個 Flask 擴展時，為以上任意一種用途注冊一個藍圖。

Flask 中的藍圖不是一個可插撥的應(yīng)用，因為它不是一個真正的應(yīng)用，而是一套可以注冊在應(yīng)用中的操作，并且可以注冊多次。那么為什么不使用多個應(yīng)用對象呢？可以使用多個應(yīng)用對象（參見應(yīng)用調(diào)度），但是這樣會導(dǎo)致每個應(yīng)用都使用自己獨立的配置，且只能在 WSGI 層中管理應(yīng)用。

而如果使用藍圖，那么應(yīng)用會在 Flask 層中進行管理，共享配置，通過注冊按需改變應(yīng)用對象。藍圖的缺點是一旦應(yīng)用被創(chuàng)建后，只有銷毀整個應(yīng)用對象才能注銷藍圖。

藍圖的概念

藍圖的基本概念是：在藍圖被注冊到應(yīng)用之后，所要執(zhí)行的操作的集合。當分配請求時， Flask 會把藍圖和視圖函數(shù)關(guān)聯(lián)起來，并生成兩個端點之前的 URL 。

第一個藍圖

以下是一個最基本的藍圖示例。在這里，我們將使用藍圖來簡單地渲染靜態(tài)模板:

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 裝飾器綁定一個函數(shù)時，藍圖會記錄下所登記的 show 函數(shù)。當以后在應(yīng)用中注冊藍圖時，這個函數(shù)會被注冊到應(yīng)用中。另外，它會把構(gòu)建 Blueprint 時所使用的名稱（在本例為 simple_page ）作為函數(shù)端點的前綴。

注冊藍圖

可以這樣注冊藍圖:

from flask import Flask
from yourapplication.simple_page import simple_page

app = Flask(__name__)
app.register_blueprint(simple_page)

以下是注冊藍圖后形成的規(guī)則:

[<Rule '/static/<filename>' (HEAD, OPTIONS, GET) -> static>,
 <Rule '/<page>' (HEAD, OPTIONS, GET) -> simple_page.show>,
 <Rule '/' (HEAD, OPTIONS, GET) -> simple_page.show>]

第一條很明顯，是來自于應(yīng)用本身的用于靜態(tài)文件的。后面兩條是用于藍圖 simple_page 的 show 函數(shù)的。你可以看到，它們的前綴都是藍圖的名稱，并且使用一個點（ . ）來分隔。

藍圖還可以掛接到不同的位置:

app.register_blueprint(simple_page, url_prefix='/pages')

這樣就會形成如下規(guī)則:

[<Rule '/static/<filename>' (HEAD, OPTIONS, GET) -> static>,
 <Rule '/pages/<page>' (HEAD, OPTIONS, GET) -> simple_page.show>,
 <Rule '/pages/' (HEAD, OPTIONS, GET) -> simple_page.show>]

總之，你可以多次注冊藍圖，但是不一定每個藍圖都能正確響應(yīng)。是否能夠多次注冊實際上取決于你的藍圖是如何編寫的，是否能根據(jù)不同的位置做出正確的響應(yīng)。

藍圖資源

藍圖還可以用于提供資源。有時候，我們僅僅是為了使用一些資源而使用藍圖。

藍圖資源文件夾

和普通應(yīng)用一樣，藍圖一般都放在一個文件夾中。雖然多個藍圖可以共存于同一個文件夾中，但是最好不要這樣做。

文件夾由 Blueprint 的第二個參數(shù)指定，通常為 __name__ 。這個參數(shù)指定與藍圖相關(guān)的邏輯 Python 模塊或包。如果這個參數(shù)指向的是實際的 Python 包（文件系統(tǒng)中的一個文件夾），那么它就是資源文件夾。如果是一個模塊，那么這個模塊包含的包就是資源文件夾。可以通過 Blueprint.root_path 屬性來查看藍圖的資源文件夾:

>>> simple_page.root_path
'/Users/username/TestProject/yourapplication'

可以使用 open_resource() 函數(shù)快速打開這個文件夾中的資源:

with simple_page.open_resource('static/style.css') as f:
    code = f.read()

靜態(tài)文件

藍圖的第三個參數(shù)是 static_folder 。這個參數(shù)用以指定藍圖的靜態(tài)文件所在的文件夾，它可以是一個絕對路徑也可以是相對路徑。:

admin = Blueprint('admin', __name__, static_folder='static')

缺省情況下，路徑最右端的部分是在 URL 中暴露的部分。上例中的文件夾為 static ，那么 URL 應(yīng)該是藍圖加上 /static 。藍圖注冊為 /admin ，那么靜態(tài)文件夾就是 /admin/static 。

端點的名稱是 blueprint_name.static ，因此你可以使用和應(yīng)用中的文件夾一樣的方法來生成其 URL:

url_for('admin.static', filename='style.css')

模板

如果你想使用藍圖來暴露模板，那么可以使用 Blueprint 的 template_folder 參數(shù):

admin = Blueprint('admin', __name__, template_folder='templates')

和靜態(tài)文件一樣，指向藍圖資源文件夾的路徑可以是絕對的也可以是相對的。藍圖中的模板文件夾會被添加到模板搜索路徑中，但其優(yōu)先級低于實際應(yīng)用的模板文件夾。這樣在實際應(yīng)用中可以方便地重載藍圖提供的模板。

假設(shè)你的藍圖便于 yourapplication/admin 中，要渲染的模板是 'admin/index.html' ， template_folder 參數(shù)值為 templates ，那么真正的模板文件為： yourapplication/admin/templates/admin/index.html 。

創(chuàng)建 URL

如果要創(chuàng)建頁面鏈接，可以和通常一樣使用 url_for() 函數(shù)，只是要把藍圖名稱作為端點的前綴，并且用一個點（ . ）來分隔:

url_for('admin.index')

另外，如果在一個藍圖的視圖函數(shù)或者被渲染的模板中需要鏈接同一個藍圖中的其他端點，那么使用相對重定向，只使用一個點使用為前綴:

url_for('.index')

如果當前請求被分配到 admin 藍圖端點時，上例會鏈接到 admin.index 。

在线观看不卡亚洲电影_亚洲妓女99综合网_91青青青亚洲娱乐在线观看_日韩无码高清综合久久

使用藍圖的模塊化應(yīng)用

為什么使用藍圖？