Class: Rack::ETag

Inherits:
Object
  • Object
show all
Defined in:
lib/rack/etag.rb

Overview

Automatically sets the ETag header on all String bodies.

The ETag header is skipped if ETag or Last-Modified headers are sent or if a sendfile body (body.responds_to :to_path) is given (since such cases should be handled by apache/nginx).

On initialization, you can pass two parameters: a Cache-Control directive used when Etag is absent and a directive when it is present. The first defaults to nil, while the second defaults to “max-age=0, privaute, must-revalidate”

Constant Summary collapse

DEFAULT_CACHE_CONTROL =
"max-age=0, private, must-revalidate".freeze

Instance Method Summary collapse

Constructor Details

#initialize(app, no_cache_control = nil, cache_control = DEFAULT_CACHE_CONTROL) ⇒ ETag

Returns a new instance of ETag.



16
17
18
19
20
# File 'lib/rack/etag.rb', line 16

def initialize(app, no_cache_control = nil, cache_control = DEFAULT_CACHE_CONTROL)
  @app = app
  @cache_control = cache_control
  @no_cache_control = no_cache_control
end

Instance Method Details

#call(env) ⇒ Object



22
23
24
25
26
27
28
29
30
31
32
33
34
35
# File 'lib/rack/etag.rb', line 22

def call(env)
  status, headers, body = @app.call(env)

  if etag_status?(status) && etag_body?(body) && !http_caching?(headers)
    digest, body = digest_body(body)
    headers['ETag'] = %("#{digest}") if digest
  end

  unless headers['Cache-Control']
    headers['Cache-Control'] = digest ? @cache_control : @no_cache_control
  end

  [status, headers, body]
end