aoqi@0: /* aoqi@0: * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. aoqi@0: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. aoqi@0: * aoqi@0: * This code is free software; you can redistribute it and/or modify it aoqi@0: * under the terms of the GNU General Public License version 2 only, as aoqi@0: * published by the Free Software Foundation. Oracle designates this aoqi@0: * particular file as subject to the "Classpath" exception as provided aoqi@0: * by Oracle in the LICENSE file that accompanied this code. aoqi@0: * aoqi@0: * This code is distributed in the hope that it will be useful, but WITHOUT aoqi@0: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or aoqi@0: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License aoqi@0: * version 2 for more details (a copy is included in the LICENSE file that aoqi@0: * accompanied this code). aoqi@0: * aoqi@0: * You should have received a copy of the GNU General Public License version aoqi@0: * 2 along with this work; if not, write to the Free Software Foundation, aoqi@0: * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. aoqi@0: * aoqi@0: * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA aoqi@0: * or visit www.oracle.com if you need additional information or have any aoqi@0: * questions. aoqi@0: */ aoqi@0: aoqi@0: package com.sun.tools.javac.util; aoqi@0: aoqi@0: import com.sun.tools.javac.api.Messages; aoqi@0: import java.lang.ref.SoftReference; aoqi@0: import java.util.ResourceBundle; aoqi@0: import java.util.MissingResourceException; aoqi@0: import java.text.MessageFormat; aoqi@0: import java.util.HashMap; aoqi@0: import java.util.Locale; aoqi@0: import java.util.Map; aoqi@0: aoqi@0: /** aoqi@0: * Support for formatted localized messages. aoqi@0: * aoqi@0: *

This is NOT part of any supported API. aoqi@0: * If you write code that depends on this, you do so at your own risk. aoqi@0: * This code and its internal interfaces are subject to change or aoqi@0: * deletion without notice. aoqi@0: */ aoqi@0: public class JavacMessages implements Messages { aoqi@0: /** The context key for the JavacMessages object. */ aoqi@0: public static final Context.Key messagesKey = aoqi@0: new Context.Key(); aoqi@0: aoqi@0: /** Get the JavacMessages instance for this context. */ aoqi@0: public static JavacMessages instance(Context context) { aoqi@0: JavacMessages instance = context.get(messagesKey); aoqi@0: if (instance == null) aoqi@0: instance = new JavacMessages(context); aoqi@0: return instance; aoqi@0: } aoqi@0: aoqi@0: private Map>> bundleCache; aoqi@0: aoqi@0: private List bundleNames; aoqi@0: aoqi@0: private Locale currentLocale; aoqi@0: private List currentBundles; aoqi@0: aoqi@0: public Locale getCurrentLocale() { aoqi@0: return currentLocale; aoqi@0: } aoqi@0: aoqi@0: public void setCurrentLocale(Locale locale) { aoqi@0: if (locale == null) { aoqi@0: locale = Locale.getDefault(); aoqi@0: } aoqi@0: this.currentBundles = getBundles(locale); aoqi@0: this.currentLocale = locale; aoqi@0: } aoqi@0: aoqi@0: /** Creates a JavacMessages object. aoqi@0: */ aoqi@0: public JavacMessages(Context context) { aoqi@0: this(defaultBundleName, context.get(Locale.class)); aoqi@0: context.put(messagesKey, this); aoqi@0: } aoqi@0: aoqi@0: /** Creates a JavacMessages object. aoqi@0: * @param bundleName the name to identify the resource bundle of localized messages. aoqi@0: */ aoqi@0: public JavacMessages(String bundleName) throws MissingResourceException { aoqi@0: this(bundleName, null); aoqi@0: } aoqi@0: aoqi@0: /** Creates a JavacMessages object. aoqi@0: * @param bundleName the name to identify the resource bundle of localized messages. aoqi@0: */ aoqi@0: public JavacMessages(String bundleName, Locale locale) throws MissingResourceException { aoqi@0: bundleNames = List.nil(); aoqi@0: bundleCache = new HashMap>>(); aoqi@0: add(bundleName); aoqi@0: setCurrentLocale(locale); aoqi@0: } aoqi@0: aoqi@0: public JavacMessages() throws MissingResourceException { aoqi@0: this(defaultBundleName); aoqi@0: } aoqi@0: aoqi@0: public void add(String bundleName) throws MissingResourceException { aoqi@0: bundleNames = bundleNames.prepend(bundleName); aoqi@0: if (!bundleCache.isEmpty()) aoqi@0: bundleCache.clear(); aoqi@0: currentBundles = null; aoqi@0: } aoqi@0: aoqi@0: public List getBundles(Locale locale) { aoqi@0: if (locale == currentLocale && currentBundles != null) aoqi@0: return currentBundles; aoqi@0: SoftReference> bundles = bundleCache.get(locale); aoqi@0: List bundleList = bundles == null ? null : bundles.get(); aoqi@0: if (bundleList == null) { aoqi@0: bundleList = List.nil(); aoqi@0: for (String bundleName : bundleNames) { aoqi@0: try { aoqi@0: ResourceBundle rb = ResourceBundle.getBundle(bundleName, locale); aoqi@0: bundleList = bundleList.prepend(rb); aoqi@0: } catch (MissingResourceException e) { aoqi@0: throw new InternalError("Cannot find javac resource bundle for locale " + locale); aoqi@0: } aoqi@0: } aoqi@0: bundleCache.put(locale, new SoftReference>(bundleList)); aoqi@0: } aoqi@0: return bundleList; aoqi@0: } aoqi@0: aoqi@0: /** Gets the localized string corresponding to a key, formatted with a set of args. aoqi@0: */ aoqi@0: public String getLocalizedString(String key, Object... args) { aoqi@0: return getLocalizedString(currentLocale, key, args); aoqi@0: } aoqi@0: aoqi@0: public String getLocalizedString(Locale l, String key, Object... args) { aoqi@0: if (l == null) aoqi@0: l = getCurrentLocale(); aoqi@0: return getLocalizedString(getBundles(l), key, args); aoqi@0: } aoqi@0: aoqi@0: /* Static access: aoqi@0: * javac has a firmly entrenched notion of a default message bundle aoqi@0: * which it can access from any static context. This is used to get aoqi@0: * easy access to simple localized strings. aoqi@0: */ aoqi@0: aoqi@0: private static final String defaultBundleName = aoqi@0: "com.sun.tools.javac.resources.compiler"; aoqi@0: private static ResourceBundle defaultBundle; aoqi@0: private static JavacMessages defaultMessages; aoqi@0: aoqi@0: aoqi@0: /** aoqi@0: * Gets a localized string from the compiler's default bundle. aoqi@0: */ aoqi@0: // used to support legacy Log.getLocalizedString aoqi@0: static String getDefaultLocalizedString(String key, Object... args) { aoqi@0: return getLocalizedString(List.of(getDefaultBundle()), key, args); aoqi@0: } aoqi@0: aoqi@0: // used to support legacy static Diagnostic.fragment aoqi@0: @Deprecated aoqi@0: static JavacMessages getDefaultMessages() { aoqi@0: if (defaultMessages == null) aoqi@0: defaultMessages = new JavacMessages(defaultBundleName); aoqi@0: return defaultMessages; aoqi@0: } aoqi@0: aoqi@0: public static ResourceBundle getDefaultBundle() { aoqi@0: try { aoqi@0: if (defaultBundle == null) aoqi@0: defaultBundle = ResourceBundle.getBundle(defaultBundleName); aoqi@0: return defaultBundle; aoqi@0: } aoqi@0: catch (MissingResourceException e) { aoqi@0: throw new Error("Fatal: Resource for compiler is missing", e); aoqi@0: } aoqi@0: } aoqi@0: aoqi@0: private static String getLocalizedString(List bundles, aoqi@0: String key, aoqi@0: Object... args) { aoqi@0: String msg = null; aoqi@0: for (List l = bundles; l.nonEmpty() && msg == null; l = l.tail) { aoqi@0: ResourceBundle rb = l.head; aoqi@0: try { aoqi@0: msg = rb.getString(key); aoqi@0: } aoqi@0: catch (MissingResourceException e) { aoqi@0: // ignore, try other bundles in list aoqi@0: } aoqi@0: } aoqi@0: if (msg == null) { aoqi@0: msg = "compiler message file broken: key=" + key + aoqi@0: " arguments={0}, {1}, {2}, {3}, {4}, {5}, {6}, {7}"; aoqi@0: } aoqi@0: return MessageFormat.format(msg, args); aoqi@0: } aoqi@0: }