【保姆级】SpringBoot项目中的i18n国际化

我会带着你远行 2024-04-03 09:21 39阅读 0赞

**【Spring源码系列- IOC】**

<table> 
 <tbody> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 1 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/124325005" title="【Spring源码】0.安装Gradle环境" rel="nofollow">【Spring源码】0.安装Gradle环境</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 2 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/124295132" title="【Spring源码】1.下载与编译_pom relocation to an other version number is not f" rel="nofollow">【Spring源码】1.下载与编译_pom relocation to an other version number is not f</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 3 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/124494757" title="【Spring源码】2.试个水先～Debug找到传说中的三级缓存(图解向，堆图预警)" rel="nofollow">【Spring源码】2.试个水先～Debug找到传说中的三级缓存(图解向，堆图预警)</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 4 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/124494175" title="【Spring源码】3. xml文件如何转换成BeanDefinition(主要涉及prepareRefresh()+ obtainFreshBeanFactory()两个函数，图解向，堆图预警)_spring xml转bean" rel="nofollow">【Spring源码】3. xml文件如何转换成BeanDefinition(主要涉及prepareRefresh()+ obtainFreshBeanFactory()两个函数，图解向，堆图预警)_spring xml转bean</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 5 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/124967341" title="【Spring源码】4. 自己搞个标签?~自定义标签保姆级全过程(图解向，堆图预警)" rel="nofollow">【Spring源码】4. 自己搞个标签?~自定义标签保姆级全过程(图解向，堆图预警)</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 6 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/125099022" title="【Spring源码】5.spring的bean工厂准备工作（prepareBeanFactory(beanFactory)" rel="nofollow">【Spring源码】5.spring的bean工厂准备工作（prepareBeanFactory(beanFactory)</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 7 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/125099608" title="【Spring源码】6. Spring扩展自定义属性编辑器保姆级教程" rel="nofollow">【Spring源码】6. Spring扩展自定义属性编辑器保姆级教程</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 8 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/125189197" title="【Spring源码】7. 如何添加自定义的BeanFactoryPostProcessor" rel="nofollow">【Spring源码】7. 如何添加自定义的BeanFactoryPostProcessor</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 9 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/125913768" title="【Spring源码】8. 捋下invokeBeanFactoryPostProcessors()主要处理流程" rel="nofollow">【Spring源码】8. 捋下invokeBeanFactoryPostProcessors()主要处理流程</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 10 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/126053792" title="【Spring源码】9. 超级重要的ConfigurationClassPostProcessor" rel="nofollow">【Spring源码】9. 超级重要的ConfigurationClassPostProcessor</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 11 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/126107551" title="【Spring源码】10. 递归调用的processConfigurationClass()方法" rel="nofollow">【Spring源码】10. 递归调用的processConfigurationClass()方法</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 12 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/126107412" title="【Spring源码】11. 我是注解类不？checkConfigurationClassCandidate()注解类判断方法详解" rel="nofollow">【Spring源码】11. 我是注解类不？checkConfigurationClassCandidate()注解类判断方法详解</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 13 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/126136230" title="【Spring源码】12. 注册bean处理器registerBeanPostProcessors()" rel="nofollow">【Spring源码】12. 注册bean处理器registerBeanPostProcessors()</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 14 </td> 
 <td colspan="1" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/126303691" title="【Spring源码】13. 国际化处理initMessageSource()源码解析" rel="nofollow">【Spring源码】13. 国际化处理initMessageSource()源码解析</a> </td> 
 <td colspan="1" style="vertical-align:middle;"> 【补充内容】<a href="https://blog.csdn.net/aqin1012/article/details/127171568" title="【保姆级】SpringBoot项目中的i18n国际化" rel="nofollow">【保姆级】SpringBoot项目中的i18n国际化</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 15 </td> 
 <td colspan="1" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/126644051" title="【Spring源码】14. 消息多播器（观察者模式）" rel="nofollow">【Spring源码】14. 消息多播器（观察者模式）</a> </td> 
 <td colspan="1" style="vertical-align:middle;"> 【补充内容】<a href="https://blog.csdn.net/aqin1012/article/details/126127883" title="【保姆级示例向】观察者模式" rel="nofollow">【保姆级示例向】观察者模式</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 16 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/127362286" title="【Spring源码】15. Bean的创建过程（1.概述篇）" rel="nofollow">【Spring源码】15. Bean的创建过程（1.概述篇）</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 17 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/127432109" title="【Spring源码】16. Bean的创建过程（2）" rel="nofollow">【Spring源码】16. Bean的创建过程（2）</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 18 </td> 
 <td colspan="1" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/127472470" title="【Spring源码】17.创建Bean这篇认真的@(・●・)@" rel="nofollow">【Spring源码】17.创建Bean这篇认真的@(・●・)@</a> </td> 
 <td colspan="1" style="vertical-align:middle;"> 【补充内容】 <a href="https://blog.csdn.net/aqin1012/article/details/128188799" title="【保姆级·创建对象】如何通过Supplier创建对象" rel="nofollow">【保姆级·创建对象】如何通过Supplier创建对象</a> <a href="https://blog.csdn.net/aqin1012/article/details/128204883" title="【保姆级·创建对象】如何通过factory-method创建对象" rel="nofollow">【保姆级·创建对象】如何通过factory-method创建对象</a> <a href="https://blog.csdn.net/aqin1012/article/details/127865881" title="【保姆级·创建对象】如何利用resolveBeforeInstantiation()在预处理阶段返回一个Bean的实例对象" rel="nofollow">【保姆级·创建对象】如何利用resolveBeforeInstantiation()在预处理阶段返回一个Bean的实例对象</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 19 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/128002786" title="【Spring源码】18. factory-method创建对象关键函数详解：instantiateUsingFactoryMethod()" rel="nofollow">【Spring源码】18. factory-method创建对象关键函数详解：instantiateUsingFactoryMethod()</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 20 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/128632696" title="【Spring源码】19. 没合适的构造器？找determineCandidateConstructors()！" rel="nofollow">【Spring源码】19. 没合适的构造器？找determineCandidateConstructors()！</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 21 </td> 
 <td colspan="1" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/128633664" title="【Spring源码】20. MergedBeanDefinitionPostProcessor修改/合并bean定义" rel="nofollow">【Spring源码】20. MergedBeanDefinitionPostProcessor修改/合并bean定义</a> </td> 
 <td colspan="1" style="vertical-align:middle;"> 【补充内容】 <a href="https://blog.csdn.net/aqin1012/article/details/128633923" title="【保姆级】@PostConstruct &amp; @PreDestroy使用示例" rel="nofollow">【保姆级】@PostConstruct &amp; @PreDestroy使用示例</a> <a href="https://blog.csdn.net/aqin1012/article/details/128644949" title="【Spring源码】AutowiredAnnotationBeanPostProcessor.postProcessMergedBeanDefinition()详解" rel="nofollow">【Spring源码】AutowiredAnnotationBeanPostProcessor.postProcessMergedBeanDefinition()详解</a> <a href="https://blog.csdn.net/aqin1012/article/details/128644909" title="【Spring源码】CommonAnnotationBeanPostProcessor.postProcessMergedBeanDefinition()详解" rel="nofollow">【Spring源码】CommonAnnotationBeanPostProcessor.postProcessMergedBeanDefinition()详解</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 22 </td> 
 <td colspan="1" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/128656295" title="【Spring源码】21. 初探循环依赖" rel="nofollow">【Spring源码】21. 初探循环依赖</a> </td> 
 <td colspan="1" style="vertical-align:middle;"> 【补充内容】 <a href="https://blog.csdn.net/aqin1012/article/details/128702039" title="【保姆级】手把手Debug循环依赖的整体流程" rel="nofollow">【保姆级】手把手Debug循环依赖的整体流程</a> <a href="https://blog.csdn.net/aqin1012/article/details/128715562" title="【实践向】当移除了三级缓存……" rel="nofollow">【实践向】当移除了三级缓存……</a> <a href="https://blog.csdn.net/aqin1012/article/details/128775251" title="【分析向】没有三级缓存会导致什么？" rel="nofollow">【分析向】没有三级缓存会导致什么？</a> <a href="https://blog.csdn.net/aqin1012/article/details/128785050" title="【Spring源码】插播一个创建代理对象的wrapIfNecessary()方法" rel="nofollow">【Spring源码】插播一个创建代理对象的wrapIfNecessary()方法</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 23 </td> 
 <td colspan="1" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/128800736" title="【Spring源码】22. 属性填充populateBean()详解" rel="nofollow">【Spring源码】22. 属性填充populateBean()详解</a> </td> 
 <td colspan="1" style="vertical-align:middle;"> 【补充内容】 <a href="https://blog.csdn.net/aqin1012/article/details/128812119" title="【Spring源码】自动注入·名称：autowireByName()详解" rel="nofollow">【Spring源码】自动注入·名称：autowireByName()详解</a> <a href="https://blog.csdn.net/aqin1012/article/details/128905209" title="【Spring源码】自动注入·类型：autowireByType()详解" rel="nofollow">【Spring源码】自动注入·类型：autowireByType()详解</a> <a href="https://blog.csdn.net/aqin1012/article/details/128922136" title="【Spring源码】属性值的解析与赋值：populateBean().applyPropertyValues()" rel="nofollow">【Spring源码】属性值的解析与赋值：populateBean().applyPropertyValues()</a> <a href="https://blog.csdn.net/aqin1012/article/details/128938759" title="【保姆级】超超超简单的自定义注解实现@Autowired同款功能" rel="nofollow">【保姆级】超超超简单的自定义注解实现@Autowired同款功能</a> </td> 
 </tr> 
 <tr> 
 <td colspan="1" style="vertical-align:middle;"> 24 </td> 
 <td colspan="2" style="vertical-align:middle;"> <a href="https://blog.csdn.net/aqin1012/article/details/128949267" title="【Spring源码】23. 执行初始化逻辑：initializeBean()" rel="nofollow">【Spring源码】23. 执行初始化逻辑：initializeBean()</a> </td> 
 </tr> 
 </tbody> 
