wicket.resource
Interface IStringResourceLoader

All Known Implementing Classes:

ApplicationStringResourceLoader, BundleStringResourceLoader, ComponentStringResourceLoader

public interface IStringResourceLoader

The string resource loader interface allows a strategy pattern to be applied to the loading of resource strings for an application. The loader (or chain of loaders) that are used is configured via the ApplicationSettings class.

Each particular implementation of this interface may define its own mechanism for searching for resources. Please see the documents for each particular implementation to determine this behaviour and to see how it can be configured.

It is important to note that if a resource is not found by a particular loader then the loader should return null rather than throw an exception. The reason for this is that loaders can be arranged in a chain and it would be very inefficient for loaders earlier in the chain to throw exceptions that must be caught and handled each time until the correct loader in the chain is reached.

Author:

Chris Turner

See Also:

ApplicationSettings

Method Summary

java.lang.String

loadStringResource(Component component, java.lang.String key, java.util.Locale locale, java.lang.String style) Get the string resource for the given combination of component class, resource key, locale and style.

Method Detail

loadStringResource

public java.lang.String loadStringResource(Component component,
                                           java.lang.String key,
                                           java.util.Locale locale,
                                           java.lang.String style)

Get the string resource for the given combination of component class, resource key, locale and style. The component is provided used to allow implementation of component specific resource loading (e.g. per page or per reusable component). It also allows the resource loader implementation to get access to the application settings and the root application object if necessary. The key should be a String containing a lookup key into a resource bundle. The locale should contain the locale of the current operation so that the appopriate set of resources can be selected. The style allows the set of resources to select to be varied by skin/brand.

Parameters:

component - The component class to get the string resource for

key - The key to obtain the string for

locale - The locale identifying the resource set to select the strings from

style - The (optional) style identifying the resource set to select the strings from (see Session)

Returns:

The string resource value or null if the resource could not be loaded by this loader