RASMessageCatalog (IBM WebSphere Application Server, Release 8.5)

java.lang.Object
- com.ibm.ras.RASMessageCatalog

Deprecated.
As of WAS 6.0, recommend using java.util.logging
```
public class RASMessageCatalog
extends java.lang.Object
```
RASMessageCatalog formats messages within the RAS system according to the current locale (that is, in the desired language). The text associated with any RAS message is kept in a java.util.ResourceBundle. Each message text is associated with a "key," which is, essentially, a name for the message text. RASMessageCatalog formats the message text using a java.text.MessageFormat object. One way to define the messages is through a PropertyResourceBundle file, backed up by a Properties file. Here is a sample:
```
 # {0} is the name of a file.                                            
 # {1} is the detailed message created when the file creation error      
 #     occurred                                                          
                                                                          
 ERR_FILE_WRITER=Unable to create a FileWriter for {0}:  {1}
                                                                          
 # {0} is a text string naming the missing message key.                  
                                                                          
 ERR_MISSING_KEY=Message key {0} was not found in any searched catalog.
                                                                          
 ERR_SOCKET=Unable to connect to the RAS Log Server.
 
```
To create a message catalog, pass it the base name of the resource bundle. For example, if your base file was com.ibm.ras.RASMsgs.properties you would code:
```
 RASMessageCatalog msgCat = new RASMessageCatalog("com.ibm.ras.RASMsgs");
 
```
Use the RASMessageCatalog.getMessage methods to retrieve the message text in the desired locale. Java will look for the proper translation of this file according to the supplied or default locale. For example, it might first search for RASMsgs_en_GB.properties, then RASMsgs_en.properties and, finally RASMsgs.properties.
RASMessageCatalog provides a debug mode, which makes it easy to determine if messages are retrieved from locale-specific resource bundles. When debug mode is enabled through setDebug, messages returned from a RASMessageCatalog are enclosed in square brackets ("[ ]").
By default, debug mode is disabled. In addition to setDebug, the debug mode may be altered by creating a file, RASMessageCatalog/catalog.properties and placing it in the root of any directory in your Java CLASSPATH. For applets, it may also be placed in a JAR or CAB file. To enable debug mode, this properties file must contain the property debug=true. The property debug=false will disable debug mode.
When used as part of the RAS Toolkit, it is not necessary for an application to create a RASMessageCatalog. If national language support is required elsewhere, RASMessageCatalog provides many useful features.

Constructor Summary

Constructors
Constructor and Description
`RASMessageCatalog(java.util.ResourceBundle bundle)` Deprecated. Creates a `RASMessageCatalog`.
`RASMessageCatalog(java.util.ResourceBundle bundle, java.util.Locale loc)` Deprecated. Creates a `RASMessageCatalog`.
`RASMessageCatalog(java.lang.String baseName)` Deprecated. Creates a `RASMessageCatalog` using the default locale.
`RASMessageCatalog(java.lang.String baseName, java.util.Locale loc)` Deprecated. Creates a `RASMessageCatalog`.

Method Summary

Methods
Modifier and Type	Method and Description
`char`	`getChar(java.lang.String key)` Deprecated. Gets the first character of a message.
`java.util.Locale`	`getLocale()` Deprecated. Gets the locale used by the `RASMessageCatalog`.
`java.lang.String`	`getMessage(java.lang.String key)` Deprecated. Gets a message with no inserts from the catalog.
`java.lang.String`	`getMessage(java.lang.String key, java.lang.Object insert1)` Deprecated. Gets a message with one insert from the catalog.
`java.lang.String`	`getMessage(java.lang.String key, java.lang.Object[] inserts)` Deprecated. Gets a message with an array of inserts from the catalog.
`java.lang.String`	`getMessage(java.lang.String key, java.lang.Object insert1, java.lang.Object insert2)` Deprecated. Gets a message with two inserts from the catalog.
`java.lang.String`	`getMsg(java.lang.String key, java.lang.Object[] inserts)` Deprecated. Gets a message with an array of inserts from the catalog.
`boolean`	`isDebug()` Deprecated. Determines if the `RASMessageCatalog` is in debug mode.
`void`	`setDebug(boolean flag)` Deprecated. Sets the `RASMessageCatalog` debug mode.
`void`	`setLocale(java.util.Locale loc)` Deprecated. Sets the locale to be used by the `RASMessageCatalog`.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - RASMessageCatalog
```
public RASMessageCatalog(java.lang.String baseName)
                  throws java.util.MissingResourceException
```
    Deprecated.
    
    Creates a RASMessageCatalog using the default locale.
    
    Parameters:
    baseName - The base name of the ResourceBundle which contains the messages.
    
    Throws:
    
    java.util.MissingResourceException - This exception is thrown if the ResourceBundle cannot be loaded.
  - RASMessageCatalog
```
public RASMessageCatalog(java.lang.String baseName,
                 java.util.Locale loc)
                  throws java.util.MissingResourceException
```
    Deprecated.
    
    Creates a RASMessageCatalog.
    
    Parameters:
    baseName - The base name of the ResourceBundle which contains the messages.
    loc - The locale with which the messages should be displayed.
    
    Throws:
    
    java.util.MissingResourceException - This exception is thrown if the ResourceBundle cannot be loaded.
  - RASMessageCatalog
```
public RASMessageCatalog(java.util.ResourceBundle bundle)
```
    Deprecated.
    
    Creates a RASMessageCatalog.
    
    Parameters:
    bundle - The ResourceBundle which contains the messages.
  - RASMessageCatalog
