Spring I18N 底层源码大揭秘:你的 MessageSource 到底是怎么找到配置的?

关注我的公众号:【编程朝花夕拾】,可获取首发内容。

01 引言

上一节介绍了国际化的一个完整案例,但是国际化是到时底层是怎么调用呢?前后端分离的的国家化又当如何使用?

带着这些问题,我们一步步深入了解一下。了解了底层的逻辑,我们才能在使用上随心所欲。

02 前后端分离

上一节使用了后端框架thymeleaf直接获取语言文件的配置信息。前后端分离又当如何传递给前端呢?

2.1 自动装配

这里的关键类是SpringBoot的自动注册类:org.springframework.boot.autoconfigure.context.MessageSourceAutoConfiguration

自动注入MessageSource对象:

我们调用的时候就可以直接调用messageSource.getMessage()即可获取到对应的数据。

当然我们也可以自己定义。

2.2 调用案例

测试结果:

参数主要包括三个:

  • code:就是文件配置的key
  • args:就是配置文件的参数,参数是一个数组,如:user.welcome=Welcome, {0}!
  • locale:区域,决定了哪一个文件配置

03 源码追踪

3.1 自动注册

Spring容器初始化就专门初始化MessageSource:

关键点:

  • 约定优于配置 :约定用户把国际化 Bean 命名为 messageSource。
  • 父子容器自动串联 :子 ApplicationContext 会自动把父容器的 MessageSource 设为 parent,多容器场景天然支持。
  • DelegatingMessageSource 兜底 :当用户没配置时使用空实现,不会抛异常,但调用 getMessage 会抛 NoSuchMessageException。

3.2 Web调用

大致处理步骤:

  • 请求进入 DispatcherServlet。
  • 拦截器链执行,LocaleChangeInterceptor 检查 URL 参数 lang,若有则用 LocaleResolver 切换。
  • Handler 执行业务逻辑。
  • 业务代码通过注入的 MessageSource 调用 getMessage(code, args, locale)。
  • Spring 在当前 ApplicationContext 中查找 MessageSource,按 code -> locale 链回退到 parent 容器查找资源。
  • 找到原始字符串后用 MessageFormat 按 args 渲染,按 locale 格式化数字/日期。
  • 渲染好的字符串返回给业务层。

04小结

Spring Framework 作为 Java 生态最主流的应用框架,对 I18N 提供了完整、优雅、且高度可扩展的支持。基于 JDK 标准的 java.util.Locale、ResourceBundle 抽象,封装出一套以 MessageSource 为核心的体系,并进一步和 ApplicationContext 容器、事件机制、占位符解析深度集成。

有了框架的支撑,我们就很容易去使用国际化处理多语言的业务。

相关推荐
北城笑笑3 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
Misnearch3 小时前
ScheduledExecutorService
java·线程池
ServBay3 小时前
Local harness 将退役,VS Code 本地开发要不要搬到云端?
后端·ai编程·visual studio code
ashiho4 小时前
【LeetCode hot 100】3. 无重复字符的最长子串 (三种解法)
java·数据结构·后端·算法·leetcode·滑动窗口
T_Wizard4 小时前
AI 回复为什么要转圈 3 秒才「啪」一下全出来?把流式输出拆开看,顺便踩了 6 个坑
java·ai编程
CoderYanger4 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第二弹)
java·数据库·面试·职场和发展·java-ee·tomcat·mybatis
张一凡935 小时前
你的 AGENTS.md,真的管到模型写代码了吗?
前端·后端·agent
00后程序员5 小时前
iOS 实时活动怎么开发,Windows 上用 KXBuild 和 ActivityKit 写灵动岛
后端·ios
程序员cxuan5 小时前
推荐 10 个 WorkBuddy 中的邪修用法
人工智能·后端·程序员
Bacon5 小时前
给项目做一次"全身 CT":Agent Skills 生态里的代码体检全链路
前端·人工智能·后端