Paginimi ndan një grup të madh rezultatesh në faqe diskrete, në mënyrë që të mos ngarkohen mijëra regjistrime nëse në një herë. Është thelbësor për performancën dhe përdorshmërinë. Django ofron një klasë Paginator për templatee/views, dhe DRF ofron paginim të integruar për APIs.
# ❌ 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-i ndan një queryset në faqe dhe get_page() kthen një objekt faqeje me ndihmuesit e navigimit (has_next, next_page_number, etj.) — vëre se shton LIMIT/OFFSET në pyetjen, pra vetëm një faqe merret nga baza e të dhënave.
# 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 paginon automatikisht pikëpamjet e listës sapo të konfigurohet, duke kthyer metapërmbledhje të faqes (count, next/previous links) krah me rezultatet — klientët lundrojnë përmes URL-ave të ofruara.
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.
Paginimi është thelbësor për ndërtimin e aplikacioneve performante dhe të përdorshmërisë që përballojnë vëllime reale të të dhënave — pa të, pikëpamjet e listës dhe faqet që ngarkohen tabelat e plota (potencialisht mijëra ose miliona rreshtave) bëhen të ngadalta, intensive në memorie dhe të pazbatueshmëria, si sforcojnë bazën e të dhënave dhe i mbingarkohen përdoruesit dhe klientët.
Kuptimi i paginimit është njohuri praktike e përditshme: Paginator-i i Django-s trajtë views/templateet tradicionalë (ndan querysets në faqe me ndihmuesit e navigimit, merr efikasitshëm vetëm një faqe përmes LIMIT/OFFSET), dhe paginimi i integruar i DRF-it trajtë APIs (paginon automatikisht pikëpamjet e listës me metapërmbledhje dhe lidhjet e navigimit sapo të konfigurohet) — të dyja nevojiten në varësi të faktit nëse ndërton faqe të rjezuara në server ose APIs.
Dija se si të zbatohet paginimi në të dy kontekstet është e nevojshme për pothuajse çdo veçori të listimit të të dhënave.
Nuanca e performancës është njohuri veçanërisht e vlefshme në nivel senior: paginimi standard i bazuar në OFFSET degradohet në faqet e thella të tabelave shumë të mëdha (baza e të dhënave duhet të kalojë të gjithë rreshtat pararendës), kështu paginimi përmes kursorit (keyset) është zgjedhja efikase për grupe të mëdha ose të dhënash që ndryshojnë shpejt, dhe renditja gjithmonë sipas një fushe të qëndrueshme është e nevojshme për të shmangur rezultatet e paqëndrueshme ose të dyfishta në të gjitha faqet.
Kuptimi i mekanikës bazë (Paginator, klasat e paginimit të DRF-it) dhe këto konsiderata performance (OFFSET kundrejt paginimi përmes kursorit, renditja konsistente) është i rëndësishëm për ndërtimin e aplikacioneve që mbeten të shpejta dhe të sakta ndërsa të dhënat rriten — paginimi është një kërkesë e përhapur, dhe ta bëni atë mirë, veçanërisht në shkallë, është një aftësi praktike që ndikon drejtpërdrejtë në performancën e aplikacionit dhe përvojën e përdoruesit.