• SpringBoot起飞系列-国际化(六)


    一、前言


    国际化这个功能可能我们不常用,但是在有需要的地方还是必须要上的,今天我们就来看一下怎么在我们的web开发中配置国际化,让我们的网站可以根据语言来展示不同的形式。本文接续上一篇SpringBoot起飞系列-Web开发(五)来在此基础上进行国际化配置。


    二、国际化配置


    2.1 springboot中的自动配置


    springboot已经自动配置好了管理国际化资源文件的组件:



    @ConfigurationProperties(prefix = 'spring.messages')
    public class MessageSourceAutoConfiguration {

    /**
    * Comma-separated list of basenames (essentially a fully-qualified classpath
    * location), each following the ResourceBundle convention with relaxed support for
    * slash based locations. If it doesn't contain a package qualifier (such as
    * 'org.mypackage'), it will be resolved from the classpath root.
    */
    private String basename = 'messages';
    //我们的配置文件可以直接放在类路径下叫messages.properties;

    @Bean
    public MessageSource messageSource() {
    ResourceBundleMessageSource messageSource
    = new ResourceBundleMessageSource();
    if (StringUtils.hasText(this.basename)) {
    //设置国际化资源文件的基础名(去掉语言国家代码的)
    messageSource.setBasenames(StringUtils.commaDelimitedListToStringArray(
    StringUtils.trimAllWhitespace(
    this.basename)));
    }
    if (this.encoding != null) {
    messageSource.setDefaultEncoding(
    this.encoding.name());
    }
    messageSource.setFallbackToSystemLocale(
    this.fallbackToSystemLocale);
    messageSource.setCacheSeconds(
    this.cacheSeconds);
    messageSource.setAlwaysUseMessageFormat(
    this.alwaysUseMessageFormat);
    return messageSource;
    }


    从上边的源码我们可以看出,我们的国际化资源文件可以直接起名字为messages.properties,springboot就会自动识别,其实相当于在配置文件中添加了一个spring.messages.basename=messages,如果我们指定一个xxx.properties作为国际化文件,那么我们就指定


    spring.messages.basename=xxx就可以了,springboot会自动的找到以xxx开头的properties,根据语言和国家代码,找到相应的xxx_zh_CN.properties(中文_中国)、xxx_en_US.properties(英文_美国)来选择其中的资源值作为当前页面中所要渲染的值。


    2.2 添加资源文件


    我们新建一个名称为i18n的文件夹,在里边添加3个配置文件,分别是login.properties(默认无语言选择时的配置),login_zh_CN.properties(中文语言配置),login_en_US.properties(英文语言配置),默认的格式为:文件名_区域_语言.properties;当我们这样命名生成文件后,IDEA也会帮我们识别这是个国际化配置包,自动转换成如下的模式,上边附带一个Resource Bundle 'login'的文件夹,右键在这个文件夹上点击,就可以方便的添加其他语言的配置:





    分别在三个配置文件中写入配置:


    login.properties:



    login.btn=登陆~
    login.password
    =密码~
    login.remember
    =记住我~
    login.tip
    =请登陆~
    login.username
    =用户名~


    login_zh_CN.properties:



    login.tip=请登录
    login.username
    =用户名
    login.password
    =密码
    login.btn
    =登录
    login.remember
    = 记住我


    login_en_US.properties:



    login.tip=Please sign in
    login.username
    =Username
    login.password
    =Password
    login.btn
    =Sign in
    login.remember
    = Remember Me


    然后我们的主配置文件application.properties中添加如下配置,启用我们自定义的资源文件:



    spring.messages.basename=i18n.login


     2.3 添加登录页面


    这里我们以之前的thymeleaf语法来添加一个登录页面来进行测试:



    <!DOCTYPE html>
    <html lang='en' xmlns:th='http://www.thymeleaf.org'>
    <head>
    <meta http-equiv='Content-Type' content='text/html; charset=UTF-8'>
    <meta name='viewport' content='width=device-width, initial-scale=1, shrink-to-fit=no'>
    <meta name='description' content=''>
    <meta name='author' content=''>
    <title>Signin Template for Bootstrap</title>
    <!-- Bootstrap core CSS -->
    <link th:href='@{/webjars/bootstrap/4.0.0/css/bootstrap.css}' rel='stylesheet'>
    <!-- Custom styles for this template -->
    <link th:href='@{/asserts/css/signin.css}' rel='stylesheet'>
    </head>
    <body class='text-center'>
    <form class='form-signin' action='dashboard.html' th:action='@{/user/login}' method='post'>
    <img class='mb-4' th:src='@{/asserts/img/bootstrap-solid.svg}' src='asserts/img/bootstrap-solid.svg' alt='' width='72' height='72'>
    <h1 class='h3 mb-3 font-weight-normal' th:text='#{login.tip}'>Please sign in</h1>
    <!--判断-->
    <p style='color: red' th:text='${msg}' th:if='${not #strings.isEmpty(msg)}'></p>
    <label class='sr-only' th:text='#{login.username}'>Username</label>
    <input type='text' name='username' class='form-control' placeholder='Username' th:placeholder='#{login.username}' required='' autofocus=''>
    <label class='sr-only' th:text='#{login.password}'>Password</label>
    <input type='password' name='password' class='form-control' placeholder='Password' th:placeholder='#{login.password}' required=''>
    <div class='checkbox mb-3'>
    <label>
    <input type='checkbox' value='remember-me'/> [[#{login.remember}]]
    </label>
    </div>
    <button class='btn btn-lg btn-primary btn-block' type='submit' th:text='#{login.btn}'>Sign in</button>
    <p class='mt-5 mb-3 text-muted'>© 2017-2018</p>
    <a class='btn btn-sm' th:href='@{/index.html(lang='zh_CN')}'>中文</a>
    <a class='btn btn-sm' th:href='@{/index.html(lang='en_US')}'>English</a>
    </form>
    </body>

    </html>


    #{login.username} 会直接从国际化的资源文件中取到我们所配置的值,根据不同的语言会切换为不同的语言配置,默认是根据浏览器的语言来判断的,我们可以按照以下方式来设置浏览器的语言来查看效果,在谷歌浏览器的设置里边搜索语言,然后添加一个英文语言,设置语言的顺序来设置首选语言,如下所示:



    我们也可以查看浏览器发送的请求头部分来确定语言是否 设置成功:



    2.4 自定义语言文化解析器


    从上边我们可以看出,默认的是从请求头中解析语言文化的,我们可以设置自己的解析器,比如访问页面的查询参数中来解析语言,下边是我们的登录页面,我们可以添加两个按钮,当点击按钮的时候,重新跳转index.html页面,并附带上一个lang的参数:



    可以查看网页源代码,我们生成的链接:



    html关键代码,用thymeleaf生成,也可以自己手写:



    <button class='btn btn-lg btn-primary btn-block' type='submit' th:text='#{login.btn}'>Sign in</button>
    <p class='mt-5 mb-3 text-muted'>© 2017-2018</p>
    <a class='btn btn-sm' th:href='@{/index.html(lang='zh_CN')}'>中文</a>
    <a class='btn btn-sm' th:href='@{/index.html(lang='en_US')}'>English</a>


    添加我们自己的解析器MyLocaleResolver,从请求参数中获取lang,根据lang的值来设置不同的Locale:




    package com.example.demo.component;

    import org.springframework.util.StringUtils;
    import org.springframework.web.servlet.LocaleResolver;

    import javax.servlet.http.HttpServletRequest;
    import javax.servlet.http.HttpServletResponse;
    import java.util.Locale;

    public class MyLocaleResolver implements LocaleResolver {
    @Override
    public Locale resolveLocale(HttpServletRequest httpServletRequest) {
    String lang
    = httpServletRequest.getParameter('lang');
    Locale locale
    = Locale.getDefault();
    if(!StringUtils.isEmpty(lang)){
    String[] parts
    = lang.split('_');
    locale
    = new Locale(parts[0],parts[1]);
    }
    return locale;
    }

    @Override
    public void setLocale(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Locale locale) {

    }
    }


    在WebConfig添加如下代码,把这个MyLocaleResolver添加到容器中去,springboot发现到有LocaleResolver的新实例,就会用这个解析器:



    重新编译启动就可以了,点击不同语言跳转不同链接,显示不同的语言:



    三、总结


    springboot中的国际化配置还是比较简单的,虽然我们日常中用到很少,但是还是有必要了解一下的。

  • 相关阅读:
    移动端hybrid开发复盘
    node/webpack 调试 loader 等技巧
    javascript(js)小数精度丢失的解决方案
    必经之路--买房之后需要走的流程--针对 组合贷款方式
    canvas 画半圆的两种方式
    svg path 画圆
    1.快速排序
    7.桥接设计模式
    6.适配器设计模式
    5.策略设计模式
  • 原文地址:https://www.cnblogs.com/Yangbuyi/p/13388331.html
Copyright © 2020-2023  润新知