实际建站的时候,缓存整个网址或页面往往是不现实而且会带来诸多问题的。
例如,我们缓存了某个查询,但数据库更新后,该查询的结果会发生变化,但缓存并没有被更新,这样页面就好出现问题。
对于这个情况 Django 提供了一个底层的 cache API。你可以用这个 API 来储存在缓存中的对象,并且控制粒度随你喜欢。
1. 访问缓存
缓存可以通过 key 来访问:
>>> from django.core.cache import caches
>>> cache1 = caches['myalias']
>>> cache2 = caches['myalias']
>>> cache1 is cache2
True
如果key不存在,就会引发一个 InvalidCacheBackendError
。
有一个快捷方式,默认缓存可用为 django.core.cache.cache
:
>>> from django.core.cache import cache
此对象等效于: caches['default']
2. 基本用法
最基本的接口是: set(key, value, timeout)
和 get(key)
:
>>> cache.set('my_key', 'hello, world!', 30)
>>> cache.get('my_key')
'hello, world!'
timeout 参数是可选的,默认为 CACHES 设置的 timeout 参数。
如果对象不存在于缓存中,则 cache.get()
返回 None
:
# Wait 30 seconds for 'my_key' to expire...
>>> cache.get('my_key')
None
所以建议不要在缓存中存储文本值 None
,因为您将无法区分返回的是你缓存的 None
值还是对象不存在产生的None
值。
cache.get()
可以采用 default 参数。如果对象不存在于缓存中,则返回一个指定的值:
>>> cache.get('my_key', 'has expired')
'has expired'
要添加键(如果它尚不存在),请使用 add()
方法。它使用与 set()
相同的参数,但如果指定的键已经存在,它不会更新缓存:
>>> cache.set('add_key', 'Initial value')
>>> cache.add('add_key', 'New value')
>>> cache.get('add_key')
'Initial value'
get_many()
方法返回一个字典,其中包含您请求的所有存在于缓存中的键值对(也就是并且未过期):
>>> cache.set('a', 1)
>>> cache.set('b', 2)
>>> cache.set('c', 3)
>>> cache.get_many(['a', 'b', 'c'])
{'a': 1, 'b': 2, 'c': 3}
要更有效地设置多个值,请使用 set_many()
传递键值对的字典:
>>> cache.set_many({'a': 1, 'b': 2, 'c': 3})
>>> cache.get_many(['a', 'b', 'c'])
{'a': 1, 'b': 2, 'c': 3}
像 cache.set()
,set_many()
采用可选的 timeout 参数。
delete()
方法可以删除键。这是清除特定对象的缓存的简单方法:
>>> cache.delete('a')
如果您想一次清除多个键,delete_many()
可以取得要清除的键列表:
>>> cache.delete_many(['a', 'b', 'c'])
最后,如果要删除缓存中的所有键,请使用 cache.clear()
。注意,clear()
将从缓存中删除所有,而不仅仅是应用程序设置的键。
>>> cache.clear()
3. 简单例子
views.py:
from django.core.cache import cache
def index(requests):
context = {}
# 读取key为index的缓存
books = cache.get('index')
# 如果缓存存在,返回缓存的内容
if books is not None:
context['books'] = books
# 如果缓存不存在
else:
# 通过数据库进行一次查询
books = Book.objects.all()
# 再把查询的结果存到缓存中,key同样是设为index
cache.set('index', books)
context['books'] = books
return render(requests, 'index.html', context)
def add_book(requests):
book_obj = Book.objects.create(
title = '测试书',
author = '测试作者',
pub_data = datetime.now(),
)
# 因为更新了数据库,所有要把之前的缓存删除
cache.delete('index')
return redirect(to='index')
urls.py:
urlpatterns = [
…………
url(r'index/', index, name='index'),
url(r'add_book/', add_book, name='add_book'),
]