Module: I18n::Backend::Cache

### Home Classes Methods

### In Files

- lib/i18n/backend/cache.rb

### Methods

- #_fetch
- #cache_key
- #fetch
- #translate

### Class/Module Index

Quicksearch

- I18n
- I18n::ArgumentError
- I18n::Backend
- I18n::Backend::Base
- I18n::Backend::Cache
- I18n::Backend::Cascade
- I18n::Backend::Chain
- I18n::Backend::Chain::Implementation
- I18n::Backend::Fallbacks
- I18n::Backend::Flatten
- I18n::Backend::Gettext
- I18n::Backend::Gettext::PoData
- I18n::Backend::InterpolationCompiler
- I18n::Backend::InterpolationCompiler::Compiler
- I18n::Backend::KeyValue
- I18n::Backend::KeyValue::Implementation
- I18n::Backend::Memoize
- I18n::Backend::Metadata
- I18n::Backend::Pluralization
- I18n::Backend::Simple
- I18n::Backend::Simple::Implementation
- I18n::Config
- I18n::ExceptionHandler
- I18n::Gettext
- I18n::Gettext::Helpers
- I18n::InvalidLocale
- I18n::InvalidLocaleData
- I18n::InvalidPluralizationData
- I18n::Locale
- I18n::Locale::Fallbacks
- I18n::Locale::Tag
- I18n::Locale::Tag::Parents
- I18n::Locale::Tag::Rfc4646
- I18n::Locale::Tag::Rfc4646::Parser
- I18n::Locale::Tag::Simple
- I18n::MissingInterpolationArgument
- I18n::MissingTranslation
- I18n::MissingTranslation::Base
- I18n::MissingTranslationData
- I18n::ReservedInterpolationKey
- I18n::Tests
- I18n::Tests::Basics
- I18n::Tests::Defaults
- I18n::Tests::Link
- I18n::Tests::Localization
- I18n::Tests::Lookup
- I18n::Tests::Pluralization
- I18n::Tests::Procs
- I18n::UnknownFileType
- GetText
- GetText::PoParser
- Hash
- Kernel

No matching classes.

# 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

    # 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

[Validate]

Generated with the Darkfish Rdoc Generator 2.