модуль ActionController::ConditionalGet

# File actionpack/lib/action_controller/metal/conditional_get.rb, line 246
def expires_in(seconds, options = {})
  response.cache_control.merge!(
    max_age: seconds,
    public: options.delete(:public),
    must_revalidate: options.delete(:must_revalidate),
    stale_while_revalidate: options.delete(:stale_while_revalidate),
    stale_if_error: options.delete(:stale_if_error),
  )
  options.delete(:private)

  response.cache_control[:extras] = options.map { |k, v| "#{k}=#{v}" }
  response.date = Time.now unless response.date?
end

Устанавливает заголовок HTTP 1.1 Cache-Control. По умолчанию выдает инструкцию private, чтобы промежуточные кэши не кэшировали ответ.

expires_in 20.minutes
expires_in 3.hours, public: true
expires_in 3.hours, public: true, must_revalidate: true

Этот метод перезапишет существующий заголовок Cache-Control. См. www.w3.org/Protocols/rfc2616/rfc2616-sec14.html для других возможностей.

Расширения HTTP Cache-Control для устаревших данных. См. tools.ietf.org/html/rfc5861 Это помогает кэшировать ресурс и предоставлять его во время повторной проверки и/или возвращения с ошибкой.

expires_in 3.hours, public: true, stale_while_revalidate: 60.seconds
expires_in 3.hours, public: true, stale_while_revalidate: 60.seconds, stale_if_error: 5.minutes

Другие значения расширений HTTP Cache-Control: developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control Все дополнительные пары ключ-значение конкатенируются в заголовок `Cache-Control` в ответе:

expires_in 3.hours, public: true, "s-maxage": 3.hours, "no-transform": true

Метод также обеспечит заголовок HTTP Date для совместимости с клиентом.

# File actionpack/lib/action_controller/metal/conditional_get.rb, line 263
def expires_now
  response.cache_control.replace(no_cache: true)
end

Устанавливает заголовок HTTP 1.1 Cache-Control со значением no-cache. Это означает, что ресурс будет помечен как устаревший, поэтому клиенты всегда должны проверять его актуальность. Промежуточные кэши/браузеры всё ещё могут хранить ресурс.

# File actionpack/lib/action_controller/metal/conditional_get.rb, line 106
def fresh_when(object = nil, etag: nil, weak_etag: nil, strong_etag: nil, last_modified: nil, public: false, template: nil)
  weak_etag ||= etag || object unless strong_etag
  last_modified ||= object.try(:updated_at) || object.try(:maximum, :updated_at)

  if strong_etag
    response.strong_etag = combine_etags strong_etag,
      last_modified: last_modified, public: public, template: template
  elsif weak_etag || template
    response.weak_etag = combine_etags weak_etag,
      last_modified: last_modified, public: public, template: template
  end

  response.last_modified = last_modified if last_modified
  response.cache_control[:public] = true if public

  head :not_modified if request.fresh?(response)
end

Устанавливает etag, last_modified, или оба в ответе и отображает ответ 304 Not Modified, если запрос уже свежий.

Параметры:

• :etag Устанавливает валидатор «слабой» метки ETag в ответе. См. параметр :weak_etag.

• :weak_etag Устанавливает валидатор «слабой» метки ETag в ответе. Запросы, устанавливающие заголовок If-None-Match, могут вернуть ответ 304 Not Modified, если метка ETag совпадает точно. Слабая метка ETag указывает на семантическое соответствие, а не байтовое, поэтому она подходит для кэширования HTML-страниц в кэшах браузеров. Она не может использоваться для ответов, которые должны быть идентичными по байтам, например, для обработки запросов Range внутри PDF-файла.

• :strong_etag Устанавливает валидатор «сильной» метки ETag в ответе. Запросы, устанавливающие заголовок If-None-Match, могут вернуть ответ 304 Not Modified, если метка ETag совпадает точно. Сильная метка ETag подразумевает точное равенство: ответ должен соответствовать байту за байтом. Это необходимо для обработки запросов Range внутри больших видео или PDF-файлов, например, или для совместимости с некоторыми CDN, которые не поддерживают слабые метки ETag.

• :last_modified Устанавливает валидатор «слабой» последней даты обновления в ответе. Последующие запросы, устанавливающие заголовок If-Modified-Since, могут вернуть ответ 304 Not Modified, если last_modified <= If-Modified-Since.

• :public По умолчанию заголовок Cache-Control имеет значение private, установите это в true, если вы хотите, чтобы ваш приложение можно было кэшировать другими устройствами (прокси-кэшами).

• :template По умолчанию хеш-код шаблона для текущего контроллера/действия включается в метки ETag. Если действие отображает другой шаблон, вы можете включить его хеш-код вместо этого. Если действие вообще не отображает шаблон, вы можете передать template: false, чтобы пропустить попытку проверки хеш-кода шаблона.

Пример:

def show
  @article = Article.find(params[:id])
  fresh_when(etag: @article, last_modified: @article.updated_at, public: true)
end

Это отобразит шаблон show, если запрос не отправляет совпадающую метку ETag или заголовок If-Modified-Since, и просто ответ 304 Not Modified если есть совпадение.

Вы также можете просто передать запись. В этом случае last_modified будет установлено вызовом updated_at и etag передачей самого объекта.

