Webanwendungen erfordern häufig die Verarbeitung eingehender Anforderungsdaten von Benutzern. Diese Nutzdaten können in Form von Abfragezeichenfolgen, Formulardaten und JSON-Objekten vorliegen. Mit Flask können Sie wie mit jedem anderen Webframework auf die Anforderungsdaten zugreifen.
In diesem Tutorial erstellen Sie eine Flask-Anwendung mit drei Routen, die entweder Abfragezeichenfolgen, Formulardaten oder JSON-Objekte akzeptieren.
Um diesem Tutorial zu folgen, benötigen Sie:
Dieses Tutorial wurde mit Pipenv v2020.11.15, Python v3.9.0 und Flask v1.1.2 verifiziert.
Um die verschiedenen Verwendungsmöglichkeiten von Anforderungen zu demonstrieren, müssen Sie eine Flask-App erstellen. Obwohl die Beispiel-App eine vereinfachte Struktur für die Ansichtsfunktionen und -routen verwendet, kann das, was Sie in diesem Tutorial lernen, auf jede Methode zum Organisieren Ihrer Ansichten angewendet werden, z. B. auf klassenbasierte Ansichten, Blaupausen oder eine Erweiterung wie Flask-Via.
Zuerst müssen Sie ein Projektverzeichnis erstellen. Öffnen Sie Ihren Terminal und führen Sie folgenden Befehl aus:
- mkdir flask_request_example
Navigieren Sie dann zum neuen Verzeichnis:
- cd flask_request_example
Installieren Sie als nächstes Flask. Öffnen Sie Ihren Terminal und führen Sie folgenden Befehl aus:
- pipenv install Flask
Der Befehl pipenv
erstellt eine virtuelle Umgebung für dieses Projekt, eine Pipfile, eine Installations-flask
und eine Pipfile.lock.
Führen Sie den folgenden Befehl aus, um virtualenv des Projekts zu aktivieren:
- pipenv shell
Um auf die eingehenden Daten in Flask zuzugreifen, müssen Sie das Anforderungsobjekt
verwenden. Das Anforderungsobjekt
enthält alle eingehenden Daten aus der Anforderung, einschließlich Mimetyp, Referrer, IP-Adresse, Rohdaten, HTTP-Methode und Überschriften.
Obwohl alle Informationen, die das Anforderungsobjekt
enthält, nützlich sein können, konzentrieren Sie sich für die Zwecke dieses Artikels auf die Daten, die normalerweise direkt vom Aufrufer des Endpunkts bereitgestellt werden.
Um Zugriff auf das Anforderungsobjekt in Flask zu erhalten, müssen Sie es aus der Flask-Bibliothek importieren:
from flask import request
Sie können es dann in jeder Ihrer Ansichtsfunktionen verwenden.
Verwenden Sie Ihren Code-Editor, um eine Datei app.py
zu erstellen. Importieren Sie Flask
und das Anforderungsobjekt
. Und erstellen Sie auch Routen für query-example
, form-example
und json-example
:
# import main Flask class and request object
from flask import Flask, request
# create the Flask app
app = Flask(__name__)
@app.route('/query-example')
def query_example():
return 'Query String Example'
@app.route('/form-example')
def form_example():
return 'Form Data Example'
@app.route('/json-example')
def json_example():
return 'JSON Object Example'
if __name__ == '__main__':
# run app in debug mode on port 5000
app.run(debug=True, port=5000)
Öffnen Sie als nächstes Ihr Terminal und starten Sie die App mit dem folgenden Befehl:
- python app.py
Die App wird auf Port 5000 gestartet, sodass Sie jede Route in Ihrem Browser über die folgenden Links anzeigen können:
http://127.0.0.1:5000/query-example (or localhost:5000/query-example)
http://127.0.0.1:5000/form-example (or localhost:5000/form-example)
http://127.0.0.1:5000/json-example (or localhost:5000/json-example)
Der Code erstellt drei Routen und zeigt die Nachrichten „Beispiel für Abfragezeichenfolge“
,„Beispiel für Formulardaten“
bzw. „Beispiel für JSON-Objekt“
an.
URL-Argumente, die Sie einer Abfragezeichenfolge hinzufügen, sind eine übliche Methode, um Daten an eine Webanwendung zu übergeben. Beim Surfen im Internet sind Sie wahrscheinlich schon einmal auf eine Abfragezeichenfolge gestoßen.
Eine Abfragezeichenfolge ähnelt der folgenden:
example.com?arg1=value1&arg2=value2
Die Abfragezeichenfolge beginnt nach dem Fragezeichen (?
) Zeichen:
example.com?arg1=value1&arg2=value2
Und hat Schlüssel-Wert-Paare, die durch ein kaufmännisches Und (&
) getrennt sind:
example.com?arg1=value1&arg2=value2
Für jedes Paar folgt auf den Schlüssel ein Gleichheitszeichen (=
) und dann der Wert.
arg1 : value1
arg2 : value2
Abfragezeichenfolgen sind nützlich, um Daten zu übergeben, für die der Benutzer keine Maßnahmen ergreifen muss. Sie können irgendwo in Ihrer App eine Abfragezeichenfolge generieren und an eine URL anhängen. Wenn ein Benutzer eine Anfrage stellt, werden die Daten automatisch für ihn übergeben. Eine Abfragezeichenfolge kann auch von Formularen generiert werden, deren Methode GET ist.
Fügen wir der Abfragebeispielroute
eine Abfragezeichenfolge hinzu. In diesem hypothetischen Beispiel geben Sie den Namen einer Programmiersprache an, die auf dem Bildschirm angezeigt wird. Erstellen Sie einen Schlüssel für „Sprache“
und einen Wert für „Python“
:
http://127.0.0.1:5000/query-example?language=Python
Wenn Sie die App ausführen und zu dieser URL navigieren, wird weiterhin die Meldung „Beispiel für eine Abfragezeichenfolge“
angezeigt.
Sie müssen den Teil programmieren, der die Abfrageargumente verarbeitet. Dieser Code liest den Schlüssel Sprache
durch Verwendung von request.args.get('language')
oder request.args.get('language')
.
Durch den Aufruf von request.args.get('language')
wird die Anwendung weiterhin ausgeführt, wenn der Schlüssel Sprache
nicht in der URL vorhanden ist. In diesem Fall ist das Ergebnis der Methode Keine
.
Durch den Aufruf von request.args['language']
gibt die App einen 400-Fehler zurück, wenn der Schlüssel Sprache
nicht in der URL vorhanden ist.
Beim Umgang mit Abfragezeichenfolgen wird empfohlen, request.args.get ()
zu verwenden, um zu verhindern, dass die App fehlschlägt.
Lesen wir den Schlüssel Sprache
und zeigen ihn als Ausgabe an.
Ändern Sie die Route query-example
in app.py
mit dem folgenden Code:
@app.route('/query-example')
def query_example():
# if key doesn't exist, returns None
language = request.args.get('language')
return '''<h1>The language value is: {}</h1>'''.format(language)
Führen Sie dann die App aus und navigieren Sie zur URL:
http://127.0.0.1:5000/query-example?language=Python
Der Browser sollte die folgende Nachricht anzeigen:
OutputThe language value is: Python
Das Argument aus der URL wird der Variable Sprache
zugewiesen und dann an den Browser zurückgegeben.
Um weitere Parameter für Abfragezeichenfolgen hinzuzufügen, können Sie ein kaufmännisches Und und die neuen Schlüssel-Wert-Paare an das Ende der URL anhängen. Erstellen Sie einen Schlüssel für „Framework“
und einen Wert für „Flask“
:
http://127.0.0.1:5000/query-example?language=Python&framework=Flask
Wenn Sie mehr möchten, fügen Sie weiterhin ein kaufmännisches Und und Schlüssel-Wert-Paare hinzu. Erstellen Sie einen Schlüssel für „Framework“
und einen Wert für „Flask“
:
http://127.0.0.1:5000/query-example?language=Python&framework=Flask&website=DigitalOcean
Um Zugriff auf diese Werte zu erhalten, verwenden Sie weiterhin entweder request.args.get()
oder request.args[]
. Verwenden wir beide, um zu demonstrieren, was passiert, wenn ein Schlüssel fehlt. Ändern Sie die Route query_example
, um den Wert der Ergebnisse in Variablen zu zuweisen und sie dann anzuzeigen:
@app.route('/query-example')
def query_example():
# if key doesn't exist, returns None
language = request.args.get('language')
# if key doesn't exist, returns a 400, bad request error
framework = request.args['framework']
# if key doesn't exist, returns None
website = request.args.get('website')
return '''
<h1>The language value is: {}</h1>
<h1>The framework value is: {}</h1>
<h1>The website value is: {}'''.format(language, framework, website)
Führen Sie dann die App aus und navigieren Sie zur URL:
http://127.0.0.1:5000/query-example?language=Python&framework=Flask&website=DigitalOcean
Der Browser sollte die folgende Nachricht anzeigen:
OutputThe language value is: Python
The framework value is: Flask
The website value is: DigitalOcean
Entfernen Sie den Schlüssel Sprache
aus der URL:
http://127.0.0.1:5000/query-example?framework=Flask&website=DigitalOcean
Der Browser sollte die folgende Nachricht mit Keine
anzeigen, wenn ein Wert nicht für Sprache
bereitgestellt wird:
OutputThe language value is: None
The framework value is: Flask
The website value is: DigitalOcean
Entfernen Sie den Schlüssel Framework
aus der URL:
http://127.0.0.1:5000/query-example?language=Python&website=DigitalOcean
Der Browser sollte auf einen Fehler stoßen, da er einen Wert für Framework
erwartet:
Outputwerkzeug.exceptions.BadRequestKeyError
werkzeug.exceptions.BadRequestKeyError: 400 Bad Request: The browser (or proxy) sent a request that this server could not understand.
KeyError: 'framework'
Jetzt verstehen Sie den Umgang mit Abfragezeichenfolgen. Fahren wir mit dem nächsten Typ eingehender Daten fort.
Formulardaten stammen aus einem Formular, das als POST-Abfrage an eine Route gesendet wurde. Anstatt die Daten in der URL anzuzeigen (außer in Fällen, in denen das Formular mit einer GET-Abfrage gesendet wird), werden die Formulardaten hinter den Kulissen an die App übergeben. Obwohl Sie die Formulardaten nicht einfach sehen können, die übergeben werden, kann Ihre App sie weiterhin lesen.
Um dies zu demonstrieren, ändern Sie die Formularbeispielroute
in app.py
, um sowohl GET- als auch POST-Abfragen zu akzeptieren, und geben Sie ein Formular zurück:
# allow both GET and POST requests
@app.route('/form-example', methods=['GET', 'POST'])
def form_example():
return '''
<form method="POST">
<div><label>Language: <input type="text" name="language"></label></div>
<div><label>Framework: <input type="text" name="framework"></label></div>
<input type="submit" value="Submit">
</form>'''
Führen Sie dann die App aus und navigieren Sie zur URL:
http://127.0.0.1:5000/form-example
Der Browser sollte ein Formular mit zwei Eingabefeldern - einem für Sprache
und einem für Framework
- und eine Senden-Taste übergeben.
Das Wichtigste, was Sie über dieses Formular wissen müssen, ist, dass es eine POST-Abfrage an dieselbe Route ausführt, die das Formular generiert hat. Die Schlüssel, die in der App gelesen werden, stammen alle aus den Namensattributen
in unseren Formulareingaben. In diesem Fall sind Sprache
und Framework
die Namen der Eingaben, sodass Sie Zugriff auf die in der App haben.
Innerhalb der Ansichtsfunktion müssen Sie überprüfen, ob die Abfragemethode GET oder POST ist. Wenn es sich um eine GET-Abfrage handelt, können Sie das Formular anzeigen. Wenn es sich um eine POST-Abfrage handelt, möchten Sie die eingehenden Daten verarbeiten.
Ändern Sie die Route form-example
in app.py
mit dem folgenden Code:
# allow both GET and POST requests
@app.route('/form-example', methods=['GET', 'POST'])
def form_example():
# handle the POST request
if request.method == 'POST':
language = request.form.get('language')
framework = request.form.get('framework')
return '''
<h1>The language value is: {}</h1>
<h1>The framework value is: {}</h1>'''.format(language, framework)
# otherwise handle the GET request
return '''
<form method="POST">
<div><label>Language: <input type="text" name="language"></label></div>
<div><label>Framework: <input type="text" name="framework"></label></div>
<input type="submit" value="Submit">
</form>'''
Führen Sie dann die App aus und navigieren Sie zur URL:
http://127.0.0.1:5000/form-example
Füllen Sie das Feld Sprache
mit dem Wert von Python
und das Feld Framework
mit dem Wert von Flask
aus. Drücken Sie dann Senden.
Der Browser sollte die folgende Nachricht anzeigen:
OutputThe language value is: Python
The framework value is: Flask
Jetzt verstehen Sie den Umgang mit Formulardaten. Fahren wir mit dem nächsten Typ eingehender Daten fort.
JSON-Daten werden normalerweise von einem Prozess erstellt, der die Route aufruft.
Ein Beispiel-JSON-Objekt sieht folgendermaßen aus:
{
"language": "Python",
"framework": "Flask",
"website": "Scotch",
"version_info": {
"python": "3.9.0",
"flask": "1.1.2"
},
"examples": ["query", "form", "json"],
"boolean_test": true
}
Diese Struktur kann die Übergabe von viel komplizierteren Daten im Gegensatz zu Abfragezeichenfolgen und Formulardaten ermöglichen. Im Beispiel sehen Sie verschachtelte JSON-Objekte und eine Anordnung von Elementen. Flask kann dieses Format von Daten verarbeiten.
Ändern Sie die Route form-example
in app.py
, um POST-Abfragen zu akzeptieren und andere Abfragen wie GET zu ignorieren:
@app.route('/json-example', methods=['POST'])
def json_example():
return 'JSON Object Example'
Im Gegensatz zu dem Webbrowser, der für Abfragezeichenfolgen und Formulardaten zum Senden eines JSON-Objekts in diesem Artikel verwendet wird, verwenden Sie Postman, um benutzerdefinierte Anforderungen an URLs zu senden.
Hinweis: Wenn Sie Hilfe benötigen, um Postman für Abfragen zu navigieren, konsultieren Sie die offizielle Dokumentation.
Fügen Sie in Postman die URL hinzu und ändern Sie den Typ in POST. Wechseln Sie auf der Registerkarte Body zu raw und wählen Sie JSON aus der Dropdown-Liste aus.
Diese Einstellungen sind erforderlich, sodass Postman JSON-Daten richtig senden kann und Ihre Flask-App versteht, dass sie JSON empfängt:
POST http://127.0.0.1:5000/json-example
Body
raw JSON
Kopieren Sie als Nächstes das frühere JSON-Beispiel in die Texteingabe.
Senden Sie die Abfrage und Sie sollten „Beispiel eines JSON-Objekts“
als Antwort erhalten. Das ist ziemlich antiklimatisch, aber zu erwarten, da der Code für die Verarbeitung der JSON-Datenantwort noch nicht geschrieben wurde.
Um die Daten zu lesen, müssen Sie verstehen, wie Flask JSON-Daten in Python-Datenstrukturen übersetzt:
{"key": value "}
in JSON entspricht somedict['key']
, das in Python einen Wert zurückgibt.[1,2,3,4,5]
wahr
und falsch
werden in Python zu Wahr
und Falsch
.Arbeiten wir nun an dem Code, um die eingehenden JSON-Daten zu lesen.
Zuerst weisen wir alles aus dem JSON-Objekt mit request.get_json()
einer Variable zu.
request.get_json()
konvertiert das JSON-Objekt in Python-Daten. Weisen wir die eingehenden Abfragedaten den Variablen zu, und geben sie zurück, indem wir die folgenden Änderungen an der Route json-example
vornehmen:
# GET requests will be blocked
@app.route('/json-example', methods=['POST'])
def json_example():
request_data = request.get_json()
language = request_data['language']
framework = request_data['framework']
# two keys are needed because of the nested object
python_version = request_data['version_info']['python']
# an index is needed because of the array
example = request_data['examples'][0]
boolean_test = request_data['boolean_test']
return '''
The language value is: {}
The framework value is: {}
The Python version is: {}
The item at index 0 in the example list is: {}
The boolean value is: {}'''.format(language, framework, python_version, example, boolean_test)
Beachten Sie, wie Sie auf Elemente zugreifen, die nicht auf der oberen Ebene sind. ['version']['python']
wird verwendet, da Sie ein verschachteltes Objekt eingeben. Und ['examples'][0]
wird verwendet, um auf den 0. Index in der Anordnung der Beispiele zuzugreifen.
Wenn das mit der Abfrage gesendete JSON-Objekt keinen Schlüssel hat, auf den in Ihrer Ansichtsfunktion zugegriffen wird, wird die Abfrage fehlschlagen. Wenn Sie nicht möchten, dass es fehlschlägt, wenn ein Schlüssel nicht vorhanden ist, müssen Sie überprüfen, ob der Schlüssel vorhanden ist, bevor Sie versuchen, darauf zuzugreifen.
# GET requests will be blocked
@app.route('/json-example', methods=['POST'])
def json_example():
request_data = request.get_json()
language = None
framework = None
python_version = None
example = None
boolean_test = None
if request_data:
if 'language' in request_data:
language = request_data['language']
if 'framework' in request_data:
framework = request_data['framework']
if 'version_info' in request_data:
if 'python' in request_data['version_info']:
python_version = request_data['version_info']['python']
if 'examples' in request_data:
if (type(request_data['examples']) == list) and (len(request_data['examples']) > 0):
example = request_data['examples'][0]
if 'boolean_test' in request_data:
boolean_test = request_data['boolean_test']
return '''
The language value is: {}
The framework value is: {}
The Python version is: {}
The item at index 0 in the example list is: {}
The boolean value is: {}'''.format(language, framework, python_version, example, boolean_test)
Führen Sie die App aus und senden Sie die Beispiel-JSON-Abfrage mit Postman. In der Antwort erhalten Sie die folgende Ausgabe:
OutputThe language value is: Python
The framework value is: Flask
The Python version is: 3.9
The item at index 0 in the example list is: query
The boolean value is: false
Jetzt verstehen Sie die Verarbeitung von JSON-Objekten.
In diesem Artikel haben Sie eine Flask-Anwendung mit drei Routen erstellt, die entweder Abfragezeichenfolgen, Formulardaten oder JSON-Objekte akzeptieren.
Denken Sie auch daran, dass alle Ansätze die wiederkehrende Überlegung berücksichtigen mussten, ob ein Schlüssel ordnungsgemäß fehlschlägt, wenn ein Schlüssel fehlt.
Warnung: ein Thema, das in diesem Artikel nicht behandelt wurde, war die Bereinigung von Benutzereingaben. Durch die Bereinigung von Benutzereingaben wird sichergestellt, dass von der Anwendung gelesene Daten nicht unerwartet fehlschlagen oder Sicherheitsmaßnahmen umgehen.
Wenn Sie mehr über Flask erfahren möchten, lesen Sie unsere Themenseite zu Flask für Übungen und Programmierprojekte.
Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.
This textbox defaults to using Markdown to format your answer.
You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!
Sign up for Infrastructure as a Newsletter.
Working on improving health and education, reducing inequality, and spurring economic growth? We'd like to help.
Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.