Strings.java

package abbot.i18n;

import java.text.MessageFormat;
import java.util.*;

import abbot.Log;

/** Provides i18n support. */
// TODO: auto-format tooltips (".tip") and dialog messages (".dlg.")
public class Strings {
    private static final String BUNDLE = "abbot.i18n.StringsBundle";

    private static Set bundles = new HashSet();
    private static Map formats = new HashMap();

    static {
        String language = System.getProperty("abbot.locale.language");
        if (language != null) {
            String country = System.getProperty("abbot.locale.country",
                                                language.toUpperCase());
            String variant = System.getProperty("abbot.locale.variant", "");
            Locale locale = new Locale(language, country, variant);
            Locale.setDefault(locale);
            System.out.println("Using locale " + locale);
        }
        addBundle(BUNDLE);
    }

    private Strings() { }

    public static void addBundle(String bundle) {
        Locale locale = Locale.getDefault();
        try {
            bundles.add(ResourceBundle.getBundle(bundle, locale));
        }
        catch(MissingResourceException mre) {
            String msg = "No resource bundle found in " + bundle;
            if (System.getProperty("java.class.path").indexOf("eclipse") != -1) {
                Log.warn(msg + ": copy one into your project output dir or run the ant build");
            }
            else {
                throw new Error(msg);
            }
        }
    }

    /** Returns the localized String for the given key, or the key surrounded
        by '#' if no corresponding localized string is found.
    */
    public static String get(String key) {
        return get(key, false);
    }

    /** Returns the localized string for the given key.  If optional is true,
        return null, otherwise returns the key surrounded by '#' if no
        corresponding localized string is found. 
    */
    public static String get(String key, boolean optional) {
        String defaultValue = "#" + key + "#";
        String value = null;
        Iterator iter = bundles.iterator();
        while (iter.hasNext()) {
            ResourceBundle local = (ResourceBundle)iter.next();
            try {
                value = local.getString(key);
            }
            catch(MissingResourceException mre) {
            }
        }
        if (value == null) {
            if (!optional) {
                Log.log("Missing resource '" + key + "'");
                value = defaultValue;
            }
        }
        return value;
    }

    /** Returns a formatted localized string for the given key and arguments,
        or the key if no corresponding localized string is found.  Use
        java.text.MessageFormat syntax for the format string and arguments.
    */
    public static String get(String key, Object[] args) {
        MessageFormat fmt = (MessageFormat)formats.get(key);
        if (fmt == null) {
            fmt = new MessageFormat(get(key));
            formats.put(key, fmt);
        }
        return fmt.format(args);
    }
}