Исключение InvalidPage

Исключение InvalidPage является базовым классом исключений в Django, который используется для обработки ошибок, связанных с пагинацией. Это исключение возникает, когда запрашивается страница, которая не существует или когда номер страницы не является целым числом. Оно наследуется от Exception и служит родительским классом для более конкретных исключений: PageNotAnInteger, EmptyPage и InvalidPage. Это исключение обычно не вызывается напрямую, а используется как базовый класс для обработки всех ошибок пагинации.

Синтаксис

from django.core.paginator import InvalidPage

Исключение можно использовать в блоке try/except для перехвата любых ошибок, связанных с пагинацией.

Пример

Рассмотрим пример перехвата ошибок пагинации с использованием базового исключения InvalidPage:

from django.core.paginator import Paginator, InvalidPage
from myapp.models import Article

# Создаем список объектов
articles = Article.objects.all()
paginator = Paginator(articles, 10)  # 10 объектов на страницу

try:
	# Попытка получить несуществующую страницу
	page = paginator.page(999)
except InvalidPage as e:
	print("InvalidPage error:", str(e))

Результат выполнения кода:

"InvalidPage error: Page has no page 999"

В данном примере исключение InvalidPage перехватывает ошибку, которая возникает при попытке доступа к странице с номером 999, которой не существует в пагинаторе.

Пример

Исключение InvalidPage также перехватывает ошибки, когда номер страницы не является целым числом:

from django.core.paginator import Paginator, InvalidPage
from myapp.models import Article

articles = Article.objects.all()
paginator = Paginator(articles, 10)

try:
	# Попытка получить страницу с некорректным номером
	page = paginator.page("abc")
except InvalidPage as e:
	print("Caught InvalidPage:", str(e))

Результат выполнения кода:

"Caught InvalidPage: That page number is not an integer"

В этом примере исключение InvalidPage перехватывает ошибку, которая возникает при попытке передать строковое значение вместо целого числа в метод page.

Пример

Исключение InvalidPage используется как базовое для создания обобщенных обработчиков ошибок пагинации во вьюхах:

from django.core.paginator import Paginator, InvalidPage
from django.shortcuts import render
from myapp.models import Article

def article_list(request):
	articles = Article.objects.all().order_by('-created_at')
	paginator = Paginator(articles, 5)
	
	try:
		page_number = request.GET.get('page', 1)
		page = paginator.page(page_number)
	except InvalidPage:
		# Перенаправление на первую страницу при любой ошибке пагинации
		page = paginator.page(1)
	
	return render(request, 'articles/list.html', {'page': page})

В данной вьюхе исключение InvalidPage используется для обработки любых ошибок пагинации: как несуществующих страниц, так и неверных форматов номера страницы. При возникновении любой ошибки пользователь будет перенаправлен на первую страницу.

Смотрите также

исключение PageNotAnInteger,
которое возникает при неверном формате номера страницы
исключение EmptyPage,
которое возникает при запросе страницы вне допустимого диапазона
исключение Http404,
которое используется для возврата ошибки 404 Not Found
исключение ObjectDoesNotExist,
которое возникает при попытке доступа к несуществующему объекту