python-flask学习（一）

 

Flask-（狗书学习）

Flask 自开发伊始就被设计为可扩展的框架，它具备一个包含基本服务的强健核心，其余功能则可经过扩展实现。你能够本身挑选所需的扩展包，组成一个没有附加功能的精益组合，从而彻底精确知足自身需求。

 

Flask 有两个主要依赖：路由、调试和 Web 服务器网关接口

子系统由 Werkzeug（http://werkzeug.pocoo.org/）提供；模板系统由 Jinja2（http://jinja.pocoo.org/）提供

 

1.1 初始化

 

 

全部 Flask 程序都必须建立一个程序实例。Web 服务器使用一种名为 Web 服务器网关接口

 

 

（Web Server Gateway Interface，WSGI）的协议，把接收自客户端的全部请求都转交给这

 

 

个对象处理。程序实例是 Flask 类的对象，常用下述代码建立：

from flask import Flask app = Flask(__name__)

Flask 类的构造函数只有一个必须指定的参数，即程序主模块或包的名字。在大多数程

中，Python 的 __name__ 变量就是所需的值。

 

Flask 用这个参数决定程序的根目录，以便稍后可以找到相对于程序根目录的资源文件位置

 

1.2 路由和视图函数

 

 客户端（例如 Web 浏览器）把请求发送给 Web 服务器，Web 服务器再把请求发送给 Flask程序实例。

 

程序实例须要知道对每一个 URL 请求运行哪些代码,因此保存了一个 URL 到 Python 函数的映射关系.处理 URL 和函数之间关系的程序称为路由.

 

在 Flask 程序中定义路由的最简便方式,是使用程序实例提供的 app.route 修饰器,把修 饰的函数注册为路由.下面的例子说明了如何使用这个修饰器声明路由：

 

修饰器是 Python 语言的标准特性,可使用不一样的方式修改函数的行为.惯 经常使用法是使用修饰器把函数注册为事件的处理程序.

 

@app.route('/') def index(): return '<h1>Hello World!</h1>'

前例把 index() 函数注册为程序根地址的处理程序.若是部署程序的服务器域名为 www. example.com,在浏览器中访问 http://www.example.com 后,会触发服务器执行 index() 函 数.

这个函数的返回值称为响应,是客户端接收到的内容.若是客户端是 Web 浏览器,响 应就是显示给用户查看的文档.

也就是若是在“/”后添加各类自定义路径就能够实现返回本身定义的不一样函数。

像 index() 这样的函数称为视图函数（view function）。视图函数返回的响应能够是包含HTML 的简单字符串，也能够是复杂的表单

 

 

注意：在 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　启动服务器

程序实例用 run 方法启动 Flask 集成的开发 Web 服务器：

if __name__ == '__main__' app.run(debug=True)

 

__name__=='__main__' 是 Python 的惯经常使用法，在这里确保直接执行这个脚本时才启动开发Web 服务器。

若是这个脚本由其余脚本引入，程序假定父级脚本会启动不一样的服务器，所以不会执行 app.run()。

 

服务器启动后,会进入轮询,等待并处理请求.轮询会一直运行,直到程序中止,好比按 Ctrl-C 键.

有一些选项参数可被 app.run() 函数接受用于设置 Web 服务器的操做模式.

在开发过程当中 启用调试模式会带来一些便利,好比说激活调试器和重载程序.要想启用调试模式,咱们 能够把 debug 参数设为 True.例如：

app.run(host='0.0.0.0',port=80,debug=True)

2.4　请求-响应循环

2.5.1　程序和请求上下文

Flask 从客户端收到请求时,要让视图函数能访问一些对象,这样才能处理请求.请求对象就是一个很好的例子,它封装了客户端发送的 HTTP 请求.

要想让视图函数可以访问请求对象,一个显而易见的方式是将其做为参数传入视图函数,

不过这会致使程序中的每一个视图函数都增长一个参数.除了访问请求对象,若是视图函数在处理请求时还要访问其余对象,状况会变得更糟.

为了不大量无关紧要的参数把视图函数弄得一团糟,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 中有两种上下文：程序上下文和请求上下文。

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　请求钩子

有时在处理请求以前或以后执行代码会颇有用.例如,在请求开始时,咱们可能须要创 建数据库链接或者认证发起请求的用户.为了不在每一个视图函数中都使用重复的代码, Flask 提供了注册通用函数的功能,注册的函数可在请求被分发到视图函数以前或以后 调用.

 

请求钩子使用修饰器实现.Flask 支持如下 4 种钩子.

 

• before_first_request：注册一个函数，在处理第一个请求以前运行。

 

• before_request：注册一个函数，在每次请求以前运行。

 

• after_request：注册一个函数，若是没有未处理的异常抛出，在每次请求以后运行。

 

• teardown_request：注册一个函数，即便有未处理的异常抛出，也在每次请求以后运行。

 

 在请求钩子函数和视图函数之间共享数据通常使用上下文全局变量 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 被设计为可扩展形式,故而没有提供一些重要的功能,例如数据库和用户认证,所 以开发者能够自由选择最适合程序的包,或者按需求自行开发.

 

社区成员开发了大量不一样用途的扩展，若是这还不能知足需求，你还可以使用全部 Python 标准包或代码库。

 

使用Flask-Script支持命令行选项

 

Flask 的开发 Web 服务器支持不少启动设置选项,但只能在脚本中做为参数传给 app.run() 函数.这种方式并不十分方便,传递设置选项的理想方式是使用命令行参数.

 

Flask-Script 是一个 Flask 扩展,为 Flask 程序添加了一个命令行解析器.Flask-Script 自带 了一组经常使用选项,并且还支持自定义命令.