com.force.i18n.LocalizerFactory Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of grammaticus Show documentation
Localization Framework that allows grammatically correct renaming of nouns
There is a newer version: 1.2.30
/* 
 * Copyright (c) 2017, salesforce.com, inc.
 * All rights reserved.
 * Licensed under the BSD 3-Clause license. 
 * For full license text, see LICENSE.txt file in the repo root  or https://opensource.org/licenses/BSD-3-Clause
 */

package com.force.i18n;

import java.util.Locale;
import java.util.TimeZone;
import java.util.concurrent.atomic.AtomicReference;

/**
 *  The real nitty-gritty of localization - every App should have 1 of these
 *  Note: this provides access to loaders, but not much else.
 */
public abstract class LocalizerFactory implements LocalizerProvider {

	private static LocalizerProvider INSTANCE;

	// TODO: Put this someplace else
	public static LocalizerProvider get() {
		return INSTANCE;
	}
	public static void set(LocalizerProvider factory) {
		INSTANCE = factory;
	}

	
    private static final AtomicReference default_locale =
    		new AtomicReference(Locale.US);  // TODO: Less 'mericun


	/* (non-Javadoc)
	 * @see shared.i18n.LocalizerProvider#getLabelLocalizer(i18n.UserLanguage)
	 */
    @Override
	public BaseLocalizer getLabelLocalizer(HumanLanguage language) {
        return getLocalizer(language.getLocale(), language.getLocale(), language, TimeZone.getDefault());
    }



    /* (non-Javadoc)
	 * @see shared.i18n.LocalizerProvider#getLocalizer(java.util.Locale)
	 */
    @Override
	public BaseLocalizer getLocalizer(Locale langLocale) {
        return getLocalizer(langLocale, null, // currency locale
            LanguageProviderFactory.get().getLanguageForLocale(langLocale), TimeZone.getDefault());
    }

    /* (non-Javadoc)
	 * @see shared.i18n.LocalizerProvider#getLocalizer(i18n.UserLanguage)
	 */
    @Override
	public BaseLocalizer getLocalizer(HumanLanguage language) {
        return getLocalizer(language.getLocale(), null, // currency locale
            language, TimeZone.getDefault());
    }

    /* (non-Javadoc)
	 * @see shared.i18n.LocalizerProvider#getDefaultLocalizer()
	 */
    @Override
	public BaseLocalizer getDefaultLocalizer() {
        return getLocalizer(LocalizerFactory.getDefaultLocale(),
            LocalizerFactory.getDefaultLocale(),
            LocalizerFactory.getDefaultLanguage(), TimeZone.getDefault());
    }


    public static Locale getDefaultLocale() {
        return default_locale.get();
    }

    public static HumanLanguage getDefaultLanguage() {
    	return LanguageProviderFactory.get().getLanguageForLocale(default_locale.get());
    }


    @Override
	public BaseLocalizer getEnglishLocalizer() {
        return getLocalizer(Locale.US, Locale.US, HumanLanguage.Helper.get(Locale.US), TimeZone.getDefault());
    }

    /**
     * Return the translated name of the language.  This will be the same in all languages, as retrieved from
     * public_i18n.xml (With ENGLISH using the special "en" label instead of en_US)
     * @param language the language for whom the language should be retrieved
     * @return the name of the human language in that language
     */
    public static String getTranslatedLanguageLabel(HumanLanguage language) {
        assert language != null : "You cannot provide a null language to this method";
        BaseLocalizer loc = get().getDefaultLocalizer();
        String label = loc.getLabel("translatedlanguagename", language.getLabelKey());
        if (language.getDirection() != loc.getUserLanguage().getDirection()) {  // Only embed for languages where the direction differs
            label = language.getDirection().addEmbeddingMarks(label);
        }
        return label;
     }

}