org.springframework.core.io.support

Class LocalizedResourceHelper

java.lang.Object

org.springframework.core.io.support.LocalizedResourceHelper

public class LocalizedResourceHelper
extends 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 String	DEFAULT_SEPARATOR The default separator to use in-between file name parts: an underscore.

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(String name, String extension, Locale locale) Find the most specific localized resource for the given name, extension and locale:
void	setSeparator(String separator) Set the separator to use in-between 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 String DEFAULT_SEPARATOR

The default separator to use in-between file name parts: an underscore.

See Also:

Constant Field Values

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(@Nullable
                         String separator)

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

findLocalizedResource

public Resource findLocalizedResource(String name,
                                      String extension,
                                      @Nullable
                                      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