Apache Tomcat 6.0.53

org.apache.tomcat.util.res
Class StringManager

java.lang.Object
  extended by org.apache.tomcat.util.res.StringManager

public class StringManager
extends java.lang.Object

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.

The StringManager operates on a package basis. One StringManager per package can be created and accessed via the getManager method call.

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 class path.

Please see the documentation for java.util.ResourceBundle for more information.

Author:
James Duncan Davidson [duncan@eng.sun.com], James Todd [gonzo@eng.sun.com], Mel Martinez [mmartinez@g1440.com]
See Also:
ResourceBundle

Method Summary
 java.util.Locale getLocale()
          Identify the Locale this StringManager is associated with.
static StringManager getManager(java.lang.Class<?> clazz)
          Get the StringManager for a given class.
static StringManager getManager(java.util.ResourceBundle bundle)
          Deprecated. This is unused in Tomcat 6 and will be removed in Tomcat 7
static StringManager getManager(java.lang.String packageName)
          Get the StringManager for a particular package.
static StringManager getManager(java.lang.String packageName, java.util.Enumeration<java.util.Locale> requestedLocales)
          Retrieve the StringManager for a list of Locales.
static StringManager getManager(java.lang.String packageName, java.util.Locale locale)
          Get the StringManager for a particular package and Locale.
 java.lang.String getString(java.lang.String key)
          Get a string from the underlying resource bundle or return null if the String is not found.
 java.lang.String getString(java.lang.String key, java.lang.Object... args)
          Get a string from the underlying resource bundle and format it with the given set of arguments.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getString

public java.lang.String getString(java.lang.String key)
Get a string from the underlying resource bundle or return null if the String is not found.

Parameters:
key - to desired resource String
Returns:
resource String matching key from underlying bundle or null if not found.
Throws:
java.lang.IllegalArgumentException - if key is null

getString

public java.lang.String getString(java.lang.String key,
                                  java.lang.Object... args)
Get a string from the underlying resource bundle and format it with the given set of arguments.

Parameters:
key - The key for the required message
args - The values to insert into the message
Returns:
The request string formatted with the provided arguments or the key if the key was not found.

getLocale

public java.util.Locale getLocale()
Identify the Locale this StringManager is associated with.

Returns:
The Locale associated with the StringManager

getManager

public static final StringManager getManager(java.lang.Class<?> clazz)
Get the StringManager for a given class. The StringManager will be returned for the package in which the class is located. If a manager for that package already exists, it will be reused, else a new StringManager will be created and returned.

Parameters:
clazz - The class for which to retrieve the StringManager
Returns:
The instance associated with the package of the provide class

getManager

public static final StringManager getManager(java.lang.String packageName)
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.

Parameters:
packageName - The package name
Returns:
The instance associated with the given package and the default Locale

getManager

public static final StringManager getManager(java.lang.String packageName,
                                             java.util.Locale locale)
Get the StringManager for a particular package and Locale. If a manager for a package/Locale combination already exists, it will be reused, else a new StringManager will be created and returned.

Parameters:
packageName - The package name
locale - The Locale
Returns:
The instance associated with the given package and Locale

getManager

public static StringManager getManager(java.lang.String packageName,
                                       java.util.Enumeration<java.util.Locale> requestedLocales)
Retrieve the StringManager for a list of Locales. The first StringManager found will be returned.

Parameters:
packageName - The package for which the StringManager was requested
requestedLocales - the list of Locales
Returns:
the found StringManager or the default StringManager

getManager

@Deprecated
public static final StringManager getManager(java.util.ResourceBundle bundle)
Deprecated. This is unused in Tomcat 6 and will be removed in Tomcat 7

Always returns null.

Parameters:
bundle - The resource bundle
Returns:
Always null

Apache Tomcat 6.0.53

Copyright © 2000-2017 Apache Software Foundation. All Rights Reserved.