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

【Spring源码系列- IOC】

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

本文目录

项目结构

配置类 · MessageI18NConfig.java

接口 · IMessageLocalizationService.java

实现类 · IMessageLocalizationServiceImpl.java

测试类 · TestI18N.java

配置文件

message.properties

message_en_US.properties

message_zh_CN.properties

测试结果

总结

---

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

项目结构

配置类 · MessageI18NConfig.java

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

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

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

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在线工具)

测试结果

总结

值得一提的是下面这行

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

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