SpringBoot实现国际化的操作步骤

 更新时间:2024年02月04日 11:51:37   作者:索码理  
国际化(Internationalization) 是指为了适应不同语言、文化和地区的用户,使软件能够方便地进行本地化修改的过程,本文介绍了SpringBoot 国际化功能的简单使用,感兴趣的朋友可以参考下

什么是国际化

国际化(Internationalization) 是指为了适应不同语言、文化和地区的用户,使软件能够方便地进行本地化修改的过程。 国际化(Internationalization) 简称i18n,其中 “i”Internationalization的首字母 ,“n” 是最后一个字母 , “18” 代表了中间省略的18个字母。

SpringBoot 国际化

SpringBoot也提供了国际化的功能,在Spring Boot中,国际化通常涉及以下几个关键组件:

  • 资源文件(Properties文件):这些文件包含了不同语言的文本消息,每个语言对应一个资源文件。通常,资源文件的命名采用messages_语言代码.properties的格式,例如messages_en.properties(英语)、messages_zh_CN.properties(简体中文)等。

  • MessageSource接口:这是Spring框架提供的一个核心接口,定义了获取文本消息的方法。它的实现类负责加载并解析资源文件,并根据语言和代码来返回相应的消息。

  • LocaleResolver接口:这是Spring框架提供的另一个接口,用于解析用户的语言偏好。根据用户的设置,LocaleResolver可以确定要使用哪个语言。

  • 组件中使用的文本消息:在应用程序的界面和代码中,您可以使用特定的消息代码来引用资源文件中的文本消息。Spring Boot会根据用户的语言偏好选择合适的消息进行显示。

通过配置MessageSource和LocaleResolver,以及在应用程序中使用相应的消息代码,就可以实现Spring Boot的国际化功能。

实践出真知

话不多说,上代码。

新建Properties文件

Resource目录下新建Properties文件

  • 中文properties文件 messages_zh_CN.properties :
hello=你好
welcome=欢迎关注公众号, {0}!
  • 英文properties文件 messages_en.properties
hello=hi
welcome=Welcome to follow WeChat Public Number, {0}!

创建完文件idea会自动将国际化文件归类到Resource Bundle中

修改配置文件

application.properties

测试

@Resource
private MessageSource messageSource;

@Test
void testMessageSource() {

    Locale china = Locale.CHINA;
    System.out.println("\n中文环境");
    //中文语言
    String hello_zh = messageSource.getMessage("hello", null, china);
    System.out.println(hello_zh);
    // 占位符替换
    String welcome_zh = messageSource.getMessage("welcome", new String[]{"索码理"}, china);
    System.out.println(welcome_zh);

    //英文语言
    Locale english = Locale.ENGLISH;
    System.out.println("\n英文环境");
    String hello_en = messageSource.getMessage("hello", null, english);
    System.out.println(hello_en);
    String welcome_en = messageSource.getMessage("welcome", new String[]{"suncodernote"}, english);
    System.out.println(welcome_en);

    System.out.println("\n没有对应语言的国际化属性,返回code");
    //没有对应语言的国际化属性,返回code
    String hello_test = messageSource.getMessage("hello-test", null, china);
    System.out.println(hello_test);

    System.out.println("\n没有对应语言的国际化区域时,返回默认语言");
    //没有对应语言的国际化区域时,返回默认
    String hello_fr = messageSource.getMessage("hello", null, Locale.FRANCE);
    System.out.println(hello_fr);
}

测试结果:

中文环境
你好
欢迎关注公众号, 索码理!

英文环境
你好
欢迎关注公众号, suncodernote!

没有对应语言的国际化属性,返回code
hello-test

没有对应语言的国际化区域时,返回默认语言
你好

获取所有国际化资源

上面的测试我们都是只能根据一个code获取一个国际化信息,我们在切换语言使用国际化时,总不能每次进行国际化的时候都调用一次接口吧,这肯定是不行的。 下面是获取指定语言的所有的国际化信息的代码示例。

定义一个I18nService 接口:

public interface I18nService {

    /**
     * 获取指定语言所有国际化信息
     * @param locale
     * @return
     */
    Map<String, String> getAllMessages(Locale locale);
}

I18nService 接口实现类

@Service
public class I18nServiceImpl implements I18nService{

    @Autowired
    private MessageSource messageSource;

    @Override
    public Map<String, String> getAllMessages(Locale locale) {
        if (locale == null) {
            locale = Locale.getDefault();
        }
        //存放所有message
        Map<String, String> messages = new HashMap<>();

        ResourceBundleMessageSource bundleMessageSource = (ResourceBundleMessageSource) messageSource;
        String[] basenames = bundleMessageSource.getBasenameSet().toArray(new String[0]);

        for (String basename : basenames) {
            //从缓存中获取资源文件
            ResourceBundle resourceBundle = ResourceBundle.getBundle(basename, locale);
            //获取资源文件的所有code
            Set<String> keys = resourceBundle.keySet();

            for (String key : keys) {
                //根据code获取对应的message
                String message = messageSource.getMessage(key, null, locale);
                messages.put(key, message);
            }
        }
        return messages;
    }
}

