在hello.py程序中,增加动态路由
from flask import Flask
app = Flask(__name__)
@app.route('/')
def index():
return 'Hello World!
'
@app.route('/user/' )
def user(name):
return 'Hello, %s!
' % name
if __name__ == '__main__':
app.run(debug=True)
程序和请求下文
Flask 从客户端收到请求时,要让视图函数能访问一些对象,这样才能处理请求。 请求对象就是一个很好的例子,它封装了客户端发送的 HTTP 请求。
要想让视图函数能够访问请求对象, 一个显而易见的方式是将其作为参数传入视图函数,不过这会导致程序中的每个视图函数都增加一个参数。 除了访问请求对象,如果视图函数在处理请求时还要访问其他对象,情况会变得更糟。
为了避免大量可有可无的参数把视图函数弄得一团糟, Flask 使用上下文临时把某些对象变为全局可访问。有了上下文,就可以写出下面的视图函数:
from flask import request
@app.route('/')
def index():
user_agent = request.headers.get('User-Agent')
return 'Your browser is %s
' % user_agent
注意在这个视图函数中我们如何把 request 当作全局变量使用。事实上, request 不可能是全局变量。试想,在多线程服务器中,多个线程同时处理不同客户端发送的不同请求时,每个线程看到的 request 对象必然不同。 Falsk 使用上下文让特定的变量在一个线程中全局可访问,与此同时却不会干扰其他线程。
Flask上下文全局变量
Flask 在分发请求之前激活(或推送)程序和请求上下文,请求处理完成后再将其删除。程序上下文被推送后, 就可以在线程中使用 current_app 和 g 变量。类似地,请求上下文被推送后,就可以使用 request 和 session 变量。如果使用这些变量时我们没有激活程序上下文或请求上下文, 就会导致错误。
shell上使用方法:
>python
>>>from hello import app
>>>from flask import current_app
>>>current_app.name
>Traceback (most recent call last):
...##注意这里报错,是为了告诉没有激活程序上下文就调用current_app.name会出错
RuntimeError: working outside of application context
>>> app_ctx = app.app_context()
>>> app_ctx.push()
>>> current_app.name
'hello'
>>> app_ctx.pop()
hello.py程序一定要先开启运行
程序收到客户端发来的请求时,要找到处理该请求的视图函数。为了完成这个任务, Flask会在程序的 URL 映射中查找请求的 URL。 URL 映射是 URL 和视图函数之间的对应关系。Flask 使用 app.route 修饰器或者非修饰器形式的 app.add_url_rule() 生成映射。
>python
>>>from hello import app
>>> app.url_map
Map([<Rule '/' (OPTIONS, HEAD, GET) -> index>,
<Rule '/static/' (OPTIONS, HEAD, GET) -> static>,
<Rule '/user/' (OPTIONS, HEAD, GET) -> user>])
请求钩子
有时在处理请求之前或之后执行代码会很有用。例如,在请求开始时,我们可能需要创建数据库连接或者认证发起请求的用户。 为了避免在每个视图函数中都使用重复的代码,Flask 提供了注册通用函数的功能, 注册的函数可在请求被分发到视图函数之前或之后调用。
请求钩子使用修饰器实现。 Flask 支持以下 4 种钩子。
在请求钩子函数和视图函数之间共享数据一般使用上下文全局变量 g。例如, before_request 处理程序可以从数据库中加载已登录用户,并将其保存到 g.user 中。随后调用视图函数时,视图函数再使用 g.user 获取用户。
响应
Flask 调用视图函数后,会将其返回值作为响应的内容。大多数情况下,响应就是一个简单的字符串,作为 HTML 页面回送客户端。
但 HTTP 协议需要的不仅是作为请求响应的字符串。 HTTP 响应中一个很重要的部分是状态码, Flask 默认设为 200,这个代码表明请求已经被成功处理。
如果视图函数返回的响应需要使用不同的状态码, 那么可以把数字代码作为第二个返回值,添加到响应文本之后。例如,下述视图函数返回一个 400 状态码,表示请求无效:
@app.route('/')
def index():
return 'Bad Request
',400
视图函数返回的响应还可接受第三个参数,这是一个由首部( header)组成的字典,可以添加到 HTTP 响应中。
如果不想返回由 1 个、 2 个或 3 个值组成的元组, Flask 视图函数还可以返回 Response 对象。 make_response() 函数可接受 1 个、 2 个或 3 个参数(和视图函数的返回值一样),并返回一个 Response 对象。有时我们需要在视图函数中进行这种转换,然后在响应对象上调用各种方法,进一步设置响应。下例创建了一个响应对象,然后设置了 cookie:
from flask import make_response
@app.route('/')
def index():
response = make_response('This document carries a cookie!
')
response.set_cookie('answer', '42')
return response
有一种名为重定向的特殊响应类型。 这种响应没有页面文档,只告诉浏览器一个新地址用以加载新页面。
重定向经常使用 302 状态码表示,指向的地址由 Location 首部提供。重定向响应可以使用3 个值形式的返回值生成, 也可在 Response 对象中设定。不过,由于使用频繁, Flask 提供了 redirect() 辅助函数,用于生成这种响应:
from flask import redirect
@app.route('/')
def index():
return redirect('https://blog.csdn.net/richowe')
redirect()辅助函数重定向到新的url。
还有一种特殊的响应由 abort 函数生成,用于处理错误。在下面这个例子中,如果 URL 中动态参数 id 对应的用户不存在,就返回状态码 404:
from flask import abort
@app.route('/user/' )
def get_user(id):
user = load_user(id)
if not user:
abort(404)
return 'Hello, %s
' % user.name
注意, abort 不会把控制权交还给调用它的函数,而是抛出异常把控制权交给 Web 服务器。
可以看见返回为404
* Restarting with stat
* Debugger is active!
* Debugger PIN: 109-618-885
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
127.0.0.1 - - [25/Apr/2020 22:36:46] "GET / HTTP/1.1" 404 -