脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 软件编程 → java → Spring国际化与本地化

Spring实现国际化与本地化的详细步骤

 更新时间：2025年06月18日 10:52:41   作者：潜意识Java  
在全球化背景下,应用支持多语言和本地化显示是满足不同地区用户需求的关键,Spring 的国际化与本地化功能,能帮助开发者轻松实现应用的语言切换与区域适配,下面从核心概念、实现步骤、应用场景等方面详细解析其实现方式,需要的朋友可以参考下

一、核心概念：国际化（i18n）与本地化（l10n）

  • 国际化（Internationalization）：简称 i18n，指设计应用时使其能够适应不同语言和区域的过程。开发者需将应用中的固定文本（如提示信息、按钮标签）提取为可替换的资源，避免硬编码。
  • 本地化（Localization）：简称 l10n，是根据用户的语言、地区等偏好，将国际化后的应用内容显示为对应语言和格式（如日期、货币）的过程。例如，将英文界面切换为中文，或者根据地区显示不同格式的日期（美式 “MM/dd/yyyy” vs 中式 “yyyy-MM-dd”）。

二、Spring 国际化实现步骤

1. 创建资源文件

在src/main/resources目录下创建以messages为基础名，后跟语言代码和区域代码的属性文件。常见的语言代码如zh（中文）、en（英文），区域代码如CN（中国）、US（美国）。

  • messages.properties：默认资源文件，用于未匹配到特定语言时的兜底显示。
  • messages_zh_CN.properties：简体中文资源文件。
  • messages_en_US.properties：美式英语资源文件。

示例内容：

messages.properties

greeting=Hello!

messages_zh_CN.properties

greeting=你好！

messages_en_US.properties

greeting=Hello!

2. 配置 MessageSource

在 Spring 配置类（如@Configuration类）或application.properties中配置MessageSource，用于加载和管理资源文件。

Java 配置方式

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.support.ResourceBundleMessageSource;
 
@Configuration
public class AppConfig {
    @Bean
    public ResourceBundleMessageSource messageSource() {
        ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
        messageSource.setBasename("messages"); // 指定资源文件基础名
        messageSource.setDefaultEncoding("UTF-8"); // 设置编码
        return messageSource;
    }
}

application.properties 配置方式

spring.messages.basename=messages
spring.messages.encoding=UTF-8

3. 在代码中使用 MessageSource

通过注入MessageSource，调用getMessage方法获取对应语言的文本。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.MessageSource;
import org.springframework.context.i18n.LocaleContextHolder;
import org.springframework.stereotype.Component;
 
@Component
public class MessageService {
    private final MessageSource messageSource;
 
    @Autowired
    public MessageService(MessageSource messageSource) {
        this.messageSource = messageSource;
    }
 
    public String getGreeting() {
        return messageSource.getMessage("greeting", null, LocaleContextHolder.getLocale());
    }
}

上述代码中，LocaleContextHolder.getLocale()获取当前用户的区域设置，messageSource.getMessage根据区域设置查找对应的资源文件，返回相应的文本。

三、本地化实现：处理日期、数字和货币

Spring 通过DateFormat、NumberFormat等类实现不同区域的格式转换，结合@Bean配置和@Autowired注入使用。

1. 配置日期格式化

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.format.FormatterRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
 
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Locale;
 
@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addFormatters(FormatterRegistry registry) {
        registry.addFormatterForFieldType(Date.class, new SimpleDateFormat("yyyy-MM-dd", Locale.getDefault()));
    }
}

上述配置将Date类型数据格式化为 “yyyy-MM-dd”，并根据用户的区域设置动态调整。

2. 货币格式化

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.text.NumberFormat;
import java.util.Currency;
import java.util.Locale;
 
@Configuration
public class AppConfig {
    @Bean
    public NumberFormat currencyFormat() {
        Locale locale = Locale.getDefault();
        Currency currency = Currency.getInstance(locale);
        return NumberFormat.getCurrencyInstance(locale).setCurrency(currency);
    }
}

通过上述配置，在显示货币金额时，会根据用户区域自动使用对应货币符号和格式（如￥、$）。

四、在 Web 应用中实现语言切换

1. 通过请求参数切换语言

在 Controller 中接收lang参数，设置Locale。

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.servlet.LocaleResolver;
import org.springframework.web.servlet.support.RequestContextUtils;
 
import javax.servlet.http.HttpServletRequest;
import java.util.Locale;
 
@RestController
public class LanguageController {
    @GetMapping("/setLang")
    public String setLanguage(@RequestParam String lang, HttpServletRequest request) {
        LocaleResolver localeResolver = RequestContextUtils.getLocaleResolver(request);
        if (localeResolver != null) {
            localeResolver.setLocale(request, new Locale(lang));
        }
        return "Language set to: " + lang;
    }
}

