Paginazione divide un grande set di risultati in pagine discrete, così non carichi migliaia di record contemporaneamente. È essenziale per le prestazioni e l'usabilità. Django fornisce una classe Paginator per template/view, e DRF offre paginazione integrata per le API.
# ❌ loading everything — slow, memory-heavy, bad UX with thousands of rows
articles = Article.objects.()
from django.core.paginator import Paginator
def article_list(request):
articles = Article.objects.all().order_by("-created_at") # ORDER matters for consistent pages
paginator = Paginator(articles, 20) # 20 items per page
page_number = request.GET.get("page") # ?page=2
page_obj = paginator.get_page(page_number) # the requested page
return render(request, "list.html", {"page_obj": page_obj})
<!-- in the template -->
{% for article in page_obj %}
<h2>{{ article.title }}</h2>
{% endfor %}
{% if page_obj.has_previous %}<a href="?page={{ page_obj.previous_page_number }}">Prev</a>{% endif %}
Page {{ page_obj.number }} of {{ page_obj.paginator.num_pages }}
{% if page_obj.has_next %}<a href="?page={{ page_obj.next_page_number }}">Next</a>{% endif %}
Paginator divide un queryset in pagine e get_page() restituisce un oggetto pagina con helper di navigazione (has_next, next_page_number, ecc.) — nota che aggiunge LIMIT/OFFSET alla query, così viene scaricata dal database solo una pagina.
# global default in settings.py
REST_FRAMEWORK = {
"DEFAULT_PAGINATION_CLASS": "rest_framework.pagination.PageNumberPagination",
"PAGE_SIZE": 20,
}
# now list endpoints are automatically paginated, returning:
# { "count": 1000, "next": "...?page=3", "previous": "...?page=1", "results": [...] }
DRF impagina automaticamente gli endpoint di lista una volta configurato, restituendo i metadati della pagina (count, link next/previous) insieme ai risultati — i client navigano tramite gli URL forniti.
PageNumberPagination → ?page=2 (simple page numbers)
LimitOffsetPagination → ?limit=20&offset=40 (flexible offsets)
CursorPagination → opaque cursor; consistent & performant for large/changing data
(avoids OFFSET performance issues on huge datasets)
⚠️ OFFSET-based pagination (page/offset) gets SLOWER on deep pages of huge tables
(the DB must skip OFFSET rows). For very large datasets, CURSOR pagination
(keyset, using a WHERE on an indexed column) is far more efficient.
⚠️ Always ORDER BY a stable field, or pages can be inconsistent/repeat items.
La paginazione è essenziale per costruire applicazioni performanti e usabili che gestiscono volumi di dati reali — senza di essa, gli endpoint di listing e le pagine che caricano intere tabelle (potenzialmente migliaia o milioni di righe) diventano lenti, intensive in memoria e inutilizzabili, sia per il carico del database che per utenti e client. Comprendere la paginazione è una conoscenza pratica quotidiana: il Paginator di Django gestisce view/template tradizionali (divide i queryset in pagine con helper di navigazione, scaricando efficientemente solo una pagina via LIMIT/OFFSET), e la paginazione integrata di DRF gestisce le API (impagina automaticamente gli endpoint di lista con metadati e link di navigazione una volta configurati) — entrambi sono necessari a seconda che tu stia costruendo pagine server-rendered o API.
Sapere come implementare la paginazione in entrambi i contesti è necessario per quasi qualsiasi feature di listing di dati.
La sfumatura di prestazioni è particolarmente una conoscenza di livello senior preziosa: la paginazione standard basata su OFFSET si degrada su pagine profonde di tabelle molto grandi (il database deve saltare tutte le righe precedenti), quindi la paginazione cursor (keyset) è la scelta efficiente per dataset enormi o che cambiano rapidamente, e ordinare sempre per un campo stabile è necessario per evitare risultati incoerenti o duplicati tra le pagine.
Comprendere sia la meccanica di base (Paginator, classi di paginazione DRF) che queste considerazioni di prestazioni (OFFSET vs paginazione cursor, ordinamento coerente) è importante per costruire applicazioni che rimangono veloci e corrette al crescere dei dati — la paginazione è un requisito ubiquitario, e farla bene, specialmente in scala, è una skill pratica che influisce direttamente sulle prestazioni dell'applicazione e sull'esperienza dell'utente.