raptor/lib/raptor/i18n/Dictionaries.js

RaptorJS provides an AMD module loader that works in Node, Rhino and the web browser. It also includes various sub-modules to support building optimized web applications.

/*
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
/**
 * The Dictionaries class manages dictionaries for a given locale.
 * Dictionaries for multiple locales can be loaded but the resources
 * for a single locale or accessed via a Dictionaries instance.
 */
define.Class('raptor/i18n/Dictionaries', function(require, exports, module) {
    "use strict";

    var i18n = require('raptor/i18n'),
        Dictionary = require('raptor/i18n/Dictionary'),
        logger = module.logger();

    function Dictionaries(localeCode) {
        this._localeCode = localeCode || '';
        this._dictionaryByName = {};
    }

    Dictionaries.prototype = {
        setDictionary: function(name, dictionary) {
            this._dictionaryByName[name] = dictionary;
        },

        getDictionaryIfLoaded: function(name) {
            return this._dictionaryByName[name];
        },

        getDictionary: function(name) {
            var dictionary = this._dictionaryByName[name];
            if (!dictionary) {
                dictionary = i18n.resolveDictionary(name, this);
                if (!dictionary) {
                    logger.error('Unable to load dictionary "' + name + '" for locale "' + this._localeCode + '". Using empty dictionary.');
                    this._dictionaryByName[name] = dictionary = new Dictionary(name, {}, this._localeCode);
                }
            }
            return dictionary;
        },

        isDictionaryLoaded: function(name) {
            return !!this._dictionaryByName[name];
        },

        getLocaleCode: function() {
            return this._localeCode;
        }
    };

    return Dictionaries;
});