Flask 中很重要的 request 对象
- 浏览器访问服务端时，向服务端发送请求
- Flask 程序使用 request 对象描述请求信息
- 当你想获取请求体、请求参数、请求头数据的时候，就需要靠 request 对象了
- 这一篇会用结果驱动源码解析的方式来讲解
真实使用场景
浏览器访问服务端，需要将相应的数据发送给服务端，可能有如下场景：
- 通过 URL 参数进行查询，浏览器需要将查询参数发送给服务端
- 提交表单 form 进行查询，浏览器需要将表单 form 中的字段发送给服务端
- 上传文件，浏览器需要将文件发送给服务端
- 通过 JSON 格式的请求体进行请求，一般是 post 请求
服务端收到将客户端发送的数据后，封装形成一个请求对象，在 Flask 中，请求对象是一个模块变量 flask.request
request 包含的常用属性
属性 | 说明 |
|---|---|
method | 当前的请求方法 |
form | 表单参数及其值的字典对象 |
args | 查询字符串的字典对象 |
values | 包含所有数据的字典对象 |
json | 如果 mimetype 是 application/json，这个参数将会解析 json 数据，如果不是则返回 None |
headers | http 协议 请求头 |
cookies | cookie 名称和值的字典对象 |
files | 与上传文件有关的数据 |
form、args、values、json 都是获取 http 请求的请求数据的属性，只不过请求体类型不同
还记得之前讲 url 组成的时候，request 对象也能获取 url 相关参数吗，复习下
request 获取 url 组成的常用属性
假设 URL 等于 http://localhost/query?userId=123，request 对象中与 URL 参数相关的属性如下
属性 | 说明 |
|---|---|
url | http://localhost/query?userId=123 |
base_url | http://localhost/query |
host | localhost |
host_url | http://localhost/ |
path | /query |
full_path | /query?userId=123 |
获取 url 请求参数的栗子
代码
代码语言：javascript复制#!usr/bin/env python
# -*- coding:utf-8 _*-
"""
# author: 小菠萝测试笔记
# blog: https://www.cnblogs.com/poloyy/
# time: 2021/7/11 11:13 上午
# file: 5_request.py
"""
from flask import Flask, request
app = Flask(__name__)
@app.route('/query')
def query():
return {"name": request.args['name'], "age": request.args['age']}
@app.route('/query2')
def query2():
print('args =', request.args)
print('form =', request.form)
return "form"
@app.route('/query3')
def query3():
print('args =', request.args)
print('json =', request.json)
return "json"
@app.route('/query4')
def query4():
return {"name": request.values['name'], "age": request.values['age']}
if __name__ == '__main__':
app.run(debug=True)- 下面我会用 postman 统一通过 params，就是 url 请求参数传数据
- 在 Flask 里面，把四种获取请求数据的属性都写一遍，然后看看最后的结果，提前帮大家踩坑
postman 发起请求的结果
/query
/query2
控制台输出
代码语言：javascript复制args = ImmutableMultiDict([('name', 'zhangsan'), ('age', '13')])
form = ImmutableMultiDict([])用 form 属性的话得到是一个空字典哦
/query3
控制台输出
代码语言：javascript复制args = ImmutableMultiDict([('name', 'zhangsan'), ('age', '13')])
json = None 用 json 属性的话得到是一个 None 哦，所以无论如何都不要用 json 获取 url 请求参数哟！
/query4
可以看到 values 属性也能拿到 url 请求参数哦
获取表单参数的栗子
代码
代码语言：javascript复制#!usr/bin/env python
# -*- coding:utf-8 _*-
"""
# author: 小菠萝测试笔记
# blog: https://www.cnblogs.com/poloyy/
# time: 2021/7/11 1:47 下午
# file: 5_request_form.py
"""
from flask import Flask, request
app = Flask(__name__)
@app.route('/addUser', methods=['POST'])
def check_login():
return {"name": request.form['name'], "age": request.form['age']}
@app.route('/addUser2', methods=['POST'])
def check_login2():
print('form =', request.form)
print('args =', request.args)
return "good"
@app.route('/addUser3', methods=['POST'])
def check_login3():
print('form =', request.form)
print('json =', request.json)
return "good"
@app.route('/addUser4', methods=['POST'])
def check_login4():
return {"name": request.values['name'], "age": request.values['age']}
if __name__ == '__main__':
app.run(debug=True)- 下面我会用 postman 统一通过 form-data，就是表单格式来传数据
- 在 Flask 里面，把四种获取请求数据的属性都写一遍，然后看看最后的结果，提前帮大家踩坑
postman 发起请求的结果
/addUser
/addUser2
控制台输出
代码语言：javascript复制form = ImmutableMultiDict([('name', 'poloyy'), ('age', '12')])
args = ImmutableMultiDict([])用 args 属性的话得到是一个空字典哦
/addUser3
控制台输出
代码语言：javascript复制form = ImmutableMultiDict([('name', 'poloyy'), ('age', '12')])
json = None用 json 属性的话得到是一个 None 哦，所以无论如何都不要用 json 获取 form-data 哟！
/addUser4
可以看到 values 属性也能拿到 form 表单提交的数据哦
获取 Json 数据的栗子
代码
代码语言：javascript复制#!usr/bin/env python
# -*- coding:utf-8 _*-
"""
# author: 小菠萝测试笔记
# blog: https://www.cnblogs.com/poloyy/
# time: 2021/7/11 1:47 下午
# file: 5_request_form.py
"""
from flask import Flask, request
app = Flask(__name__)
@app.route('/addJson', methods=['POST'])
def check_login():
return {"name": request.json['name'], "age": request.json['age']}
@app.route('/addJson2', methods=['POST'])
def check_login2():
print('json =', request.json)
print('args =', request.args)
return "good"
@app.route('/addJson3', methods=['POST'])
def check_login3():
print('json =', request.json)
print('form =', request.form)
return "good"
@app.route('/addJson4', methods=['POST'])
def check_login4():
print('json =', request.json, type(request.json))
print('values =', request.values)
return {"name": request.json['name'], "age": request.json['age']}- 下面我会用 postman 统一通过 raw-json，就是 Json 格式的请求体来传数据
- 在 Flask 里面，把四种获取请求数据的属性都写一遍，然后看看最后的结果，提前帮大家踩坑
postman 发起请求的结果
/addJson
/addJson2
代码语言：javascript复制json = {'age': '12', 'name': 'poloyy'}
args = ImmutableMultiDict([])用 args 属性的话得到是一个空字典哦
/addJson3
代码语言：javascript复制json = {'age': '12', 'name': 'poloyy'}
form = ImmutableMultiDict([])用 form 属性的话得到是一个空字典哦
/addJson4
这里要注意的是，当你的请求体是 Json 时，是不能通过 values 来获取请求数据哦！！
最后来看看 request.json 会返回什么吧
代码语言：javascript复制json = {'age': '12', 'name': 'poloyy'} <class 'dict'>request.json 拿到的就是 Json 格式的请求体，并且自动转换成字典了哦！
为什么 requests.values 能获取 form、args 的数据，但是拿不到 json 的数据呢？
request.values 源码
- 能看到，它本质就是获取 args、form 的数据，但不包含 json 数据
- 但是这里有个重点，只有你的请求方法不为 GET 的时候，发送 form 表单数据才能通过 request.values 拿到请求数据
- 来试试是不是真的这样
代码
代码语言：javascript复制@app.route('/query4', methods=["GET", "POST"])
def query4():
print(request.form)
print(request.args)
print(request.values)
return {"name": request.values['name'], "age": request.values['age']}postman 发起 GET 请求，form-data 传数据
直接报错，找不到对应的 name key，因为 request.values 是空的
控制台输出
代码语言：javascript复制ImmutableMultiDict([('name', 'poloyy'), ('age', '12')])
CombinedMultiDict([ImmutableMultiDict([])])
ImmutableMultiDict([])很明显，request.form 是能拿到数据的，但是 request.value 是拿不到数据哦
postman 发起 POST 请求，form-data 传数据
这次就能正常显示返回值啦
控制台输出
代码语言：javascript复制ImmutableMultiDict([('name', 'poloyy'), ('age', '12')])
ImmutableMultiDict([])
CombinedMultiDict([ImmutableMultiDict([]), ImmutableMultiDict([('name', 'poloyy'), ('age', '12')])])看源码应该知道，当非 GET 请求的时候传递表单数据，request.values 也能获取得到 request.form 的数据
