Flask学习之一——程序的基本结构

转载自 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()