method

fresh_when

v2.2.1 - Show latest stable - 0 notes - Class: ActionController::Base

1.0.0
1.1.6
1.2.6
2.0.3
2.1.0
2.2.1 (0)
2.3.2 (13)
2.3.8 (0)
3.0.0
3.0.9
3.1.0
3.2.1
3.2.8
3.2.13
4.0.2
4.1.8
4.2.1
4.2.7
4.2.9
5.0.0.1
5.1.7
5.2.3
6.0.0
6.1.3.1
What's this?

fresh_when(options) protected

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

Example:

  def show
    @article = Article.find(params[:id])
    fresh_when(:etag => @article, :last_modified => @article.created_at.utc)
  end

This will render the show template if the request isn’t sending a matching etag or If-Modified-Since header and just a "304 Not Modified" response if there’s a match.

Show source

# File actionpack/lib/action_controller/base.rb, line 1129
      def fresh_when(options)
        options.assert_valid_keys(:etag, :last_modified)

        response.etag          = options[:etag]          if options[:etag]
        response.last_modified = options[:last_modified] if options[:last_modified]

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

fresh_when

Related methods

Flowdock - Team Inbox With Chat for Software Developers