W3cubDocs

/Ruby on Rails 7.0

module ActionDispatch::Http::Cache::Request

Constants

HTTP_IF_MODIFIED_SINCE
HTTP_IF_NONE_MATCH

Public Instance Methods

etag_matches?(etag) Show source
# File actionpack/lib/action_dispatch/http/cache.rb, line 28
def etag_matches?(etag)
  if etag
    validators = if_none_match_etags
    validators.include?(etag) || validators.include?("*")
  end
end
fresh?(response) Show source
# File actionpack/lib/action_dispatch/http/cache.rb, line 38
def fresh?(response)
  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

Check response freshness (Last-Modified and ETag) against request If-Modified-Since and If-None-Match conditions. If both headers are supplied, both must match, or the request is not considered fresh.

if_modified_since() Show source
# File actionpack/lib/action_dispatch/http/cache.rb, line 10
def if_modified_since
  if since = get_header(HTTP_IF_MODIFIED_SINCE)
    Time.rfc2822(since) rescue nil
  end
end
if_none_match() Show source
# File actionpack/lib/action_dispatch/http/cache.rb, line 16
def if_none_match
  get_header HTTP_IF_NONE_MATCH
end
if_none_match_etags() Show source
# File actionpack/lib/action_dispatch/http/cache.rb, line 20
def if_none_match_etags
  if_none_match ? if_none_match.split(/\s*,\s*/) : []
end
not_modified?(modified_at) Show source
# File actionpack/lib/action_dispatch/http/cache.rb, line 24
def not_modified?(modified_at)
  if_modified_since && modified_at && if_modified_since >= modified_at
end

© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.