org.apache.commons.i18n
Class ResourceBundleMessageProvider

java.lang.Object
  extended by org.apache.commons.i18n.ResourceBundleMessageProvider
All Implemented Interfaces:
MessageProvider

public class ResourceBundleMessageProvider
extends java.lang.Object
implements MessageProvider

The ResourceBundleMessageProvider deals with messages defined in resource bundles. Messages defined in resource bundles can be grouped together by adding the entry key at the end of the message key separated by a dot.


Constructor Summary
ResourceBundleMessageProvider(java.lang.String baseName)
           
 
Method Summary
 java.util.Map getEntries(java.lang.String id, java.util.Locale locale)
           
 java.lang.String getText(java.lang.String id, java.lang.String entry, java.util.Locale locale)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ResourceBundleMessageProvider

public ResourceBundleMessageProvider(java.lang.String baseName)
                              throws MessageNotFoundException
Throws:
MessageNotFoundException - Thrown if the resource bundle does not exist.
Method Detail

getText

public java.lang.String getText(java.lang.String id,
                                java.lang.String entry,
                                java.util.Locale locale)
                         throws MessageNotFoundException
Specified by:
getText in interface MessageProvider
Parameters:
id - unique id that specifies a particular message
entry - specifies a particular entry in the specified message
locale - the locale for which this text should be provided
Returns:
returns the localized message entry matching the given message id, entry key and locale. If no match is found for the given locale, the parent locale is used, and finally the default. If the id is found but the entry is not, null is returned.
Throws:
MessageNotFoundException - thrown if no message exists matching the given id

getEntries

public java.util.Map getEntries(java.lang.String id,
                                java.util.Locale locale)
Specified by:
getEntries in interface MessageProvider
Parameters:
id - unique id that specifies a particular message
locale - the locale for which to return the entries
Returns:
returns a map <entry(String) -> localized text(String) of message entries matching the given message id and locale


Copyright 2004-2008 The Apache Software Foundation. All Rights Reserved.