Spring如何实现国际化

发布时间：2026-01-03 21:02:40 来源：亿速云阅读：95 作者：小樊栏目：编程语言

在Spring框架中，实现国际化（i18n）主要依赖于MessageSource接口及其相关配置。以下是实现Spring国际化的步骤：

1. 配置MessageSource

首先，需要在Spring配置文件中定义一个MessageSource bean。这通常在applicationContext.xml或通过Java配置类完成。

XML配置示例：

<bean id="messageSource" class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
    <property name="basename" value="classpath:messages"/>
    <property name="defaultEncoding" value="UTF-8"/>
    <property name="useCodeAsDefaultMessage" value="true"/>
</bean>

Java配置示例：

import org.springframework.context.MessageSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.support.ReloadableResourceBundleMessageSource;

@Configuration
public class InternationalizationConfig {

    @Bean
    public MessageSource messageSource() {
        ReloadableResourceBundleMessageSource messageSource = new ReloadableResourceBundleMessageSource();
        messageSource.setBasename("classpath:messages");
        messageSource.setDefaultEncoding("UTF-8");
        messageSource.setUseCodeAsDefaultMessage(true);
        return messageSource;
    }
}

2. 创建资源文件

在src/main/resources目录下创建不同语言的资源文件。例如：

messages.properties (默认语言)
messages_en.properties (英语)
messages_zh_CN.properties (简体中文)

每个文件中定义键值对，键是消息代码，值是对应语言的消息。

messages.properties:

greeting=Hello
welcome=Welcome to our application

messages_en.properties:

greeting=Hi
welcome=Welcome to our application

messages_zh_CN.properties:

greeting=你好
welcome=欢迎使用我们的应用程序

3. 在视图中使用消息

在JSP、Thymeleaf或其他视图技术中，可以使用Spring的<spring:message>标签或#{}表达式来获取国际化消息。

JSP示例：

<%@ taglib prefix="spring" uri="http://www.springframework.org/tags"%>

<html>
<body>
    <h1><spring:message code="greeting"/></h1>
    <p><spring:message code="welcome"/></p>
</body>
</html>

Thymeleaf示例：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<body>
    <h1 th:text="#{greeting}"></h1>
    <p th:text="#{welcome}"></p>
</body>
</html>

4. 设置Locale

为了根据用户的语言偏好显示相应的消息，需要设置Locale。可以通过多种方式实现：

通过URL参数：

import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Locale;

public class LocaleInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        String lang = request.getParameter("lang");
        if (lang != null) {
            Locale locale = new Locale(lang);
            request.getSession().setAttribute(org.springframework.web.servlet.i18n.SessionLocaleResolver.LOCALE_SESSION_ATTRIBUTE_NAME, locale);
        }
        return true;
    }

    // 其他方法省略
}

配置LocaleResolver：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.LocaleResolver;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import org.springframework.web.servlet.i18n.LocaleChangeInterceptor;
import org.springframework.web.servlet.i18n.SessionLocaleResolver;

import java.util.Locale;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Bean
    public LocaleResolver localeResolver() {
        SessionLocaleResolver slr = new SessionLocaleResolver();
        slr.setDefaultLocale(Locale.US);
        return slr;
    }

    @Bean
    public LocaleChangeInterceptor localeChangeInterceptor() {
        LocaleChangeInterceptor lci = new LocaleChangeInterceptor();
        lci.setParamName("lang");
        return lci;
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(localeChangeInterceptor());
    }
}

通过以上步骤，你可以在Spring应用中实现国际化，根据用户的语言偏好显示相应的消息。

向AI问一下细节