Spring Boot REST国际化

Spring Boot REST国际化
本指南将向您展示如何轻松只需几个简单的步骤即可实现Spring Boot应用的国际化

我们将讨论如何在现有的Spring Boot项目中添加国际化。当您处理应该为来自不同国家/地区的用户提供不同语言服务的项目时,app国际化的问题变得很常见。比如,你需要向中国用户提供中文回复信息,并向法国用户提供法语信息,那么让我们来看看如何在Spring Boot中实现它。

让我们使用Spring Initializer创建项目 ,这使得项目的创建更容易。选择Web,Security,JPA,Actuator,Devtools等模块。

下载项目后,解压缩,并用IDE打开。

第一件事是创建CustomLocaleResolver类,它将负责定义用户的语言环境。


@Configuration
public

class

CustomLocaleResolver

 extends 
AcceptHeaderLocaleResolver

 implements 
WebMvcConfigurer
 {

List
<
Locale
> LOCALES = 
Arrays
.asList(

new

Locale
(
"en"
),

new

Locale
(
"fr"
));

@Override

public

Locale
 resolveLocale(
HttpServletRequest
 request) {

String
 headerLang = request.getHeader(
"Accept-Language"
);

return
 headerLang == 
null
 || headerLang.isEmpty()
 ? 
Locale
.getDefault()
 : 
Locale
.lookup(
Locale
.
LanguageRange
.parse(headerLang), LOCALES);
 }

@Bean

public

ResourceBundleMessageSource
 messageSource() {

ResourceBundleMessageSource
 rs = 
new

ResourceBundleMessageSource
();
 rs.setBasename(
"messages"
);
 rs.setDefaultEncoding(
"UTF-8"
);
 rs.setUseCodeAsDefaultMessage(
true
);

return
 rs;
 }
}

这里告诉我们项目中支持2个语言环境:en和fr。在名为“ Accept-Language ” 的http的Header中传递语言环境。因此,如果Header存在这个变量名且它不为空,我们将使用它的语言环境,否则 - 我们将使用默认语言环境,即en。

接下来让我们创建一个类,负责根据指定的语言环境选择正确的语言信息。我将其称为Translator,它将有一个单独的方法,它将接受应翻译的信息代码。

@Component
public

class

Translator

{

private

static

ResourceBundleMessageSource
 messageSource
;

@Autowired

Translator
(
ResourceBundleMessageSource
 messageSource
)

{

Translator
.
messageSource 
=
 messageSource
;

}

public

static

String
 toLocale
(
String
 msgCode
)

{

Locale
 locale 
=

LocaleContextHolder
.
getLocale
();

return
 messageSource
.
getMessage
(
msg
,

null
,
 locale
);

}
}

messageSource.getMessage(...)接受入参“msg”。但这并不是应该翻译的信息,它只是信息代码。现在我们还没有任何信息代码定义,所以现在定义信息代码。

在resources文件夹下,创建两个文件:messages.properties和messages_fr.prop``erties。

这是messages.properties的内容:

hello
=
Hello

World
!
welcome
=
Welcome
 to 
this
 guide
!
这里是messages_fr.properties的内容:

hello
=
Bonjour
 le 
Monde
!
welcome
=
Bienvenue
 dans ce guide
!

在这里我们已经定义了我们的消息代码。他们是“ hello ”和“ welcome ”。现在你可以指导我们应该将哪些代码传递给toLocale(String msgCode)方法,这样才能根据用户的语言环境获取适当的消息。

可能最后一步是创建简单的控制器,让我们将它命名为MainController,它只有一个端点,它将接受消息代码,我们将其作为请求参数传递给HTTP请求。

@RestController
@RequestMapping
(
value 
=“/
 api
”)
public

class

MainController

{
@GetMapping
()
public

String
 getMessage
(
@RequestParam
(“
msg
”)
String
 msg
){
return

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类。

猜你喜欢

转载自blog.51cto.com/13981400/2313075