Flask-(狗书学习)
1.1 初始化
from flask import Flask
app = Flask(__name__)
1.2 路由和视图函数
@app.route('/')
def index():
return '<h1>Hello World!</h1>'
前例把 index() 函数注册为程序根地址的处理程序.如果部署程序的服务器域名为 www. example.com,在浏览器中访问 http://www.example.com 后,会触发服务器执行 index() 函 数.
这个函数的返回值称为响应,是客户端接收到的内容.如果客户端是 Web 浏览器,响 应就是显示给用户查看的文档.
也就是如果在“/”后添加各种自定义路径就可以实现返回自己定义的不同函数。
注意:在 Python 代码中嵌入响应字符串会导致代码难以维护,此处这么做只是为了介绍响应的概念。
动态地址:
Flask 支持这种形式的 URL,只需在 route 修饰器中使用特 殊的句法即可.下例定义的路由中
<name>
就是动态名字:
@app.route('/user/<name>')
def user(name):
return '<h1>Hello, %s!</h1>' % name
尖括号中的内容就是动态部分,任何能匹配静态部分的 URL 都会映射到这个路由上.调 用视图函数
user(name)
时,Flask 会将动态部分作为参数传入函数.在这个视图函数中,参数用于生成针对个人的欢迎消息.
路由中的动态部分默认使用字符串,不过也可使用类型定义.例如,路由 /user/<int:id> 只会匹配动态片段 id 为整数的 URL.
Flask 支持在路由中使用 int,float 和 path 类型. path 类型也是字符串,但不把斜线视作分隔符,而将其当作动态片段的一部分.
2.3 启动服务器
if __name__ == '__main__'
app.run(debug=True)
app.run(host='0.0.0.0',port=80,debug=True)
2.4 请求-响应循环
2.5.1 程序和请求上下文
为了避免大量可有可无的参数把视图函数弄得一团糟,Flask 使用上下文临时把某些对象 变为全局可访问.有了上下文,就可以写出下面的视图函数:
from flask import request
@app.route('/')
def index():
user_agent = request.headers.get('User-Agent')
return '<p>Your browser is %s</p>' % user_agent
注意在这个视图函数中我们如何把 request 当作全局变量使用.事实上,request 不可能是 全局变量.试想,在多线程服务器中,多个线程同时处理不同客户端发送的不同请求时, 每个线程看到的 request 对象必然不同.
Falsk 使用上下文让特定的变量在一个线程中全局 可访问,与此同时却不会干扰其他线程.
线程:线程是可单独管理的最小指令集.进程经常使用多个活动线程,有时还会共 享内存或文件句柄等资源.多线程 Web 服务器会创建一个线程池,再从线 程池中选择一个线程用于处理接收到的请求.

Flask 在分发请求之前激活(或推送)程序和请求上下文,请求处理完成后再将其删除.
程序上下文被推送后,就可以在线程中使用 current_app 和 g 变量.类似地,
请求上下文被推送后,就可以使用 request 和 session 变量.
如果使用这些变量时我们没有激活程序上 下文或请求上下文,就会导致错误.
>>> 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()
在这个例子中,没激活程序上下文之前就调用 current_app.name 会导致错误,但推送完上 下文之后就可以调用了.
注意:在程序实例上调用 app.app_context() 可获得一个程序上 下文.
2.4.2 请求调度
程序收到客户端发来的请求时,要找到处理该请求的视图函数.为了完成这个任务,Flask 会在程序的 URL 映射中查找请求的 URL.
URL 映射是 URL 和视图函数之间的对应关系. Flask 使用 app.route 修饰器或者非修饰器形式的 app.add_url_rule() 生成映射.
(venv) $ python
>>> from hello import app
>>> app.url_map
Map([<Rule '/' (HEAD, OPTIONS, GET) -> index>,
<Rule '/static/<filename>' (HEAD, OPTIONS, GET) -> static>,
<Rule '/user/<name>' (HEAD, OPTIONS, GET) -> user>])
/ 和 /user/<name> 路由在程序中使用 app.route 修饰器定义./static/<filename> 路由是 Flask 添加的特殊路由,用于访问静态文件.
URL 映射中的 HEAD,Options,GET 是请求方法,由路由进行处理.Flask 为每个路由都指 定了请求方法,这样不同的请求方法发送到相同的 URL 上时,会使用不同的视图函数进行处理.
HEAD 和 OPTIONS 方法由 Flask 自动处理,因此可以这么说,在这个程序中,URL 映射中的 3 个路由都使用 GET 方法.
2.5.3 请求钩子
在请求钩子函数和视图函数之间共享数据一般使用上下文全局变量 g.例如,before_ request 处理程序可以从数据库中加载已登录用户,并将其保存到 g.user 中.随后调用视 图函数时,视图函数再使用 g.user 获取用户.
2.5.4 响应
Flask 调用视图函数后,会将其返回值作为响应的内容.大多数情况下,响应就是一个简单的字符串,作为 HTML 页面回送客户端.例如
return redirect(url_for('admin.list_entries'))# admin.list_entries是html页面
但 HTTP 协议需要的不仅是作为请求响应的字符串.HTTP 响应中一个很重要的部分是状 态码,Flask 默认设为 200,这个代码表明请求已经被成功处理.
如果视图函数返回的响应需要使用不同的状态码,那么可以把数字代码作为第二个返回 值,添加到响应文本之后.例如,下述视图函数返回一个 400 状态码,表示请求无效:
@app.route('/')
def index():
return '<h1>Bad Request</h1>', 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('<h1>This document carries a cookie!</h1>')
response.set_cookie('answer', '42')
return response
有一种名为重定向的特殊响应类型.这种响应没有页面文档,只告诉浏览器一个新地址用 以加载新页面.重定向经常在 Web 表单中使用
重定向经常使用 302 状态码表示,指向的地址由 Location 首部提供.重定向响应可以使用 3 个值形式的返回值生成,也可在 Response 对象中设定.
不过,由于使用频繁,Flask 提 供了 redirect() 辅助函数,用于生成这种响应:
from flask import redirect
@app.route('/')
def index():
return redirect('http://www.example.com')
还有一种特殊的响应由 abort 函数生成,用于处理错误.在下面这个例子中,如果 URL 中 动态参数 id 对应的用户不存在,就返回状态码 404:
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
注意:abort 不会把控制权交还给调用它的函数,而是抛出异常把控制权交给 Web 服 务器
2.6 Flask扩展
Flask 被设计为可扩展形式,故而没有提供一些重要的功能,例如数据库和用户认证,所 以开发者可以自由选择最适合程序的包,或者按需求自行开发.