ResourceBundle Inheritance

Dynamo uses the Java ResourceBundle inheritance rules. According to Java specifications, all internationalized ResourceBundles belong to a family of ResourceBundle subclasses that share the same basename. The following steps are followed to determine which ResourceBundle.properties file to instantiate.

  1. The getBundle method first looks for a class name that matches the request locale’s basename, language, country, and variant. For example, if the desired class is DynamoBundle_fr_FR_Unix, it first looks for this class.

    If no class is found with the specified language, country, and variant arguments, it proceeds to step 2.

  2. The getBundle method looks for a class that matches the request locale’s basename, language, and country, such as DynamoBundle_fr_FR.

    If no class is found with the specified language and country arguments, it proceeds to step 3.

  3. The getBundle method looks for a class with a name that matches the request locale’s basename and language, such as DynamoBundle_fr.

    If no class is found with the specified language argument, it proceeds to step 4.

  4. The getBundle method then goes through steps 1-3 for the default locale, instead of the request locale. For example, if the default locale is en_US_UNIX, it would look for a class name in the following order:

    DynamoBundle_en_US_UNIX
    DynamoBundle_en_US
    DynamoBundle_en

    If no class is found for the default locale, it proceeds to step 5.

  5. The getBundle method looks for a class with a name of the following format: basename, such as DynamoBundle. This class is used as a default ResourceBundle that can be used by any locale that is not supported by the Web site.

    If no class is found for the specified basename, a Java MissingResourceException is thrown.

 
loading table of contents...