Django Academy · Lezione

Filtri, ricerca e paginazione

Rendere utilizzabili le risposte API di grandi dimensioni

Lezione 4 di 413 passaggi

Filtri, ricerca e paginazione è una lezione Django Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Django Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Django Academy include 4 lezioni in totale.

Le risposte troppo grandi sono un problema

Restituire migliaia di righe in un'unica risposta è lento e poco gestibile. DRF offre filtri, ricerca e paginazione per mantenere i payload utilizzabili.

Perché iniziare dalla paginazione

La paginazione divide un elenco grande in pagine, così i client recuperano una porzione alla volta invece dell'intero elenco.

Attivare la paginazione

Imposti una classe di paginazione predefinita e la dimensione della pagina nelle impostazioni: ogni vista di elenco inizierà automaticamente a impaginare i risultati.

REST_FRAMEWORK = {
    'DEFAULT_PAGINATION_CLASS':
        'rest_framework.pagination.PageNumberPagination',
    'PAGE_SIZE': 10,
}

La struttura paginata

PageNumberPagination racchiude i risultati con count e i link next e previous, così i client possono scorrere facilmente le pagine. 📄

Stili di paginazione

Scelga uno stile: PageNumberPagination usa i numeri di pagina, mentre LimitOffsetPagination permette ai client di richiedere direttamente un limite e un offset.

Ora i filtri

Il filtraggio restringe i risultati in base ai valori esatti dei campi, ad esempio chiedendo solo i libri il cui id dell'autore è 5.

Aggiungere DjangoFilterBackend

Installi django-filter, abiliti DjangoFilterBackend ed elenchi i campi sui quali i client possono filtrare con filterset_fields.

class BookViewSet(viewsets.ModelViewSet):
    queryset = Book.objects.all()
    filterset_fields = ['author', 'published_year']

I filtri come parametri di query

I client filtrano tramite la query string dell'URL, quindi una richiesta come /books/?author=5 restituisce solo i libri di quell'autore. 🔍

Ricerca e filtro a confronto

SearchFilter esegue una corrispondenza approssimativa del testo tra più campi, mentre il filtraggio cerca valori esatti. La ricerca è pensata per le query in testo libero.

Abilitare i campi di ricerca

Aggiunga SearchFilter ed elenchi le colonne da analizzare in search_fields. I client passeranno quindi un termine di ricerca tramite il parametro di query search.

from rest_framework.filters import SearchFilter

class BookViewSet(viewsets.ModelViewSet):
    filter_backends = [SearchFilter]
    search_fields = ['title', 'author__name']

Ordinare i risultati

Aggiunga OrderingFilter per permettere ai client di ordinare con ordering=title o ordering=-price in ordine decrescente, direttamente dall'URL.

Verifica rapida

Si assicuri di saper distinguere questi strumenti.

Riepilogo: risposte API utilizzabili

Ora può suddividere gli elenchi con la paginazione, restringerli con i filtri, cercare testo e ordinarli. La Sua API rimane veloce e intuitiva. 🎉

Gratis per iniziare

Impara Python con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi
30
Lezioni
120

Domande Frequenti

La lezione «Filtri, ricerca e paginazione» è gratuita?

Sì — il testo completo di «Filtri, ricerca e paginazione» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Django Academy, passa a CoddyKit PRO. Il corso Django Academy include 4 lezioni in totale.

Cosa imparerò in «Filtri, ricerca e paginazione»?

Rendere utilizzabili le risposte API di grandi dimensioni Eserciti Django Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Django Academy?

Non è richiesta alcuna esperienza precedente. Django Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «Filtri, ricerca e paginazione»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Django Academy?

Sì. Ogni lezione Django Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. ModelViewSet e router
  2. Permessi e limitazione delle richieste
  3. Autenticazione con token e JWT
  4. Filtri, ricerca e paginazione
← Torna a Django Academy