用户访问/setLang?lang=zh即可将语言切换为中文，访问/setLang?lang=en切换为英文。

2. 通过 Cookie 或 Session 切换语言

实现自定义的LocaleResolver，将用户选择的语言存储在 Cookie 或 Session 中，下次访问时自动应用。

import org.springframework.web.servlet.LocaleResolver;
import org.springframework.web.servlet.i18n.CookieLocaleResolver;
 
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Locale;
 
public class CustomLocaleResolver extends CookieLocaleResolver {
    private static final String LANG_COOKIE_NAME = "myapp_lang";
 
    @Override
    public Locale resolveLocale(HttpServletRequest request) {
        Locale locale = super.resolveLocale(request);
        if (locale == null) {
            // 从Cookie获取语言，若不存在则使用默认语言
            String lang = request.getCookies() != null ? findCookieValue(request.getCookies(), LANG_COOKIE_NAME) : null;
            if (lang != null) {
                locale = new Locale(lang);
            }
        }
        return locale;
    }
 
    @Override
    public void setLocale(HttpServletRequest request, HttpServletResponse response, Locale locale) {
        // 将语言存储到Cookie
        super.setLocale(request, response, locale);
        setCookie(response, LANG_COOKIE_NAME, locale.getLanguage());
    }
 
    private String findCookieValue(javax.servlet.http.Cookie[] cookies, String cookieName) {
        for (javax.servlet.http.Cookie cookie : cookies) {
            if (cookie.getName().equals(cookieName)) {
                return cookie.getValue();
            }
        }
        return null;
    }
}

在 Spring 配置类中注册自定义LocaleResolver：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.LocaleResolver;
 
@Configuration
public class AppConfig {
    @Bean
    public LocaleResolver localeResolver() {
        return new CustomLocaleResolver();
    }
}

五、总结

Spring 的国际化与本地化功能通过资源文件管理、MessageSource配置和Locale设置，为开发者提供了一套完整的解决方案。通过合理配置和代码实现，能够轻松满足不同地区用户的语言和格式需求，提升应用的用户体验和全球化竞争力。在实际开发中，可根据项目需求灵活选择语言切换方式，并结合前端技术（如 Vue、React）实现更流畅的多语言交互效果。

以上就是Spring实现国际化与本地化的详细步骤的详细内容，更多关于Spring国际化与本地化的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

相关文章

  • Java C++题解leetcode769最多能完成排序的块

    Java C++题解leetcode769最多能完成排序的块

    这篇文章主要为大家介绍了Java C++题解leetcode769最多能完成排序的块示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
    2022-10-10
  • mybatis+springboot中使用mysql的实例

    mybatis+springboot中使用mysql的实例

    在软件开发中，数据库的引入是必不可少的，这里来展现一下通过mybatis框架在springboot中使用mysql，具有一定的参考价值，感兴趣的可以了解一下
    2021-07-07
  • 深入Java对象的地址的使用分析

    深入Java对象的地址的使用分析

    本篇文章介绍了，Java对象的地址的使用分析。需要的朋友参考下
    2013-05-05
  • Javaweb使用getPart接收表单文件过程解析

    Javaweb使用getPart接收表单文件过程解析

    这篇文章主要介绍了Javaweb使用getPart接收表单文件过程解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-07-07
  • java和jsp之间的request传值方法

    java和jsp之间的request传值方法

    这篇文章主要给大家介绍了关于java和jsp之间的request传值方法的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2020-10-10
  • SpringBoot中@RestControllerAdvice @ExceptionHandler异常统一处理类失效原因分析

    SpringBoot中@RestControllerAdvice @ExceptionHandler异常统一处

    这篇文章主要介绍了SpringBoot中@RestControllerAdvice @ExceptionHandler异常统一处理类失效原因,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-01-01
  • IDEA反编译jar,查看源码方式

    IDEA反编译jar,查看源码方式

    该篇文章总结了查看Java本地jar包注释的几种方法,包括使用快捷键CTRL+q和在设置中设置自动浮现注释
    2024-11-11
  • springboot2 jackson实现动态返回类字段方式

    springboot2 jackson实现动态返回类字段方式

    这篇文章主要介绍了springboot2 jackson实现动态返回类字段方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-08-08
  • 简单了解java ORM框架JOOQ

    简单了解java ORM框架JOOQ

    这篇文章主要介绍了简单了解java ORM框架JOOQ,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-12-12
  • MyBatis传入数组集合类并使用foreach遍历

    MyBatis传入数组集合类并使用foreach遍历

    这篇文章主要介绍了MyBatis传入数组集合类并使用foreach遍历,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-02-02

最新评论