Implementare l’API GraphQL in un’applicazione Django può essere un compito relativamente semplice grazie a pacchetti open source come Graphene-Django. Graphene è un framework per Python che consente di creare schemi GraphQL e definire come devono essere risolte le query. La versione Django di Graphene offre funzionalità aggiuntive specifiche per Django.
Per implementare la GraphQL API con Django, hai bisogno di seguire questi passaggi:
1. Installare Graphene-Django: Prima di tutto, devi installare il pacchetto Graphene-Django. Puoi installarlo tramite pip eseguendo il comando `pip install “graphene-django”` nel terminale.
1. Aggiungere Graphene-Django alla configurazione dell’applicazione: devi aggiungere Graphene-Django alla configurazione dell’app Django. Puoi farlo aggiungendo `graphene_django` all’elenco delle applicazioni installate in `settings.py`.
1. Creare lo schema GraphQL: Il prossimo passo è creare lo schema GraphQL che definisce la forma delle tue API. Questo si fa creando una nuova classe `Schema` che estende `graphene.Schema` e definendo il tipo di query e mutazione.
1. Creare i tipi di dati GraphQL: Puoi definire i tuoi tipi di dati GraphQL creando nuove classi che estendono `graphene.ObjectType`. Ogni campo di questi tipi di dati può essere un campo scalare di GraphQL (come `graphene.String`, `graphene.Int`, ecc.) o può essere un altro tipo di dato che hai definito.
1. Definire le funzioni di risoluzione: Ogni campo nei tuoi tipi di dati ha bisogno di una funzione di risoluzione che definisce come ottenere i dati per quel campo. Queste funzioni di risoluzione possono essere metodi sulla classe del tipo di dati o possono essere funzioni separate.
1. Creare l’endpoint GraphQL: Infine, devi creare l’endpoint GraphQL che sarà il punto di ingresso per tutte le tue richieste GraphQL. Questo si fa aggiungendo un URL al tuo `urls.py` che punta a `GraphQLView`.
Ecco un esempio di come può sembrare il codice per implementare una semplice API GraphQL con Django e Graphene:
In `schema.py`:
```
import graphene
from graphene_django import DjangoObjectType
from .models import YourModel
class YourModelType(DjangoObjectType): class Meta: model = YourModel
class Query(graphene.ObjectType): your_models = graphene.List(YourModelType)
def resolve_your_models(self, info): return YourModel.objects.all()schema = graphene.Schema(query=Query)
```
In `urls.py`:
```
from django.urls import path
from graphene_django.views import GraphQLView
from .schema import schema
urlpatterns = [
path(‘graphql/’, GraphQLView.as_view(graphiql=True, schema=schema)),
]
```
Questa guida è basata su informazioni provenienti dalle documentazioni ufficiali di Graphene e Django.
Fonti:
- Documentazione di Graphene-Django: https://docs.graphene-python.org/projects/django/en/latest/
- Documentazione di Django: https://docs.djangoproject.com/en/stable/
