路由

• 要給 URL 添加變量部分，你可以把這些特殊的字段標(biāo)記為 <variable_name> ， 這個(gè)部分將會(huì)作為命名參數(shù)傳遞到你的函數(shù)蓄愁。規(guī)則可以用 <converter:variable_name> 指定一個(gè)可選的轉(zhuǎn)換器

@app.route('/user/<username>')
def show_user_profile(username):
    # show the user profile for that user
    return 'User %s' % username

@app.route('/post/<int:post_id>')
def show_post(post_id):
    # show the post with the given id, the id is an integer
    return 'Post %d' % post_id

• 唯一 URL / 重定向行為

待補(bǔ)充 / Werkzeug 文檔

Flask 的 URL 規(guī)則基于 Werkzeug 的路由模塊

@app.route('/projects/')
def projects():
    return 'The project page'

@app.route('/about')
def about():
    return 'The about page'

• 構(gòu)造 URL

以下例子就不用語(yǔ)言敘述了

>>> from flask import Flask, url_for
>>> app = Flask(__name__)
>>> @app.route('/')
... def index(): pass
...
>>> @app.route('/login')
... def login(): pass
...
>>> @app.route('/user/<username>')
... def profile(username): pass
...

print url_for('index')
print url_for('login')
print url_for('login', next='/')
print url_for('profile', username='John Doe')
...

/
/login
/login?next=/
/user/John%20Doe

• HTTP 方法

# 默認(rèn) method 為 get
from flask import request
@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        do_the_login()
    else:
        show_the_login_form()

靜態(tài)文件(static)

也就是 web 里常用的 CSS/ JavaScript 文件, Flask默認(rèn)配置路徑為/static 可以通過(guò) url_for('static', filename='style.css') 來(lái)獲取靜態(tài)文件的路徑

模版渲染

Flask 使用 Jinja2 模板引擎, 默認(rèn)模板路徑為/templates Jinja2文檔

from flask import render_template

@app.route('/hello/')
@app.route('/hello/<name>')
def hello(name=None):
    return render_template('hello.html', name=name)

請(qǐng)求數(shù)據(jù)

• request

# 想使用該對(duì)象,需要從 flask 模塊中導(dǎo)入
from flask import request

@app.route('/login', methods=['POST', 'GET'])
def login():
    error = None
    if request.method == 'POST':
    # 訪問(wèn) form 屬性中的不存在的鍵會(huì)發(fā)生什么阅酪？會(huì)拋出一個(gè)特殊的 `KeyError` 異常
        if valid_login(request.form['username'],
                       request.form['password']):
            return log_the_user_in(request.form['username'])
        else:
            error = 'Invalid username/password'
    return render_template('login.html', error=error)

# 獲取 url 上的參數(shù)( GET )   類似于 `?key=value`
# 如果訪問(wèn)不存在的 key 也會(huì)拋出`KeyError`, 建議 catch
searchword = request.args.get('q', '')

• upload file

from flask import request

@app.route('/upload', methods=['GET', 'POST'])
def upload_file():
    if request.method == 'POST':
        f = request.files['the_file']
        f.save('存在文件的路徑')
    ...

# 你可以訪問(wèn) filename 屬性知道上傳前文件在客戶端的文件名
# 但請(qǐng)記住， 永遠(yuǎn)不要信任這個(gè)值汁针，這個(gè)值是可以偽造的术辐。如果你要把文件按客戶端提供的 文件名存儲(chǔ)在服務(wù)器上，那么請(qǐng)把它傳遞給 Werkzeug 提供的 secure_filename() 函數(shù):

from flask import request
from werkzeug import secure_filename

@app.route('/upload', methods=['GET', 'POST'])
def upload_file():
    if request.method == 'POST':
        f = request.files['the_file']
        f.save('/var/www/uploads/' + secure_filename(f.filename))
    ...

• cookie

cookie 結(jié)構(gòu)為 dict, 取不存在的 key 會(huì)產(chǎn)生 keyError 異常

from flask import request
from flask import make_response

@app.route('/')
def index():
    resp = make_response(render_template(...))
    # 存
    resp.set_cookie('username', 'the username')
    # 取
    username = request.cookies.get('username')
    return resp

重定向&錯(cuò)誤

from flask import abort, redirect, url_for, render_template

@app.route('/')
def index():
    # 重定向到 login 函數(shù)
    return redirect(url_for('login'))

@app.route('/login')
def login():
    pass
    
@app.route('error')
def error():
    # 404
    abort(404)
    # this_is_never_executed
    
@app.errorhandler(404)
def page_not_found(error):
    return render_template('page_not_found.html'), 404

response

from flask import make_response

@app.errorhandler(404)
def not_found(error):
    resp = make_response(render_template('error.html'), 404)
    resp.headers['X-Something'] = 'A value'
    # 包裝的響應(yīng)對(duì)象
    return resp

session

暫無(wú)

logging

相關(guān)文檔-> logging 文檔

app.logger.debug('A value for debugging')
app.logger.warning('A warning occurred (%d apples)', 42)
app.logger.error('An error occurred')