7.1 KiB
Pfad-Parameter und Validierung von Zahlen
So wie Sie mit Query für Query-Parameter zusätzliche Validierungen und Metadaten deklarieren können, können Sie mit Path die gleichen Validierungen und Metadaten für Pfad-Parameter deklarieren.
Path importieren
Importieren Sie zuerst Path von fastapi, und importieren Sie Annotated:
{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[1,3] *}
/// info | Info
FastAPI hat in Version 0.95.0 Unterstützung für Annotated hinzugefügt und es zur Verwendung empfohlen.
Wenn Sie eine ältere Version haben, würden Fehler angezeigt werden, wenn Sie versuchen, Annotated zu verwenden.
Stellen Sie sicher, dass Sie FastAPI aktualisieren{.internal-link target=_blank}, auf mindestens Version 0.95.1, bevor Sie Annotated verwenden.
///
Metadaten deklarieren
Sie können dieselben Parameter wie für Query deklarieren.
Um zum Beispiel einen title-Metadaten-Wert für den Pfad-Parameter item_id zu deklarieren, können Sie schreiben:
{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[10] *}
/// note | Hinweis
Ein Pfad-Parameter ist immer erforderlich, da er Teil des Pfads sein muss. Selbst wenn Sie ihn mit None deklarieren oder einen Defaultwert setzen, würde das nichts ändern, er wäre dennoch immer erforderlich.
///
Die Parameter sortieren, wie Sie möchten
/// tip | Tipp
Das ist wahrscheinlich nicht so wichtig oder notwendig, wenn Sie Annotated verwenden.
///
Angenommen, Sie möchten den Query-Parameter q als erforderlichen str deklarieren.
Und Sie müssen sonst nichts anderes für diesen Parameter deklarieren, Sie brauchen also Query nicht wirklich.
Aber Sie müssen dennoch Path für den item_id-Pfad-Parameter verwenden. Und aus irgendeinem Grund möchten Sie Annotated nicht verwenden.
Python wird sich beschweren, wenn Sie einen Wert mit einem „Default“ vor einem Wert ohne „Default“ setzen.
Aber Sie können die Reihenfolge ändern und den Wert ohne Default (den Query-Parameter q) zuerst setzen.
Für FastAPI spielt es keine Rolle. Es erkennt die Parameter anhand ihrer Namen, Typen und Default-Deklarationen (Query, Path, usw.), es kümmert sich nicht um die Reihenfolge.
Sie können Ihre Funktion also so deklarieren:
{* ../../docs_src/path_params_numeric_validations/tutorial002.py hl[7] *}
Aber bedenken Sie, dass Sie dieses Problem nicht haben, wenn Sie Annotated verwenden, da es nicht darauf ankommt, dass Sie keine Funktionsparameter-Defaultwerte für Query() oder Path() verwenden.
{* ../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py *}
Die Parameter sortieren, wie Sie möchten: Tricks
/// tip | Tipp
Das ist wahrscheinlich nicht so wichtig oder notwendig, wenn Sie Annotated verwenden.
///
Hier ist ein kleiner Trick, der nützlich sein kann, obwohl Sie ihn nicht oft benötigen werden.
Wenn Sie:
- den
q-Query-Parameter sowohl ohneQueryals auch ohne Defaultwert deklarieren - den Pfad-Parameter
item_idmitPathdeklarieren - sie in einer anderen Reihenfolge haben
- nicht
Annotatedverwenden
... möchten, dann hat Python eine kleine Spezial-Syntax dafür.
Übergeben Sie *, als den ersten Parameter der Funktion.
Python wird nichts mit diesem * machen, aber es wird wissen, dass alle folgenden Parameter als Schlüsselwortargumente (Schlüssel-Wert-Paare) verwendet werden sollen, auch bekannt als kwargs. Selbst wenn diese keinen Defaultwert haben.
{* ../../docs_src/path_params_numeric_validations/tutorial003.py hl[7] *}
Besser mit Annotated
Bedenken Sie, dass Sie, wenn Sie Annotated verwenden, da Sie keine Funktionsparameter-Defaultwerte verwenden, dieses Problem nicht haben werden und wahrscheinlich nicht * verwenden müssen.
{* ../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py hl[10] *}
Validierung von Zahlen: Größer oder gleich
Mit Query und Path (und anderen, die Sie später sehen werden) können Sie Zahlenbeschränkungen deklarieren.
Hier, mit ge=1, muss item_id eine ganze Zahl sein, die „greater than or equal to“ (größer oder gleich) 1 ist.
{* ../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py hl[10] *}
Validierung von Zahlen: Größer und kleiner oder gleich
Das Gleiche gilt für:
gt:greaterthan (größer als)le:less than orequal (kleiner oder gleich)
{* ../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py hl[10] *}
Validierung von Zahlen: Floats, größer und kleiner
Zahlenvalidierung funktioniert auch für float-Werte.
Hier wird es wichtig, in der Lage zu sein, gt und nicht nur ge zu deklarieren. Da Sie mit dieser Option erzwingen können, dass ein Wert größer als 0 sein muss, selbst wenn er kleiner als 1 ist.
Also wäre 0.5 ein gültiger Wert. Aber 0.0 oder 0 nicht.
Und das Gleiche gilt für lt.
{* ../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py hl[13] *}
Zusammenfassung
Mit Query, Path (und anderen, die Sie noch nicht gesehen haben) können Sie Metadaten und Stringvalidierungen auf die gleichen Weisen deklarieren wie in Query-Parameter und Stringvalidierungen{.internal-link target=_blank} beschrieben.
Und Sie können auch Zahlenvalidierungen deklarieren:
gt:greaterthan (größer als)ge:greater than orequal (größer oder gleich)lt:lessthan (kleiner als)le:less than orequal (kleiner oder gleich)
/// info | Info
Query, Path, und andere Klassen, die Sie später sehen werden, sind Unterklassen einer gemeinsamen Param-Klasse.
Alle von ihnen teilen die gleichen Parameter für zusätzliche Validierung und Metadaten, die Sie gesehen haben.
///
/// note | Technische Details
Wenn Sie Query, Path und andere von fastapi importieren, sind sie tatsächlich Funktionen.
Die, wenn sie aufgerufen werden, Instanzen von Klassen mit demselben Namen zurückgeben.
Sie importieren also Query, was eine Funktion ist. Und wenn Sie sie aufrufen, gibt sie eine Instanz einer Klasse zurück, die auch Query genannt wird.
Diese Funktionen existieren (statt die Klassen direkt zu verwenden), damit Ihr Editor keine Fehlermeldungen über ihre Typen ausgibt.
Auf diese Weise können Sie Ihren normalen Editor und Ihre Programmier-Tools verwenden, ohne besondere Einstellungen vornehmen zu müssen, um diese Fehlermeldungen stummzuschalten.
///