Документация/Режимы страниц файла

ISR (устаревший при повторной проверке)

Определение

ISR кэширует HTML-код одной страницы для каждого URL-адреса и обслуживает его до истечения срока действия окна. Копия с истекшим сроком действия по-прежнему обслуживается, пока в фоновом режиме отображается новая: то есть устаревшая при повторной проверке.

Как это работает

revalidate = N в заголовке страницы .nexy включает его. N - количество секунд; отсутствие, нулевое или отрицательное значение означает отсутствие кэша вообще.

Ключом кэша является только путь запроса - request.scope["path"]. Строка запроса не является его частью.

Жизненный цикл рендеринга

1. Поступает запрос на страницу, которая объявляет revalidate.
2. Записей пока нет: страница отображается, сохраняется и возвращается.
3. Запись моложе N секунд: возвращается как есть, страница не отображается.
4. Запись старше N секунд: запись stale возвращается немедленно, а фоновая задача отображает новую.
5. Если этот фоновый рендеринг активируется, устаревшая запись остается, и следующий устаревший запрос пытается повториться.

Когда использовать

• Один и тот же HTML-код для каждого посетителя: сообщение в блоге, страница продукта, страница документации.
• Страница читается часто и меняется редко.
• Данные могут быть датированы несколькими секундами, и никто этого не заметит.

Конфигурация

---revalidate = 60---<h1>Rendered at most once per minute</h1>

N - простое целое число. В другом месте нет переопределения для каждого маршрута, а обработчики .py не являются страницами: они никогда не попадают в этот кеш.

Пример

Сообщение в блоге, которое читает базу данных:

---revalidate = 300slug: prop[str] = "untitled"posts = {"hello": {"title": "Hello"}, "other": {"title": "Other"}}post = posts.get(slug, {"title": "Untitled"})---<h1>{{ post.title }}</h1>

Первый запрос к /blog/hello обрабатывается и сохраняется. Следующие 300 секунд обслуживаются по памяти. /blog/other - это отдельная запись, отображаемая и сохраняемая отдельно. В реальном проекте posts поступает из базы данных или службы, вызываемой один раз при регенерации.

Ограничения

Nexy гарантирует, что ключ кэша является путем, устаревшая копия обслуживается во время регенерации, а хранилище ограничено и потокобезопасно.

По соглашению страница, на которой объявлено revalidate, является общедоступным контентом. Напишите это так, как будто каждый посетитель видит один и тот же HTML-код.

Ваше приложение отвечает за всё остальное:

Следующие шаги

• SSR: как страница отображается перед кэшированием
• Действия: заголовок revalidate и что он не делает
• Производительность
• Страницы: макеты и динамические сегменты

Скопировать страницу как Markdown Изменить на GitHub