Flask（7）- request 对象

Flask 中很重要的 request 对象

• 浏览器访问服务端时，向服务端发送请求
• Flask 程序使用 request 对象描述请求信息
• 当你想获取请求体、请求参数、请求头数据的时候，就需要靠 request 对象了
• 这一篇会用结果驱动源码解析的方式来讲解

真实使用场景

浏览器访问服务端，需要将相应的数据发送给服务端，可能有如下场景：

1. 通过 URL 参数进行查询，浏览器需要将查询参数发送给服务端
2. 提交表单 form 进行查询，浏览器需要将表单 form 中的字段发送给服务端
3. 上传文件，浏览器需要将文件发送给服务端
4. 通过 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 请求参数的栗子

代码

#!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

控制台输出

args = ImmutableMultiDict([('name', 'zhangsan'), ('age', '13')])
form = ImmutableMultiDict([])

用 form 属性的话得到是一个空字典哦

/query3

控制台输出

args = ImmutableMultiDict([('name', 'zhangsan'), ('age', '13')])
json = None 

用 json 属性的话得到是一个 None 哦，所以无论如何都不要用 json 获取 url 请求参数哟！

/query4

可以看到 values 属性也能拿到 url 请求参数哦

获取表单参数的栗子

代码

#!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

控制台输出

form = ImmutableMultiDict([('name', 'poloyy'), ('age', '12')])
args = ImmutableMultiDict([])

用 args 属性的话得到是一个空字典哦

/addUser3

控制台输出

form = ImmutableMultiDict([('name', 'poloyy'), ('age', '12')])
json = None

用 json 属性的话得到是一个 None 哦，所以无论如何都不要用 json 获取 form-data 哟！

/addUser4

可以看到 values 属性也能拿到 form 表单提交的数据哦

获取 Json 数据的栗子

代码

#!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']}

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

• 下面我会用 postman 统一通过 raw-json，就是 Json 格式的请求体来传数据
• 在 Flask 里面，把四种获取请求数据的属性都写一遍，然后看看最后的结果，提前帮大家踩坑

postman 发起请求的结果

/addJson

/addJson2

json = {'age': '12', 'name': 'poloyy'}
args = ImmutableMultiDict([])

用 args 属性的话得到是一个空字典哦

/addJson3

json = {'age': '12', 'name': 'poloyy'}
form = ImmutableMultiDict([])

用 form 属性的话得到是一个空字典哦

/addJson4

这里要注意的是，当你的请求体是 Json 时，是不能通过 values 来获取请求数据哦！！

最后来看看 request.json 会返回什么吧

json = {'age': '12', 'name': 'poloyy'} <class 'dict'>

request.json 拿到的就是 Json 格式的请求体，并且自动转换成字典了哦！

为什么 requests.values 能获取 form、args 的数据，但是拿不到 json 的数据呢？

request.values 源码

• 能看到，它本质就是获取 args、form 的数据，但不包含 json 数据
• 但是这里有个重点，只有你的请求方法不为 GET 的时候，发送 form 表单数据才能通过 request.values 拿到请求数据
• 来试试是不是真的这样

代码

@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 是空的

控制台输出

ImmutableMultiDict([('name', 'poloyy'), ('age', '12')])
CombinedMultiDict([ImmutableMultiDict([])])
ImmutableMultiDict([])

很明显，request.form 是能拿到数据的，但是 request.value 是拿不到数据哦

postman 发起 POST 请求，form-data 传数据

这次就能正常显示返回值啦

控制台输出

ImmutableMultiDict([('name', 'poloyy'), ('age', '12')])
ImmutableMultiDict([])
CombinedMultiDict([ImmutableMultiDict([]), ImmutableMultiDict([('name', 'poloyy'), ('age', '12')])])

看源码应该知道，当非 GET 请求的时候传递表单数据，request.values 也能获取得到 request.form 的数据