转载自 http://www.cnblogs.com/whuyt
1. 初始化
所有flask程序都必须创建一个程序实例(application instance)
from flask import Flask app = Flask(__name__)
2. 路由和视图函数
处理URL和函数之间关系的程序称为路由。
在Flask中定义定义路由最简单的方式,是使用程序实例提供的app.route修饰器,把修饰的函数注册为路由。
@app.route('/') def index(): return '<h1>Hello World!</h1>'
像index这样的函数即称为视图函数(view function)
flask支持动态URL
@app.route('/user/<name>') def user(name): return '<h1>Hello, %s</h1>' % name
路由中的动态部分默认使用字符串, 但flask支持在路由中使用int, float和path类型
如路由 /user/<int:id>只会匹配动态片段 id 为整数的 URL
3. 启动服务器
if __name__ == '__main__': app.run(debug=True)
4. 请求-响应
请求
视图函数经常需要处理请求,这样就要传入请求对象参数。
为了避免大量参数把视图函数搞得一团糟, flask使用上下文临时把某些对象变为全局可访问。
事实上,request 不可能是全局变量。试想,在多线程服务器中,多个线程同时处理不同客户端发送的不同请求时,每个线程看到的 request 对象必然不同。
Falsk 使用上下文让特定的变量在一个线程中全局可访问,与此同时却不会干扰其他线程。
from flask import request @app.route('/') def index(): user_agent = request.headers.get('User-Agent') return '<p>Your browser is %s</p>' % user_agent
变量名 | 上下文 | 说明 |
current_app | 程序上下文 | 当前激活程序的程序实例 |
g | 程序上下文 | 处理请求时用作临时存储的对象。每次请求都会重设这个变量 |
request | 请求上下文 | 请求对象,封装了客户端发出的 HTTP 请求中的内容 |
session | 请求上下文 | 用户会话,用于存储请求之间需要“记住”的值的词典 |
Flask 在分发请求之前激活(或推送)程序和请求上下文,请求处理完成后再将其删除。
程序上下文被推送后,就可以在线程中使用 current_app 和 g 变量。类似地,请求上下文被推送后,就可以使用 request 和 session 变量。
如果使用这些变量时我们没有激活程序上下文或请求上下文,就会导致错误。
下面这个 Python shell 会话演示了程序上下文的使用方法:
>>> from hello import app >>> from flask import current_app >>> current_app.name Traceback (most recent call last): ... RuntimeError: working outside of application context >>> app_ctx = app.app_context() >>> app_ctx.push() >>> current_app.name 'hello' >>> app_ctx.pop()
程序实例上调用 app.app_context() 可获得一个程序上下文。push之后就可以调用了。
请求Hooks
请求hooks由装饰器实现。下面是四个Flask支持的hooks:
before_first_request
:在第一个请求被处理前注册一个函数运行。before_request
:在每一个请求前注册一个函数运行。after_request
:如果没有未处理的异常发生,在每一个请求后注册一个函数运行。teardown_request
:即使未处理的异常发生,在每一个请求后注册一个函数运行。
在请求钩子函数和视图函数之间共享数据一般使用上下文全局变量 g。
例如,before_request 处理程序可以从数据库中加载已登录用户,并将其保存到 g.user 中。随后调用视图函数时,视图函数再使用 g.user 获取用户。
响应
视图函数返回的响应可以把状态码作为第二个参数, 把首部组成的字典作为第三个参数
@app.route('/') def index(): return '<h1>Bad Request</h1>', 400
flask视图函数还可以返回Response对象(往往用于需要在响应对象上调用各种方法, 进一步设置响应)
from flask import make_response @app.route('/') def index(): response = make_response('<h1>This document carries a cookie!</h1>') response.set_cookie('answer', '42') return response
重定向
from flask import redirect @app.route('/') def index(): return redirect('http://www.example.com')
abort (用于处理错误)
from flask import abort @app.route('/user/<id>') def get_user(id): user = load_user(id) if not user: abort(404) return '<h1>Hello, %s<h1>' % user.name
5. flask运用扩展
使用Flask-Script支持命令行选项
from flask.ext.script import Manager manager = Manager(app) # ... if __name__ == '__main__': manager.run()