Flask路由&视图
1 路由
1.1app.url_map 查看所有路由
from flask import flask app = flask(__name__) @app.route('/') def hello_world(): """定义视图函数""" print(app.url_map) return "hello flask" @app.route('/index') def index(): return 'index' if __name__ == '__main__': app.run(debug=true)
访问127.0.0.1 :5000
显示当前所有的路由,和每条路由的访问方式。
1.2通过method限定访问方式
给index函数添加method
@app.route('/index', methods=["post"]) def index(): return 'index'
此时去浏览器在地址栏输入地址访问,
很显然,不让get请求,给method列表中添加get请求方式。
@app.route('/index', methods=["post", 'get']) def index(): return 'index'
此时就能get和post请求
1.3同一路由装饰多个视图函数
添加两个视图函数
@app.route('/test') def test1(): return "test1" @app.route("/test") def test2(): return "test2"
在浏览器访问127.0.0.1:5000/test,返回的是test1.
修改两个函数的请求方式
@app.route('/test', methods=["post"]) def test1(): return "test1" @app.route("/test", methods=["get"]) def test2(): return "test2"
再去浏览器访问127.0.0.1:5000/test,返回的是test2
1.4同一视图多个路由装饰器
添加一个func视图函数
@app.route("/func1") @app.route("/func2") def func(): return "func"
在浏览器访问127.0.0.1:5000/func1和 127.0.0.1:5000/func2,返回的结果都是func。
1.5 使用url_for进行反解析
添加一个login视图函数
from flask import flask, redirect, url_for @app.route("/login") def login(): url = url_for("index") # 使用url_for,通过视图函数的名字找到视图对应url return redirect(url)
访问127.0.0.1:5000/login,然后就会直接跳转到index页面。
1.6 动态路由
# 路由传递的参数默认当做string处理,这里指定int,尖括号中冒号后面的内容是动态的 @app.route('/book/<int:book_id>') def book_detail(book_id): return "book detail %s" % book_id
# 路由传递的参数默认当做string处理,这里指定int,尖括号中冒号后面的内容是动态的 # @app.route('/book/<int:book_id>') @app.route('/book/<book_id>') # 不加转换器类型,默认时普通字符串规则,除了 / 字符 def book_detail(book_id): return "book detail %s" % book_id
1.7 自定义转换器
from werkzeug.routing import baseconverter # 1.定义自己的转换器 class regexconverter(baseconverter): def __init__(self, url_map, regex): # 调用父类的初始化方法 super().__init__(url_map) # 将正则表达式的参数保存到对象的属性中, flask会去使用这个属性来进行路由的正则匹配 self.regex = regex # 2.将自定义的转换器添加到flask的应用中 app.url_map.converters["re"] = regexconverter # 127.0.0.1:5000/send/178456123789 @app.route("/send/<re(r'1[34578]\d{9}'):mobile>") def send_msg(mobile): return "send_msg---to:%s" % mobile
1.8 转换器转换过程
自定义的转换器regexconverter添加两个方法,他们都是父类baseconverter的方法,现在看下他们其实是在做什么。
to_python
# 1.定义自己的转换器 class regexconverter(baseconverter): def __init__(self, url_map, regex): # 调用父类的初始化方法 super().__init__(url_map) # 将正则表达式的参数保存到对象的属性中, flask会去使用这个属性来进行路由的正则匹配 self.regex = regex def to_python(self, value): print(value) return 123 def to_url(self, value): pass # 2.将自定义的转换器添加到flask的应用中 app.url_map.converters["re"] = regexconverter # 127.0.0.1:5000/send/178456123789 @app.route("/send/<re(r'1[34578]\d{9}'):mobile>") def send_msg(mobile): return "send_msg---to:%s" % mobile
在浏览器访问http://127.0.0.1:5000/send/17845678912,页面显示
控制台属输出17845678912。转换过程:
to_url
class regexconverter(baseconverter): def __init__(self, url_map, regex): # 调用父类的初始化方法 super().__init__(url_map) # 将正则表达式的参数保存到对象的属性中, flask会去使用这个属性来进行路由的正则匹配 self.regex = regex def to_python(self, value): # print(value) # value是在路径进行正则表达式匹配的时候提取的参数 # return 123 return value def to_url(self, value): print(value) return "15612187594" # 2.将自定义的转换器添加到flask的应用中 app.url_map.converters["re"] = regexconverter # 127.0.0.1:5000/send/178456123789 @app.route("/send/<re(r'1[34578]\d{9}'):mobile>") def send_msg(mobile): return "send_msg---to:%s" % mobile @app.route("/index") def index(): url = url_for("send_msg", mobile="18732141231") return redirect(url)
访问http://127.0.0.1:5000/index, 页面显示:
控制台输出:18732141231, 转换过程:
to_url是在使用url_for方法的时候被调用。
2 获取请求参数
from flask import request
就是 flask 中表示当前请求的 request 对象,request对象中保存了一次http请求的一切信息。
from flask import flask, request app = flask(__name__) @app.route("/index", methods=["get", 'post']) def index(): # request中包含了前端发送过来的所有请求数据 # form和data是用来提取请求体数据 # 通过request.form可以直接提取请求体中的表单格式的数据, 是一个类字典的对象 # 通过get方法只能拿到多个同名参数的第一个 name = request.form.get("name") age = request.form.get("age") # getlist可以获取同名的所有数据 name_list = request.form.getlist("name") print("request.data", request.data) # 发送json数据 # 127.0.0.1:5000/index?page=1 查询字符串 querystring # args使用提取url中的参数(查询字符串) page = request.args.get("page") print(page) return "%s:%s,,%s" % (name, age, name_list) if __name__ == '__main__': app.run()
2.1 上传文件
已上传的文件存储在内存或是文件系统中一个临时的位置。你可以通过请求对象的 files 属性访问它们。每个上传的文件都会存储在这个字典里。它表现近乎为一个标准的 python file 对象,但它还有一个 save() 方法,这个方法允许你把文件保存到服务器的文件系统上。这里是一个用它保存文件的例子:
@app.route("/upload", methods=['post']) def upload(): # 接收前端发送过来的文件 file_obj = request.files.get("pic") # if file_obj is none: # return "未上传文件" # # 将文件保存到本地 # # 1.创建一个文件对象 # f = open('./test.png', 'wb') # # 2.向文件写内容 # content = file_obj.read() # f.write(content) # # 3.关闭文件 # f.close() # 直接使用上传文件的对象保存 file_obj.save("./test1.png") return "上传成功"
3 abort函数与自定义异常处理
3.1 abort函数
from flask import abort
@app.route("/login", methods=['get']) def login(): name = "hhh" pwd = '123' if name != "aaa" or pwd != 123: # 使用abort函数可以立即终止视图函数的执行, 并可以返回了浏览器特定的信息 # 1.传递状态码信息, 必须是标准的http状态码 abort(404) # 2.传递响应体信息 # res = response("login failed") # abort(res) return "login success"
3.2 自定义异常处理
@app.errorhandler(404) def handle_error(err): """自定义处理错误方法""" # 这个函数的返回值会是用户看到的最终结果 return "首页已换, 下次记得收藏网站。。%s" % err
4 返回的响应数据
4.1 元组
可以返回一个元组,这样的元组必须是 (response, status, headers) 的形式,且至少包含一个元素。 status 值会覆盖状态代码, headers 可以是一个列表或字典,作为额外的消息标头值。
@app.route("/index") def index(): # 使用元祖返回自定义的响应信息 # 响应头 状态码 响应头 # return "使用元祖返回自定义的响应信息", 400, [("name", "haha")] # return "使用元祖返回自定义的响应信息", 400, {("name", "haha")} # return "使用元祖返回自定义的响应信息", 666, {("name", "haha")} # return "使用元祖返回自定义的响应信息", "666 mystatus", {("name", "haha")} # return "使用元祖返回自定义的响应信息", "666 mystatus"
4.2 make_response
from flask import make_response @app.route("/index") def index(): # 使用make_response来构造响应信息 res = make_response("使用make_response来构造响应信息") res.status = "666 mystatus" # 设置状态码 res.headers["name"] = "haha" # 设置响应头 return res
5 使用jsonify返回json数据
from flask import jsonify @app.route("/index") def index(): data = {"title": "santi", "price": 90} # return json.dumps(data) # 此时响应头的content-type: text/html; charset=utf-8 # 手动设置content-type # return json.dumps(data), 200, {"content-type": "application/json"} # 使用jsonify, jsonify帮助转换json数据, 并设置响应头content-type": "application/json" # return jsonify(data) return jsonify(title="santi", price=90)
6 设置和读取cookie
from flask import flask, make_response, request app = flask(__name__) @app.route("/set_cookie") def set_cookie(): res = make_response("set_cookie") # 默认有效期是临时cookie, 浏览器关闭就失效 # res.set_cookie("name", "test") # max_age设置有效期, 单位:秒 # res.set_cookie("name1", "test1", max_age=3600) # 通过响应头设置cookie # res.headers["set-cookie"] = "name2=test2; expires=sun, 28-apr-2019 12:37:29 gmt; max-age=3600; path=/" return res @app.route("/get_cookie") def get_cookie(): cook = request.cookies.get("name1") return cook @app.route("/delete_cookie") def delete_cookie(): res = make_response("delete_cookie") res.delete_cookie("name1") return res if __name__ == '__main__': app.run()
7 session
from flask import session 需要设置secret_key
from flask import flask, session app = flask(__name__) app.config["secret_key"] = "qlxmxlnmj" @app.route("/login") def login(): # 设置session session["name"] = "test" return "login success" @app.route("/index") def index(): # 获取session name= session.get("name") return "session :: %s" %name if __name__ == '__main__': app.run()
8 请求上下文与应用上下文
上下文:相当于一个容器,保存了flask程序运行过程中的一些信息。
flask中有两种上下文,请求上下文和应用上下文。
8.1 请求上下文(request context)
request和session都属于请求上下文对象。
request:封装了http请求的内容,针对的是http请求。举例:user = request.args.get('user'),获取的是get请求的参数。
session:用来记录请求会话中的信息,针对的是用户信息。举例:session['name'] = user.id,可以记录用户信息。还可以通过session.get('name')获取用户信息。
8.2 应用上下文(application context)
current_app和g都属于应用上下文对象。
current_app:表示当前运行程序文件的程序实例。我们可以通过current_app.name打印出当前应用程序实例的名字。
g:处理请求时,用于临时存储的对象,每次请求都会重设这个变量。比如:我们可以获取一些临时请求的用户信息。
-
当调用app = flask(_name_)的时候,创建了程序应用对象app;
-
request 在每次http请求发生时,wsgi server调用flask.call();然后在flask内部创建的request对象;
-
app的生命周期大于request和g,一个app存活期间,可能发生多次http请求,所以就会有多个request和g。
-
最终传入视图函数,通过return、redirect或render_template生成response对象,返回给客户端。
区别: 请求上下文:保存了客户端和服务器交互的数据。 应用上下文:在flask程序运行过程中,保存的一些配置信息,比如程序文件名、数据库的连接、用户信息等。
9 请求钩子
在客户端和服务器交互的过程中,有些准备工作或扫尾工作需要处理,比如:在请求开始时,建立数据库连接;在请求结束时,指定数据的交互格式。为了让每个视图函数避免编写重复功能的代码,flask提供了通用设施的功能,即请求钩子。
请求钩子是通过装饰器的形式实现,flask支持如下四种请求钩子:
before_first_request:在处理第一个请求前运行。
before_request:在每次请求前运行。
after_request:如果没有未处理的异常抛出,在每次请求后运行。
teardown_request:在每次请求后运行,即使有未处理的异常抛出。
from flask import flask app = flask(__name__) @app.route("/index") def index(): print("index 被执行") return "index" @app.before_first_request def handle_before_first_request(): """在第一次请求处理之前被执行""" print("handle_before_first_request 被执行") @app.before_request def handle_before_request(): """在每次请求之前都被执行""" print("handle_before_request 被执行") @app.after_request def handle_after_request(response): """在每次请求(视图函数处理)之后都被执行, 前提是视图函数没有出现异常""" print("handle_after_request 被执行") return response @app.teardown_request def handle_teardown_request(response): """在每次请求(视图函数处理)之后都被执行, 无论视图函数是否出现异常,都被执行""" print("handle_teardown_request 被执行") return response if __name__ == '__main__': app.run()
启动服务器,在浏览器访问index,控制台输出结果:
服务器不重启,再次刷新浏览器,控制台输出:
在index函数中添加一个异常,
from flask import flask app = flask(__name__) @app.route("/index") def index(): print("index 被执行") int("a") return "index" @app.before_first_request def handle_before_first_request(): """在第一次请求处理之前被执行""" print("handle_before_first_request 被执行") @app.before_request def handle_before_request(): """在每次请求之前都被执行""" print("handle_before_request 被执行") @app.after_request def handle_after_request(response): """在每次请求(视图函数处理)之后都被执行, 前提是视图函数没有出现异常""" print("handle_after_request 被执行") return response @app.teardown_request def handle_teardown_request(response): """在每次请求(视图函数处理)之后都被执行, 无论视图函数是否出现异常,都被执行, 工作在非调试模式, debug=false""" print("handle_teardown_request 被执行") return response if __name__ == '__main__': app.run()
把调试模式关了, 重启服务器,在浏览器访问,控制台输出:
10 flask-script扩展命令行
通过使用flask-script扩展,我们可以在flask服务器启动的时候,通过命令行的方式传入参数。而不仅仅通过app.run()方法中传参,比如我们可以通过python hello.py runserver --host ip地址,告诉服务器在哪个网络接口监听来自客户端的连接。默认情况下,服务器只监听来自服务器所在计算机发起的连接,即localhost连接。
pip3 install flask-script
from flask import flask from flask_script import manager app = flask(__name__) # 创建manager管理类的对象 manager = manager(app) @app.route("/index") def index(): return "index" if __name__ == '__main__': # app.run() # 通过管理对象来启动 manager.run()