</table>

**本文目录**

项目结构

配置类 · MessageI18NConfig.java

接口 · IMessageLocalizationService.java

实现类 · IMessageLocalizationServiceImpl.java

测试类 · TestI18N.java

配置文件

message.properties

message\_en\_US.properties

message\_zh\_CN.properties

测试结果

总结

--------------------

[【Spring源码】13. 国际化处理initMessageSource()源码解析][Spring_13. _initMessageSource] 中有对于Spring中的国际化代码的介绍，本篇是保姆级的SpringBoot项目中的国际化实践（其实也就是把Spring中的配置文件简化成了SpringBoot中的注解）  
来～我们开始这次的保姆级实践教程(￣∇￣)

## 项目结构 ##

![c042876b7bf264bdb1eab8da468154da.png][]

### 配置类 · MessageI18NConfig.java ###

![7808bd1eabe2ce209d76086e56e1c775.png][]

package com.aqin.messagelocalization.config;
    
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.context.support.ResourceBundleMessageSource;
    
    import java.util.Locale;
    
    /**
    *  @Description
     *  @Author  aqin1012 AQin.
    *  @Date  2022/9/20 1:37 PM
    *  @Version  1.0
    */
    @Configuration
    public class MessageI18NConfig {
    @Bean
        public ResourceBundleMessageSource resourceBundleMessageSource () {
    ResourceBundleMessageSource resourceBundleMessageSource = new ResourceBundleMessageSource () ;
            resourceBundleMessageSource.setBasename ( "classpath:messages/message" ) ;
            resourceBundleMessageSource.setDefaultLocale ( Locale.CHINA) ;
            return resourceBundleMessageSource;
        }
    }

