Per-View Caching

The cache_page Decorator

cache_page wraps a view so that Django automatically stores its rendered response and serves that same response to future requests until the timeout expires, skipping the view logic entirely.

Note: Timeouts are given in seconds, so 60 * 15 means 15 minutes.

Example: The cache_page Decorator

cache_page wraps a view so that Django automatically stores its rendered response and serves that same response to future requests until the timeout expires, skipping the view logic entirely.

from django.views.decorators.cache import cache_page

@cache_page(60 * 15)
def article_list(request):
    articles = Article.objects.all()
    return render(request, 'articles/list.html', {'articles': articles})

Caching Class-Based Views

For class-based views, cache_page can't be applied directly above the class. Instead, wrap the as_view() call in urls.py, or apply method_decorator to the view's dispatch method.

Example: Caching Class-Based Views

For class-based views, cache_page can't be applied directly above the class. Instead, wrap the as_view() call in urls.py, or apply method_decorator to the view's dispatch method.

from django.utils.decorators import method_decorator
from django.views.decorators.cache import cache_page
from django.views.generic import ListView

@method_decorator(cache_page(60 * 15), name='dispatch')
class ArticleListView(ListView):
    model = Article
    template_name = 'articles/list.html'

Per-View Caching in urls.py

Instead of decorating the view itself, you can wrap it where it's registered in urls.py. This keeps the view function clean and makes the caching behavior visible right next to the URL it applies to.

Example: Per-View Caching in urls.py

Instead of decorating the view itself, you can wrap it where it's registered in urls.py. This keeps the view function clean and makes the caching behavior visible right next to the URL it applies to.

from django.urls import path
from django.views.decorators.cache import cache_page
from . import views

urlpatterns = [
    path('articles/', cache_page(60 * 15)(views.article_list), name='article-list'),
]