本指南将向您展示如何轻松只需几个简单的步骤即可实现Spring Boot应用的国际化,从而总是在一个地方处理语言环境问题。
我们将讨论如何在现有的Spring Boot项目中添加国际化。当您处理应该为来自不同国家/地区的用户提供不同语言服务的项目时,app国际化的问题变得很常见。比如,你需要向中国用户提供中文回复信息,并向法国用户提供法语信息,那么让我们来看看如何在Spring Boot中实现它。
让我们使用Spring Initializer创建项目 ,这使得项目的创建更容易。选择Web,Security,JPA,Actuator,Devtools等模块。
下载项目后,解压缩,并用打开IntelliJ IDEA打开。
第一件事是创建CustomLocaleResolver类,它将负责定义用户的语言环境。
@Configuration <b>public</b> <b>class</b> CustomLocaleResolver <b>extends</b> AcceptHeaderLocaleResolver implements WebMvcConfigurer { List<Locale> LOCALES = Arrays.asList( <b>new</b> Locale(<font>"en"</font><font>), <b>new</b> Locale(</font><font>"fr"</font><font>)); @Override <b>public</b> Locale resolveLocale(HttpServletRequest request) { String headerLang = request.getHeader(</font><font>"Accept-Language"</font><font>); <b>return</b> headerLang == <b>null</b> || headerLang.isEmpty() ? Locale.getDefault() : Locale.lookup(Locale.LanguageRange.parse(headerLang), LOCALES); } @Bean <b>public</b> ResourceBundleMessageSource messageSource() { ResourceBundleMessageSource rs = <b>new</b> ResourceBundleMessageSource(); rs.setBasename(</font><font>"messages"</font><font>); rs.setDefaultEncoding(</font><font>"UTF-8"</font><font>); rs.setUseCodeAsDefaultMessage(<b>true</b>); <b>return</b> rs; } } </font>
这里告诉我们项目中支持2个语言环境:en和fr。在名为“ Accept-Language ” 的http的Header中传递语言环境。因此,如果Header存在这个变量名且它不为空,我们将使用它的语言环境,否则 - 我们将使用默认语言环境,即en。
接下来让我们创建一个类,负责根据指定的语言环境选择正确的语言信息。我将其称为Translator,它将有一个单独的方法,它将接受应翻译的信息代码。
@Component <b>public</b> <b>class</b> Translator { <b>private</b> <b>static</b> ResourceBundleMessageSource messageSource; @Autowired Translator(ResourceBundleMessageSource messageSource) { Translator.messageSource = messageSource; } <b>public</b> <b>static</b> String toLocale(String msgCode) { Locale locale = LocaleContextHolder.getLocale(); <b>return</b> messageSource.getMessage(msg, <b>null</b>, locale); } }
messageSource.getMessage(...)接受入参“msg”。但这并不是应该翻译的信息,它只是信息代码。现在我们还没有任何信息代码定义,所以现在定义信息代码。
在resources文件夹下,创建两个文件:messages.properties和messages_fr.properties。
这是messages.properties的内容:
hello=Hello World!
welcome=Welcome to this guide!
这里是messages_fr.properties的内容:
hello=Bonjour le Monde!
welcome=Bienvenue dans ce guide!
在这里我们已经定义了我们的消息代码。他们是“ hellp ”和“ welcome ”。现在你可以指导我们应该将哪些代码传递给toLocale(String msgCode)方法,这样才能根据用户的语言环境获取适当的消息。
可能最后一步是创建简单的控制器,让我们将它命名为MainController,它只有一个端点,它将接受消息代码,我们将其作为请求参数传递给HTTP请求。
@RestController @RequestMapping(value =“/ api”) <b>public</b> <b>class</b> MainController { @GetMapping() <b>public</b> String getMessage(@RequestParam(“msg”)String msg){ <b>return</b> Translator。toLocale(msg) ; } }
现在已经完成!
使用CURL发出简单的请求:
curl -X GET -H "Accept-Language: fr" 'http://localhost:8080/api?msg-welcome'
这个将返回法语的welcome信息:
Bienvenue dans ce guide!
再发出请求:
curl -X GET -H "Accept-Language: en" 'http://localhost:8080/api?msg-welcome'
这个将返回英语的welcome信息:
welcome to this guide!
正如你看到:响应会根据请求中传递的“ Accept-Language ”标头的值而有所不同。这样,我们不需要检查每个控制器方法中请求中传递的内容,然后将其进一步传递给服务层。我们现在可以在一个单独的地方执行此操作,即CustomLocaleResolver类。
源码: GitHub