4 Creating a Message Bundle

Oracle recommends that you define all of the text strings that your Administration Console extension displays in a message bundle. A message bundle is a collection of text files (properties files) that contain key-value pairs (properties). You create one properties file for each language or locale that you want to support. If you name the properties file per a set of file-naming conventions, the Administration Console displays strings from the properties file whose locale matches the Web browser's locale setting.

To create a message bundle:

1. Create a text file that contains name-value pairs for each string you want to display. Use the equal sign (=) as the delimiter between the name and value, and place each property on its own line.

   For example:

   myextension.myTab.introduction=This page provides monitoring data for 
   my application.
   myextension.myTab.TotalServletHits.label=Total hits for my servlet.
   

2. Save the file as root-dir/WEB-INF/classes/bundle.properties where

   • root-dir is the root directory of your extension

   • bundle is a unique value (do not use global, which is the name of a WebLogic Server bundle). Consider using your company name as the value for bundle.

   The bundle.properties file is the default file that the Administration Console uses if the Web browser or the JVM have not specified a locale. It is a required file.

3. Save each localized version of the properties file as root-dir/WEB-INF/classes/bundle_locale.properties.

   where locale is a locale code supported by java.util.Locale. See Locale in the Java SE API Specification, at http://download.oracle.com/javase/1.5.0/docs/api/java/util/Locale.html.

   For example, mycompany_ja.properties.

For information about using message bundles, see Use a Message Bundle for Your Look and Feel and Create and Use a Message Bundle in Your JSPs.