Spring Boot 国际化,国际化是一个过程,可以使您的应用程序适应不同的语言和地区,而无需对源代码进行工程更改。换句话说,国际化是本地化的准备。在本章中,我们将详细了解如何在 Spring Boot 中实现国际化。
依赖关系
我们需要 Spring Boot Starter Web 和 Spring Boot Starter Thymeleaf 依赖项来在 Spring Boot 中开发 Web 应用程序。
Maven
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency>
Gradle
compile('org.springframework.boot:spring-boot-starter-web') compile group: 'org.springframework.boot', name: 'spring-boot-starter-thymeleaf'
LocaleResolver
我们需要确定您的应用程序的默认区域设置。我们需要在 Spring Boot 应用程序中添加 LocaleResolver bean。
@Bean public LocaleResolver localeResolver() { SessionLocaleResolver sessionLocaleResolver = new SessionLocaleResolver(); sessionLocaleResolver.setDefaultLocale(Locale.US); return sessionLocaleResolver; }
LocaleChangeInterceptor
LocaleChangeInterceptor 用于根据添加到请求的语言参数的值更改新的 Locale。
@Bean public LocaleChangeInterceptor localeChangeInterceptor() { LocaleChangeInterceptor localeChangeInterceptor = new LocaleChangeInterceptor(); localeChangeInterceptor.setParamName("language"); return localeChangeInterceptor; }
为了达到这个效果,我们需要将 LocaleChangeInterceptor 添加到应用程序的注册表拦截器中。配置类应该扩展 WebMvcConfigurerAdapter 类并覆盖 addInterceptors() 方法。
@Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(localeChangeInterceptor()); }
消息来源
默认情况下,Spring Boot 应用程序从类路径下的 src/main/resources文件夹中获取消息源。默认语言环境消息文件名应为message.properties,每个语言环境的文件应命名为messages_XX.properties。“XX”代表地区代码。
所有消息属性都应用作密钥对值。如果在语言环境中找不到任何属性,应用程序将使用 messages.properties 文件中的默认属性。
默认的 messages_en.properties 将如图所示 –
welcome.text=Hi Welcome to Everyone
汉语语言 messages.properties 将如图所示 –
welcome.text=嗨,欢迎大家
注意-消息源文件应保存为“UTF-8”文件格式。
HTML文件
在 HTML 文件中,使用语法#{key}显示属性文件中的消息。
<h1 th:text = "#{welcome.text}"></h1>
完整代码如下
Maven – pom.xml
<?xml version = "1.0" encoding = "UTF-8"?> <project xmlns = "http://maven.apache.org/POM/4.0.0" xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation = "http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.tutorialspoint</groupId> <artifactId>demo</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>jar</packaging> <name>demo</name> <description>Demo project for Spring Boot</description> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>1.5.8.RELEASE</version> <relativePath /> </parent> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> <java.version>1.8</java.version> </properties> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>
Gradle——build.gradle
buildscript { ext { springBootVersion = '1.5.8.RELEASE' } repositories { mavenCentral() } dependencies { classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}") } } apply plugin: 'java' apply plugin: 'eclipse' apply plugin: 'org.springframework.boot' group = 'net.zuze' version = '0.0.1-SNAPSHOT' sourceCompatibility = 1.8 repositories { mavenCentral() } dependencies { compile('org.springframework.boot:spring-boot-starter-web') compile group: 'org.springframework.boot', name: 'spring-boot-starter-thymeleaf' testCompile('org.springframework.boot:spring-boot-starter-test') }
主要的 Spring Boot 应用程序类文件如下:
package net.zuze.demo; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }
控制器类文件如下 –
package net.zuze.demo.controller; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; @Controller public class ViewController { @RequestMapping("/locale") public String locale() { return "locale"; } }
支持国际化的配置类
package net.zuze.demo; import java.util.Locale; 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.WebMvcConfigurerAdapter; import org.springframework.web.servlet.i18n.LocaleChangeInterceptor; import org.springframework.web.servlet.i18n.SessionLocaleResolver; @Configuration public class Internationalization extends WebMvcConfigurerAdapter { @Bean public LocaleResolver localeResolver() { SessionLocaleResolver sessionLocaleResolver = new SessionLocaleResolver(); sessionLocaleResolver.setDefaultLocale(Locale.US); return sessionLocaleResolver; } @Bean public LocaleChangeInterceptor localeChangeInterceptor() { LocaleChangeInterceptor localeChangeInterceptor = new LocaleChangeInterceptor(); localeChangeInterceptor.setParamName("language"); return localeChangeInterceptor; } @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(localeChangeInterceptor()); } }
消息源 – messages_en.properties 如图所示 –
welcome.text = Hi Welcome to Everyone
消息源 – message.properties 如下所示 –
welcome.text = 嗨,欢迎大家
HTML 文件 locale.html 应该放在类路径的模板目录下,如下所示 –
<!DOCTYPE html> <html> <head> <meta charset = "ISO-8859-1"/> <title>Internationalization</title> </head> <body> <h1 th:text = "#{welcome.text}"></h1> </body> </html>
您可以创建一个可执行 JAR 文件,并使用以下 Maven 或 Gradle 命令运行 Spring boot 应用程序 –
对于 Maven,使用以下命令 –
mvn clean install
“BUILD SUCCESS”后,可以在目标目录下找到JAR文件。
对于 Gradle,使用以下命令 –
gradle clean build
“BUILD SUCCESS”后,您可以在build/libs 目录下找到 JAR 文件。
现在,使用如下所示的命令运行 JAR 文件 –
java –jar
你会发现应用已经在Tomcat的8080端口上启动了。
现在在您的网络浏览器中点击 URL http://localhost:8080/locale
将为您展示 嗨,欢迎大家 输出
现在在您的网络浏览器中点击 URL http://localhost:8080/locale?language=en
将为您展示 Hi Welcome to Everyone 输出