Flask Request Object API
Die Request-Klasse kapselt alle Informationen über die vom Client gesendete HTTP-Anfrage.
Durchfrom flask import requestImportiere das Proxy-Objekt und verwende es direkt in View-Funktionen.
Kurzreferenz für gängige Attribute
| Eigenschaft | Type | Beschreibung | Beispielwert |
|---|---|---|---|
| method | str | HTTP-Anfragemethode | "GET"、"POST" |
| path | str | URL-Pfadteil (ohne Domain und Query-String) | "/search" |
| full_path | str | Pfad + Query-String | "/search?q=example" |
| url | str | Vollständige Anfrage-URL (ohne Query-String) | "http://localhost:5000/search" |
| base_url | str | Wie url, jedoch ohne den abschließenden Query-String. | "http://localhost:5000/search" |
| url_root | str | Domain + Anwendungsstammpfad | "http://localhost:5000/" |
| host | str | Host-Header, einschließlich Port | "localhost:5000" |
| host_url | str | scheme + host + Anwendungsstamm | "http://localhost:5000/" |
| scheme | str | Protokoll | "http"、"https" |
| remote_addr | str | Client-IP-Adresse | "127.0.0.1" |
| endpoint | str | Der übereinstimmende Routen-Endpunkt | "index"、"blog.show" |
| url_rule | Regel | Übereinstimmendes Routenregel-Objekt | Werkzeug Rule-Instanz |
| view_args | dict | Dynamische Variablen in der URL | {"post_id": 42} |
| blueprint | str | Aktueller Blueprint-Name | "auth"、"blog" |
| blueprints | Liste | Aktuelle Liste der übereinstimmenden Blueprint-Ebenen | ["auth"] |
| is_json | bool | Ob der Content-Type der Anfrage JSON ist | True / False |
Anfragedaten abrufen
| Attribute/Methoden | Type | Beschreibung |
|---|---|---|
| args | MultiDict | URL-Abfrageparameter. Zugriff auf /search?q=flask → request.args.get("q") |
| Form | MultiDict | POST-Formulardaten (application/x-www-form-urlencoded oder multipart/form-data) |
| json | dict / None | JSON-Anfragekörper (in ein Python-Objekt geparst). Gibt None zurück, wenn die Anfrage nicht JSON ist. |
| data | bytes | Rohdaten des Anfragekörpers |
| files | FileMultiDict | Hochgeladene Datei. request.files["file"] gibt ein FileStorage-Objekt zurück |
| cookies | dict | Vom Client gesendetes Cookie |
| headers | Headers | Anfrage-Header. Unterstützt mehrere Zugriffsmethoden |
| get_json(force=False, silent=False, cache=True) | — | Den JSON-Anfragekörper parsen. force erzwingt das Parsen von Nicht-JSON-Typen, silent gibt bei Fehler None zurück |
Paarargs、formusw. MultiDict-Typen, immer verwenden..get(key, default)Methode zum Abrufen des Werts. Direkt verwenden.request.args["key"]Der Zugriff auf einen nicht existierenden Schlüssel löst einen KeyError aus (gibt einen 400-Fehler zurück).
Attribute der Inhaltsaushandlung
| Attribute/Methoden | Beschreibung |
|---|---|
| accept_mimetypes | Liste der vom Client akzeptierten MIME-Typen (MIMEAccept-Objekt). |
| accept_charsets | Vom Client akzeptierter Zeichensatz |
| accept_encodings | Vom Client akzeptierte Kodierung |
| accept_languages | Vom Client akzeptierte Sprache |
| content_type | Content-Type der Anfrage |
| content_length | Länge des Anfragekörpers (Bytes) |
| content_md5 | MD5-Prüfsumme des Anfragekörpers |
Codebeispiele
Beispiel
from flask import Flask, request
app = Flask(__name__)
@app.route("/demo", methods=["GET", "POST"])
def demo():
# Query-Parameter abrufen
keyword = request.args.get("q", "")
# Formulardaten abrufen
username = request.form.get("username", "")
# JSON-Daten abrufen
if request.is_json:
data = request.json
name = data.get("name", "unknown")
# Request-Header abrufen
user_agent = request.headers.get("User-Agent", "")
accept_lang = request.accept_languages.best
# URL-Informationen abrufen
url_info = {
"method": request.method, # "GET" oder "POST"
"path": request.path, # "/demo"
"url": request.url, # Vollständige URL
"remote_addr": request.remote_addr, # Client-IP
}
return url_info
app = Flask(__name__)
@app.route("/demo", methods=["GET", "POST"])
def demo():
# Query-Parameter abrufen
keyword = request.args.get("q", "")
# Formulardaten abrufen
username = request.form.get("username", "")
# JSON-Daten abrufen
if request.is_json:
data = request.json
name = data.get("name", "unknown")
# Request-Header abrufen
user_agent = request.headers.get("User-Agent", "")
accept_lang = request.accept_languages.best
# URL-Informationen abrufen
url_info = {
"method": request.method, # "GET" oder "POST"
"path": request.path, # "/demo"
"url": request.url, # Vollständige URL
"remote_addr": request.remote_addr, # Client-IP
}
return url_info