### 接口 · IMessageLocalizationService.java ###

![b82aded6d6bbece8f38e4b9c9288fb0a.png][]

package com.aqin.messagelocalization.service;
    
    import java.util.Locale;
    
    /**
    *  @Description
     *  @Author  aqin1012 AQin.
    *  @Date  2022/9/20 1:37 PM
    *  @Version  1.0
    */
    public interface IMessageLocalizationService {
     /**
    * 国际化处理
    *
    *  @param  code
    *  @param  args
    *  @param  locale
    *  @return
     */
    String getMessage ( String code, Object [] args, Locale locale ) ;
    
    }

### 实现类 · IMessageLocalizationServiceImpl.java ###

![7bb6141f9f267dd3ef20fd4182361215.png][]

package com.aqin.messagelocalization.service.impl;
    
    import com.aqin.messagelocalization.service.IMessageLocalizationService;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.context.support.ResourceBundleMessageSource;
    import org.springframework.stereotype.Service;
    
    import java.util.Locale;
    
    /**
    *  @Description
     *  @Author  aqin1012 AQin.
    *  @Date  2022/9/20 2:10 PM
    *  @Version  1.0
    */
    @Service
    public class IMessageLocalizationServiceImpl implements IMessageLocalizationService {
    
    @Autowired
        ResourceBundleMessageSource resourceBundleMessageSource;
    
        @Override
        public String getMessage ( String code, Object [] args, Locale locale ) {
    System.out.println ( "IMessageLocalizationServiceImpl-getMessage()" ) ;
            try {
    return resourceBundleMessageSource.getMessage ( code, args, locale ) ;
            } catch ( Exception e ) {
    System.out.println ( e.getMessage ()) ;
            }
    return null;
        }
    }

