Sha256: c80a5cd6b2c42221fd7726fa44645bf03b6501055e9f816b5a4d65b0f35fc497

Contents?: true

Size: 1.82 KB

Versions: 24

Compression:

Stored size: 1.82 KB

Contents

module ActionController
  # 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
  #
  module EtagWithTemplateDigest
    extend ActiveSupport::Concern

    include ActionController::ConditionalGet

    included do
      class_attribute :etag_with_template_digest
      self.etag_with_template_digest = true

      ActiveSupport.on_load :action_view, yield: true do
        etag do |options|
          determine_template_etag(options) if etag_with_template_digest
        end
      end
    end

    private
    def determine_template_etag(options)
      if template = pick_template_for_etag(options)
        lookup_and_digest_template(template)
      end
    end

    # Pick the template digest to include in the ETag. If the +:template+ option
    # is present, use the named template. If +:template+ is nil or absent, use
    # the default controller/action template. If +:template+ is false, omit the
    # template digest from the ETag.
    def pick_template_for_etag(options)
      unless options[:template] == false
        options[:template] || "#{controller_path}/#{action_name}"
      end
    end

    def lookup_and_digest_template(template)
      ActionView::Digestor.digest name: template, finder: lookup_context
    end
  end
end

Version data entries

24 entries across 24 versions & 3 rubygems

Version Path
actionpack-5.0.7.2 lib/action_controller/metal/etag_with_template_digest.rb
actionpack-5.0.7.1 lib/action_controller/metal/etag_with_template_digest.rb
actionpack-5.0.7 lib/action_controller/metal/etag_with_template_digest.rb
actionpack-5.0.6 lib/action_controller/metal/etag_with_template_digest.rb
actionpack-5.0.6.rc1 lib/action_controller/metal/etag_with_template_digest.rb
actionpack-5.0.5 lib/action_controller/metal/etag_with_template_digest.rb
actionpack-5.0.5.rc2 lib/action_controller/metal/etag_with_template_digest.rb
actionpack-5.0.5.rc1 lib/action_controller/metal/etag_with_template_digest.rb
actionpack-5.0.4 lib/action_controller/metal/etag_with_template_digest.rb
actionpack-5.0.4.rc1 lib/action_controller/metal/etag_with_template_digest.rb
actionpack-5.0.3 lib/action_controller/metal/etag_with_template_digest.rb
enju_leaf-1.2.1 vendor/bundle/ruby/2.3/gems/actionpack-5.0.2/lib/action_controller/metal/etag_with_template_digest.rb
actionpack-5.0.2 lib/action_controller/metal/etag_with_template_digest.rb
actionpack-5.0.2.rc1 lib/action_controller/metal/etag_with_template_digest.rb
autocompl-0.2.2 test/dummy/vendor/bundle/ruby/2.3.0/gems/actionpack-5.0.1/lib/action_controller/metal/etag_with_template_digest.rb
autocompl-0.2.1 test/dummy/vendor/bundle/ruby/2.3.0/gems/actionpack-5.0.1/lib/action_controller/metal/etag_with_template_digest.rb
autocompl-0.2.0 test/dummy/vendor/bundle/ruby/2.3.0/gems/actionpack-5.0.1/lib/action_controller/metal/etag_with_template_digest.rb
autocompl-0.1.2 test/dummy/vendor/bundle/ruby/2.3.0/gems/actionpack-5.0.1/lib/action_controller/metal/etag_with_template_digest.rb
autocompl-0.1.1 test/dummy/vendor/bundle/ruby/2.3.0/gems/actionpack-5.0.1/lib/action_controller/metal/etag_with_template_digest.rb
autocompl-0.1.0 test/dummy/vendor/bundle/ruby/2.3.0/gems/actionpack-5.0.1/lib/action_controller/metal/etag_with_template_digest.rb