org.springframework.core.io.support

Class LocalizedResourceHelper

java.lang.Object

org.springframework.core.io.support.LocalizedResourceHelper

public class LocalizedResourceHelper
extends java.lang.Object

Helper class for loading a localized resource, specified through name, extension and current locale.

Since:

1.2.5

Author:

Juergen Hoeller

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_SEPARATOR The default separator to use inbetween file name parts: an underscore
private ResourceLoader	resourceLoader
private java.lang.String	separator

Constructor Summary

Constructors

Constructor and Description
LocalizedResourceHelper() Create a new LocalizedResourceHelper with a DefaultResourceLoader.
LocalizedResourceHelper(ResourceLoader resourceLoader) Create a new LocalizedResourceHelper with the given ResourceLoader.

Method Summary

Modifier and Type	Method and Description
Resource	findLocalizedResource(java.lang.String name, java.lang.String extension, java.util.Locale locale) Find the most specific localized resource for the given name, extension and locale:
void	setSeparator(java.lang.String separator) Set the separator to use inbetween file name parts.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_SEPARATOR

public static final java.lang.String DEFAULT_SEPARATOR

The default separator to use inbetween file name parts: an underscore

See Also:

Constant Field Values

resourceLoader

private final ResourceLoader resourceLoader

separator

private java.lang.String separator

Constructor Detail

LocalizedResourceHelper

public LocalizedResourceHelper()

Create a new LocalizedResourceHelper with a DefaultResourceLoader.

See Also:

DefaultResourceLoader

LocalizedResourceHelper

public LocalizedResourceHelper(ResourceLoader resourceLoader)

Create a new LocalizedResourceHelper with the given ResourceLoader.

Parameters:

resourceLoader - the ResourceLoader to use

Method Detail

setSeparator

public void setSeparator(java.lang.String separator)

Set the separator to use inbetween file name parts. Default is an underscore ("_").

findLocalizedResource

public Resource findLocalizedResource(java.lang.String name,
                                      java.lang.String extension,
                                      java.util.Locale locale)

Find the most specific localized resource for the given name, extension and locale:

The file will be searched with locations in the following order, similar to java.util.ResourceBundle's search order:

• [name]_[language]_[country]_[variant][extension]
• [name]_[language]_[country][extension]
• [name]_[language][extension]
• [name][extension]

If none of the specific files can be found, a resource descriptor for the default location will be returned.

Parameters:

name - the name of the file, without localization part nor extension

extension - the file extension (e.g. ".xls")

locale - the current locale (may be null)

Returns:

the most specific localized resource found

See Also:

ResourceBundle