oracle.i18n.util
Class OraResourceBundle

java.lang.Object
  |
  +--oracle.i18n.util.OraResourceBundle

public class OraResourceBundle

extends Object

OraResourceBundle is the factory class that constructs a java.util.ResourceBundle.

It provides the special locale fallback behaviors on the top of Java's. Here are the rules:

• If the given locale exactly matches that in the available resource bundles, it will be used.
• If the resource bundle for Chinese in Singapore (zh_SG) is not found, it will fallback to that for Chinese in China (zh_CN) for Simplified Chinese translations.
• If the resource bundle for Chinese in Hong Kong (zh_HK) is not found, it will fallback to that for Chinese in Taiwan (zh_TW) for Traditional Chinese translations.
• If the resource bundle for Chinese in Macau (zh_MO) is not found, it will fallback to that for Chinese in Taiwan (zh_TW) for Traditional Chinese translations.
• If the resource bundles for any other Chinese locale(zh_* and zh) is not found, it will fallback to that for Chinese in China (zh_CN) for Simplified Chinese translations.
• The default Locale, which can be obtained by Locale.getDefault(), will not be considered in the fallback operations.

For example, when the resource bundle for es_MX is requested, assuming default locale is ja_JP, the resource bundle for ja_JP is available, neither resource bundle for es or es_MX is provided, it will return the resource bundle object that doesn't have any locale suffix.

The usage of OraResourceBundle is similar to java.util.ResourceBundle but OraResourceBundle will not be instantiated by itself; instead, the return value of getBundle is an instance of subclass of java.util.ResourceBundle. Here is an example to get the instance of the bundle:

 import java.util.ResourceBundle;
 import oracle.i18n.util.OraResourceBundle;
 ...
 ResourceBundle resb = OraResourceBundle.getBundle(
   "oracle.demo.wob.Translations", request.getLocale());
 ...
 String resb = resb.getString("hello");
 ...

Since:

10.1.0.2

getBundle

public static ResourceBundle getBundle(String baseName,
Locale locale,
ClassLoader classLoader)

Returns a ResourceBundle object specified by the base class name. A Locale should be specified to get the translations. The class loader can be specified if necessary.

Parameters:

baseName - a base name of ResourceBundle class

locale - a Locale used to specify the translation language.

classLoader - a ClassLoader object used to load the ResourceBundle class.

Returns:

A ResourceBundle object.

getBundle

public static ResourceBundle getBundle(String baseName,
Locale locale)

Returns a ResourceBundle object specified by the base class name. A Locale should be specified to get the translations.

Parameters:

baseName - a base name of ResourceBundle class

locale - a Locale used to specify the translation language.

Returns:

A ResourceBundle object.

getBundle

public static ResourceBundle getBundle(String baseName)

Returns a ResourceBundle object derived from the given base class name. By default, the translation is in English.

Parameters:

baseName - a base name of ResourceBundle class

Returns:

A ResourceBundle object.