## 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
`static String` `DEFAULT_SEPARATOR` The default separator to use inbetween file name parts: an underscore

Constructor Summary
`LocalizedResourceHelper()` Create a new LocalizedResourceHelper with a DefaultResourceLoader.
`LocalizedResourceHelper(ResourceLoader resourceLoader)` Create a new LocalizedResourceHelper with the given ResourceLoader.

Method Summary
`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 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 String DEFAULT_SEPARATOR

  The default separator to use inbetween 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(String separator)

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

### findLocalizedResource

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