```
public RASMessageCatalog(java.util.ResourceBundle bundle,
                 java.util.Locale loc)
```
    Deprecated.
    
    Creates a RASMessageCatalog.
    Note: Use of this constructor may cause unexpected behavior if the locale of the ResourceBundle is not the same as the locale parameter.
    
    Parameters:
    bundle - The ResourceBundle which contains the messages.
    loc - The locale with which the messages should be displayed.
- Method Detail
  - getLocale
```
public java.util.Locale getLocale()
```
    Deprecated.
    
    Gets the locale used by the RASMessageCatalog.
    
    Returns:
    The message catalog locale. If a locale has not been set, the default Locale.getDefault is returned.
  - setLocale
```
public void setLocale(java.util.Locale loc)
```
    Deprecated.
    
    Sets the locale to be used by the RASMessageCatalog.
    Note: Use of this method may cause unexpected behavior if the RASMessageCatalog was created with one of the constructors that takes a ResourceBundle as a parameter. In this case, the RASMessageCatalog cannot recreate the ResourceBundle in the new locale.
    
    Parameters:
    loc - The new locale. If this locale is null, the current locale is not changed.
  - isDebug
```
public boolean isDebug()
```
    Deprecated.
    
    Determines if the RASMessageCatalog is in debug mode. In debug mode, messages retrieved via getMessage or getMsg are enclosed in brackets, "[This is a test]," for example. This makes it easy to identify those messages which do not come from locale-specific message bundles.
    By default, debug mode is disabled.
    
    Returns:
    true if debug mode is enabled, or false otherwise.
  - setDebug
```
public void setDebug(boolean flag)
```
    Deprecated.
    
    Sets the RASMessageCatalog debug mode. In debug mode, messages retrieved via getMessage or getMsg are enclosed in brackets, "[This is a test]," for example. This makes it easy to identify those messages which do not come from locale-specific message bundles.
    By default, debug mode is disabled.
    
    Parameters:
    flag - true to enable debug mode, or false otherwise.
  - getMessage
```
public java.lang.String getMessage(java.lang.String key)
                            throws java.util.MissingResourceException
```
    Deprecated.
    
    Gets a message with no inserts from the catalog.
    
    Parameters:
    key - The key name of this message.
    
    Returns:
    The formatted message from the catalog.
    
    Throws:
    
    java.util.MissingResourceException - This exception is thrown if a message with the given key cannot be found in the message catalog.
  - getMessage
```
public java.lang.String getMessage(java.lang.String key,
                          java.lang.Object insert1)
                            throws java.util.MissingResourceException
```
    Deprecated.
    
    Gets a message with one insert from the catalog.
    
    Parameters:
    key - The key name of this message.
    insert1 - An element to be inserted into the message.
    
    Returns:
    The formatted message from the catalog.
    
    Throws:
    
    java.util.MissingResourceException - This exception is thrown if a message with the given key cannot be found in the message catalog.
  - getMessage
```
public java.lang.String getMessage(java.lang.String key,
                          java.lang.Object insert1,
                          java.lang.Object insert2)
                            throws java.util.MissingResourceException
```
    Deprecated.
    
    Gets a message with two inserts from the catalog.
    
    Parameters:
    key - The key name of this message.
    insert1 - An element to be inserted into the message.
    insert2 - An element to be inserted into the message.
    
    Returns:
    The formatted message from the catalog.
    
    Throws:
    
    java.util.MissingResourceException - This exception is thrown if a message with the given key cannot be found in the message catalog.
  - getMessage
```
public java.lang.String getMessage(java.lang.String key,
                          java.lang.Object[] inserts)
                            throws java.util.MissingResourceException
```
    Deprecated.
    
    Gets a message with an array of inserts from the catalog.
    
    Parameters:
    key - The key name of this message.
    inserts - An array of elements to be inserted into the message.
    
    Returns:
    The formatted message from the catalog.
    
    Throws:
    
    java.util.MissingResourceException - This exception is thrown if a message with the given key cannot be found in the message catalog.
  - getMsg
```
public java.lang.String getMsg(java.lang.String key,
                      java.lang.Object[] inserts)
```
    Deprecated.
    
    Gets a message with an array of inserts from the catalog. This convenience method returns an error message if the requested key was not found in this catalog. No exception is thrown.
    
    Parameters:
    key - The key name of this message.
    inserts - An array of elements to be inserted into the message.
    
    Returns:
    The formatted message from the catalog.
  - getChar
```
public char getChar(java.lang.String key)
```
    Deprecated.
    Gets the first character of a message. This method is used to retrieve a character to be used as a mnemonic in a Swing user interface. (This is the underlined character which activates a button, for example, when you press Alt-character.)
    Typically, one would define two strings in a message file. For example:
```
 CANCEL=Cancel
 CANCEL_MNEMONIC=a
 
```
    The first string is the label to go on a button. The second is the mnemonic character. The method getMessage("CANCEL") will return the button label, while getChar("CANCEL_MNEMONIC") will return the mnemonic character.
    Parameters:
    key - The key name of the message.
    
    Returns:
    The mnemonic character.
    
    Throws:
    
    java.util.MissingResourceException - This exception is thrown if a message with the given key cannot be found in the message catalog.

Methods inherited from class java.lang.Object

RASMessageCatalog

RASMessageCatalog

RASMessageCatalog

RASMessageCatalog

getLocale

setLocale

isDebug

setDebug

getMessage

getMessage

getMessage

getMessage

getMsg

getChar