Spring 3 MVC: Internationalization & localization

Application Context Configuration

Message Resource Files

Normally in the Java world, the locale-specific data is stored in message resource files. In Spring you configure it by adding the following beanorg.springframework.context.support.ReloadableResourceBundleMessageSource to the application context:

1

2

3

4

5

6

<!-- Application Message Bundle -->

<bean id="messageSource"

  class="org.springframework.context.support.ReloadableResourceBundleMessageSource">

  <property name="basename" value="classpath:messages/messages" />

  <property name="defaultEncoding" value="UTF-8"/>

</bean>

The configuration specifies that the message resource files should be named messages_xx.properties (xx is the shortcut of the locale), are stored in the messages folder in the classpath, and that the default encoding for the files is UTF-8.

Message resource files in classpath

Note: If the message resources files change often and you don’t want to restart the JVM, you should useorg.springframework.context.support.ReloadableResourceBundleMessageSource

Spring’s DispatcherServlet enables you to automatically resolve messages using the client’s locale. This is done with LocaleResolver objects. You can select between

an AcceptHeaderLocaleResolver, which inspects the accept-language header in the request that was sent by the client (e.g., a web browser). Usually this header field contains the locale of the client’s operating system.
a CookieLocaleResolver,
and a SessionLocaleResolver, which allows you to retrieve locales from the session that might be associated with the user’s reques

`CookieLocaleResolver`

The CookieLocaleResolver made the most sense for Podcastpedia.org . It inspects a cookie namedpodcastpediaPreferredLanguage, that might exist on the client to see if a locale is specified:

1

2

3

4

5

<bean id="localeResolver">

    <property name="cookieName" value="podcastpediaPreferredLanguage"/>

    <property name="defaultLocale" value="en_US" /> 

    <property name="cookieMaxAge" value="604800"/>        

</bean>

If the cookie is not found, then the defaultLocale is set to American English. The cookieMaxAge (the maximum time a cookie will stay persistent on the client) is set to 604800 seconds (one month).

`LocaleChangeInterceptor`

The LocaleResolver is normally used in combination with the LocaleChangeInterceptor, which allows you to change of the current locale by using a defined parameter in the request (in this case the langparameter). So, for example, a request for the following URL,http://www.podcastpedia.org/categories?lang=de, will change the site language to German:

1

2

3

4

5

6

<mvc:interceptors>

<!-- Changes the locale when a 'lang' request parameter is sent; e.g. /?lang=de -->

  <bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor">

      <property name="paramName" value="lang"/>

   </bean>

</mvc:interceptors>

Access the Locale in Spring

If you need to access the current locale in Spring you can use theorg.springframework.context.i18n.LocaleContextHolder.LocaleContextHolder.getLocale(), which returns the Locale associated with the current thread, if any, or the system default Locale else. In the following code snippet you can see how I use this in the start page’s controller to display the newest and most popular podcasts based on the language selected:

Browser Caching optimization

If you have enabled browser caching, as specified for example in the post How To: Enable compression and leverage browser caching with Apache Server, make sure you set the expiring and cache controlfor the html pages to 0 seconds:

1

2

3

ExpiresByType text/html                 "access plus 0 seconds"

....

Header set Cache-Control "max-age=0, private"

, so that changing the locale is effective immediately for the page – otherwise if you come back later to the same page, but without the locale parameter in the url, you would have the page displayed in the old locale, if the expiration time was not reached yet.

Well, that’s All Folks! If you would like to have Podcastpedia.org localized in your language, you can download the message resource file for English – messages_en.properties, and contact me at ama [AT] codingpedia DOT org – thanks

If you liked this, please show your support by helping us with Podcastpedia.org
We promise to only share high quality podcasts and episodes.