org.apache.openjpa.lib.util
Class Localizer

java.lang.Object
  extended by org.apache.openjpa.lib.util.Localizer

public class Localizer
extends java.lang.Object

The Localizer provides convenient access to localized strings. It inlcudes built-in support for parameter substitution through the use of the MessageFormat utility. Strings are stored in per-package Properties files. The property file for the default locale must be named localizer.properties. Additional locales can be supported through additional property files using the naming conventions specified in the ResourceBundle class. For example, the german locale could be supported through a localizer_de_DE.properties file.

Author:
Abe White

Constructor Summary
Localizer()
           
 
Method Summary
static void addProvider(org.apache.openjpa.lib.util.ResourceBundleProvider provider)
          Register a resource provider.
static Localizer forPackage(java.lang.Class cls)
          Return a Localizer instance that will access the properties file in the package of the given class using the system default locale.
static Localizer forPackage(java.lang.Class cls, java.util.Locale locale)
          Return a Localizer instance that will access the properties file in the package of the given class using the given locale.
 java.lang.String get(java.lang.String key)
          Return the localized string matching the given key.
 java.lang.String get(java.lang.String key, java.lang.Object sub)
          Return the localized string matching the given key.
 java.lang.String get(java.lang.String key, java.lang.Object[] subs)
          Return the localized string matching the given key.
 java.lang.String get(java.lang.String key, java.lang.Object sub1, java.lang.Object sub2)
          Return the localized string for the given key.
 java.lang.String get(java.lang.String key, java.lang.Object sub1, java.lang.Object sub2, java.lang.Object sub3)
          Return the localized string for the given key.
 java.lang.String getFatal(java.lang.String key)
          Return the localized string matching the given key.
 java.lang.String getFatal(java.lang.String key, java.lang.Object sub)
          Return the localized string matching the given key.
 java.lang.String getFatal(java.lang.String key, java.lang.Object[] subs)
          Return the localized string matching the given key.
 java.lang.String getFatal(java.lang.String key, java.lang.Object sub1, java.lang.Object sub2)
          Return the localized string for the given key.
static boolean removeProvider(org.apache.openjpa.lib.util.ResourceBundleProvider provider)
          Remove a resource provider.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Localizer

public Localizer()
Method Detail

forPackage

public static Localizer forPackage(java.lang.Class cls)
Return a Localizer instance that will access the properties file in the package of the given class using the system default locale.

See Also:
forPackage(Class,Locale)

forPackage

public static Localizer forPackage(java.lang.Class cls,
                                   java.util.Locale locale)
Return a Localizer instance that will access the properties file in the package of the given class using the given locale.

Parameters:
cls - the class whose package to check for the localized properties file; if null, the system will check for a top-level properties file
locale - the locale to which strings should be localized; if null, the system default will be assumed

addProvider

public static void addProvider(org.apache.openjpa.lib.util.ResourceBundleProvider provider)
Register a resource provider.


removeProvider

public static boolean removeProvider(org.apache.openjpa.lib.util.ResourceBundleProvider provider)
Remove a resource provider.


get

public java.lang.String get(java.lang.String key)
Return the localized string matching the given key.


getFatal

public java.lang.String getFatal(java.lang.String key)
Return the localized string matching the given key.


get

public java.lang.String get(java.lang.String key,
                            java.lang.Object sub)
Return the localized string matching the given key. The given sub object will be packed into an array and substituted into the found string according to the rules of the MessageFormat class.

See Also:
get(String)

getFatal

public java.lang.String getFatal(java.lang.String key,
                                 java.lang.Object sub)
Return the localized string matching the given key. The given sub object will be packed into an array and substituted into the found string according to the rules of the MessageFormat class.

See Also:
getFatal(String)

get

public java.lang.String get(java.lang.String key,
                            java.lang.Object sub1,
                            java.lang.Object sub2)
Return the localized string for the given key.

See Also:
get(String,Object)

getFatal

public java.lang.String getFatal(java.lang.String key,
                                 java.lang.Object sub1,
                                 java.lang.Object sub2)
Return the localized string for the given key.

See Also:
getFatal(String,Object)

get

public java.lang.String get(java.lang.String key,
                            java.lang.Object sub1,
                            java.lang.Object sub2,
                            java.lang.Object sub3)
Return the localized string for the given key.

See Also:
get(String,Object)

get

public java.lang.String get(java.lang.String key,
                            java.lang.Object[] subs)
Return the localized string matching the given key. The given subs objects will be substituted into the found string according to the rules of the MessageFormat class.

See Also:
get(String)

getFatal

public java.lang.String getFatal(java.lang.String key,
                                 java.lang.Object[] subs)
Return the localized string matching the given key. The given subs objects will be substituted into the found string according to the rules of the MessageFormat class.

See Also:
getFatal(String)


Copyright © 2006 Apache Software Foundation. All Rights Reserved.