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:
self,
::ActiveSupport::Concern
|
|
Instance Chain:
self,
ConditionalGet ,
Head
|
|
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
- .etaggers rw
- #etaggers rw
- .etaggers? ⇒ Boolean rw
- #etaggers? ⇒ Boolean rw
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 |
#expires_now | Sets an HTTP 1.1 |
#fresh_when | Sets the |
#http_cache_forever | Cache or yield the block. |
#no_store | Sets an HTTP 1.1 |
#stale? | Sets the |
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 || determine_template_etag( ) 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: []