request对于 Web 应用与客户端发送给服务器的数据交互至关重要。在 Flask 中由全局的 request 对象来提供这些信息。
导入request:
from flask import 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。 -
environ
WSGI隐含的环境配置。 -
method
请求方法,比如POST、GET。 -
path
- script_root
- url
- base_url
- url_root
如果用户请求如下URL:http://www.example.com/myapplication/page.html?x=y
以上的参数内容如下:
名称 | 内容 |
---|---|
path | /page.html |
script_root | /myapplication |
base_url | http://www.example.com/myapplication/page.html |
url | http://www.example.com/myapplication/page.html?x=y |
url_root | http://www.example.com/myapplication/ |
-
is_xhr
如果请求是一个来自JavaScript XMLHttpRequest
的触发,则返回True
,这个只工作在支持X-Requested-With
头的库并且设置了XMLHttpRequest
。 -
blurprint
蓝本名字。 -
endpoint
endpoint匹配请求,这个与view_args
相结合,可是用于重构相同或修改URL。当匹配的时候发生异常,会返回None。 -
get_json(force=False, silent=False, cache=True)
-
json
如果mimetype
是application/json
,这个参数将会解析JSON数据,如果不是则返回None。
可以使用这个替代get_json()方法。 -
max_content_length
只读,返回MAX_CONTENT_LENGTH
的配置键。 -
module
如果请求是发送到一个实际的模块,则该参数返回当前模块的名称。这是弃用的功能,使用blueprints
替代。 - on_json_loading_failed(e)
-
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。 -
files
MultiDict,带有通过POST或PUT请求上传的文件。用 Flask 处理文件上传很简单。只要确保你没忘记在 HTML 表单中设置enctype="multipart/form-data" 属性,不然你的浏览器根本不会发送文件。
已上传的文件存储在内存或是文件系统中一个临时的位置。你可以通过请求对象的 files属性访问它们。每个上传的文件都会存储在这个字典里。它表现近乎为一个标准的 Python file 对象,但它还有一个 save() 方法,这个方法允许你把文件保存到服务器的文件系统上。这里是一个用它保存文件的例子:
from flask import request @app.route('/upload', methods=['GET', 'POST']) def upload_file(): if request.method == 'POST': f = request.files['the_file'] f.save('/var/www/uploads/uploaded_file.txt')
如果你想知道上传前文件在客户端的文件名是什么,你可以访问 filename 属性。但请记住, 永远不要信任这个值,这个值是可以伪造的。如果你要把文件按客户端提供的文件名存储在服务器上,那么请把它传递给 Werkzeug 提供的 secure_filename() 函数:
from flask import request from werkzeug import secure_filename @app.route('/upload', methods=['GET', 'POST']) def upload_file(): if request.method == 'POST': f = request.files['the_file'] f.save('/var/www/uploads/' + secure_filename(f.filename))
转自:https://blog.csdn.net/ialexanderi/article/details/78747101和https://www.cnblogs.com/wangjikun/p/6935592.html
中文文档:http://docs.jinkan.org/docs/flask/quickstart.html#accessing-request-data