123456789_123456789_123456789_123456789_123456789_

Module: ActionController::EtagWithTemplateDigest

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Included In:
Base, ::ActionView::TestCase::TestController, Rails::ApplicationController, ::Rails::HealthController, Rails::InfoController, Rails::MailersController, Rails::WelcomeController
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
Instance Chain:
Defined in: actionpack/lib/action_controller/metal/etag_with_template_digest.rb

Overview

When our views change, they should bubble up into HTTP cache freshness and bust browser caches. So the template digest for the current action is automatically included in the ETag.

Enabled by default for apps that use Action View. Disable by setting

config.action_controller.etag_with_template_digest = false

Override the template to digest by passing :template to fresh_when and stale? calls. For example:

# We're going to render widgets/show, not posts/show
fresh_when @post, template: 'widgets/show'

# We're not going to render a template, so omit it from the ETag.
fresh_when @post, template: false

ConditionalGet - Attributes & Methods

Class Method Summary

::ActiveSupport::Concern - Extended

class_methods

Define class methods from given block.

included

Evaluate given block in context of base class, so that you can write class macros here.

prepended

Evaluate given block in context of base class, so that you can write class macros here.

Instance Method Summary

ConditionalGet - Included

#expires_in

Sets the Cache-Control header, overwriting existing directives.

#expires_now

Sets an HTTP 1.1 Cache-Control header of no-cache.

#fresh_when

Sets the etag, last_modified, or both on the response, and renders a 304 Not Modified response if the request is already fresh.

#http_cache_forever

Cache or yield the block.

#no_store

Sets an HTTP 1.1 Cache-Control header of no-store.

#stale?

Sets the etag and/or last_modified on the response and checks them against the request.

Head - Included

#head

Returns a response that has no content (merely headers).

DSL Calls

included

[ GitHub ]


28
29
30
31
32
33
34
# File 'actionpack/lib/action_controller/metal/etag_with_template_digest.rb', line 28

included do
  class_attribute :etag_with_template_digest, default: true

  etag do |options|
    determine_template_etag(options) if etag_with_template_digest
  end
end

Class Attribute Details

.etaggers (rw)

[ GitHub ]

  
# File 'actionpack/lib/action_controller/metal/conditional_get.rb', line 13

class_attribute :etaggers, default: []

.etaggers?Boolean (rw)

[ GitHub ]

  
# File 'actionpack/lib/action_controller/metal/conditional_get.rb', line 13

class_attribute :etaggers, default: []

Instance Attribute Details

#etaggers (rw)

[ GitHub ]

  
# File 'actionpack/lib/action_controller/metal/conditional_get.rb', line 13

class_attribute :etaggers, default: []

#etaggers?Boolean (rw)

[ GitHub ]

  
# File 'actionpack/lib/action_controller/metal/conditional_get.rb', line 13

class_attribute :etaggers, default: []