Module: ActionDispatch::Http::Cache::Request
Relationships & Source Files | |
Extension / Inclusion / Inheritance Descendants | |
Included In:
| |
Defined in: | actionpack/lib/action_dispatch/http/cache.rb |
Constant Summary
-
HTTP_IF_MODIFIED_SINCE =
# File 'actionpack/lib/action_dispatch/http/cache.rb', line 9"HTTP_IF_MODIFIED_SINCE"
-
HTTP_IF_NONE_MATCH =
# File 'actionpack/lib/action_dispatch/http/cache.rb', line 10"HTTP_IF_NONE_MATCH"
Class Attribute Summary
- .strict_freshness (also: #strict_freshness) rw
Instance Attribute Summary
Instance Method Summary
- #etag_matches?(etag) ⇒ Boolean
-
#fresh?(response) ⇒ Boolean
Check response freshness (‘Last-Modified` and
ETag
) against requestIf-Modified-Since
andIf-None-Match
conditions. - #if_modified_since
- #if_none_match
- #if_none_match_etags
- #not_modified?(modified_at) ⇒ Boolean
Class Attribute Details
.strict_freshness (rw) Also known as: #strict_freshness
[ GitHub ]# File 'actionpack/lib/action_dispatch/http/cache.rb', line 12
mattr_accessor :strict_freshness, default: false
Instance Attribute Details
#strict_freshness (rw)
[ GitHub ]# File 'actionpack/lib/action_dispatch/http/cache.rb', line 12
mattr_accessor :strict_freshness, default: false
Instance Method Details
#etag_matches?(etag) ⇒ Boolean
# File 'actionpack/lib/action_dispatch/http/cache.rb', line 32
def etag_matches?(etag) if etag validators = validators.include?(etag) || validators.include?("*") end end
#fresh?(response) ⇒ Boolean
Check response freshness (‘Last-Modified` and ETag
) against request If-Modified-Since
and If-None-Match
conditions. If both headers are supplied, based on configuration, either ETag
is preferred over Last-Modified
or both are considered equally. You can adjust the preference with config.action_dispatch.strict_freshness
. Reference: tools.ietf.org/html/rfc7232#section-6
# File 'actionpack/lib/action_dispatch/http/cache.rb', line 45
def fresh?(response) if Request.strict_freshness if if_none_match etag_matches?(response.etag) elsif if_modified_since not_modified?(response.last_modified) else false end else last_modified = if_modified_since etag = if_none_match return false unless last_modified || etag success = true success &&= not_modified?(response.last_modified) if last_modified success &&= etag_matches?(response.etag) if etag success end end
#if_modified_since
[ GitHub ]# File 'actionpack/lib/action_dispatch/http/cache.rb', line 14
def if_modified_since if since = get_header(HTTP_IF_MODIFIED_SINCE) Time.rfc2822(since) rescue nil end end
#if_none_match
[ GitHub ]# File 'actionpack/lib/action_dispatch/http/cache.rb', line 20
def if_none_match get_header HTTP_IF_NONE_MATCH end
#if_none_match_etags
[ GitHub ]# File 'actionpack/lib/action_dispatch/http/cache.rb', line 24
def if_none_match ? if_none_match.split(",").each(&:strip!) : [] end
#not_modified?(modified_at) ⇒ Boolean
# File 'actionpack/lib/action_dispatch/http/cache.rb', line 28
def not_modified?(modified_at) if_modified_since && modified_at && if_modified_since >= modified_at end