spring boot国际化 i18n

Spring Boot的国际化（i18n）功能使得开发者可以轻松地为应用程序提供多语言支持，以便用户可以根据他们的偏好选择不同的语言界面。以下是对这个主题的详细讲解。 我们需要了解i18n这个术语，它是“Internationalization”的缩写，由于“i”和“n”之间有18个字母，所以称为i18n。它涉及到软件设计的各个阶段，旨在确保产品能够适应全球市场，而不仅仅是本地市场。 在Spring Boot中，实现i18n主要依赖于两个关键组件：`MessageSource`和资源文件。`MessageSource`是Spring框架提供的一种接口，用于加载和解析应用中的消息和本地化文本。资源文件通常是以.properties为扩展名的文件，存储了不同语言的文本键值对。 1. **配置MessageSource**： 在Spring Boot中，可以通过在配置类中配置`MessageSource`来启用i18n。通常，我们会使用`ResourceBundleMessageSource`，这是`MessageSource`的一个实现，它可以读取基于Java的资源包（.properties文件）。配置如下： ```java @Configuration public class MessageSourceConfig { @Bean public MessageSource messageSource() { ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource(); messageSource.setBasenames("classpath:i18n/messages"); messageSource.setDefaultEncoding("UTF-8"); return messageSource; } } ``` 在上述代码中，`basenames`属性设置为`classpath:i18n/messages`，意味着Spring将在类路径下的`i18n`目录查找名为`messages.properties`的资源文件。同时，我们设置了默认编码为UTF-8。 2. **创建资源文件**： 创建不同语言的资源文件，例如`messages.properties`（默认语言，通常是英语）、`messages_en_US.properties`（美国英语）、`messages_zh_CN.properties`（简体中文）等。每个文件包含一组键值对，如`greeting=Hello`，在不同的文件中根据语言设定不同的值。 3. **在视图中使用**： 在Thymeleaf或JSP等模板引擎中，我们可以使用表达式来显示本地化消息。例如，在Thymeleaf中： ```html <p th:text="#{greeting}">Hello</p> ``` Thymeleaf会自动从`MessageSource`获取对应语言的消息并显示。 4. **切换语言**： 要在页面间切换语言，可以创建一个处理请求的控制器方法，该方法接收语言参数并将其保存到Session中。例如： ```java @Controller public class LocaleController { @RequestMapping("/changeLanguage") public String changeLanguage(@RequestParam("language") String language, HttpSession session) { Locale locale = Locale.forLanguageTag(language); session.setAttribute(WebUtils.SessionLocaleResolver.LOCALE_KEY, locale); return "redirect:" + request.getHeader("Referer"); } } ``` 当用户选择新的语言后，此方法会更新Session中的语言设置，并重定向回之前的页面，确保页面内容使用新语言显示。 5. **自动检测和首选语言**： Spring Boot可以通过`Accept-Language`请求头自动检测用户的浏览器语言首选项。你可以在配置中设置`WebMvcConfigurer`来定制这个行为： ```java @Configuration public class WebConfig implements WebMvcConfigurer { @Override public void configureContentNegotiation(ContentNegotiationConfigurer configurer) { configurer.favorPathExtension(false) .favorParameter(true) .parameterName("mediaType") .ignoreAcceptHeader(false) .useJaf(false) .defaultContentType(MediaType.APPLICATION_JSON) .mediaTypes(map -> map.put("json", MediaType.APPLICATION_JSON)) .mediaTypes(map -> map.put("xml", MediaType.APPLICATION_XML)); } @Override public void configureLocaleResolver(LocaleResolver resolver) { SessionLocaleResolver slr = (SessionLocaleResolver) resolver; slr.setDefaultLocale(Locale.CHINA); } } ``` 通过以上步骤，你可以为Spring Boot应用实现完整的国际化功能，包括页面的中英文切换，并确保在页面跳转时，语言设置得以保持。记得在实际项目中，还要考虑如何优雅地处理未找到对应语言资源的情况，以及优化语言切换的用户体验。