在Flask的官方文档中是这样介绍request的:对于 Web 应用,与客户端发送给服务器的数据交互至关重要。在 Flask 中由全局的 request 对象来提供这些信息。
从Flask模块导入request:from flask import request
request的属性:下面是request可使用的属性。
属性名 | 解释 |
form | 一个从POST和PUT请求解析的 MultiDict(一键多值字典)。 |
args | MultiDict,要操作 URL (如 ?key=value )中提交的参数可以使用 args 属性: searchword = request.args.get('key', '') |
values | CombinedMultiDict,内容是form 和args 。 可以使用values替代form和args。 |
cookies | 请求的cookies,类型是dict。 |
stream | 在可知的mimetype下,如果进来的表单数据无法解码,会没有任何改动的保存到这个 stream 以供使用。很多时候,当请求的数据转换为string时,使用data 是最好的方式。这个stream只返回数据一次。 |
headers | 请求头,字典类型。 |
data | 包含了请求的数据,并转换为字符串,除非是一个Flask无法处理的mimetype。 |
files | MultiDict,带有通过POST或PUT请求上传的文件。 |
environ | WSGI隐含的环境配置。 |
method | 请求方法,比如POST、GET。 |
path | 获取请求文件路径:/myapplication/page.html |
script_root | |
base_url | 获取域名与请求文件路径:http://www.baidu.com/myapplication/page.html |
url | 获取全部url:http://www.baidu.com/myapplication/page.html?id=1&edit=edit |
url_root | 获取域名:http://www.baidu.com/ |
is_xhr | 如果请求是一个来自JavaScript XMLHttpRequest 的触发,则返回True ,这个只工作在支持X-Requested-With 头的库并且设置了XMLHttpRequest 。 |
blueprint | 蓝图名字。 |
endpoint | endpoint匹配请求,这个与view_args 相结合,可是用于重构相同或修改URL。当匹配的时候发生异常,会返回None。 |
json | 如果mimetype 是application/json ,这个参数将会解析JSON数据,如果不是则返回None。 可以使用这个替代get_json()方法。 |
max_content_length | 只读,返回MAX_CONTENT_LENGTH 的配置键。 |
module | 如果请求是发送到一个实际的模块,则该参数返回当前模块的名称。这是弃用的功能,使用blueprints 替代。 |
routing_exception = None | 如果匹配URL失败,这个异常将会/已经抛出作为请求处理的一部分。这通常用于NotFound 异常或类似的情况。 |
url_rule = None | 内部规则匹配请求的URL。这可用于在URL之前/之后检查方法是否允许(request.url_rule.methods) 等等。 默认情况下,在处理请求函数中写下 print('request.url_rule.methods', request.url_rule.methods) 会打印: request.url_rule.methods {‘GET’, ‘OPTIONS’, ‘HEAD’} |
view_args = None | 一个匹配请求的view参数的字典,当匹配的时候发生异常,会返回None。 |
其他方法 | get_json(force=False, silent=False, cache=True) on_json_loading_failed(e) |
二、常用方法的使用
代码示例,仅仅是为了测试request的属性值
@app.route('/login', methods = ['GET','POST']) def login(): if request.method == 'POST': if request.form['username'] == request.form['password']: return 'TRUE' else: #当form中的两个字段内容不一致时,返回我们所需要的测试信息 return str(request.headers) #需要替换的部分 else: return render_template('login.html')
1、method:请求的方法
return request.method #POST
2、form:返回form的内容
return json.dumps(request.form) #{"username": "123", "password": "1234"}
3、args和values:args返回请求中的参数,values返回请求中的参数和form
return json.dumps(request.args) #url:http://192.168.1.183:5000/login?a=1&b=2、返回值:{"a": "1", "b": "2"} print(request.args['a']) #输出:1 return str(request.values) #CombinedMultiDict([ImmutableMultiDict([('a', '1'), ('b', '2')]), ImmutableMultiDict([('username', '123'), ('password', '1234')])])
4、cookies:cookies信息
return json.dumps(request.cookies) #cookies信息
5、headers:请求headers信息,返回的结果是个list
return str(request.headers) #headers信息 request.headers.get('User-Agent') #获取User-Agent信息
6、url、path、script_root、base_url、url_root:看结果比较直观
return 'url: %s , script_root: %s , path: %s , base_url: %s , url_root : %s' % (request.url,request.script_root, request.path,request.base_url,request.url_root) ''' url: http://192.168.1.183:5000/testrequest?a&b , script_root: , path: /testrequest , base_url: http://192.168.1.183:5000/testrequest , url_root : http://192.168.1.183:5000/ '''
7、date、files:date是请求的数据,files随请求上传的文件
@app.route('/upload',methods=['GET','POST']) def upload(): if request.method == 'POST': f = request.files['file'] filename = secure_filename(f.filename) #f.save(os.path.join('app/static',filename)) f.save('app/static/'+str(filename)) return 'ok' else: return render_template('upload.html') #html <!DOCTYPE html> <html> <body> <form action="upload" method="post" enctype="multipart/form-data"> <input type="file" name="file" /><br /> <input type="submit" value="Upload" /> </form> </body> </html>