请求对象request

介绍

request是flask框架的全局对象，可以通过它来获得当前进入的请求数据。

而在多线程环境下，flask可以保证所使用的request对象为当前这个线程所处理的请求。

关于request，最让人感到疑惑的地方在于，明明是一个全局变量，在使用时却提供了当前时刻的请求数据，而且，不同线程之间互不干扰，它是如何设计出来的呢。

通过request可以获得当前请求的全部信息，例如请求的method,path, url, headers,cookies,请求的参数，请求的body…..

示例

服务端代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

from flask import Flask, request
app = Flask(__name__)


@app.route('/users', methods=['GET', 'POST'])
def users():
    print(request.method)       # 请求方法
    print(request.headers)      # 请求的headers
    print(request.path)         # 资源路径
    print(request.url)          # 完整的url
    print(request.remote_addr)  # 客户端IP
    print(request.cookies)      # 请求的cookie
    return 'ok'


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

客户端代码

1
2
3
4

import requests

cookie_dict = {'name': 'python'}
res = requests.get('http://127.0.0.1:5000/users', cookies=cookie_dict)

使用客户端代码发出请求后，服务端程序会输出如下内容

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

GET              # 请求方法
Content-Type: 
Content-Length: 
Host: 127.0.0.1:5000
User-Agent: python-requests/2.22.0
Accept-Encoding: gzip, deflate
Accept: */*
Connection: keep-alive
Cookie: name=python


/users          # 资源路径
http://127.0.0.1:5000/users     # 完整路径
127.0.0.1                       # 客户端ip
{'name': 'python'}              # 请求的cookie

提醒一点，request.remote_addr并不一定能够准确的获得客户端的IP，因为在部署服务时，通常最前端用nginx做转发，这样，你获得其实是nginx的IP地址，而非用户的真实地址，如何准确获得客户端的IP地址，请参考文章https://www.cnblogs.com/mzhaox/p/11214747.html

解析请求数据

客户端（浏览器）会向服务器提交HTTP请求；然后服务器向客户端返回响应；其中响应包含有关请求的状态信息，还可能包含请求的内容。

GET

get请求用于查询数据时，通常会带有参数，参数放在path的后面，中间用问号连接。

多个请求参数以key=value的形式用&连接起来。

下面是一个带参数的get请求的示例url：

1

http://127.0.0.1:5000/users?name=poly&age=14

get请求的参数可以通过request.args 和 request.values 两种方法来获得

其中request.args 是包含解析过的get参数的MultiDict

MultiDict 是werkzeug提供的一种多key字典，具体可参考 https://werkzeug.palletsprojects.com/en/0.16.x/datastructures/#werkzeug.datastructures.MultiDict

使用方法示例

1
2
3
4
5
6
7

@app.route('/users', methods=['GET', 'POST'])
def users():
    name = request.args['name']
    age = request.args['age']
    print(name, age)
    return 'ok'
# 获取到的参数一律都是字符串类型

POST

post请求用于新增数据，它提交数据的格式有两种：form表单，json数据

requests.form里存储着post请求提交的form表单数据，下面是解析示例

1
2
3
4
5
6

@app.route('/users', methods=['POST'])
def users():
    name = request.form['name']
    age = request.form['age']
    print(name, age)
    return 'ok'

request.values

request.args和request.form，其类型都是MultiDict。

因此，flask又提供了一个request.values，类型为CombinedMultiDict。

它包含了args和form,这样，在获取数据时，就不必在纠结到底用args还是用form了，request.values使用方法与args,form相同。

json

post提交的json数据，应该用get_json()方法来获取

服务端示例代码

1
2
3
4
5

@app.route('/users', methods=['POST'])
def users():
    data = request.get_json()
    print(data)
    return 'ok'

客户端示例代码

1
2
3

import requests

res = requests.post('http://127.0.0.1:5000/users', json={'name': 'poly', 'age': 13})