当前位置：首页 > news >正文

Spring MVC 国际化机制详解（MessageSource 接口体系）

news 来源：原创 2025/9/21 0:22:59

Spring MVC 国际化机制详解（MessageSource 接口体系）

在这里插入图片描述

1. 核心接口与实现类详解

接口/类名	描述	功能特性	适用场景
MessageSource	核心接口，定义消息解析能力	支持参数化消息（如`{0}`占位符）	所有国际化场景的基础接口
ResourceBundleMessageSource	Spring 官方实现，基于 `ResourceBundle`	支持缓存、自动加载属性文件（如`messages_en.properties`）	通用场景（推荐）
StaticMessageSource	内存中存储消息（非文件）	动态注册消息（如运行时配置）	单元测试或动态消息场景
ReloadableResourceBundleMessageSource	增强版 `ResourceBundleMessageSource`	支持热加载（无需重启）、编码指定（如`encoding=UTF-8`）	需要动态更新消息的生产环境
CacheAwareContextControlMessageSource	支持国际化上下文控制（如日期格式）	结合 `LocaleContextHolder` 管理线程级本地化	需要复杂本地化控制的场景

2. 完整示例代码

2.1 配置类（Spring Boot）

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.support.ReloadableResourceBundleMessageSource;@Configuration
public class I18nConfig {@Beanpublic ReloadableResourceBundleMessageSource messageSource() {ReloadableResourceBundleMessageSource source = new ReloadableResourceBundleMessageSource();source.setBasename("classpath:i18n/messages"); // 属性文件前缀source.setDefaultEncoding("UTF-8");            // 编码设置source.setCacheSeconds(60);                    // 60秒后重新加载（热更新）return source;}
}

2.2 国际化属性文件

messages_en.properties

greeting=Hello, {0}!
error=An error occurred: {0}

messages_zh.properties

greeting=你好，{0}！
error=发生错误：{0}

2.3 控制器示例

import org.springframework.context.MessageSource;
import org.springframework.web.bind.annotation.*;import java.util.Locale;@RestController
public class I18nController {private final MessageSource messageSource;public I18nController(MessageSource messageSource) {this.messageSource = messageSource;}@GetMapping("/greeting")public String greeting(@RequestHeader(value = "Accept-Language", required = false) Locale locale,@RequestParam String name) {// 根据 locale 解析消息String message = messageSource.getMessage("greeting", new Object[]{name}, locale);return message;}@ExceptionHandler(Exception.class)public String handleException(Exception ex, Locale locale) {return messageSource.getMessage("error", new Object[]{ex.getMessage()}, locale);}
}

2.4 测试请求

# 中文请求
curl -H "Accept-Language: zh-CN" "http://localhost:8080/greeting?name=张三"
# 输出：你好，张三！# 英文请求
curl -H "Accept-Language: en-US" "http://localhost:8080/greeting?name=John"
# 输出：Hello, John!

3. Spring Boot 国际化配置项整理

配置项	作用	默认值	示例
`spring.messages.basename`	消息属性文件前缀（路径）	`messages`	`classpath:i18n/messages`
`spring.messages.encoding`	文件编码	`UTF-8`	`GBK`
`spring.messages.cache-duration`	热加载间隔（仅 `Reloadable` 实现生效）	`7200s`（2小时）	`60s`
`spring.http.accept-language.header`	自定义语言头名称	`Accept-Language`	`X-Language`
`spring.mvc.locale`	默认语言	由系统 Locale 决定	`en`
`spring.mvc.fallback-locale`	备用语言	`en`	`zh`

4. 关键代码注释说明

ReloadableResourceBundleMessageSource 配置

source.setCacheSeconds(60); // 60秒后自动重新加载属性文件（无需重启）

控制器中解析消息

// 参数顺序：消息键、参数数组、当前Locale
messageSource.getMessage("greeting", new Object[]{name}, locale);

属性文件占位符语法

greeting=Hello, {0}! // {0} 表示第一个参数（name）

5. 总结表格：MessageSource 实现对比

实现类	特性	适用场景	配置复杂度
ResourceBundleMessageSource	基础实现，无缓存	简单项目	低
ReloadableResourceBundleMessageSource	支持热加载、编码指定	需要动态更新的生产环境	中
StaticMessageSource	内存存储，动态注册消息	单元测试或动态消息	高
CacheAwareContextControlMessageSource	支持线程级本地化上下文	需要复杂本地化控制（如日期格式）	高

6. 常见问题

Q：如何自定义语言切换参数？
A：通过 @Configuration 注册 LocaleResolver，例如从请求参数 lang 获取语言：

@Bean
public LocaleResolver localeResolver() {AcceptHeaderLocaleResolver resolver = new AcceptHeaderLocaleResolver();resolver.setDefaultLocale(Locale.US);resolver.setLanguageAttribute("lang"); // 从请求参数 lang 获取return resolver;
}

Q：属性文件路径错误如何排查？
A：确保文件位于 src/main/resources/i18n/ 目录，名称格式为 messages_{language}.properties。

提示：国际化配置建议与前端框架（如 Thymeleaf）结合，通过 <spring:message> 标签直接渲染消息。

Spring MVC 国际化机制详解（MessageSource 接口体系）

Spring MVC 国际化机制详解（MessageSource 接口体系） 1. 核心接口与实现类详解接口/类名描述功能特性适用场景MessageSource核心接口，定义消息解析能力支持参数化消息（如{0}占位符）所有国际化场景的基础接口Resource…...

编程日记 2025/9/21 0:22:59

java学习笔记13——IO流

File 类的使用常用构造器路径分隔符常用方法 File类的获取功能和重命名功能 File 类的判断功能 File类的创建功能和删除功能 File 类的使用总结： 1.File类的理解 > File类位于java.io包下，本章中涉及到的相关流也都声明在java.io包下 > File…...

编程日记 2025/9/21 0:19:04

防DDoS流量清洗核心机制解析

本文深度剖析DDoS流量清洗技术演进路径，揭示混合云清洗系统的四层过滤架构，结合2023年新型反射攻击案例，提出基于AI行为分析的动态防御策略。通过Gartner最新攻防效能数据与金融行业实战方案，阐明流量清洗系统在误判率、清洗延迟、…...

编程日记 2025/9/21 0:20:26

边缘计算革命：低功耗GPU在自动驾驶实时决策中的应用

边缘计算革命：低功耗GPU在自动驾驶实时决策中的应用 ——分析NVIDIA Jetson与华为昇腾的嵌入式方案差异一、自动驾驶的实时决策挑战与边缘计算需求自动驾驶系统需在30ms内完成环境感知、路径规划与车辆控制的全流程闭环‌。传统云端计算受限于网络延迟&#xf…...

编程日记 2025/9/21 0:19:04

ubuntu24.04-MyEclipse的项目导入到 IDEA中

用myeclipse创建的一个web项目， jdk1.7,tomcat7,mysql8.0,导入到idea项目中 1.导入现有项目 1.打开IDEA，选择“Import Project”进入下一步 2.选择所需要导入的项目，点击“OK” 3.点击创建一个新的项目，然后下一步 4.直接点…...

编程日记 2025/9/21 0:20:26

基于SpringBoot的律师事务所案件管理系统【附源码】

基于SpringBoot的律师事务所案件管理系统（源码L文说明文档） 目录 4 系统设计 4.1界面设计原则 4.2功能结构设计 4.3数据库设计 4.3.1属性图 4.3.2 数据库物理设计 5 系统实现 5.1客户信息管理 5.2 律师…...

编程日记 2025/9/21 0:17:28

电力网关：推动电力物联网及电力通信系统革新

在“双碳”目标与新型电力系统建设的背景下，电力行业正加速向数字化、智能化、绿色化转型。作为国内领先的电力物联网解决方案提供商，厦门计讯物联科技有限公司（以下简称“计讯物联”）依托自主研发的电力专用网关、边缘计算平台及…...

编程日记 2025/9/21 0:21:56

Android系统的Wi-Fi系统框架和详细启动流程

目录一、前言二、系统架构层次 ‌1、应用层‌ ‌2、Framework层‌ 3‌、HAL层‌ ‌4、驱动层‌ 三、Wi-Fi 目录树结构四、系统流程 1、应用层请求 2、Wi-Fi管理服务处理 3、硬件交互 4、数据处理与事件通知 5.连接管理 6.状态维护五、WiFi启动流程及函数调用…...

编程日记 2025/9/14 21:00:22

Scala基础知识8

集合计算高级函数包括过滤、转换或映射、扁平化、扁平化加映射、分组、简化（归约），折叠过滤:遍历一个集合并从中获取满足指定条件的元素组成一个新的集合。转换或映射:将原始集合中的元素映射到某个函数中。扁平化:取消嵌套格式&…...

编程日记 2025/9/21 0:19:05

SwiftUI 本地推送（Local Notification）教程目录

1. 本地推送简介 1.1 什么是本地推送？1.2 本地推送的应用场景（提醒、定时任务、用户交互等）1.3 本地推送与远程推送的区别 2. 前提条件 2.1 开发环境要求（Xcode 13、iOS 15）2.2 需要的基础知识（SwiftUI …...

编程日记 2025/9/21 0:20:27

大数据技术与Scala

集合高级函数过滤通过条件筛选集合元素，返回新集合。映射对每个元素应用函数，生成新集集合扁平化将嵌套集合展平为单层集合。扁平化映射先映射后展平，常用于拆分字符串。分组按规则将元素分组为Map结构。归约 …...

编程日记 2025/9/21 0:21:12

golang通过飞书邮件服务API发送邮件功能详解

一.需求需要实现通过飞书邮件服务API发送邮件验证码功能:用户输入邮箱, 点击发送邮件,然后发送邮件验证码, 这里验证码有过期时间, 保存到redis缓存中二.实现实现的部分代码如下: 控制器部分代码 // 发送邮件控制器 func EmailSendController(userId uint64, m proto.Messa…...

编程日记 2025/9/18 13:26:49

BoostSearch搜索引擎项目 —— 测试用例设计 + web自动化测试代码

web自动化代码： https://gitee.com/chicken-c/boost-search/tree/master/AutoTest...

编程日记 2025/8/18 0:26:14

MySQL学习笔记集--触发器

触发器 MySQL触发器（Trigger）是一种特殊的存储过程，它在指定的数据库表上指定的事件（INSERT、UPDATE、DELETE）之前或之后自动执行。触发器可以用来强制执行复杂的业务逻辑、数据完整性规则、自动更新数据等。触发器…...

编程日记 2025/9/18 19:27:34

算力驱动未来：从边缘计算到高阶AI的算力革命

算力驱动未来：从边缘计算到高阶AI的算力革命摘要本文深入探讨了不同算力水平（20TOPS至160TOPS）在人工智能领域的多样化应用场景。从边缘计算的实时目标检测到自动驾驶的多传感器融合，从自然语言处理的大模型应用到AI for Scie…...

编程日记 2025/9/16 0:53:13

4.8刷题记录（双指针）

今天刷的部分是代码随想录中的双指针专题代码随想录由于里面包含的题目大部分之前刷过，并且用双指针做过。所以今天仅仅复习，不再进行代码的搬运。 1.19. 删除链表的倒数第 N 个结点 - 力扣（LeetCode） 分析：此题无…...

编程日记 2025/9/19 23:26:36

在shell脚本中，$@和$#的区别与联系

在 Shell 脚本里，$ 和 $* 都是用于表示传递给脚本或函数的所有参数，下面详细介绍它们的区别与联系。联系表示所有参数：二者都能够代表传递给脚本或者函数的全部参数。当你在执行脚本时带上了多个参数，$ 和 $* 都能把这些参数呈…...

编程日记 2025/9/18 22:21:17

IP节点详解及国内IP节点获取指南

获取国内IP节点通常涉及网络技术或数据资源的使用，IP地址作为网络设备的唯一标识，对于网络连接和通信至关重要。详细介绍几种修改网络IP地址的常用方法，无论是对于家庭用户还是企业用户，希望能找到适合自己的解决方案。以下是方法…...

编程日记 2025/9/20 11:08:29

Google Play上架：解决android studio缓存问题（内容清理不干净导致拒审）

在as打包中，经常会遇到改变工程参数或者对应文件参数的情况，比如修改android gradle版本快捷键：ctrl + alt + shift + s 修改SDK文件路径快捷键：ctrl + alt + shift + s 修改Gradle存储下载文件的默认位置快捷键：ctrl + alt + s 先打开设置修改compile...

编程日记 2025/9/19 6:41:24

蓝桥杯备赛 Day 21 图论基础

图的基础 ![[图的基础.png]] 1.图的存储方式 (1)邻接表(常用) vector<pair<int,int>> g[N]; //g[x]存放x的所有出点信息,二维数组 g[i][j]{first,second},first是从i出发的第j个出点,second表示边权例如上图: g[1]{{2,0}.{3,0}} g[6]{{3,7}} g[4]{{5,0},{6,0}…...

编程日记 2025/9/15 9:36:54

MySQL数据库应用技术试卷

建一个以自己名字拼音为命名的数据库。（3分） CREATE DATABASE example; 令这个数据库为当前所使用的数据库。（2分） USE example; 写出如下student表结构语句。（95分） 表1： 列名数据类型 …...

编程日记 2025/9/18 12:20:22

openssl源码分析之加密模式(modes)

openssl实现分组加密模式（例如AES128-CBC的CBC部分）的模块名字叫做modes，源代码位于 https://gitee.com/gh_mirrors/openssl/tree/master/crypto/modes 博主又打不开github了TT，只能找个gitee镜像头文件是modes.h。该模块目前…...

编程日记 2025/9/6 14:45:32

【Unity】Unity Transform缩放控制教程：实现3D模型缩放交互，支持按钮/鼠标/手势操作

【Unity 】Transform缩放控制教程：实现3D模型缩放交互，支持按钮/鼠标/手势操作在Unity开发中，Transform组件承担着场景中物体的空间信息控制，包括位置、旋转和缩放。而缩放（Scale）操作，作为三…...

编程日记 2025/9/11 0:47:41

集成nacos2.2.1出现的错误汇总

总结 1.jdk问题 jdk要一致 2.idea使用问题 idea启动nacos要配置，idea启动类要启动两次，并配置两次vm参数 3.项目依赖问题依赖要正确添加，有的模块就是不能用公共模块的pom配置，需要独立配置，先后启动顺序也要注意…...

编程日记 2025/9/10 7:00:13

从零到有的游戏开发（visual studio 2022 + easyx.h）

引言本文章适用于C语言初学者掌握基本的游戏开发， 我将用详细的步骤引领大家如何开发属于自己的游戏。作者温馨提示：不要认为开发游戏很难，一些基本的游戏逻辑其实很简单， 关于游戏的开发环境也不用担心，我会详细…...

编程日记 2025/9/13 6:59:28

海外高防服务器延迟优化——跨国业务安全加速的底层逻辑

本文深度解析海外高防服务器延迟优化的技术实现路径，揭示跨国业务场景下DDoS防护与网络性能的平衡法则。从物理线路选择到协议栈调优，从流量调度算法到安全检测机制重构，系统阐述降低20ms-50ms延迟的工程实践方案，并附2023年东南亚…...

编程日记 2025/9/16 8:12:09

常用环境部署(二十六)——Centos搭建MQTT服务端EMQX

1、安装docker https://blog.csdn.net/wd520521/article/details/112609796?spm1011.2415.3001.5331 2、安装EMQX4.4.4 （1）使用docker pull指令安装emqx镜像 docker pull emqx/emqx:4.4.4 （2）查看镜像 docker images 3、启…...

编程日记 2025/9/20 12:20:38

ecovadis认证基本概述，ecovadis认证审核有效期

EcoVadis认证基本概述 1. 什么是EcoVadis认证？ EcoVadis是全球领先的企业可持续发展（ESG）评级平台，专注于评估企业在**环境（E）、劳工与人权（S）、商业道德（L&#xff09…...

编程日记 2025/9/19 23:08:18

2.8.4 iOS覆盖率SDK开发

iOS系统的覆盖率SDK，通过搭建本地的pod仓库，直接在podfile中添加指定的下载地址，就可以实现对被测试的app注入覆盖率SDK。 2.8.4.1 开发iOS覆盖率获取Pod私有库在网上查找了相应的开发方法后，决定开发自己的依赖库，开发方法及步骤如下： 1，开发新的包（1）通过Xcode创…...

编程日记 2025/9/11 1:16:21

Redhat(6)-ansible-变量

变量 1.作用域 Global scope:命令行中设置。 Play scope:play中设置。 Host scope ：inventory中定义、facts收集或任务中注册，在主机组和主机上设置。 1.全局变量 1.1cmd命令 #1.全局变量 #显示变量 echo %PATH1.2.ansible变量全局变量 var变量不加…...

编程日记 2025/9/15 8:01:33

麦科信光隔离探头在碳化硅（SiC）MOSFET动态测试中的应用

碳化硅（SiC）MOSFET 是基于宽禁带半导体材料碳化硅（SiC）制造的金属氧化物半导体场效应晶体管，相较于传统硅（Si）MOSFET，具有更高的击穿电压、更低的导通电阻、更快的开关速度以及更优异…...

编程日记 2025/9/16 5:35:33

android audiorecord

这里写目录标题初始化失败记录 AudioRecord 初始化及参数介绍基本初始化参数详解1. audioSource (音频源)2. sampleRateInHz (采样率)3. channelConfig (声道配置)4. audioFormat (音频格式)5. bufferSizeInBytes (缓冲区大小) 完整初始化示例使用注意事项参考地址初始化失败…...

编程日记 2025/9/16 1:32:16

有一个变量在有些线程没有加锁有些线程加锁了，那我在这些加锁的线程中能起到对应的作用吗

这是一个非常经典、但也很危险的问题。 🧨 简单结论： 如果一个变量在某些线程访问时没有加锁，即使其他线程对它加了锁，也： ❌ 不能保证线程安全！ ❌ 加锁的部分不会“保护”未加锁的部分！ &am…...

编程日记 2025/9/15 5:58:04

【人工智能】AI大模型开发数学基础指南

目录学习内容**1. 线性代数****2. 概率与统计****3. 微积分****4. 优化理论****5. 信息论****6. 数值计算****7. 离散数学****8. 统计学进阶****如何学习？****总结** 如何学习**1. 明确学习目标****2. 分阶段学习计划****阶段 1：夯实基础****阶段 2&…...

编程日记 2025/9/9 3:07:09

直流减速电机控制实验：Simulink应用层开发（3）

文章目录 1 阶段目标2 单元测试方法3 单元测试过程3.1 按键指令识别测试3.2 电机状态转换测试4 代码生成5 总结1 阶段目标本文是《直流减速电机控制实验》的第四部分，会通过图文结合的方式，手把手带读者操作Simulink工具进行直流减速电机的应用层开发。本章主要将《直流减…...

编程日记 2025/9/8 19:22:42

隔行换色总结

功能效果展示： 第一种思路： 使用数组，将数组的内容渲染到页面上，序号也就是将数组的下标输出到第一个td上，将数组的内容输出到第二个td上，（使用拼接字符串） 具体操作： …...

编程日记 2025/8/21 4:45:26

【kind管理脚本-2】脚本使用说明文档 —— 便捷使用 kind 创建、删除、管理集群脚本

当然可以，以下是为你这份 Kind 管理脚本写的一份使用说明文档，可作为 README.md 或内部文档使用： 🚀 Kind 管理脚本说明文档本脚本是一个便捷的工具，帮助你快速创建、管理和诊断基于 Kind (Kubernetes IN Docker) 的…...

编程日记 2025/9/16 8:43:56

Python星球日记 - 第13天：封装、继承与多态

🌟引言：上一篇：Python星球日记 - 第12天：面向对象编程（OOP）基础名人说：不要人夸颜色好，只留清气满乾坤（王冕《墨梅》）创作者：Code_流苏(CSDN)（一个喜欢古诗词和编程的Coder😊）目录一、引言二、封装的概念与实现1. 公有属性与私有属性2. 使用getter和sett…...

编程日记 2025/9/9 6:25:07

基于AT89C52单片机的GSM上报智能家居报警温度烟雾防盗系统

点击链接获取Keil源码与Project Backups仿真图： https://download.csdn.net/download/qq_64505944/90579530?spm1001.2014.3001.5503 功能介绍： 1、功能：具有温度、烟雾、入侵报警功能，采用LCD1602液晶显示屏实时显示温度值与…...

编程日记 2025/9/15 13:47:02

北重数控滑台厂家：机器人地轨究竟是如何运作的，又在哪些领域发光发热呢？

机器人地轨是指利用机器人技术在地面上移动或执行任务的轨道系统。这种系统通常包括导轨、传动装置、传感器和控制系统等组成部分。机器人地轨的运作原理是通过控制传动装置沿着导轨移动，同时利用传感器获取周围环境信息并通过控制系统进行实时调节。机器人地轨在…...

编程日记 2025/9/20 4:08:57

2025最新系统 Git 教程（三）

2.3 Git 基础 - 查看提交历史查看提交历史在提交了若干更新，又或者克隆了某个项目之后，你也许想回顾下提交历史。完成这个任务最简单而又有效的工具是 git log 命令。我们使用一个非常简单的 simplegit 项目作为示例。运行下面的命令获取该项目&…...

编程日记 2025/9/4 11:05:47

显示器各类异常处理方法

显示器各类异常处理方法导航文章目录显示器各类异常处理方法导航画面无显示/黑屏/无HDMI信号输入显示器闪烁显示器花屏显示画面模糊或扭曲显示器颜色异常显示器出现死点或亮点画面无显示/黑屏/无HDMI信号输入首先应该检查的是显示器电源（真的有人弄掉电源…...

编程日记 2025/9/20 4:48:54

Error 1062 (23000): Duplicate entry ‘‘ for key ‘id‘`

目录 Error 1062 (23000): Duplicate entry for key id1. **问题分析**2. **解决方法****步骤 1：检查 id 字段的值****步骤 2：检查表结构****步骤 3：检查现有数据****步骤 4：检查插入逻辑****步骤 5：修改表结构&#…...

编程日记 2025/9/20 17:59:02

谈谈模板方法模式，模板方法模式的应用场景是什么？

一、模式核心理解模板方法模式是一种行为设计模式，通过定义算法骨架并允许子类重写特定步骤来实现代码复用。如同建筑图纸规定房屋结构，具体装修由业主决定，该模式适用于固定流程中需要灵活扩展的场景。 // 基础请求处理…...

编程日记 2025/9/20 23:08:09

未来蓉城：科技与生态共舞的诗意栖居-成都

故事背景故事发生在中国四川成都的2075年，展现科技与自然深度交融的未来城市图景。通过六个充满想象力的生态装置场景，描绘市民在智慧城市中诗意栖居的生活状态，展现环境保护与人文传承的和谐共生。故事内容在电子竹林轻轨站，通…...

编程日记 2025/8/20 5:19:08

模仿axios的封装效果来封装fetch，实现baseurl超时等

因为要在cocos游戏项目里面发送网络请求获取数据，并且还有可能用到websocket发送请求，所以这里封装一个fetch放便使用： // fetch封装// 基础配置 const BASE_URL 你的url const TIMEOUT 5000// 请求封装 const http async (url: string, …...

编程日记 2025/9/11 20:16:43

Linux(CentOS10) gcc编译

本例子摘自《鸟哥的linux私房菜-基础学习第四版》 21.3 用make进行宏编译书中的代码在本机器(版本见下）编译出错，改正代码后发布此文章： #kernel version: rootlocalhost:~/testmake# uname -a Linux localhost 6.12.0-65.el10.x86_64 #1…...

编程日记 2025/9/18 15:51:05

Design Compiler：语法检查工具dcprocheck

相关阅读 Design Compilerhttps://blog.csdn.net/weixin_45791458/category_12738116.html?spm1001.2014.3001.5482 dcprocheck是一个在Design Compiler存在于安装目录下的程序（其实它是一个指向snps_shell的符号链接，但snps_shell可以根据启动命令名判…...

编程日记 2025/9/18 22:44:34