Module: ActionController::Caching::Pages::ClassMethods

Defined in:
lib/action_controller/caching/pages.rb

Instance Method Summary collapse

Instance Method Details

#cache_page(content, path) ⇒ Object

Manually cache the content in the key determined by path. Example:

cache_page "I'm the cached content", "/lists/show"

75
76
77
78
79
80
81
82
# File 'lib/action_controller/caching/pages.rb', line 75

def cache_page(content, path)
  return unless perform_caching

  benchmark "Cached page: #{page_cache_file(path)}" do
    FileUtils.makedirs(File.dirname(page_cache_path(path)))
    File.open(page_cache_path(path), "wb+") { |f| f.write(content) }
  end
end

#caches_page(*actions) ⇒ Object

Caches the actions using the page-caching approach that'll store the cache in a path within the page_cache_directory that matches the triggering url.

Usage:

# cache the index action
caches_page :index

# cache the index action except for JSON requests
caches_page :index, :if => Proc.new { |c| !c.request.format.json? }

94
95
96
97
98
# File 'lib/action_controller/caching/pages.rb', line 94

def caches_page(*actions)
  return unless perform_caching
  options = actions.extract_options!
  after_filter({:only => actions}.merge(options)) { |c| c.cache_page }
end

#expire_page(path) ⇒ Object

Expires the page that was cached with the path as a key. Example:

expire_page "/lists/show"

65
66
67
68
69
70
71
# File 'lib/action_controller/caching/pages.rb', line 65

def expire_page(path)
  return unless perform_caching

  benchmark "Expired page: #{page_cache_file(path)}" do
    File.delete(page_cache_path(path)) if File.exist?(page_cache_path(path))
  end
end