Flask Web开发-1.1Flask框架的基本使用及第一个程序

一,基础知识及各代码

1.初始化

所有 Flask 程序都必须创建一个程序实例,该实例是 Flask 类的对象。因为:Web 服务器使用一种名为 Web 服务器网关接口 (Web Server Gateway Interface,WSGI)的协议,把接收自客户端的所有请求都转交给这 个对象(实例)处理。经常使用下述代码创建:

from flask import Flask
app = Flask(__name__)

Flask 类的构造函数(根据Flask类创建实例)只有一个必须指定的参数,即程序主模块或包的名字。在大多数程序 中,Python 的 name 变量就是所需的值(一般地,简单地就这么做就行)。
注意:创建程序实例时,将构造函数的 name 参数传给 Flask 程序实例。Flask 用这个参数决定程序的根目录,以便稍后能够找到相对于程序根目录的资源文件位置。
后面会介绍更复杂的程序初始化方式,对于简单的程序来说,上面的代码足够了。

2.路由和视图函数

客户端(如 Web 浏览器)把请求发送给 Web 服务器,Web 服务器再把请求发送给 Flask程序实例处理。程序实例需要知道对每个 URL 请求运行哪些代码,所以保存了一个 URL 到 Python 函数的映射关系。而处理 URL 和函数之间关系的程序称为路由。
那么如何实现以上的描述呢?在 Flask 程序中定义路由的最简便方式,是使用程序实例提供的 app.route 修饰器,把修饰的函数注册为路由。下面的例子说明了如何使用这个修饰器声明路由:

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

注:修饰器是 Python 语言的标准特性,可以使用不同的方式修改函数的行为。通常用法是使用修饰器把函数注册为事件的处理程序,对应路由的概念即可理解。
前面把 index() 函数注册为程序根地址(’/’)的处理程序。如果部署程序的服务器域名为 www. example.com,在浏览器中访问 http://www.example.com(或输入示例中flaskweb服务器网址http://127.0.0.1:5000) 后,会触发服务器执行 index() 函 数。这个函数的返回值称为响应,是客户端接收到的内容。如果客户端是 Web 浏览器,响应就是显示给用户查看的文档。
像 index() 这样的函数称为视图函数(view function)。视图函数返回的响应可以是字符串,或包含 HTML 的简单字符串(类似于HTML的标签对),也可以是复杂的表单,后面会介绍。
在 Python 代码中嵌入响应字符串(即return后面的值)会导致代码难以维护,此处这么做只是为了介绍响应的概念。你将在后面了解生成响应的正确方法。
如果你仔细观察日常所用服务的某些 URL 格式,会发现很多地址中都包含可变部分。例 如, 你 的 Facebook 资 料 页 面 的 地 址 是 http://www.facebook.com/, 用 户 名 (your-name)是地址的一部分。Flask 支持这种形式的 URL,只需在 route 修饰器中使用特殊的句法即可(尖括号中的内容就是动态部分)。下例定义的路由中就有一部分是动态名字:

@app.route('/user/<name>')
def user(name):
    return '<h2>欢迎你,{}!<h2/>'.format(name)

任何能匹配静态部分(即像符合该例中的/user/部分)的 URL 都会映射到这个路由上。调 用视图函数时,Flask 会将动态部分作为参数传入函数。在这个视图函数中,参数用于生 成针对个人的欢迎消息或提示信息。
路由中的动态部分默认使用字符串,不过也可使用类型定义。例如,路由 /user/int:id 只会匹配动态片段 id 为整数的 URL。Flask 支持在路由中使用 int、float 和 path 类型。 path 类型也是字符串,但不把斜线视作分隔符,而将其当作动态片段的一部分。

3.启动服务器

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

if __name__ == '__main__':
    app.run()

name==‘main’ 是 Python 的惯常用法,在这里确保直接执行这个脚本时才启动开发 Web 服务器。如果这个脚本由其他脚本引入,程序假定父级脚本会启动不同的服务器,因 此不会执行 app.run()。
服务器启动后,会进入轮询,等待并处理请求。轮询会一直运行,直到程序停止,比如按 Ctrl-C 键。像下面提示的那样:

 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

有一些选项参数可被 app.run() 函数接受用于设置 Web 服务器的操作模式。在开发过程中 启用调试模式会带来一些便利,比如说激活调试器和重载程序。要想启用调试模式,我们 可以把 debug 参数设为 True。如:

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

Flask 提供的 Web 服务器不适合在生产环境中使用。后面会介绍生产环境 Web 服务器。

4.实例:一个简单的Flask程序

我们已经了解flask的基本组成和使用,那么我们利用这些知识来编写一个简单的flask程序吧。本次用到的编写及运行环境是pycharm20.1版本,

(1)编写程序代码:

(1)在打开pycharm后,点击新建项目(使用的pycharm以汉化):
在这里插入图片描述
(2)在新建项目中选择flask项目,同时注意里面的项目位置是否为自己所选择的(可以改为自己想放置的位置),如下:
在这里插入图片描述
(3)会发现工程目录下会有app.y文件(一般会自动打开先),如下:
在这里插入图片描述
(4)根据前面所学知识,一次编写初始化,路由和试图函数,启动服务器部分的代码,一般这三部分代码都有了(虽是简单的),视图函数也有一个hello world 功能,然后我们可以这样拓展代码(app.py文件里的代码):

from flask import Flask
app = Flask(__name__)

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

@app.route('/user/<name>')
def user(name):
    return '<h2>欢迎你,{}!<h2/>'.format(name)

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

(5)按软件右上角的运行键(或shift+F10)
在这里插入图片描述
成功运行后,即可出现:

在这里插入图片描述
在运行提示窗口点击 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)中的网址,即会出现根目录’/'的index函数返回响应(Hello World!)如下:
在这里插入图片描述
当我们在输入http://127.0.0.1:5000/user/乔布斯(可变部分输入任何字符串都可以,乔布斯为示例),就会出现:
在这里插入图片描述
但是当你结束flask的web服务器连接后,web浏览器输入实例中的两个url请求都会失效,我们运行pycharm中的flask程序时都会相当于申请一个临时的服务器供我们临时使用,一旦停止运行,即终止该web服务连接。

(2)一些可能会遇到的问题:

往往在第一次运行flask程序时,会遇到一些问题,比较常见的就是web服务器端口不行(或被占用),如下错误提示:

OSError: [WinError 10013] 以一种访问权限不允许的方式做了一个访问套接字的尝试。

那么如何在pycharm中解决这一问题呢?很简答:
1)点击pycharm右上角项目应用按钮(运行按钮左边的那一个),会出现编辑配置,继续点击“编辑配置”,如下:
在这里插入图片描述

2)在Additional options对应的窗口填上:-p 四位端口(常用的四位端口:3306,5000,8080等其他的,也可以随便写个四位端口,可逐一尝试,直到没有报错提示),本次用的是3306:
在这里插入图片描述
3)无报错提示,即可运行成功:
在这里插入图片描述可能还会出现其他的问题,可以自行C站搜索或百度。

二,进一步了解Flask的一些工作方式

1.请求-响应循环

我们可以开发了一个简单的 Flask 程序,还需进一步了解 Flask 的工作方式,以便为我们以后打下知识基础。

(1)程序上下文和请求上下文

Flask 从客户端收到请求时,需要让视图函数能访问一些对象,这样才能处理请求。请求对象就是一个很好的例子,它封装了客户端发送的 HTTP 请求。
要让视图函数能够访问请求对象,一个直接的方式是将其作为参数传入视图函数, 不过这会导致程序中的每个视图函数都增加一个参数。除了访问请求对象,如果视图函数在处理请求时还要访问其他对象,情况会变得更糟。
为了避免大量可有可无的参数把视图函数弄得一团糟,Flask 使用上下文(上下文是个概念,有点绕口,请慢慢阅读理解)临时把某些对象变为全局可访问。有了上下文,就可以写出下面的视图函数:

from flask import request
@app.route('/user-agent')
def index():
    user_agent = request.headers.get('User-Agent')
    return '<p>你的浏览器是 {}</p>'.format(user_agent)

注意在这个视图函数中我们如何把 request 当作全局变量使用。事实上,request 不可能是 全局变量。在多线程服务器中,多个线程同时处理不同客户端发送的不同请求时, 每个线程看到的 request 对象必然不同。Falsk 使用上下文让特定的变量在一个线程中全局可访问,与此同时却不会干扰其他线程。
线程:是可单独管理的最小指令集。进程经常使用多个活动线程,有时还会共 享内存或文件句柄等资源。多线程 Web 服务器会创建一个线程池,再从线 程池中选择一个线程用于处理接收到的请求。
在 Flask 中有两种上下文:程序上下文和请求上下文。下面列出了这两种上下文提供的 变量:
在这里插入图片描述

Flask 在分发请求之前激活(或推送)程序上下文和请求上下文,请求处理完成后再将其删除。程 序上下文被推送后,就可以在线程中使用 current_app 和 g 变量。类似地,请求上下文被 推送后,就可以使用 request 和 session 变量。如果使用这些变量时我们没有激活程序上下文或请求上下文,就会导致错误。如果不知道为什么这 4 个上下文变量如此有用,先别担心,后面会详细说明。
下面这个 Python shell 会话演示了程序上下文(只是演示原理过程,代码中并不是这样使用)的使用方法:
先在pycharm项目下点击python console 控制台,如下:
在这里插入图片描述
然后依次输入下列代码:
在这里插入图片描述
会出现错误,但推送后就会正常运行:
在这里插入图片描述

在这个例子中,没激活程序上下文之前就调用 current_app.name 会导致错误,但推送完上 下文之后就可以调用了。注意,在程序实例上调用 app.app_context() 可获得一个程序上 下文。

(2)请求调度