### 测试类 · TestI18N.java ###

![c52e6f2933ecbbb5213532866aac0030.png][]

package com.aqin.messagelocalization.service;
    
    import com.aqin.messagelocalization.service.impl.IMessageLocalizationServiceImpl;
    import org.apache.commons.lang3.reflect.FieldUtils;
    import org.junit.jupiter.api.Test;
    import org.springframework.context.support.ResourceBundleMessageSource;
    
    import java.util.Locale;
    
    /**
    *  @Description
     *  @Author  aqin1012 AQin.
    *  @Date  2022/9/20 2:26 PM
    *  @Version  1.0
    */
    public class TestI18N {
    
    @Test
        public void testPrint () throws IllegalAccessException {
    IMessageLocalizationService iMessageLocalizationService = new IMessageLocalizationServiceImpl () ;
            ResourceBundleMessageSource resourceBundleMessageSource = new ResourceBundleMessageSource () ;
            resourceBundleMessageSource.setBasename ( "messages/message" ) ;
            // field replace
            FieldUtils.writeField( iMessageLocalizationService, "resourceBundleMessageSource", resourceBundleMessageSource, true ) ;
            System.out.println ( iMessageLocalizationService.getMessage ( "AQIN_TEST", null, Locale.CHINA)) ;
            System.out.println ( iMessageLocalizationService.getMessage ( "AQIN_TEST", null, Locale.US)) ;
        }
    
    }

### 配置文件 ###

#### message.properties ####

AQIN_TEST=test

#### message\_en\_US.properties ####

AQIN_TEST=test

#### message\_zh\_CN.properties ####

AQIN_TEST=\u6d4b\u8bd5

*  `\u6d4b\u8bd5` 是“测试”经过Unicode编码后的结果

推荐一个在线转换的网站：

[在线Unicode编码转换工具(ES JSON在线工具)][Unicode_ES JSON]

## 测试结果 ##

![0df971b1f6eaeb2b3eaef447479128c6.png][]

## 总结 ##

值得一提的是下面这行

FieldUtils.writeField( iMessageLocalizationService, "resourceBundleMessageSource", resourceBundleMessageSource, true ) ;

这行的作用把`iMessageLocalizationService`(第1个参数)中的名为`"resourceBundleMessageSource"`(第2个参数)的参数用`resourceBundleMessageSource`(第3个参数)对象替换掉， 第4个参数是一个布尔类型，表示是否使用`reflect.AccessibleObject.setAccessible(boolean)`方法打破范围限制。

[Spring_13. _initMessageSource]: https://juejin.cn/post/7128286920764817415
[c042876b7bf264bdb1eab8da468154da.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/03/70e7fcb8a4ab47518e317dc2ca7a0d52.png
[7808bd1eabe2ce209d76086e56e1c775.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/03/af3f87c9b2b24caca21cde573bd370e7.png
[b82aded6d6bbece8f38e4b9c9288fb0a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/03/fb9573ee15314a4ea91073a184a003cf.png
[7bb6141f9f267dd3ef20fd4182361215.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/03/35c7e5cb9db546a19fcc0cd3155c55ef.png
[c52e6f2933ecbbb5213532866aac0030.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/03/89f90e8647b54685b113f1a12b231a10.png
[Unicode_ES JSON]: http://www.esjson.com/unicodeEncode.html
[0df971b1f6eaeb2b3eaef447479128c6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/03/68374b18375d4f2e86ba63149f89d761.png