module I18n::Backend::Cache - i18n-0.6.11 Documentation

# 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 65
    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 78
    def _fetch(cache_key, &block)
      result = I18n.cache_store.read(cache_key) and return result
      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 85
    def cache_key(locale, key, options)
      # This assumes that only simple, native Ruby values are passed to I18n.translate.
      "i18n/#{I18n.cache_namespace}/#{locale}/#{key.hash}/#{USE_INSPECT_HASH ? options.inspect.hash : options.hash}"
    end

fetch(cache_key, &block) click to toggle source

    # File lib/i18n/backend/cache.rb, line 71
    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