getAllMessages方法中,拿到了指定资源文件的所有code,有了code再做一些操作就很方便了。比如获取以xxx开头的code。

I18nController

@RequestMapping("/i18n")
@RestController
public class I18nController {

    @Resource
    private I18nService i18nService;

    @RequestMapping("/messages")
    public Map<String, String> getAllMessages(@RequestHeader(name = "Accept-Language" , required = false) Locale locale) {
        return i18nService.getAllMessages(locale);
    }
}

通过postman调用接口,将请求头 Accept-Language 设置为 zh 获取中文国际化环境,测试结果如下图所示:

以上就是SpringBoot 国际化一个简单的实现的操作步骤,感兴趣的可以动手试试。

总结

本文介绍了SpringBoot 国际化功能的简单使用,通过在资源文件中配置国际化字段,然后获取对应区域的国际化信息。这些操作都是静态的,要预先配置好国际化信息才能进行一系列的操作,不够灵活。

以上就是SpringBoot实现国际化的操作步骤的详细内容,更多关于SpringBoot国际化的资料请关注脚本之家其它相关文章!

相关文章

  • Java中的注解与注解处理器

    Java中的注解与注解处理器

    这篇文章主要介绍了Java中的注解与注解处理器,元注解的作用是负责注解其他注解, Java5.0定义了4个标准的meta-annotation(元注解)类型,它们被用来提供对其它注解类型进行说明,需要的朋友可以参考下
    2023-11-11
  • Java将Word文档转换为PDF文件的几种常用方法总结

    Java将Word文档转换为PDF文件的几种常用方法总结

    这篇文章主要介绍了Java将Word文档转换为PDF文件的四种常用方法,分别使用ApachePOI+iText、Aspose.Words for Java、Docx4j和JODConverter,这些库各有优点,但在使用时需要注意库与Java环境的兼容性、安装所需依赖、转换速度和资源消耗,需要的朋友可以参考下
    2024-10-10
  • Java list如何实现将指定元素排在第一位

    Java list如何实现将指定元素排在第一位

    这篇文章主要为大家详细介绍了Java list中如何实现将指定元素排在第一位,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
    2025-02-02
  • 带你粗略了解Java数组的使用

    带你粗略了解Java数组的使用

    这篇文章主要给大家介绍了关于Java中数组的定义和使用的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-08-08
  • Springboot 配置RabbitMQ文档的方法步骤

    Springboot 配置RabbitMQ文档的方法步骤

    这篇文章主要介绍了Springboot 配置RabbitMQ文档的方法步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-03-03
  • SpringBoot运行时修改定时任务Cron表达式的实现方案

    SpringBoot运行时修改定时任务Cron表达式的实现方案

    在项目开发中,定时任务是一个常见的需求,SpringBoot通过@Scheduled注解提供了简便的定时任务实现方式,但默认情况下,一旦应用启动,定时任务的Cron表达式就无法动态调整,本文将介绍如何在SpringBoot应用运行期间动态修改定时任务的Cron表达式,需要的朋友可以参考下
    2025-06-06
  • Java SpringSecurity+JWT实现登录认证

    Java SpringSecurity+JWT实现登录认证

    这篇文章主要介绍了Java SpringSecurity+JWT实现登录认证,首先通过给需要登录认证的模块添加mall-security依赖展开介绍,感兴趣的朋友可以参考一下
    2022-06-06
  • 如何为Spark Application指定不同的JDK版本详解

    如何为Spark Application指定不同的JDK版本详解

    这篇文章主要给大家介绍了关于如何为Spark Application指定不同的JDK版本的相关资料,文中通过示例代码将解决的方法介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友下面来随着小编一起学习学习吧。
    2017-11-11
  • Mybatis实现批量删除和多条件查询方式

    Mybatis实现批量删除和多条件查询方式

    本文介绍了批量删除功能的实现步骤,包括后台代码的修改,具体涉及到mapper层、Service层、Controller接口等层面的修改,同时也介绍了多条件查询功能的实现,具体包括创建封装查询条件的类,mapper层、Service层、Controller接口的修改等
    2026-05-05
  • Springboot详解如何实现SQL注入过滤器过程

    Springboot详解如何实现SQL注入过滤器过程

    这篇文章主要介绍了基于springboot实现SQL注入过滤器,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2022-06-06

最新评论