Spring框架中的LocaleResolver：国际化与本地化处理详解

巫文钧Jill

于 2025-05-30 09:05:53 发布

阅读量387

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00386/article/details/148324437

Spring框架中的LocaleResolver：国际化与本地化处理详解

spring-framework 项目地址: https://gitcode.com/gh_mirrors/spr/spring-framework

概述

在Web应用开发中，国际化（i18n）是一个重要特性，它允许应用根据用户的语言和地区偏好提供不同语言版本的内容。Spring MVC框架提供了完善的国际化支持，其中LocaleResolver是实现这一功能的核心组件。

LocaleResolver工作机制

当请求到达DispatcherServlet时，它会自动查找并调用配置的LocaleResolver来解析客户端的区域设置（Locale）。开发者可以通过RequestContext.getLocale()方法获取解析后的Locale信息。

Spring提供了多种LocaleResolver实现，每种实现都有其特定的应用场景：

1. AcceptHeaderLocaleResolver（基于HTTP头的解析器）

这是最简单的实现，它通过解析HTTP请求中的Accept-Language头部来确定客户端的区域设置。

特点：

完全依赖客户端浏览器发送的语言首选项
不支持时区设置
无法动态修改Locale

适用场景：简单的国际化需求，不需要用户手动切换语言的场景。

2. CookieLocaleResolver（基于Cookie的解析器）

这种实现将用户的区域设置存储在Cookie中，允许跨会话保持语言偏好。

配置示例：

<bean id="localeResolver" class="org.springframework.web.servlet.i18n.CookieLocaleResolver">
    <property name="cookieName" value="clientlanguage"/>
    <property name="cookieMaxAge" value="100000"/>
</bean>

关键属性：

cookieName：自定义Cookie名称（默认：类名+LOCALE）
cookieMaxAge：Cookie有效期（秒），-1表示浏览器关闭即失效
cookiePath：限制Cookie的作用路径

优点：

持久化用户语言偏好
支持时区设置
跨会话保持设置

3. SessionLocaleResolver（基于Session的解析器）

这种实现将区域设置存储在HttpSession中。

特点：

设置仅在当前会话有效
会话结束后设置丢失
支持时区设置
与外部会话管理机制（如Spring Session）无直接关联

适用场景：需要临时保存用户语言设置的场景。

时区处理

Spring通过LocaleContextResolver接口扩展了时区支持。开发者可以通过RequestContext.getTimeZone()获取用户时区，Spring的ConversionService会自动使用时区信息处理日期/时间转换。

LocaleChangeInterceptor（区域变更拦截器）

这个拦截器允许通过请求参数动态改变区域设置。

配置示例：

<bean id="localeChangeInterceptor" 
      class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor">
    <property name="paramName" value="siteLanguage"/>
</bean>

工作流程：