класс ActiveSupport::Cache::FileStore

Родитель:: ActiveSupport::Cache::Store

Реализация кэша, хранящего все данные в файловой системе.

FileStore реализует стратегию Strategy::LocalCache, которая реализует кэш в памяти внутри блока.

Константы

DIR_FORMATTER
EXCLUDED_DIRS
FILENAME_MAX_SIZE
FILEPATH_MAX_SIZE

Атрибуты

cache_path[R]

Публичные методы класса

new(cache_path, options = nil) Показать исходный код

# File activesupport/lib/active_support/cache/file_store.rb, line 20
def initialize(cache_path, options = nil)
  super(options)
  @cache_path = cache_path.to_s
  extend Strategy::LocalCache
end

Вызывает метод суперкласса ActiveSupport::Cache::Store.new

Публичные методы экземпляра

cleanup(options = nil) Показать исходный код

# File activesupport/lib/active_support/cache/file_store.rb, line 35
def cleanup(options = nil)
  options = merged_options(options)
  search_dir(cache_path) do |fname|
    key = file_path_key(fname)
    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 29
def clear(options = nil)
  root_dirs = Dir.entries(cache_path).reject {|f| (EXCLUDED_DIRS + [".gitkeep"]).include?(f)}
  FileUtils.rm_r(root_dirs.collect{|f| File.join(cache_path, f)})
end

Удаляет все элементы из кэша. В этом случае удаляются все записи в указанной директории хранилища кэша, за исключением .gitkeep. Будьте внимательны, какая директория указана в файле конфигурации при использовании FileStore, так как всё в этой директории будет удалено.

decrement(name, amount = 1, options = nil) Показать исходный код

# File activesupport/lib/active_support/cache/file_store.rb, line 52
def decrement(name, amount = 1, options = nil)
  modify_value(name, -amount, options)
end

Уменьшает уже существующее целое значение, хранящееся в кэше. Если ключ не найден, ничего не происходит.

delete_matched(matcher, options = nil) Показать исходный код

# File activesupport/lib/active_support/cache/file_store.rb, line 56
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 46
def increment(name, amount = 1, options = nil)
  modify_value(name, amount, options)
end

Увеличивает уже существующее целое значение, хранящееся в кэше. Если ключ не найден, ничего не происходит.

Защищённые методы экземпляра

delete_entry(key, options) Показать исходный код

# File activesupport/lib/active_support/cache/file_store.rb, line 87
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 69
def read_entry(key, options)
  file_name = key_file_path(key)
  if File.exist?(file_name)
    File.open(file_name) { |f| Marshal.load(f) }
  end
rescue => e
  logger.error("FileStoreError (#{e}): #{e.message}") if logger
  nil
end

write_entry(key, entry, options) Показать исходный код

# File activesupport/lib/active_support/cache/file_store.rb, line 79
def write_entry(key, entry, options)
  file_name = key_file_path(key)
  return false if options[:unless_exist] && File.exist?(file_name)
  ensure_cache_path(File.dirname(file_name))
  File.atomic_write(file_name, cache_path) {|f| Marshal.dump(entry, f)}
  true
end