程序实例收到客户端发来的请求时,要找到处理该请求的视图函数。为了完成这个任务,Flask 会在程序的 URL 映射中查找请求的 URL。URL 映射是 URL 和视图函数之间的对应关系。 Flask 使用 app.route 修饰器或者非修饰器形式的 app.add_url_rule() 生成映射。
要想查看 Flask 程序中的 URL 映射是什么样子,我们可以在 Python shell 中检查为 app.py 生成的映射:
在这里插入图片描述

/ 和 /user/ 路由在程序中使用 app.route 修饰器定义。/static/ 路由是 Flask 添加的特殊路由,用于访问静态文件。第 3 章会详细介绍静态文件。
URL 映射中的 HEAD、Options、GET 是请求方法,由路由进行处理。Flask 为每个路由都指 定了请求方法,这样不同的请求方法发送到不同的 URL 上时,会使用不同的视图函数进 行处理。HEAD 和 OPTIONS 方法由 Flask 自动处理,因此可以这么说,在这个程序中,URL 映射中的 3 个路由都使用 GET 方法。后面会介绍如何为路由指定不同的请求方法。

(3)请求钩子

有时在处理请求之前或之后执行代码会很有用。例如,在请求开始时,我们可能需要创建数据库连接或者认证发起请求的用户。为了避免在每个视图函数中都使用重复的代码, Flask 提供了注册通用函数的功能,注册的函数可在请求被分发到视图函数之前或之后 调用。
请求钩子使用修饰器实现。Flask 支持以下 4 种钩子。
• before_first_request:注册一个函数,在处理第一个请求之前运行。
• before_request:注册一个函数,在每次请求之前运行。
• after_request:注册一个函数,如果没有未处理的异常抛出,在每次请求之后运行。
• teardown_request:注册一个函数,即使有未处理的异常抛出,也在每次请求之后运行。
在请求钩子函数和视图函数之间共享数据一般使用上下文全局变量 g。例如,before_ request 处理程序可以从数据库中加载已登录用户,并将其保存到 g.user 中。随后调用视 图函数时,视图函数再使用 g.user 获取用户。
请求钩子的用法会在后面详细介绍。

(4)响应

Flask 调用视图函数后,会将其返回值作为响应的内容。大多数情况下,响应就是一个简 单的字符串,作为 HTML 页面回送客户端。
但 HTTP 协议需要的不仅是作为请求响应的字符串。HTTP 响应中一个很重要的部分是状 态码,Flask 默认设为 200,这个代码表明请求已经被成功处理。
如果视图函数返回的响应需要使用不同的状态码,那么可以把数字代码作为第二个返回 值,添加到响应文本之后。例如,下述视图函数返回一个 400 状态码,表示请求无效:

@app.route('/')
def hello_world():
    return '<h1>错误的响应!<h1/>',400

效果如下:
在这里插入图片描述

视图函数返回的响应还可接受第三个参数,这是一个由首部(header)组成的字典,可以 添加到 HTTP 响应中。一般情况下并不需要这么做,不过你会在后面看到一个例子。
如果不想返回由 1 个、2 个或 3 个值组成的元组,Flask 视图函数还可以返回 Response 对 象。make_response() 函数可接受 1 个、2 个或 3 个参数(和视图函数的返回值一样),并 返回一个 Response 对象。有时我们需要在视图函数中进行这种转换,然后在响应对象上调 用各种方法,进一步设置响应。下例创建了一个响应对象,然后设置了 cookie:

from flask import  make_response
@app.route('/response')
def Response():
    response=make_response('<h1>这个目录里有cookie!<h1/>')
    response.set_cookie('answer','42')
    return response

效果如下:
在这里插入图片描述

有一种名为重定向的特殊响应类型。这种响应没有页面文档,只告诉浏览器一个新地址用 以加载新页面。重定向经常在 Web 表单中使用,后面会进行介绍。
重定向经常使用 302 状态码表示,指向的地址由 Location 首部提供。重定向响应可以使用 3 个值形式的返回值生成,也可在 Response 对象中设定。不过,由于使用频繁,Flask 提 供了 redirect() 辅助函数,用于生成这种响应,最终会定向到我们设定的网址去:

from flask import redirect
@app.route('/redirect')
def pex():
    return redirect('http://127.0.0.1:3306/response')

还有一种特殊的响应由 abort 函数生成,用于处理错误。在下面这个例子中,如果 URL 中 动态参数 id 对应的用户不存在,就返回状态码 404:

from flask import abort
@app.route('/id/<id>')
def get_user(id):
     user = load_user(id)
     if not user:
        abort(404)
     return '<h1>你好,{}</h1>' .format(user.name)

注意,abort 不会把控制权交还给调用它的函数,而是抛出异常把控制权交给 Web 服 务器。

2.Flask扩展

Flask 被设计为可扩展形式,故而没有提供一些重要的功能,例如数据库和用户认证,所 以开发者可以自由选择最适合程序的包,或者按需求自行开发。
社区成员开发了大量不同用途的扩展,如果这还不能满足需求,你还可使用所有 Python 标 准包或代码库。
最后,文中如有不足,敬请批评指正!!!

  • 2
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值