Spring（21）——国际化MessageSource

最新推荐文章于 2025-08-16 15:19:43 发布
原创 最新推荐文章于 2025-08-16 15:19:43 发布 · 6.3k 阅读 · 7 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#Spring #国际化 #MessageSource #缓存 #ResourceBundleMessageSource

本文详细介绍了Spring框架中的MessageSource接口及其主要实现类ResourceBundleMessageSource和ReloadableResourceBundleMessageSource，用于支持国际化和参数替换。ResourceBundleMessageSource基于JDK的ResourceBundle，提供缓存功能，而ReloadableResourceBundleMessageSource允许指定非类路径下的资源文件，支持文件类型更广泛。文章通过示例展示了如何配置和使用这两个实现类，并讨论了缓存、编码、回退机制等相关特性。

21 国际化MessageSource

Spring中定义了一个MessageSource接口，以用于支持信息的国际化和包含参数的信息的替换。MessageSource接口的定义如下，对应的方法说明已经在方法上注释了。

public interface MessageSource {

	/**
	 * 解析code对应的信息进行返回，如果对应的code不能被解析则返回默认信息defaultMessage。
	 * @param 需要进行解析的code，对应资源文件中的一个属性名
	 * @param 需要用来替换code对应的信息中包含参数的内容，如：{0},{1,date},{2,time}
	 * @param defaultMessage 当对应code对应的信息不存在时需要返回的默认值
	 * @param locale 对应的Locale
	 * @return
	 */
	String getMessage(String code, Object[] args, String defaultMessage, Locale locale);

	/**
	 * 解析code对应的信息进行返回，如果对应的code不能被解析则抛出异常NoSuchMessageException
	 * @param code 需要进行解析的code，对应资源文件中的一个属性名
	 * @param args 需要用来替换code对应的信息中包含参数的内容，如：{0},{1,date},{2,time}
	 * @param locale 对应的Locale
	 * @return 
	 * @throws NoSuchMessageException 如果对应的code不能被解析则抛出该异常
	 */
	String getMessage(String code, Object[] args, Locale locale) throws NoSuchMessageException;

	/**
	 * 通过传递的MessageSourceResolvable对应来解析对应的信息
	 * @param resolvable 
	 * @param locale 对应的Locale
	 * @return 
	 * @throws NoSuchMessageException 如不能解析则抛出该异常
	 */
	String getMessage(MessageSourceResolvable resolvable, Locale locale) throws NoSuchMessageException;

}

我们熟悉的ApplicationContext接口继承了MessageSource接口，所以我们所有的ApplicationContext实现类都实现了MessageSource接口，也就是我们我们可以通过ApplicationContext来调用MessageSource接口方法以实现信息的国际化和替换信息中包含的参数。所有ApplicationContext实现类对MessageSource接口的实现都是在AbstractApplicationContext中实现的，其对MessageSource接口实现的源码如下：

@Override
public String getMessage(String code, Object args[], String defaultMessage, Locale locale) {
	return getMessageSource().getMessage(code, args, defaultMessage, locale);
}

@Override
public String getMessage(String code, Object args[], Locale locale) throws NoSuchMessageException {
	return getMessageSource().getMessage(code, args, locale);
}

@Override
public String getMessage(MessageSourceResolvable resolvable, Locale locale) throws NoSuchMessageException {
	return getMessageSource().getMessage(resolvable, locale);
}

/**
 * Return the internal MessageSource used by the context.
 * @return the internal MessageSource (never {@code null})
 * @throws IllegalStateException if the context has not been initialized yet
 */
private MessageSource getMessageSource() throws IllegalStateException {
	if (this.messageSource == null) {
		throw new IllegalStateException("MessageSource not initialized - " +
				"call 'refresh' before accessing messages via the context: " + this);
	}
	return this.messageSource;
}

从中我们可以看到AbstractApplicationContext对MessageSource的实现都是自身所持有的MessageSource类型的messageSource对象来实现的。那么对应的messageSource又是如何初始化的呢？在其中定义了一个initMessageSource()来做对应的初始化工作，其源码如下。

/**
 * Initialize the MessageSource.
 * Use parent's if none defined in this context.
 */
