codecamp

Django4.0 缓存框架-使用Vary标头

Vary 标头定义了缓存机制在构建其缓存键时应考虑哪些请求标头。 例如,如果网页的内容取决于用户的语言偏好,则称该页面因语言而异。

默认情况下,Django 的缓存系统使用请求的完全合格的URL创建它的缓存密钥——例如,"https://www.example.com/stories/2005/?order_by=author"。这意味着对该 URL 的每个请求都将使用相同的缓存版本,而不管用户代理差异(如 cookies 或语言首选项)。但是,如果这个页面基于请求头(如 cookie、语言或用户代理)中的某些差异而产生不同的内容,则需要使用Vary标头来告诉缓存机制,页面输出取决于这些东西。
要在 Django 中执行此操作,请使用方便的​ django.views.decorators.vary.vary_on_headers() ​视图装饰器,像这样:

from django.views.decorators.vary import vary_on_headers

@vary_on_headers('User-Agent')
def my_view(request):
    ...

在这里,一个缓存机制(比如 Django 自带的缓存中间件)将为每一个唯一的用户代理缓存一个独立的页面版本。
使用 ​vary_on_headers ​装饰器而不是手动设置 Vary 头(使用 ​response.headers['Vary'] = 'user-agent'​)的好处是,装饰器 添加 到 Vary头(可能已经存在),而不是从头开始设置,可能会覆盖已经存在的东西。
你可以传递多个headers参数给 ​vary_on_headers()​:

@vary_on_headers('User-Agent', 'Cookie')
def my_view(request):
    ...

这告诉下游缓存两者有所不同,意味着每个用户代理和 cookie 的组合将获取它自己的缓存值。比如,一个请求带有用户代理 Mozilla 和 cookie 值 ​foo=bar​ 被认为和用户代理 Mozilla 和 cookie 值 ​foo=ham​ 是不同的。
因为 cookie 的变化如此普遍,所以这里有个 ​django.views.decorators.vary.vary_on_cookie()​ 装饰器。这两个视图是等价的:

@vary_on_cookie
def my_view(request):
    ...

@vary_on_headers('Cookie')
def my_view(request):
    ...

传递给 ​vary_on_headers ​的headers是不区分大小写的;​User-Agent​ 和 ​user-agent​是一样的。
你也可以直接使用帮助函数 ​django.utils.cache.patch_vary_headers()​ 。这个函数可以设置或添加 ​Vary header​ 。比如:

from django.shortcuts import render
from django.utils.cache import patch_vary_headers

def my_view(request):
    ...
    response = render(request, 'template_name', context)
    patch_vary_headers(response, ['Cookie'])
    return response

patch_vary_headers ​带有一个 ​HttpResponse ​作为它的第一个参数,一个不区分大小写的头名的列表/元组作为它的第二个参数。


Django4.0 缓存框架-下游缓存
Django4.0 缓存框架-使用其他标头控制高速缓存
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

Django4.0 模型和数据库

Django4.0 处理HTTP请求

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }