SpringBoot实现国际化i18n详解
更新时间：2024年12月15日 08:14:04 作者：HBLOG
国际化（Internationalization,简称i18n）是指在软件应用中支持多种语言和文化的能力,本文将介绍如何在Spring Boot应用中实现国际化,需要的可以参考下
1.什么是国际化（i18n）
国际化（Internationalization，简称i18n）是指在软件应用中支持多种语言和文化的能力。通过国际化，应用可以根据用户的语言和地区设置，动态地显示不同的文本内容。本文将介绍如何在Spring Boot应用中实现国际化，并提供完整的代码示例。
2.代码工程
在Spring Boot中实现国际化（i18n）可以通过以下步骤完成。我们将使用Spring的消息源（MessageSource）功能来支持多语言文本。
步骤 1: 创建项目
首先，创建一个新的Spring Boot项目。可以使用Spring Initializr（start.spring.io/）来生成项目，选择以下…
Spring Web
Spring Boot DevTools（可选，用于热重载）
springboot-demo com.et 1.0-SNAPSHOT 4.0.0
<artifactId>i18n</artifactId>
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-autoconfigure</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
步骤 2: 创建国际化资源文件
在src/main/resources目录下，创建一个名为messages的文件夹，并在其中创建不同语言的资源文件。例如：
messages.properties（默认语言，通常是英语）messages_zh.properties（中文）messages_fr.properties（法语）
每个文件的内容如下：
messages.properties（默认语言）
greeting=Hello! farewell=Goodbye!
messages_zh.properties（中文）
greeting=你好! farewell=再见!
messages_fr.properties（法语）
greeting=Bonjour! farewell=Au revoir!
步骤 3: 配置MessageSource
在Spring Boot中，默认会自动配置MessageSource，但你可以自定义配置。创建一个配置类，例如MessageConfig：
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.support.ReloadableResourceBundleMessageSource;
@Configuration
public class MessageConfig {
@Bean
public ReloadableResourceBundleMessageSource messageSource() {
ReloadableResourceBundleMessageSource messageSource = new ReloadableResourceBundleMessageSource();
messageSource.setBasename("classpath:messages/messages");
messageSource.setDefaultEncoding("UTF-8");
return messageSource;
}
}
步骤 4: 创建Controller
创建一个控制器来处理请求并返回国际化的消息：
package com.et.controller;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.MessageSource;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestHeader;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.servlet.LocaleResolver;
import javax.servlet.http.HttpServletRequest;
import java.util.Locale;
@RestController
public class GreetingController {
@Autowired
private MessageSource messageSource;
@Autowired
private LocaleResolver localeResolver;
@GetMapping("/greeting")
public String greeting(HttpServletRequest request, @RequestHeader(value = "Accept-Language", required = false) String acceptLanguage) {
Locale locale = localeResolver.resolveLocale(request);
// set language by Accept-Language
if (acceptLanguage != null && !acceptLanguage.isEmpty()) {
String[] languages = acceptLanguage.split(",");
String language = languages[0].split(";")[0]; // get the first language
language = language.trim();
locale = Locale.forLanguageTag(language);
}
return messageSource.getMessage("greeting", null, locale);
}
}
步骤 5: 前端实现
如果你有前端页面，可以通过AJAX请求获取国际化文本。例如，使用JavaScript：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Internationalization Example</title>
<style>
body {
font-family: Arial, sans-serif;
background-color: #f0f0f0;
color: #333;
padding: 20px;
}
select {
margin-bottom: 20px;
}
</style>
</head>
<body>
<h1 id="greeting"></h1>
<label for="language-select">Choose a language:</label>
<select id="language-select">
<option value="en">English</option>
<option value="zh">中文</option>
<option value="fr">Français</option>
</select>
<script>
function fetchGreeting(lang) {
fetch('/greeting', {
method: 'GET',
headers: {
'Accept-Language': lang
}
})
.then(response => response.text())
.then(data => {
document.getElementById('greeting').innerText = data;
});
}
// Fetch greeting based on selected language
document.getElementById('language-select').addEventListener('change', function() {
const selectedLang = this.value;
fetchGreeting(selectedLang);
});
// Initial fetch in English
fetchGreeting('en');
</script>
</body>
</html>
以上只是一些关键代码，所有代码请参见下面代码仓库
代码仓库
github.com/Harries/springboot-demo(i18n)
3.测试
启动Spring Boot应用，访问http://127.0.0.1:8088/index.html。效果如下图
4.总结
通过以上步骤，你可以在Spring Boot应用中实现国际化。你可以根据用户的语言偏好动态地返回不同的文本内容。根据需要，你可以扩展更多语言和消息，并在前端实现语言切换功能。
到此这篇关于SpringBoot实现国际化i18n详解的文章就介绍到这了,更多相关SpringBoot国际化i18n内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
这篇文章主要介绍了Java web数据可视化实现原理解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2020-03-03
这篇文章主要介绍了spring boot中的静态资源加载处理方式,需要的朋友可以参考下2017-04-04
spring @Cacheable扩展实现缓存自动过期时间及自动刷新功能
用过spring cache的朋友应该会知道,Spring Cache默认是不支持在@Cacheable上添加过期时间的,虽然可以通过配置缓存容器时统一指定,本文主要介绍了如何基于spring @Cacheable扩展实现缓存自动过期时间以及缓存即将到期自动刷新,2024-02-02
在Web开发中,防止用户重复提交表单是一个常见的需求,用户可能会因为网络延迟、误操作等原因多次点击提交按钮,导致后台接收到多个相同的请求,本文将介绍几种在Spring Boot中实现接口防重复提交的方法,需要的朋友可以参考下2024-11-11
无论是刚刚入门Java的新手还是已经工作了的老司机，恐怕都不容易把Java代码如何一步步被CPU执行起来这个问题完全讲清楚。本文就带你详细了解Java代码到底是怎么运行起来的。感兴趣的同学可以参考阅读2023-03-03
这篇文章主要介绍了如何使用会话Cookie和Java实现JWT身份验证，帮助大家更好的理解和使用Java，感兴趣的朋友可以了解下2021-03-03
springboot 自定义权限标签(tld),在freemarker引用操作
这篇文章主要介绍了springboot 自定义权限标签(tld),在freemarker引用操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2020-09-09
这篇文章主要介绍了Java中Range函数的简单介绍，Java中的range方法用于返回IntStream和LongStream在函数参数范围内的顺序值2022-07-07
Maven dependencyManagement元素标签的具体使用
在Maven中dependencyManagement的作用其实相当于一个对所依赖jar包进行版本管理的管理器,本文主要介绍了Maven dependencyManagement元素标签的具体使用,感兴趣的可以了解一下2024-03-03
如果Spring 被回收掉,Spring管理的bean全部会被回收,那我们的Java应用不就被一锅端了吗？所以本文小编将和大家一起聊聊Spring如何避免被JVM垃圾回收,需要的朋友可以参考下2023-11-11
最新评论