我的 Python 学习笔记：结合 FlaskWeb 进行开发

携手创作，共同成长！这是我参与「掘金日新计划 · 8 月更文挑战」的第24天，点击查看活动详情

在学习一门技能的过程中，记记笔记，日计月累，发现有一些效果！

python版本：3.5
flask版本：0.12
jinja2：2.94
werkzeug:0.11.15

IDE使用 pyCharm。

1.1、首例

首先从flask初始化的一个例子说起。打开pyCharm新建一个Flask的项目之后，会初始化一个Flask的程序目录（假设创建一个名为flaskblog的项目）。首先来看flaskblog.py这个文件里的代码： (包含注释)

#flaskblpg.py

#1、初始化：创建一个程序实例
from flask import Flask

app = Flask(__name__)
#flask用name这个参数决定程序的根目录，以便稍后能够找到相对于程序根目录的资源文件位置。

#2、路由和视图函数:客户端把请求发送给web服务器，web服务器再把请求发送给flask程序实例。程序实例需要知道对每个URL请求运行哪些代码
#所以保存了一个URL到Python函数的映射关系。处理URL和函数之间的关系称为路由。
# @app.route('/')flask是使用程序实例提供的app.route修饰器，把修饰的函数注册为路由。
@app.route('/user/<name>')#尖括号中得内容就是动态部分，任何能匹配静态部分的URL都会映射到这个路由上。
# flask支持在路由中使用int(如:@app.route('/user/<int:id>'))\float\path类型.path类型也是字符串，但不把斜线视作分隔符，而将其当做动态片段的一部分。
def hello_world(name):
# 视图函数,返回的响应可以是包含HTML的简单字符串，也可以是复杂的表单
    return '<h1>Hello,%s!</h1>' %name

#3、启动服务器：程序实例用run方法启动flask集成的开发web服务器。服务器启动后会进入轮询，等待并处理请求。轮询会一直运行，直到程序
#停止，比如按Ctrl-C键。
if __name__ == '__main__':
    app.run(debug=True)
#启用调式模式,ps:flask提供的web服务器不适合在生产环境中使用。

请详细阅读注释，然后在pyCharm中选中flaskblog.py运行(Run),在浏览器中测试。在浏览器地址栏中输入http://127.0.0.1:5000/user/example 进行测试。

1.2程序与请求上下文

请求对象封装了客户端发送的HTTP请求。在多线程服务器中，多个线程同时处理不同客户端发送的不同请求时，每个线程看到的request对象必然不同。Falsk使用上下文让特定的变量在一个线程中全局可访问，与此同时却不会干扰其他线程。

Flask两种上下文：（1）程序上下文

current_app：当前激活程序的程序实例
g：处理请求时用作临时存储的对象。每次请求都会重设这个变量

（2）请求上下文

request：请求对象，封装了客户端发出的HTTP请求中得内容
session：用户会话，用于存储请求之间需要“记住”的值的词典

在使用这些变量时，我们需要先激活(push())程序（app_context()）或请求上下文，否则会报错。

1.3请求调度

URL映射是URL和视图函数之间的对应关系。Falsk使用app.route修饰器或者非修饰器形式的app.add_url_rule()生成映射。

Falsk为每个路由都指定了请求方法，这样不同的请求方法发送到相同的URL上时，会使用不同的视图函数进行处理。

1.4请求钩子

请求钩子使用修饰器实现。Falsk支持4种钩子。

before_first_request: 注册一个函数，在处理第一个请求之前运行。
before_request: 注册一个函数，在每次请求之前运行。
after_request：注册一个函数，如果没有未处理的异常抛出，在每次请求之后运行。
teardown_request：注册一个函数，即使有未处理的异常抛出，也在每次请求之后运行。

1.5响应

HTTP响应中一个很重要的部分是“状态码”，默认为200，表示请求已被成功处理。

Flask视图函数还能返回Response对象。make_response()函数可接受1、2或3个参数，并返回一个Response对象。 eg:

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

有一种名为“重定向”的特殊响应类型。这种响应没有页面文档，只告诉浏览器一个新地址用以加载新页面。重定向常使用302状态码表示，指向的地址由Location首部提供。Flask提供 redirect（）辅助函数用于生成这种响应：

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 nor user:
	   abort(404)
return '<h1>Hello,%s</h1>'%user.name

以上例子中，如果URL中动态参数id对应的用户不存在，就返回状态码404。

模板是一个包含响应的文本的文件，期中包含用占位变量表示的动态部分，其具体值只在请求的上下文中才能知道。使用真实替换变量，再返回最终得到的响应字符串，这一过程称为“渲染”。在Falsk中使用Jinja2这个模板引擎。

2.1 jinja2 模板引擎

2.1.1渲染模板

默认情况下，Falsk在程序/项目的文件夹中的 templates 子文件夹中寻找模板。我们可以将定义好的模板保存在这个文件夹中。现在我们改造下“01讲中的首例”:

from flask import Flask,render_template
from flask import request
app = Flask(__name__)
@app.route('/')
def index():
    user_agent=request.headers.get('User-Agent')
return render_template('index.html',user_agent=user_agent)
@app.route('/user/<name>')
def hello_world(name):
return render_template('user.html',name=name)
if __name__ == '__main__':
app.run(debug=True)

然后分别在 templates 文件夹下新建两个文件 index.html和user.html,

这里写图片描述

内容分别如下:

#index.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <p>欢迎您！您的浏览器是:{{user_agent}}</p>
</body>
</html>

#user.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1 style="color: coral">Hello {{name}}</h1>
</body>
</html>

从这里我们可以看到：Falsk提供 render_template 函数把 jinja2 模板引擎集成到了程序中。 render_template 函数的第一个参数是模板的文件名。随后的参数都是键值对，表示末班中变量对应的真实值。

2.1.2 jinja2 变量过滤器

这里写图片描述

注意：很多情况下需要显示变量中存储的HTML代码，这时就需要使用safe过滤器。但是，千万不要在不可信的值上使用safe过滤器，例如用户在表单中输入的文本。