ó Ñ7ec@s­dZddlmZddlmZmZddlmZmZm Z m Z m Z ddl m Z de fd„ƒYZde fd „ƒYZd eefd „ƒYZd S( sÙ Cache middleware. If enabled, each Django-powered page will be cached based on URL. The canonical way to enable cache middleware is to set ``UpdateCacheMiddleware`` as your first piece of middleware, and ``FetchFromCacheMiddleware`` as the last:: MIDDLEWARE = [ 'django.middleware.cache.UpdateCacheMiddleware', ... 'django.middleware.cache.FetchFromCacheMiddleware' ] This is counter-intuitive, but correct: ``UpdateCacheMiddleware`` needs to run last during the response phase, which processes middleware bottom-up; ``FetchFromCacheMiddleware`` needs to run last during the request phase, which processes middleware top-down. The single-class ``CacheMiddleware`` can be used for some simple sites. However, if any other piece of middleware needs to affect the cache key, you'll need to use the two-part ``UpdateCacheMiddleware`` and ``FetchFromCacheMiddleware``. This'll most often happen when you're using Django's ``LocaleMiddleware``. More details about how the caching works: * Only GET or HEAD-requests with status code 200 are cached. * The number of seconds each page is stored for is set by the "max-age" section of the response's "Cache-Control" header, falling back to the CACHE_MIDDLEWARE_SECONDS setting if the section was not found. * This middleware expects that a HEAD request is answered with the same response headers exactly like the corresponding GET request. * When a hit occurs, a shallow copy of the original response object is returned from process_request. * Pages will be cached based on the contents of the request headers listed in the response's "Vary" header. * This middleware also sets ETag, Last-Modified, Expires and Cache-Control headers on the response object. iÿÿÿÿ(tsettings(tDEFAULT_CACHE_ALIAStcaches(t get_cache_keyt get_max_agethas_vary_headertlearn_cache_keytpatch_response_headers(tMiddlewareMixintUpdateCacheMiddlewarecBs,eZdZdd„Zd„Zd„ZRS(s6 Response-phase cache middleware that updates the cache if the response is cacheable. Must be used as part of the two-part update/fetch cache middleware. UpdateCacheMiddleware must be the first piece of middleware in MIDDLEWARE so that it'll get called last during the response phase. cCsAtj|_tj|_tj|_t|j|_||_ dS(N( RtCACHE_MIDDLEWARE_SECONDSt cache_timeouttCACHE_MIDDLEWARE_KEY_PREFIXt key_prefixtCACHE_MIDDLEWARE_ALIASt cache_aliasRtcachet get_response(tselfR((sA/usr/local/lib/python2.7/dist-packages/django/middleware/cache.pyt__init__@s    cCst|dƒo|jS(Nt_cache_update_cache(thasattrR(Rtrequesttresponse((sA/usr/local/lib/python2.7/dist-packages/django/middleware/cache.pyt_should_update_cacheGscs)ˆj||ƒs|S|js.|jdkr2|S|j rX|jrXt|dƒrX|St|ƒ‰ˆd kr|ˆj‰nˆdkrŒ|St |ˆƒˆr%|jdkr%t ||ˆˆj dˆj ƒ‰t |dƒr t|jƒr |j‡‡‡fd†ƒq%ˆj jˆ|ˆƒn|S( sSets the cache, if needed.iÈi0tCookieiRtrendercsˆjjˆ|ˆƒS(N(Rtset(tr(t cache_keyRttimeout(sA/usr/local/lib/python2.7/dist-packages/django/middleware/cache.pytft(iÈi0N(Rt streamingt status_codetCOOKIEStcookiesRRtNoneR RRR RRtcallableRtadd_post_render_callbackR(RRR((RRRsA/usr/local/lib/python2.7/dist-packages/django/middleware/cache.pytprocess_responseJs&"     !N(t__name__t __module__t__doc__R%RRR((((sA/usr/local/lib/python2.7/dist-packages/django/middleware/cache.pyR 7s  tFetchFromCacheMiddlewarecBs#eZdZdd„Zd„ZRS(s! Request-phase cache middleware that fetches a page from the cache. Must be used as part of the two-part update/fetch cache middleware. FetchFromCacheMiddleware must be the last piece of middleware in MIDDLEWARE so that it'll get called last during the request phase. cCs5tj|_tj|_t|j|_||_dS(N(RR R RRRRR(RR((sA/usr/local/lib/python2.7/dist-packages/django/middleware/cache.pyRus  cCsÙ|jdkrt|_dSt||jdd|jƒ}|dkrSt|_dS|jj|ƒ}|dkr³|jdkr³t||jdd|jƒ}|jj|ƒ}n|dkrÌt|_dSt|_|S(sp Checks whether the page is already cached and returns the cached version if available. tGETtHEADR(R-R.N( tmethodtFalseRR%RR RtTruetget(RRRR((sA/usr/local/lib/python2.7/dist-packages/django/middleware/cache.pytprocess_request{s       N(R)R*R+R%RR3(((sA/usr/local/lib/python2.7/dist-packages/django/middleware/cache.pyR,ms tCacheMiddlewarecBseZdZddd„ZRS(sÌ Cache middleware that provides basic behavior for many simple sites. Also used as the hook point for the cache decorator, which is generated using the decorator-from-middleware utility. cKsÐ||_y#|d}|dkr+d}nWntk rHtj}nX||_y#|d}|dkrtt}nWntk r‘tj}nX||_|dkr³tj }n||_ t |j|_ dS(NR R R( RR%tKeyErrorRR R RRRR R RR(RRR tkwargsR R((sA/usr/local/lib/python2.7/dist-packages/django/middleware/cache.pyRŸs&                N(R)R*R+R%R(((sA/usr/local/lib/python2.7/dist-packages/django/middleware/cache.pyR4˜sN(R+t django.confRtdjango.core.cacheRRtdjango.utils.cacheRRRRRtdjango.utils.deprecationRR R,R4(((sA/usr/local/lib/python2.7/dist-packages/django/middleware/cache.pyt,s(6+