protected void initMessageSource() {
	ConfigurableListableBeanFactory beanFactory = getBeanFactory();
	if (beanFactory.containsLocalBean(MESSAGE_SOURCE_BEAN_NAME)) {
		this.messageSource = b
最低0.47元/天 解锁文章

200万优质内容无限畅学
Spring MessageSource 详解：如何在国际化消息中传递参数
码觉客的博客
05-13 301
Spring 的 MessageSource 是处理多语言应用程序国际化的核心组件，允许根据用户的 Locale 显示不同消息。当消息需要包含动态数据（如用户名、数量等）时，可以通过占位符 {index} 在消息属性文件中定义动态内容，并在 Java 代码中使用 MessageSource 的 getMessage() 方法传递参数。MessageFormat 类负责处理占位符与参数的匹配。在视图层（如 Thymeleaf 或 JSP）中，可以进一步简化消息的获取与展示。通过合理使用 MessageSour
Spring核心——MessageSource实现国际化
weixin_43770982的博客
07-26 517
Spring的国际化 在上下文与IoC对ApplicationContext以及Context相关的设计模式进行了介绍。ApplicationContext作为一个Context在应用的运行层提供了IoC容器、事件、国际化等功能接口。 Spring的国际化（i18n）功能是通过MessageSource接口实现的，他提供了MessageSource::getMessage方法从预设的资源中获取...
MessageSource类的使用（i18n国际化支持）
DreamsArchitects的博客
09-22 7520
目录一、简介二、代码实现2.1 messages.properties2.2 yml2.3 MessageUtils获取国际化三、测试四、附录SpringUtils 一、简介 i18n（其来源是英文单词 internationalization的首末字符i和n，18为中间的字符数）是“国际化”的简称。通常与i18n相关的还有L10n（“本地化”的简称）。 在我们开发WEB项目的时候，项目可能涉及到在国外部署或者应用，也有可能会有国外的用户对项目进行访问，那么在这种项目中， 为客户展现的页面或者操作的信息就需
《深入浅出Spring》Spring中国际化详解
ysj_2021的博客
07-07 815
Spring 国际化
深入剖析Spring国际化：MessageSource原理与应用
zuiyuelong的博客
08-16 571
在当今全球化的互联网时代，软件产品的国际化(i18n)支持已成为基础能力。国际化（Internationalization，简称i18n）是指软件设计时使其能够适应不同语言和地区需求的过程，而无需进行工程上的重构。Spring框架作为Java生态中最流行的企业级应用框架，提供了一套完整的国际化解决方案，其核心就是MessageSource接口体系。
Spring messageSource
weixin_34184158的博客
09-17 150
  Spring中可以使用两个类加载资源文件： org.springframework.context.support.ReloadableResourceBundleMessageSource 和 org.springframework.context.support.ResourceBundleMessageSource 可配置如下： ReloadableResou...
学习SpringMVC——国际化+上传+下载详解
09-01
<bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource"> ``` 此处的basename为“i18n”，意味着我们将创建以“i18n”为前缀的国际化资源文件。 4. 接下来需要创建...
spring mvc 3 国际化（下）——简单自定义操作
08-03
在“spring mvc 3 国际化（下）——简单自定义操作”这一主题中，我们将深入探讨如何自定义国际化过程，以满足特定的应用场景需求。 首先，国际化的核心是资源文件，通常命名为`messages.properties`，用于存储默认...
Spring特性——Aware感知特性
08-11
`setMessageSource(MessageSource messageSource)`方法使得bean能访问MessageSource，从而获取和格式化消息。 6. **ApplicationEventPublisherAware** ApplicationEventPublisherAware接口允许bean发布自定义的...
利用MessageSource实现国际化[I18N]
xzc0202
11-22 1627
3.8.1. 利用MessageSource实现国际化 ApplicationContext接口扩展了MessageSource接口，因而提供了消息处理的功能（i18n或者国际化）。与HierarchicalMessageSource一起使用，它还能够处理嵌套的消息，这些是Spring提供的处理消息的基本接口。让我们快速浏览一下它所定义的方法： String getM...
spring messageSource结合ehcache demo
07-06
spring messageSource功能结合ehcache实现提示语句从数据库读取demo，注：sql脚本都在代码中，如有问题及时沟通指点。
Spring源码分析-MessageSource
热门推荐
会走的桃子的博客
11-14 1万+
文章目录基础知识Locale本地化工具类ResourceBoundleMessageFormatMessageSource简介类结构HierarchicalMessageSourceResourceBundleMessageSourceReloadableResourceBundleMessageSource容器级的国际化信息资源 假设我们正在开发一个支持多国语言的Web应用程序，要求系统能够根据...
spring中的messageSource（国际化）
qq_43203949的博客
06-26 6836
messageSource是spring中的转换消息接口，提供了国际化信息的能力。用于解析消息，并支持消息的参数化和国际化。 Spring 包含两个内置的实现：和。 资源文件 测试 结果 spring的AbstractApplicationContext中MessageSource初始化 初始化 在中有一个方法，在刷新方法里面调用一个。方法就是初始化上下文中的MessageSource资源国际化组件。 使用容器中的messageSource 提供了接口方法来使用容器中的messagesource..
MessageSource（Spring源码分析）
Isonion的博客
05-21 725
Spring中定义了一个MessageSource接口，以用于支持信息的国际化和包含参数的信息的替换。MessageSource接口的定义如下，对应的方法说明已经在方法上注释了。/*** 解析code对应的信息进行返回，如果对应的code不能被解析则返回默认信息defaultMessage。* @param 需要进行解析的code，对应资源文件中的一个属性名* @param 需要用来替换code对应的信息中包含参数的内容，如：{0},{1,date},{2,time}
Spring实例化源码解析之MessageSource(七)
于琦海
10-07 800
initMessageSource（MessageSource）主要作用是初始化国际化文件。在Spring框架中，消息源用于提供本地化消息，例如错误消息或用户界面文本，以便支持国际化和本地化。
【Spring4揭秘 基础4】国际化--MessageSource
要啥自行车
06-01 9164
假设我们正在开发一个支持多国语言的Web应用程序，要求系统能够根据客户端的系统的语言类型返回对应的界面：英文的操作系统返回英文界面，而中文的操作系统则返回中文界面——这便是典型的i18n国际化问题。对于有国际化要求的应用系统，我们不能简单地采用硬编码的方式编写用户界面信息、报错信息等内容，而必须为这些需要国际化的信息进行特殊处理。简单来说，就是为每种语言提供一套相应的资源文件，并以规范化命名的方式保
Spring 国际化支持之 MessageSource
大鹏的博客
11-29 837
Java 对国际化的支持主要是使用 ResourceBundle 根据区域信息选取不同的 properties 文件获取 key 对应的 value，并且 Java 还提供了 MessageFormat 来支持对消息的格式化，Spring 将这两者进行结合，抽象出了 MessageSource 接口，使我们更方便的在 Spring 中获取国际化消息。
Spring——context
最新发布
09-18
### Spring - context 概述 Spring - context 是 Spring 框架的核心模块之一，它提供了依赖注入（DI）和控制反转（IoC）容器的支持，以及其他企业级服务，如事件传播、资源加载、国际化等。 ### 功能介绍 - **依赖注入和 IoC 容器**：Spring - context 实现了强大的 IoC 容器，它负责创建和管理对象（Bean），并通过依赖注入的方式将对象之间的依赖关系进行解耦。例如，可以通过 XML 配置、Java 注解或 Java 配置类来定义 Bean 及其依赖关系。 ```xml <!-- XML 配置示例 --> <bean id="userService" class="com.example.UserService"> <property name="userRepository" ref="userRepository"/> </bean> <bean id="userRepository" class="com.example.UserRepository"/> ``` ```java // Java 注解示例 import org.springframework.stereotype.Service; import org.springframework.beans.factory.annotation.Autowired; @Service public class UserService { private UserRepository userRepository; @Autowired public UserService(UserRepository userRepository) { this.userRepository = userRepository; } } ``` - **事件机制**：Spring - context 提供了事件传播机制，允许应用程序中的组件发布和监听事件。这有助于实现松耦合的组件通信。例如，当用户注册成功后，可以发布一个用户注册事件，其他组件可以监听该事件并执行相应的操作。 ```java import org.springframework.context.ApplicationEvent; // 自定义事件类 public class UserRegisteredEvent extends ApplicationEvent { public UserRegisteredEvent(Object source) { super(source); } } import org.springframework.context.ApplicationListener; import org.springframework.stereotype.Component; // 事件监听器 @Component public class UserRegisteredListener implements ApplicationListener<UserRegisteredEvent> { @Override public void onApplicationEvent(UserRegisteredEvent event) { // 处理用户注册事件 } } ``` - **资源加载**：Spring - context 提供了统一的资源加载接口 `ResourceLoader`，可以方便地加载各种类型的资源，如文件、类路径资源、URL 资源等。 ```java import org.springframework.context.ApplicationContext; import org.springframework.context.support.ClassPathXmlApplicationContext; import org.springframework.core.io.Resource; public class ResourceLoadingExample { public static void main(String[] args) { ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml"); Resource resource = context.getResource("classpath:config.properties"); // 处理资源 } } ``` - **国际化支持**：Spring - context 支持国际化（i18n），可以根据用户的语言环境提供不同的文本信息。通过配置消息源和使用 `MessageSource` 接口，可以轻松实现国际化功能。 ```xml <!-- 配置消息源 --> <bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource"> <property name="basename" value="messages"/> </bean> ``` ```java import org.springframework.context.ApplicationContext; import org.springframework.context.support.ClassPathXmlApplicationContext; public class InternationalizationExample { public static void main(String[] args) { ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml"); String message = context.getMessage("welcome.message", null, java.util.Locale.ENGLISH); System.out.println(message); } } ``` ### 使用指南 1. **添加依赖**：如果使用 Maven 项目，在 `pom.xml` 中添加 Spring - context 依赖。 ```xml <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>5.3.23</version> </dependency> ``` 2. **配置 Bean**：可以使用 XML 配置、Java 注解或 Java 配置类来定义和配置 Bean。 3. **启动 Spring 容器**：根据配置方式的不同，使用相应的方式启动 Spring 容器。 ```java import org.springframework.context.ApplicationContext; import org.springframework.context.support.ClassPathXmlApplicationContext; public class Main { public static void main(String[] args) { // 启动 XML 配置的 Spring 容器 ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml"); // 获取 Bean UserService userService = context.getBean(UserService.class); // 使用 Bean userService.doSomething(); } } ```
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值