module I18n::Backend::Cache
TODO Should the cache be cleared if new translations are stored?
Constants
- USE_INSPECT_HASH
In Ruby < 1.9 the following is true: { :foo => 1, :bar => 2 }.hash == { :foo => 2, :bar => 1 }.hash Therefore we must use the hash of the inspect string instead to avoid cache key colisions.
Public Instance Methods
translate(locale, key, options = {})
click to toggle source
Calls superclass method
# File lib/i18n/backend/cache.rb, line 78 def translate(locale, key, options = {}) I18n.perform_caching? ? fetch(cache_key(locale, key, options)) { super } : super end
Protected Instance Methods
_fetch(cache_key, &block)
click to toggle source
# File lib/i18n/backend/cache.rb, line 91 def _fetch(cache_key, &block) result = I18n.cache_store.read(cache_key) return result unless result.nil? result = catch(:exception, &block) I18n.cache_store.write(cache_key, result) unless result.is_a?(Proc) result end
cache_key(locale, key, options)
click to toggle source
# File lib/i18n/backend/cache.rb, line 99 def cache_key(locale, key, options) # This assumes that only simple, native Ruby values are passed to I18n.translate. "i18n/#{I18n.cache_namespace}/#{locale}/#{digest_item(key)}/#{USE_INSPECT_HASH ? digest_item(options.inspect) : digest_item(options)}" end
fetch(cache_key, &block)
click to toggle source
# File lib/i18n/backend/cache.rb, line 84 def fetch(cache_key, &block) result = _fetch(cache_key, &block) throw(:exception, result) if result.is_a?(MissingTranslation) result = result.dup if result.frozen? rescue result result end
Private Instance Methods
digest_item(key)
click to toggle source
# File lib/i18n/backend/cache.rb, line 109 def digest_item(key) I18n.cache_key_digest ? I18n.cache_key_digest.hexdigest(key.to_s) : key.hash end