Skip to content

Instantly share code, notes, and snippets.

@jonikarppinen
Last active November 17, 2025 06:47
Show Gist options
  • Select an option

  • Save jonikarppinen/0d600b0c82edce890310 to your computer and use it in GitHub Desktop.

Select an option

Save jonikarppinen/0d600b0c82edce890310 to your computer and use it in GitHub Desktop.
Example of using message resources in Spring Boot service layer code, in as simple way as possible (hopefully!). NOTE: this approach supports only a single locale, not dynamically changing it.
package com.company.project.components;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.MessageSource;
import org.springframework.context.support.MessageSourceAccessor;
import org.springframework.stereotype.Component;
import javax.annotation.PostConstruct;
import java.util.Locale;
/**
* Helper to simplify accessing i18n messages in code.
*
* This finds messages automatically found from src/main/resources (files named messages_*.properties)
*
* This example uses hard-coded English locale.
*
* @author Joni Karppinen
* @since 2015-11-02
*/
@Component
public class Messages {
@Autowired
private MessageSource messageSource;
private MessageSourceAccessor accessor;
@PostConstruct
private void init() {
accessor = new MessageSourceAccessor(messageSource, Locale.ENGLISH);
}
public String get(String code) {
return accessor.getMessage(code);
}
}
default.title = Title
package com.company.project.services;
import com.company.project.components.Messages;
import org.springframework.beans.factory.annotation.Autowired;
@Service
public class SomeServiceImpl implements SomeService {
@Autowired
Messages messages;
// ...
private String getDefaultTitle() {
return messages.get("default.title"));
}
}
@jonikarppinen

Copy link
Copy Markdown
Author

Feel free to comment if you know of a simpler way to access message resources on Spring Boot!

@gustavohenke

Copy link
Copy Markdown

Looking at this blog, it seems like there is a thread-local variable available called LocaleContextHolder.getLocaleContext().
This way seems pretty easy to have the messages translated to the user's language.

@kswat

kswat commented Jan 19, 2017

Copy link
Copy Markdown

Error: org.springframework.context.NoSuchMessageException: No message found under code 'hello' for locale 'en'.
The messages_en.properies in in src\main\resources

FIX: messages_en_GB.properties solved the problem

@alezzix

alezzix commented Mar 9, 2017

Copy link
Copy Markdown

Hello,
instead of this file in "src / main / resources"
I would like to use an external file in "C: \ opt \ app \ messages.properties". Is it possible?

@ohnooo

ohnooo commented Mar 17, 2017

Copy link
Copy Markdown

Is there a way to get an array of strings?

For example:
messages_en.properties

default.title = Title
default.header = Header
default.body = Body

SomeServiceImpl
private List getDefaultTitle() {
return messages.get("default"));
}

Is it possible to return list of default messages? or one must explicitly insert code..

Thank you

@normal-carrot

Copy link
Copy Markdown

Using constructor for autowiring is a better way, because it helps you prevent cyclic dependencies and also simplifies unit testing.
You can do it even in a simpler way:
https://gist.github.com/saniaky/c1cbca50202bfa3f16faa0c3e1ceadce

@kannangce

Copy link
Copy Markdown

This is a fixed Locale right? not a dynamic one that depends on param or "Accept-language" header.

@tanmoy-git

Copy link
Copy Markdown

@kannangce, yes this one uses heard coded English as the locale value. If you have a spring-boot application just replace the Locale.ENGLISH with LocaleContextHolder.getLocale() and send the Accept-Language header.

If the locale specified in the accept-language value is not found then, it will fall back on classpath:src/main/resources/messages.properties file.

@deafjava

Copy link
Copy Markdown

This solution was far better than others! So simple! Thank you!

@ayoubbenkhayi

Copy link
Copy Markdown

thank you! this solution helped!

@SudHegde

SudHegde commented Mar 8, 2019

Copy link
Copy Markdown

Thank you..this sample helped us!

@sayadi

sayadi commented Jul 17, 2019

Copy link
Copy Markdown

@kannangce, yes this one uses heard coded English as the locale value. If you have a spring-boot application just replace the Locale.ENGLISH with LocaleContextHolder.getLocale() and send the Accept-Language header.

If the locale specified in the accept-language value is not found then, it will fall back on classpath:src/main/resources/messages.properties file.

Have you tested this in an actual setup? My hunch said that this would always return the default locale and wouldn't dynamically change with the "Accept-Language" header simply because the construction of Components happens once at the start of the application when LocaleContextHolder.getLocale()) will return the default locale. Any later change of the Locale would have no effect on the already constructed Messages Component.

Tested this with a simple Spring Boot setup and confirmed my assumption above.

As far as I can see, this solution as it stands can only support a single Locale.

@mselgamal

mselgamal commented Sep 26, 2019

Copy link
Copy Markdown

Thanks, very helpful and cleared up some confusion for me

But for my spring boot app, i still needed to over-ride the messageSource bean and set basename to messages

otherwise I get the "NoSuchMessageException"

@Bean
public ResourceBundleMessageSource messageSource() {
    ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
    messageSource.addBasenames("messages");
    return messageSource;
}

@moulanaaidi

Copy link
Copy Markdown

LocaleContextHolder.getLocaleContext()

is it LocaleContextHolder.getLocale() instead?

@setoba1192

Copy link
Copy Markdown

Thanks! very helpfull

@tshavkat

tshavkat commented Apr 30, 2020

Copy link
Copy Markdown

Im getting NullPointerException that MessageSource is null

@Umit-Soylu

Copy link
Copy Markdown

Can you provide a simple unit test for this configuration? I cannot generate a dynamic locale change via this configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment