net.sf.mmm.util.nls.api

Interface NlsResourceBundleRequestor

All Known Implementing Classes:

DefaultNlsResourceBundleRequestor

@ComponentSpecification
public interface NlsResourceBundleRequestor

This is the interface of a component to request NlsResourceBundles. In regular contexts there is no need in requesting resource bundles and all methods of this component will have no effect. However, on special client-environments like GWT you may need to request them explicitly if you do NOT use NlsBundle and want to make use of code-splitting and lazy loading.

Since:

3.1.0

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

See Also:

NlsMessageFactory.createDirect(String, String, java.util.Map)

Method Summary

Modifier and Type	Method and Description
void	requestBundlesAsynchron(Runnable callback, String... bundleNames) This method requests a number of ResourceBundles by their base-name.

Method Detail

requestBundlesAsynchron

void requestBundlesAsynchron(Runnable callback,
                             String... bundleNames)

This method requests a number of ResourceBundles by their base-name. In a GWT environment this will cause that these ResourceBundle are loaded from the server (if not already available) in the Locale of the user so they are available for dictionaries. After the last bundle has been loaded the given callback will be invoked. In other environments this method will do nothing but synchronously invoking the callback.

Parameters:

callback - is the Runnable that is called when all bundles are loaded and available.

bundleNames - are the base-names of the requested ResourceBundles.