Spring Boot中实现可重载的MessageSource简明教程

引言: 在Spring Boot中messages中定义的信息,如果发生变更,则需要重启应用。那该如何实现才可以不重启应用的情况下替换messages中的展示信息呢?本文将给出一个简要的教程。

1. MessageSoure的资源配置与读取

在之前的文章中,已经介绍过了如何在Spring Boot中进行资源的配置和读取以及相应的测试代码,感兴趣的读者,可以参照Spring Boot中支持i18n简明教程

2 可重载的MessageSource

在Spring中定义了ReloadableResourceBundleMessageSource类,提供可自动刷新的Messages更新,即用户在无需重载应用的前提下,可以自动更新线上系统的messages展示信息。
在其API文档中,其描述到如下信息:

In contrast to the JDK-based ResourceBundleMessageSource, this class uses Properties instances as its custom data structure for messages, loading them via a PropertiesPersister strategy from Spring Resource handles. This strategy is not only capable of reloading files based on timestamp changes, but also of loading properties files with a specific character encoding. It will detect XML property files as well.

翻译为中文的信息如下:

与JDK中的ResourceBundleMessageBundle相比,这个类使用Properties实例作为自定义的message存储结构,通过PropertiesPersister策略从Spring中Resource加载messages,同时也支持基于特定字符编码加载messages信息。 同时他也将检查xml的属性文件。

ReloadableResourceBundleMessageSource从命名上也可以感知到其余我们默认使用的MessageSource实例对象,都是实现了同一个接口MessageSource,所以他们的使用接口和调用方式是一致的。

3 覆盖Override实例

根据网络上的教程,首先读取spring.messages的属性信息:

@Value(“${spring.messages.basename}”)
private String basename;

@Value(“${spring.messages.cache-seconds}”)
private long cacheMillis;

@Value(“${spring.messages.encoding}”)
private String encoding;

这里只使用了3个属性,分别对应application.properties的属性信息,在初始化自定义的MessageSource实例中进行设置。
然后覆盖Spring Boot默认的对象实例需要基于@Bean来声明某个对象实例:

@Bean
public MessageSource initMessageSource() {
ReloadableResourceBundleMessageSource messageSource =
new ReloadableResourceBundleMessageSource();

log.info(“baseName====>:” + this.basename);
messageSource.setBasename(basename);
messageSource.setDefaultEncoding(encoding);
messageSource.setCacheMillis(cacheMillis);

String msg = messageSource.getMessage(“login.failure.msg”, null, Locale.CHINA);
log.info(“Msg====>” + msg);

return messageSource;
}

之前的测试代码无需修改;但是在测试中一直在提示以下异常:

0:32:33.548 INFO org.jd.test.controller.TestController.testCode@42 - Locale:zh
10:32:33.561 ERROR org.jd.test.controller.GlobalExceptionHandler.handleException@20 - Exception Msg:No message found under code ‘login.failure.msg’ for locale ‘zh_CN’.
org.springframework.context.NoSuchMessageException: No message found under code ‘login.failure.msg’ for locale ‘zh_CN’.
at org.springframework.context.support.DelegatingMessageSource.getMessage(DelegatingMessageSource.java:69)
at org.jd.test.controller.TestController.testCode(TestController.java:43)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
at java.lang.reflect.Method.invoke(Unknown Source)
at org.springframework.web.method.support.InvocableHandlerMethod.doInvoke(InvocableHandlerMethod.java:205)
at org.springframework.web.method.support.InvocableHandlerMethod.invokeForRequest(InvocableHandlerMethod.java:133)
at org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod.invokeAndHandle(ServletInvocableHandlerMethod.java:97)
at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.invokeHandlerMethod(RequestMappingHandlerAdapter.java:827)
at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.handleInternal(RequestMappingHandlerAdapter.java:738)
at org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter.handle(AbstractHandlerMethodAdapter.java:85)
at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:967)
at org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:901)
at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:970)
at org.springframework.web.servlet.FrameworkServlet.doGet(FrameworkServlet.java:861)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:635)

从异常信息可以感知到,在Messages中并未找到对应的message,但是messages的资源文件并未变动,那问题出在哪里呢?
经过分析,大概率应该是自定义的MessageSource实例已经被覆盖,但是我们在使用调用之时,并未获取争取的对象实例:

@Autowired
private MessageSource messageSource;
那该如何解决呢?

4 修复无法获取正确实例的问题

4.1 设置实例对象获取顺序

@Primary告诉Spring容器在基于同种类型加载实例之时,优先加载基于@Primary的对象实例。
于是,我们声明覆盖对象的代码就变更为:

@Primary
@Bean
public MessageSource initMessageSource() {
ReloadableResourceBundleMessageSource messageSource =
new ReloadableResourceBundleMessageSource();

log.info(“baseName====>:” + this.basename);
messageSource.setBasename(basename);
messageSource.setDefaultEncoding(encoding);
messageSource.setCacheMillis(cacheMillis);

String msg = messageSource.getMessage(“login.failure.msg”, null, Locale.CHINA);
log.info(“Msg====>” + msg);

return messageSource;
}
测试之后,可以正常获取message信息。

4.2 基于实例的名称指定加载

另外,我们还可以基于@Bean指定名称,然后在@Autowired加载实例之时,基于实例名称来加载相应的实例。
声明对象的代码在@Bean中增加一个命名:

@Bean(“myMessageSource”)
public MessageSource initMessageSource() {
ReloadableResourceBundleMessageSource messageSource =
new ReloadableResourceBundleMessageSource();

log.info(“baseName====>:” + this.basename);
messageSource.setBasename(basename);
messageSource.setDefaultEncoding(encoding);
messageSource.setCacheMillis(cacheMillis);

String msg = messageSource.getMessage(“login.failure.msg”, null, Locale.CHINA);
log.info(“Msg====>” + msg);

return messageSource;
}

在加载MessageSource之时,需要基于@Qualifier指定对象命名:

@Qualifier(value=”myMessageSource”)
@Autowired
private MessageSource messageSource;

然后经过测试,功能正确。

5 总结

Spring Boot提供非常简单易用的扩展机制,但是在自定义扩展之时,需要格外注意是否加载所期望的实例,这个需要进行通过@Primary或者@Bean的命名机制来指定解决冲突的问题。

阅读更多

扫码向博主提问

bladestone

博客专家

非学,无以致疑;非问,无以广识
  • 擅长领域:
  • 架构师
  • AI手工匠人
  • 攻城狮
  • Java老兵
  • 问题解决者
去开通我的Chat快问
版权声明:本文章是作者辛勤书写的成果,如需转载,请与作者联系,并保留作者信息以及原文链接,谢谢~~ https://blog.csdn.net/blueheart20/article/details/78121143
文章标签: Spring-Boo Primary Bean
个人分类: Java技术 问题分析
所属专栏: Spring Boot实战
想对作者说点什么? 我来说一句

没有更多推荐了,返回首页

关闭
关闭
关闭