Paginarea împarte un set mare de rezultate în pagini discrete, astfel încât să nu încarci mii de înregistrări deodată. Este esențială pentru performanță și ușurință în utilizare. Django oferă o clasă Paginator pentru template-uri/view-uri, iar DRF oferă paginare încorporată pentru API-uri.
# ❌ 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-ul împarte o queryset în pagini, iar get_page() returnează un obiect pagină cu ajutoare de navigare (has_next, next_page_number, etc.) — ține cont că adaugă LIMIT/OFFSET la interogare, deci doar o singură pagină este preluată din baza de date.
# 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 pagineaza automat endpoint-urile de tip list o dată configurate, returnând metadate despre pagină (count, link-uri next/previous) alături de rezultate — clienții navigheaza prin URL-urile furnizate.
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.
Paginarea este esențială pentru construirea unor aplicații performante și ușor de utilizat care gestionează volume reale de date — fără ea, endpoint-urile de listare și paginile care încarc tabele întregi (potențial mii sau milioane de rânduri) devin lente, consumă multă memorie și devin inutilizabile, atât stresând baza de date cât și copleșind utilizatorii și clienții.
Înțelegerea paginării este cunoaștere practică zilnică: Paginator-ul Django gestionează view-uri/template-uri tradiționale (împarte queryset-uri în pagini cu ajutoare de navigare, preluând eficient doar o singură pagină via LIMIT/OFFSET), iar paginarea încorporată a DRF gestionează API-urile (pagineaza automat endpoint-urile de tip list cu metadate și link-uri de navigare o dată configurate) — ambele sunt necesare în funcție de dacă construiești pagini render-ate pe server sau API-uri.
Știind cum să implementezi paginarea în ambele contexte este necesar pentru aproape orice funcție de listare de date.
Nuanța de performanță este cunoaștere valoroasă la nivel de senior: paginarea standard bazată pe OFFSET se degradează pe pagini adânci ale tabelelor foarte mari (baza de date trebuie să omită toate rândurile anterioare), deci paginarea pe cursor (keyset) este alegerea eficientă pentru dataset-uri uriașe sau care se schimbă rapid, și ordonarea întotdeauna după un câmp stabil este necesară pentru a evita rezultate inconsistente sau duplicate în pagini.
Înțelegerea mecanicii de bază (Paginator, clase de paginare DRF) și aceste considerații de performanță (OFFSET vs paginare pe cursor, ordonare consistentă) este importantă pentru construirea unor aplicații care rămân rapide și corecte pe măsură ce datele cresc — paginarea este o cerință omniprezentă, iar a o face bine, mai ales la scară, este o abilitate practică care afectează direct performanța și experiența utilizatorului aplicației.