Module: ActionDispatch::Http::Cache::Request

Included in:
Request
Defined in:
actionpack/lib/action_dispatch/http/cache.rb

Constant Summary collapse

HTTP_IF_MODIFIED_SINCE =
'HTTP_IF_MODIFIED_SINCE'.freeze
HTTP_IF_NONE_MATCH =
'HTTP_IF_NONE_MATCH'.freeze

Instance Method Summary collapse

Instance Method Details

#etag_matches?(etag) ⇒ Boolean

Returns:

  • (Boolean)


30
31
32
33
34
35
# File 'actionpack/lib/action_dispatch/http/cache.rb', line 30

def etag_matches?(etag)
  if etag
    etag = etag.gsub(/^\"|\"$/, "")
    if_none_match_etags.include?(etag)
  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, both must match, or the request is not considered fresh.

Returns:

  • (Boolean)


40
41
42
43
44
45
46
47
48
49
50
# File 'actionpack/lib/action_dispatch/http/cache.rb', line 40

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

#if_modified_sinceObject



10
11
12
13
14
# File 'actionpack/lib/action_dispatch/http/cache.rb', line 10

def if_modified_since
  if since = env[HTTP_IF_MODIFIED_SINCE]
    Time.rfc2822(since) rescue nil
  end
end

#if_none_matchObject



16
17
18
# File 'actionpack/lib/action_dispatch/http/cache.rb', line 16

def if_none_match
  env[HTTP_IF_NONE_MATCH]
end

#if_none_match_etagsObject



20
21
22
23
24
# File 'actionpack/lib/action_dispatch/http/cache.rb', line 20

def if_none_match_etags
  (if_none_match ? if_none_match.split(/\s*,\s*/) : []).collect do |etag|
    etag.gsub(/^\"|\"$/, "")
  end
end

#not_modified?(modified_at) ⇒ Boolean

Returns:

  • (Boolean)


26
27
28
# File 'actionpack/lib/action_dispatch/http/cache.rb', line 26

def not_modified?(modified_at)
  if_modified_since && modified_at && if_modified_since >= modified_at
end