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ù)。當以后在應用中注冊藍圖時，這個函數(shù)會被注冊到應用中。另外，它會把構建 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>]

第一條很明顯，是來自于應用本身的用于靜態(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>]

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

藍圖資源

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

藍圖資源文件夾

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

文件夾由 Blueprint 的第二個參數(shù)指定，通常為 __name__ 。這個參數(shù)指定與藍圖相關的邏輯 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 應該是藍圖加上 /static 。藍圖注冊為 /admin ，那么靜態(tài)文件夾就是 /admin/static 。

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

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

模板

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

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

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

假設你的藍圖便于 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 。

使用藍圖的模塊化應用

為什么使用藍圖？

藍圖的概念

第一個藍圖

注冊藍圖

藍圖資源

藍圖資源文件夾

靜態(tài)文件

模板

創(chuàng)建 URL

為什么使用藍圖？