Class: I18n::Backend::KeyValue

Inherits:
Object
  • Object
show all
Includes:
Implementation
Defined in:
lib/i18n/backend/key_value.rb

Overview

This is a basic backend for key value stores. It receives on initialization the store, which should respond to three methods:

  • store#[](key) - Used to get a value

  • store#[]=(key, value) - Used to set a value

  • store#keys - Used to get all keys

Since these stores only supports string, all values are converted to JSON before being stored, allowing it to also store booleans, hashes and arrays. However, this store does not support Procs.

As the ActiveRecord backend, Symbols are just supported when loading translations from the filesystem or through explicit store translations.

Also, avoid calling I18n.available_locales since it's a somehow expensive operation in most stores.

Example

To setup I18n to use TokyoCabinet in memory is quite straightforward:

require 'rufus/tokyo/cabinet' # gem install rufus-tokyo
I18n.backend = I18n::Backend::KeyValue.new(Rufus::Tokyo::Cabinet.new('*'))

Performance

You may make this backend even faster by including the Memoize module. However, notice that you should properly clear the cache if you change values directly in the key-store.

Subtrees

In most backends, you are allowed to retrieve part of a translation tree:

I18n.backend.store_translations :en, :foo => { :bar => :baz }
I18n.t "foo" #=> { :bar => :baz }

This backend supports this feature by default, but it slows down the storage of new data considerably and makes hard to delete entries. That said, you are allowed to disable the storage of subtrees on initialization:

I18n::Backend::KeyValue.new(@store, false)

This is useful if you are using a KeyValue backend chained to a Simple backend.

Defined Under Namespace

Modules: Implementation

Constant Summary

Constant Summary

Constants included from Transliterator

Transliterator::DEFAULT_REPLACEMENT_CHAR

Constants included from Flatten

Flatten::FLATTEN_SEPARATOR, Flatten::SEPARATOR_ESCAPE_CHAR

Instance Attribute Summary

Attributes included from Implementation

#store

Method Summary

Methods included from Implementation

#available_locales, #initialize, #store_translations

Methods included from Base

#available_locales, #exists?, #load_translations, #localize, #reload!, #store_translations, #translate

Methods included from Transliterator

get, #transliterate

Methods included from Flatten

escape_default_separator, #flatten_keys, #flatten_translations, #links, #normalize_flat_keys, normalize_flat_keys