/Ruby on Rails 7.0

module ActionController::ConditionalGet::ClassMethods

Public Instance Methods

etag(&etagger) Show source
# File actionpack/lib/action_controller/metal/conditional_get.rb, line 31
def etag(&etagger)
  self.etaggers += [etagger]

Allows you to consider additional controller-wide information when generating an ETag. For example, if you serve pages tailored depending on who's logged in at the moment, you may want to add the current user id to be part of the ETag to prevent unauthorized displaying of cached pages.

class InvoicesController < ApplicationController
  etag { current_user&.id }

  def show
    # Etag will differ even for the same invoice when it's viewed by a different current_user
    @invoice = Invoice.find(params[:id])
    fresh_when etag: @invoice

© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.