mirror of https://github.com/tiangolo/fastapi.git
63 lines
3.6 KiB
Markdown
63 lines
3.6 KiB
Markdown
# GraphQL
|
|
|
|
Da **FastAPI** auf dem **ASGI**-Standard basiert, ist es sehr einfach, jede **GraphQL**-Bibliothek zu integrieren, die auch mit ASGI kompatibel ist.
|
|
|
|
Sie können normale FastAPI-*Pfadoperationen* mit GraphQL in derselben Anwendung kombinieren.
|
|
|
|
/// tip | Tipp
|
|
|
|
**GraphQL** löst einige sehr spezifische Anwendungsfälle.
|
|
|
|
Es hat **Vorteile** und **Nachteile** im Vergleich zu gängigen **Web-APIs**.
|
|
|
|
Wiegen Sie ab, ob die **Vorteile** für Ihren Anwendungsfall die **Nachteile** ausgleichen. 🤓
|
|
|
|
///
|
|
|
|
## GraphQL-Bibliotheken
|
|
|
|
Hier sind einige der **GraphQL**-Bibliotheken, welche **ASGI** unterstützen. Diese könnten Sie mit **FastAPI** verwenden:
|
|
|
|
* <a href="https://strawberry.rocks/" class="external-link" target="_blank">Strawberry</a> 🍓
|
|
* Mit <a href="https://strawberry.rocks/docs/integrations/fastapi" class="external-link" target="_blank">Dokumentation für FastAPI</a>
|
|
* <a href="https://ariadnegraphql.org/" class="external-link" target="_blank">Ariadne</a>
|
|
* Mit <a href="https://ariadnegraphql.org/docs/fastapi-integration" class="external-link" target="_blank">Dokumentation für FastAPI</a>
|
|
* <a href="https://tartiflette.io/" class="external-link" target="_blank">Tartiflette</a>
|
|
* Mit <a href="https://tartiflette.github.io/tartiflette-asgi/" class="external-link" target="_blank">Tartiflette ASGI</a>, für ASGI-Integration
|
|
* <a href="https://graphene-python.org/" class="external-link" target="_blank">Graphene</a>
|
|
* Mit <a href="https://github.com/ciscorn/starlette-graphene3" class="external-link" target="_blank">starlette-graphene3</a>
|
|
|
|
## GraphQL mit Strawberry
|
|
|
|
Wenn Sie mit **GraphQL** arbeiten möchten oder müssen, ist <a href="https://strawberry.rocks/" class="external-link" target="_blank">**Strawberry**</a> die **empfohlene** Bibliothek, da deren Design dem Design von **FastAPI** am nächsten kommt und alles auf **Typannotationen** basiert.
|
|
|
|
Abhängig von Ihrem Anwendungsfall bevorzugen Sie vielleicht eine andere Bibliothek, aber wenn Sie mich fragen würden, würde ich Ihnen wahrscheinlich empfehlen, **Strawberry** auszuprobieren.
|
|
|
|
Hier ist eine kleine Vorschau, wie Sie Strawberry mit FastAPI integrieren können:
|
|
|
|
```Python hl_lines="3 22 25-26"
|
|
{!../../docs_src/graphql/tutorial001.py!}
|
|
```
|
|
|
|
Weitere Informationen zu Strawberry finden Sie in der <a href="https://strawberry.rocks/" class="external-link" target="_blank">Strawberry-Dokumentation</a>.
|
|
|
|
Und auch die Dokumentation zu <a href="https://strawberry.rocks/docs/integrations/fastapi" class="external-link" target="_blank">Strawberry mit FastAPI</a>.
|
|
|
|
## Ältere `GraphQLApp` von Starlette
|
|
|
|
Frühere Versionen von Starlette enthielten eine `GraphQLApp`-Klasse zur Integration mit <a href="https://graphene-python.org/" class="external-link" target="_blank">Graphene</a>.
|
|
|
|
Das wurde von Starlette deprecated, aber wenn Sie Code haben, der das verwendet, können Sie einfach zu <a href="https://github.com/ciscorn/starlette-graphene3" class="external-link" target="_blank">starlette-graphene3</a> **migrieren**, welches denselben Anwendungsfall abdeckt und über eine **fast identische Schnittstelle** verfügt.
|
|
|
|
/// tip | Tipp
|
|
|
|
Wenn Sie GraphQL benötigen, würde ich Ihnen trotzdem empfehlen, sich <a href="https://strawberry.rocks/" class="external-link" target="_blank">Strawberry</a> anzuschauen, da es auf Typannotationen basiert, statt auf benutzerdefinierten Klassen und Typen.
|
|
|
|
///
|
|
|
|
## Mehr darüber lernen
|
|
|
|
Weitere Informationen zu **GraphQL** finden Sie in der <a href="https://graphql.org/" class="external-link" target="_blank">offiziellen GraphQL-Dokumentation</a>.
|
|
|
|
Sie können auch mehr über jede der oben beschriebenen Bibliotheken in den jeweiligen Links lesen.
|