Class: I18n::Backend::KeyValue

### Home Classes Methods

### In Files

- lib/i18n/backend/key_value.rb

### Parent

Object

### Namespace

- MODULE I18n::Backend::KeyValue::Implementation

### Included Modules

- I18n::Backend::KeyValue::Implementation

### 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
- KeyError
- String

No matching classes.

# I18n::Backend::KeyValue

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

- storekeys - 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.

[Validate]

Generated with the Darkfish Rdoc Generator 2.