U g d@s~dZddlmZddlmZmZddlmZmZm Z m Z m Z ddl m Z Gddde ZGdd d e ZGd d d eeZd S) a 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. )settings)DEFAULT_CACHE_ALIAScaches) get_cache_key get_max_agehas_vary_headerlearn_cache_keypatch_response_headers)MiddlewareMixincs<eZdZdZfddZeddZddZdd ZZ S) UpdateCacheMiddlewarea6 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. cs.t|tj|_d|_tj|_tj|_ dSN) super__init__rZCACHE_MIDDLEWARE_SECONDS cache_timeout page_timeoutCACHE_MIDDLEWARE_KEY_PREFIX key_prefixCACHE_MIDDLEWARE_ALIAS cache_aliasself get_response __class__;/tmp/pip-unpacked-wheel-_p7c4jiu/django/middleware/cache.pyrDs  zUpdateCacheMiddleware.__init__cCs t|jSr rrrrrrcacheKszUpdateCacheMiddleware.cachecCst|do|jS)N_cache_update_cache)hasattrrrrequestresponserrr_should_update_cacheOsz*UpdateCacheMiddleware._should_update_cachecs||s|S|js |jdkr$|S|js>|jr>t|dr>|Sd|ddkrR|Sjdkrt|dkrxj n dkr|St |r|jdkrt ||j j d t|d rt|jr|fd d nj ||S) zSet the cache, if needed.)i0Cookieprivatez Cache-ControlrNrr%rrendercsj|Sr )rset)r cache_keyrtimeoutrr{z8UpdateCacheMiddleware.process_response..)r$Z streaming status_codeZCOOKIEScookiesrgetrrrr rrrr callabler)Zadd_post_render_callbackr*r!rr,rprocess_responseRsF  z&UpdateCacheMiddleware.process_response) __name__ __module__ __qualname____doc__rpropertyrr$r5 __classcell__rrrrr :s   r cs4eZdZdZfddZeddZddZZS)FetchFromCacheMiddlewarea! 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. cs t|tj|_tj|_dSr )r rrrrrrrrrrrs z!FetchFromCacheMiddleware.__init__cCs t|jSr rrrrrrszFetchFromCacheMiddleware.cachecCs|jdkrd|_dSt||jd|jd}|dkr:d|_dS|j|}|dkrx|jdkrxt||jd|jd}|j|}|dkrd|_dSd|_|S)zn Check whether the page is already cached and return the cached version if available. )GETHEADFNr=r(Tr>)methodrrrrr3)rr"r-r#rrrprocess_requests*   z(FetchFromCacheMiddleware.process_request) r6r7r8r9rr:rr@r;rrrrr<s   r<cs"eZdZdZdfdd ZZS)CacheMiddlewarez 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. Nc st|z|d}|dkr"d}||_Wntk r>YnXz|d}|dkrVt}||_Wntk rrYnX|dk r||_||_dS)Nrr)r rrKeyErrorrrrr)rrrrkwargsrrrrrrs$   zCacheMiddleware.__init__)NN)r6r7r8r9rr;rrrrrAsrAN)r9Z django.confrZdjango.core.cacherrZdjango.utils.cacherrrrr Zdjango.utils.deprecationr r r<rArrrrs-  H1