def show
  @article = Article.find(params[:id])
  fresh_when(@article)
end

Вы также можете передать объект, который отвечает на maximum, например, коллекцию активных записей. В этом случае last_modified будет установлено вызовом maximum(:updated_at) на коллекции (отметка времени последней обновленной записи), а etag передачей самого объекта.

def index
  @articles = Article.all
  fresh_when(@articles)
end

При передаче записи или коллекции вы все равно можете установить заголовок public:

def show
  @article = Article.find(params[:id])
  fresh_when(@article, public: true)
end

При отображении другого шаблона, чем по умолчанию, для контроллера/действия, вы можете указать, какой хеш-код включить в метку ETag:

before_action { fresh_when @article, template: 'widgets/show' }

# File actionpack/lib/action_controller/metal/conditional_get.rb, line 275
def http_cache_forever(public: false)
  expires_in 100.years, public: public

  yield if stale?(etag: request.fullpath,
                  last_modified: Time.new(2011, 1, 1).utc,
                  public: public)
end

Кэшировать или выполнить блок. Кэш не должен истекать.

Вы можете использовать этот метод, когда у вас есть HTTP-ответ, который никогда не меняется, и браузер и прокси должны кэшировать его неограниченно.

• public: По умолчанию HTTP-ответы являются частными, кэшируются только в браузере пользователя. Чтобы разрешить прокси-серверам кэшировать ответ, установите true для указания возможности предоставлять кэшированный ответ всем пользователям.

# File actionpack/lib/action_controller/metal/conditional_get.rb, line 219
def stale?(object = nil, **freshness_kwargs)
  fresh_when(object, **freshness_kwargs)
  !request.fresh?(response)
end

Устанавливает etag и/или last_modified в ответе и проверяет их по отношению к запросу клиента. Если запрос не соответствует предоставленным параметрам, запрос считается устаревшим и должен быть сгенерирован заново. В противном случае, он свежий, и нам не нужно ничего генерировать, и отправляется ответ 304 Not Modified.

Параметры:

• :etag Устанавливает валидатор «слабой» метки ETag в ответе. См. параметр :weak_etag.

• :weak_etag Устанавливает валидатор «слабой» метки ETag в ответе. Запросы, устанавливающие заголовок If-None-Match, могут вернуть ответ 304 Not Modified, если метка ETag совпадает точно. Слабая метка ETag указывает на семантическое соответствие, а не байтовое, поэтому она подходит для кэширования HTML-страниц в кэшах браузеров. Она не может использоваться для ответов, которые должны быть идентичными по байтам, например, для обработки запросов Range внутри PDF-файла.

• :strong_etag Устанавливает валидатор «сильной» метки ETag в ответе. Запросы, устанавливающие заголовок If-None-Match, могут вернуть ответ 304 Not Modified, если метка ETag совпадает точно. Сильная метка ETag подразумевает точное равенство: ответ должен соответствовать байту за байтом. Это необходимо для обработки запросов Range внутри больших видео или PDF-файлов, например, или для совместимости с некоторыми CDN, которые не поддерживают слабые метки ETag.

• :last_modified Устанавливает валидатор «слабой» последней даты обновления в ответе. Последующие запросы, устанавливающие заголовок If-Modified-Since, могут вернуть ответ 304 Not Modified, если last_modified <= If-Modified-Since.

• :public По умолчанию заголовок Cache-Control имеет значение private, установите это в true, если вы хотите, чтобы ваш приложение можно было кэшировать другими устройствами (прокси-кэшами).

• :template По умолчанию хеш-код шаблона для текущего контроллера/действия включается в метки ETag. Если действие отображает другой шаблон, вы можете включить его хеш-код вместо этого. Если действие вообще не отображает шаблон, вы можете передать template: false для пропуска попытки проверки хеш-кода шаблона.

Пример:

def show
  @article = Article.find(params[:id])

  if stale?(etag: @article, last_modified: @article.updated_at)
    @statistics = @article.really_expensive_call
    respond_to do |format|
      # all the supported formats
    end
  end
end

Вы также можете просто передать запись. В этом случае last_modified будет установлено вызовом updated_at и etag передачей самого объекта.

def show
  @article = Article.find(params[:id])

  if stale?(@article)
    @statistics = @article.really_expensive_call
    respond_to do |format|
      # all the supported formats
    end
  end
end

Вы также можете передать объект, который отвечает на maximum, например, коллекцию активных записей. В этом случае last_modified будет установлено вызовом maximum(:updated_at) на коллекции (отметка времени последней обновленной записи), а etag передачей самого объекта.

def index
  @articles = Article.all

  if stale?(@articles)
    @statistics = @articles.really_expensive_call
    respond_to do |format|
      # all the supported formats
    end
  end
end

При передаче записи или коллекции вы все равно можете установить заголовок public:

def show
  @article = Article.find(params[:id])

  if stale?(@article, public: true)
    @statistics = @article.really_expensive_call
    respond_to do |format|
      # all the supported formats
    end
  end
end

При отображении другого шаблона, чем по умолчанию, для контроллера/действия, вы можете указать, какой хеш-код включить в метку ETag:

def show
  super if stale? @article, template: 'widgets/show'
end