SpringBoot系列——i18n國際化

時間 2019-11-24

原文原文鏈接

　　前言

　　國際化是項目中不可或缺的功能，本文將實現springboot + thymeleaf的HTML頁面、js代碼、java代碼國際化過程記錄下來。javascript

　　代碼編寫

　　工程結構html

　　每一個文件裏面的值（按工程結構循序從上往下）java

##################默認值#############################
welcome=Welcome

##################英文#############################
welcome=Welcome

##################簡體中文#############################
welcome=歡迎

##################簡體中文#############################
welcome=歡迎

　　yml配置文件jquery

#注意:在yml文件中添加value值時,value前面須要加一個空格
#2.0.0的配置切換爲servlet.path而不是"-"
server:
  port: 10086 #端口號
  servlet:
    context-path: /springboot #訪問根路徑

spring:
    thymeleaf:
      cache: false  #關閉頁面緩存
      prefix: classpath:/view/  #thymeleaf訪問根路徑
      mode: LEGACYHTML5

    messages:
      basename: static/i18n/messages #指定國際化文件路徑

　　LocaleConfig.java，git

@Configuration
@EnableAutoConfiguration
@ComponentScan
public class LocaleConfig extends WebMvcConfigurerAdapter {

    @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());
    }

}

　　controllergithub

　　單純的跳轉頁面便可web

    @RequestMapping("/i18nTest")
    public ModelAndView i18nTest(){
        ModelAndView mv=new ModelAndView();
        mv.setViewName("i18nTest.html");
        return mv;
    }

　　HTML使用，注意要用 #{} 來取值spring

<!DOCTYPE html>
<!--解決idea thymeleaf 表達式模板報紅波浪線-->
<!--suppress ALL -->
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title></title>
</head>
<body>
    <h3 th:text="#{welcome}"></h3>
    <a href="?lang=en_US">English(US)</a>
    &nbsp;&nbsp;&nbsp;&nbsp;
    <a href="?lang=zh_CN">簡體中文</a>
    &nbsp;&nbsp;&nbsp;&nbsp;
    <a href="?lang=zh_TW">繁體中文</a>
</body>
</html>

　　js代碼使用緩存

　　須要先引入jquery插件，自行百度下載或者使用webjar去拉取，能夠封裝成一個全局方法，用到時直接調用springboot

    <script th:src="@{/js/jquery-1.9.1.min.js}"></script>
    <script th:src="@{/js/jquery.i18n.properties.js}"></script>

<script th:inline="javascript">
    //項目路徑
    ctx = [[${#request.getContextPath()}]];

    //初始化i18n插件
    try {
        $.i18n.properties({
            path: ctx + '/i18n/',
            name: 'messages',
            language: [[${#locale.language+'_'+#locale.country}]],
            mode: "both"
        });
    } catch (e) {
        console.error(e);
    }

    //初始化i18n方法
    function i18n(labelKey) {
        try {
            return $.i18n.prop(labelKey);
        } catch (e) {
            console.error(e);
            return labelKey;
        }
    }

    console.log(i18n("welcome"));
</script>

　　java代碼使用

　　先封裝個工具類，直接靜態調用

@Component
public class I18nUtil {

    private static MessageSource messageSource;

    public I18nUtil(MessageSource messageSource) {
        I18nUtil.messageSource = messageSource;
    }

    /**
     * 獲取單個國際化翻譯值
     */
    public static String get(String msgKey) {
        try {
            return messageSource.getMessage(msgKey, null, LocaleContextHolder.getLocale());
        } catch (Exception e) {
            return msgKey;
        }
    }
}

　　調用

        System.out.println(I18nUtil.get("welcome"));

　　效果展現

　　默認

　　英文

　　中文

　　繁體

　　結束語

　　文章部分參考：玩轉spring boot——國際化：https://www.cnblogs.com/GoodHelper/p/6824492.html

　　代碼開源

　　代碼已經開源、託管到個人GitHub、碼雲：

　　GitHub：https://github.com/huanzi-qch/springBoot

　　碼雲：https://gitee.com/huanzi-qch/springBoot

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。