| /* |
| * Copyright (c) 1997-2018 Oracle and/or its affiliates. All rights reserved. |
| * Copyright 2004 The Apache Software Foundation |
| * |
| * 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. |
| */ |
| |
| package org.apache.catalina.util; |
| |
| import java.text.MessageFormat; |
| import java.util.*; |
| |
| /** |
| * An internationalization / localization helper class which reduces |
| * the bother of handling ResourceBundles and takes care of the |
| * common cases of message formating which otherwise require the |
| * creation of Object arrays and such. |
| * |
| * <p>The StringManager operates on a package basis. One StringManager |
| * per package can be created and accessed via the getManager method |
| * call. |
| * |
| * <p>The StringManager will look for a ResourceBundle named by |
| * the package name given plus the suffix of "LocalStrings". In |
| * practice, this means that the localized information will be contained |
| * in a LocalStrings.properties file located in the package |
| * directory of the classpath. |
| * |
| * <p>Please see the documentation for java.util.ResourceBundle for |
| * more information. |
| * |
| * @author James Duncan Davidson [duncan@eng.sun.com] |
| * @author James Todd [gonzo@eng.sun.com] |
| */ |
| |
| public class StringManager { |
| // START SJSAS 6412710 |
| private final HashMap<Locale, ResourceBundle> bundles = |
| new HashMap<Locale, ResourceBundle>(5); |
| private String bundleName = null; |
| // END SJSAS 6412710 |
| |
| |
| /** |
| * Creates a new StringManager for a given package. This is a |
| * private method and all access to it is arbitrated by the |
| * static getManager method call so that only one StringManager |
| * per package will be created. |
| * |
| * @param packageName Name of package to create StringManager for. |
| */ |
| |
| private StringManager(String packageName) { |
| /* 6412710 |
| String bundleName = packageName + ".LocalStrings"; |
| */ |
| // START SJSAS 6412710 |
| this.bundleName = packageName + ".LocalStrings"; |
| // END SJSAS 6412710 |
| /* SJSAS 6412710 |
| try { |
| */ |
| /* SJSAS 6412710 |
| } catch( MissingResourceException ex ) { |
| // Try from the current loader ( that's the case for trusted apps ) |
| ClassLoader cl=Thread.currentThread().getContextClassLoader(); |
| if( cl != null ) { |
| try { |
| bundle=ResourceBundle.getBundle(bundleName, Locale.getDefault(), cl); |
| return; |
| } catch(MissingResourceException ex2) { |
| } |
| } |
| if( cl==null ) |
| cl=this.getClass().getClassLoader(); |
| |
| if (log.isDebugEnabled()) |
| log.debug("Can't find resource " + bundleName + |
| " " + cl); |
| if( cl instanceof URLClassLoader ) { |
| if (log.isDebugEnabled()) |
| log.debug( ((URLClassLoader)cl).getURLs()); |
| } |
| } |
| */ |
| } |
| |
| |
| /** |
| * Get a string from the underlying resource bundle. |
| * |
| * @param key |
| */ |
| public String getString(String key) { |
| /* SJSAS 6412710 |
| return MessageFormat.format(getStringInternal(key),(Object[]) null); |
| */ |
| // START SJSAS 6412710 |
| return getString(key, Locale.getDefault()); |
| // END SJSAS 6412710 |
| } |
| |
| // START SJSAS 6412710 |
| public String getString(String key, Locale locale) { |
| return MessageFormat.format(getStringInternal(key, locale), |
| (Object[]) null); |
| } |
| // END SJSAS 6412710 |
| |
| |
| protected String getStringInternal(String key) { |
| // START SJSAS 6412710 |
| return getStringInternal(key, Locale.getDefault()); |
| } |
| |
| protected String getStringInternal(String key, Locale locale) { |
| // END SJSAS 6412710 |
| if (key == null) { |
| String msg = "key is null"; |
| |
| throw new NullPointerException(msg); |
| } |
| |
| // START SJSAS 6412710 |
| ResourceBundle bundle = bundles.get(locale); |
| if (bundle == null) { |
| synchronized (bundles) { |
| bundle = bundles.get(locale); |
| if (bundle == null) { |
| bundle = ResourceBundle.getBundle(this.bundleName, locale, this.getClass().getClassLoader()); |
| bundles.put(locale, bundle); |
| } |
| } |
| } |
| // END SJSAS 6412710 |
| |
| if( bundle==null ) |
| return key; |
| |
| try { |
| return bundle.getString(key); |
| } catch (MissingResourceException mre) { |
| return "Cannot find message associated with key '" + key + "'"; |
| } |
| } |
| |
| /** |
| * Get a string from the underlying resource bundle and format |
| * it with the given set of arguments. |
| * |
| * @param key |
| * @param args |
| */ |
| |
| public String getString(String key, Object[] args) { |
| // START SJSAS 6412710 |
| return getString(key, args, Locale.getDefault()); |
| } |
| |
| public String getString(String key, Object[] args, Locale locale) { |
| // END SJSAS 6412710 |
| String iString = null; |
| /* 6412710 |
| String value = getStringInternal(key); |
| */ |
| // START SJSAS 6412710 |
| String value = getStringInternal(key, locale); |
| // END SJSAS 6412710 |
| |
| // this check for the runtime exception is some pre 1.1.6 |
| // VM's don't do an automatic toString() on the passed in |
| // objects and barf out |
| |
| try { |
| // ensure the arguments are not null so pre 1.2 VM's don't barf |
| Object nonNullArgs[] = args; |
| for (int i=0; i<args.length; i++) { |
| if (args[i] == null) { |
| if (nonNullArgs==args) nonNullArgs=(Object[])args.clone(); |
| nonNullArgs[i] = "null"; |
| } |
| } |
| |
| iString = MessageFormat.format(value, nonNullArgs); |
| } catch (IllegalArgumentException iae) { |
| StringBuilder buf = new StringBuilder(); |
| buf.append(value); |
| for (int i = 0; i < args.length; i++) { |
| buf.append(" arg[" + i + "]=" + args[i]); |
| } |
| iString = buf.toString(); |
| } |
| return iString; |
| } |
| |
| /** |
| * Get a string from the underlying resource bundle and format it |
| * with the given object argument. This argument can of course be |
| * a String object. |
| * |
| * @param key |
| * @param arg |
| */ |
| |
| public String getString(String key, Object arg) { |
| /* SJSAS 6412710 |
| Object[] args = new Object[] {arg}; |
| return getString(key, args); |
| */ |
| // START SJSAS 6412710 |
| return getString(key, arg, Locale.getDefault()); |
| // END SJSAS 6412710 |
| } |
| |
| // START SJSAS 6412710 |
| public String getString(String key, Object arg, Locale locale) { |
| Object[] args = new Object[] {arg}; |
| return getString(key, args, locale); |
| } |
| // END SJSAS 6412710 |
| |
| /** |
| * Get a string from the underlying resource bundle and format it |
| * with the given object arguments. These arguments can of course |
| * be String objects. |
| * |
| * @param key |
| * @param arg1 |
| * @param arg2 |
| */ |
| |
| public String getString(String key, Object arg1, Object arg2) { |
| /* SJSAS 6412710 |
| Object[] args = new Object[] {arg1, arg2}; |
| return getString(key, args); |
| */ |
| // START SJSAS 6412710 |
| return getString(key, arg1, arg2, Locale.getDefault()); |
| // END SJSAS 6412710 |
| } |
| |
| // START SJSAS 6412710 |
| public String getString(String key, Object arg1, Object arg2, |
| Locale locale) { |
| Object[] args = new Object[] {arg1, arg2}; |
| return getString(key, args, locale); |
| } |
| // END SJSAS 6412710 |
| |
| /** |
| * Get a string from the underlying resource bundle and format it |
| * with the given object arguments. These arguments can of course |
| * be String objects. |
| * |
| * @param key |
| * @param arg1 |
| * @param arg2 |
| * @param arg3 |
| */ |
| |
| public String getString(String key, Object arg1, Object arg2, |
| Object arg3) { |
| /* SJSAS 6412710 |
| Object[] args = new Object[] {arg1, arg2, arg3}; |
| return getString(key, args); |
| */ |
| // START SJSAS 6412710 |
| return getString(key, arg1, arg2, arg3, Locale.getDefault()); |
| // END SJSAS 6412710 |
| } |
| |
| // START SJSAS 6412710 |
| public String getString(String key, Object arg1, Object arg2, |
| Object arg3, Locale locale) { |
| Object[] args = new Object[] {arg1, arg2, arg3}; |
| return getString(key, args, locale); |
| } |
| // END SJSAS 6412710 |
| |
| /** |
| * Get a string from the underlying resource bundle and format it |
| * with the given object arguments. These arguments can of course |
| * be String objects. |
| * |
| * @param key |
| * @param arg1 |
| * @param arg2 |
| * @param arg3 |
| * @param arg4 |
| */ |
| |
| public String getString(String key, Object arg1, Object arg2, |
| Object arg3, Object arg4) { |
| /* SJSAS 6412710 |
| Object[] args = new Object[] {arg1, arg2, arg3, arg4}; |
| return getString(key, args); |
| */ |
| // START SJSAS 6412710 |
| return getString(key, arg1, arg2, arg3, arg4, Locale.getDefault()); |
| // END SJSAS 6412710 |
| } |
| |
| // START SJSAS 6412710 |
| public String getString(String key, Object arg1, Object arg2, |
| Object arg3, Object arg4, Locale locale) { |
| Object[] args = new Object[] {arg1, arg2, arg3, arg4}; |
| return getString(key, args, locale); |
| } |
| // END SJSAS 6412710 |
| |
| // START SJSAS 6412710 |
| /** |
| * Returns the locale of the resource bundle for the given request locale. |
| */ |
| public Locale getResourceBundleLocale(Locale requestLocale) { |
| ResourceBundle bundle = bundles.get(requestLocale); |
| if (bundle == null) { |
| synchronized (bundles) { |
| bundle = bundles.get(requestLocale); |
| if (bundle == null) { |
| bundle = ResourceBundle.getBundle(this.bundleName, |
| requestLocale); |
| bundles.put(requestLocale, bundle); |
| } |
| } |
| } |
| return bundle.getLocale(); |
| } |
| // END SJSAS 6412710 |
| |
| // -------------------------------------------------------------- |
| // STATIC SUPPORT METHODS |
| // -------------------------------------------------------------- |
| |
| private static Hashtable<String, StringManager> managers = |
| new Hashtable<String, StringManager>(); |
| |
| /** |
| * Get the StringManager for a particular package. If a manager for |
| * a package already exists, it will be reused, else a new |
| * StringManager will be created and returned. |
| * |
| * @param packageName |
| */ |
| |
| public synchronized static StringManager getManager(String packageName) { |
| StringManager mgr = managers.get(packageName); |
| |
| if (mgr == null) { |
| mgr = new StringManager(packageName); |
| managers.put(packageName, mgr); |
| } |
| return mgr; |
| } |
| } |