A cache store implementation which stores everything on the filesystem.

FileStore implements the Strategy::LocalCache strategy which implements an in memory cache inside of a block.

Methods
C
D
I
N
R
W
Constants
DIR_FORMATTER = "%03X"
 
FILENAME_MAX_SIZE = 230
 
Attributes
[R] cache_path
Class Public methods
new(cache_path, options = nil)
# File activesupport/lib/active_support/cache/file_store.rb, line 18
def initialize(cache_path, options = nil)
  super(options)
  @cache_path = cache_path.to_s
  extend Strategy::LocalCache
end
Instance Public methods
cleanup(options = nil)
# File activesupport/lib/active_support/cache/file_store.rb, line 29
def cleanup(options = nil)
  options = merged_options(options)
  each_key(options) do |key|
    entry = read_entry(key, options)
    delete_entry(key, options) if entry && entry.expired?
  end
end
clear(options = nil)
# File activesupport/lib/active_support/cache/file_store.rb, line 24
def clear(options = nil)
  root_dirs = Dir.entries(cache_path).reject{|f| f.in?(['.', '..'])}
  FileUtils.rm_r(root_dirs.collect{|f| File.join(cache_path, f)})
end
decrement(name, amount = 1, options = nil)
# File activesupport/lib/active_support/cache/file_store.rb, line 51
def decrement(name, amount = 1, options = nil)
  file_name = key_file_path(namespaced_key(name, options))
  lock_file(file_name) do
    options = merged_options(options)
    if num = read(name, options)
      num = num.to_i - amount
      write(name, num, options)
      num
    else
      nil
    end
  end
end
delete_matched(matcher, options = nil)
# File activesupport/lib/active_support/cache/file_store.rb, line 65
def delete_matched(matcher, options = nil)
  options = merged_options(options)
  instrument(:delete_matched, matcher.inspect) do
    matcher = key_matcher(matcher, options)
    search_dir(cache_path) do |path|
      key = file_path_key(path)
      delete_entry(key, options) if key.match(matcher)
    end
  end
end
increment(name, amount = 1, options = nil)
# File activesupport/lib/active_support/cache/file_store.rb, line 37
def increment(name, amount = 1, options = nil)
  file_name = key_file_path(namespaced_key(name, options))
  lock_file(file_name) do
    options = merged_options(options)
    if num = read(name, options)
      num = num.to_i + amount
      write(name, num, options)
      num
    else
      nil
    end
  end
end
Instance Protected methods
delete_entry(key, options)
# File activesupport/lib/active_support/cache/file_store.rb, line 106
def delete_entry(key, options)
  file_name = key_file_path(key)
  if File.exist?(file_name)
    begin
      File.delete(file_name)
      delete_empty_directories(File.dirname(file_name))
      true
    rescue => e
      # Just in case the error was caused by another process deleting the file first.
      raise e if File.exist?(file_name)
      false
    end
  end
end
read_entry(key, options)
# File activesupport/lib/active_support/cache/file_store.rb, line 78
def read_entry(key, options)
  file_name = key_file_path(key)
  if File.exist?(file_name)
    entry = File.open(file_name) { |f| Marshal.load(f) }
    if entry && !entry.expired? && !entry.expires_in && !self.options[:expires_in]
      # Check for deprecated use of +:expires_in+ option from versions < 3.0
      deprecated_expires_in = options[:expires_in]
      if deprecated_expires_in
        ActiveSupport::Deprecation.warn('Setting :expires_in on read has been deprecated in favor of setting it on write.', caller)
        if entry.created_at + deprecated_expires_in.to_f <= Time.now.to_f
          delete_entry(key, options)
          entry = nil
        end
      end
    end
    entry
  end
rescue
  nil
end
write_entry(key, entry, options)
# File activesupport/lib/active_support/cache/file_store.rb, line 99
def write_entry(key, entry, options)
  file_name = key_file_path(key)
  ensure_cache_path(File.dirname(file_name))
  File.atomic_write(file_name, cache_path) {|f| Marshal.dump(entry, f)}
  true
end