Module: ActiveSupport::Cache

Relationships & Source Files
Namespace Children
Modules: `ConnectionPoolLike`, `Strategy`
Classes: `FileStore`, `MemCacheStore`, `MemoryStore`, `NullStore`, `RedisCacheStore`, `Store`
Super Chains via Extension / Inclusion / Inheritance
Instance Chain: self, `ConnectionPoolLike`
Defined in:	activesupport/lib/active_support/cache.rb, activesupport/lib/active_support/cache/file_store.rb, activesupport/lib/active_support/cache/mem_cache_store.rb, activesupport/lib/active_support/cache/memory_store.rb, activesupport/lib/active_support/cache/null_store.rb, activesupport/lib/active_support/cache/redis_cache_store.rb, activesupport/lib/active_support/cache/strategy/local_cache.rb, activesupport/lib/active_support/cache/strategy/local_cache_middleware.rb

Overview

See Store for documentation.

Constant Summary

UNIVERSAL_OPTIONS =

These options mean something to all cache implementations. Individual cache implementations may support additional options.

# File 'activesupport/lib/active_support/cache.rb', line 25
```
[:namespace, :compress, :compress_threshold, :expires_in, :race_condition_ttl, :coder]
```

Class Method Summary

.expand_cache_key(key, namespace = nil)

Expands out the key argument into a key that can be used for the cache store.
.lookup_store(store = nil, *parameters)

Creates a new Store object according to the given options.

Instance Method Summary

`ConnectionPoolLike` - Included

#with

Class Method Details

.expand_cache_key(key, namespace = nil)

Expands out the key argument into a key that can be used for the cache store. Optionally accepts a namespace, and all keys will be scoped within that namespace.

If the key argument provided is an array, or responds to to_a, then each of elements in the array will be turned into parameters/keys and concatenated into a single key. For example:

ActiveSupport::Cache.expand_cache_key([:foo, :bar])               # => "foo/bar"
ActiveSupport::Cache.expand_cache_key([:foo, :bar], "namespace")  # => "namespace/foo/bar"

The key argument can also respond to cache_key or to_param.

[ GitHub ]

# File 'activesupport/lib/active_support/cache.rb', line 89


def expand_cache_key(key, namespace = nil)
  expanded_cache_key = namespace ? +"#{namespace}/" : +""

  if prefix = ENV["RAILS_CACHE_ID"] || ENV["RAILS_APP_VERSION"]
    expanded_cache_key << "#{prefix}/"
  end

  expanded_cache_key << retrieve_cache_key(key)
  expanded_cache_key
end

.lookup_store(store = nil, *parameters)

Creates a new Cache::Store object according to the given options.

If no arguments are passed to this method, then a new Cache::MemoryStore object will be returned.

If you pass a ::Symbol as the first argument, then a corresponding cache store class under the Cache namespace will be created. For example:

ActiveSupport::Cache.lookup_store(:memory_store)
# => returns a new ActiveSupport::Cache::MemoryStore object

ActiveSupport::Cache.lookup_store(:mem_cache_store)
# => returns a new ActiveSupport::Cache::MemCacheStore object

Any additional arguments will be passed to the corresponding cache store class’s constructor:

ActiveSupport::Cache.lookup_store(:file_store, '/tmp/cache')
# => same as: ActiveSupport::Cache::FileStore.new('/tmp/cache')

If the first argument is not a ::Symbol, then it will simply be returned:

ActiveSupport::Cache.lookup_store(MyOwnCacheStore.new)
# => returns MyOwnCacheStore.new