render-caching

render-caching copied to clipboard

= Render Caching

Cache render calls in Rails controllers.

== Install

First install the gem.

gem install ryanb-render-caching --source=http://gems.github.com

Then specify it in your Rails config.

config.gem 'ryanb-render-caching', :lib => 'render_caching', :source => 'http://gems.github.com'

Rails 2.1 or later required.

== Usage

This gem adds the render_with_cache method to all controllers. Call this inside of an action to cache the view.

def show
  @user = User.find(params[:id])
  render_with_cache
end

This will cache the full rendered contents into a key matching the URL path (similar to action caching). You can change this key by simply passing any parameter.

def show
  @user = User.find(params[:id])
  render_with_cache @user.cache_key
end

Cache key is a method supplied by Rails. This includes the updated_at time which will give you an auto-expiring cache when the user record is updated.

You can also supply a block to the render call which will only get executed if there is no cache. Here is a good place to do any custom render calls.

def show
  @user = User.find(params[:id])
  render_with_cache @user.cache_key do
    render :layout => false
  end
end

== Development

This project can be found on github at the following URL.

http://github.com/ryanb/render-caching/

If you would like to contribute to this project, please fork the repository and send me a pull request.