5.2.1 AcceptHeaderLocaleResolver 基于浏览器请求的国际化

发表于 2019-06-02 更新于 2020-06-04 分类于 4 Spring+Mybatis企业应用实战(第2版) ，第5章 Spring MVC的国际化， 5.2 Spring MVC的国际化处理 Waline：本文字数： 6.5k 阅读时长 ≈ 6 分钟

5.2 Spring MVC的国际化处理

5.2.1 AcceptHeaderLocaleResolver

AcceptHeaderLocaleResolver是默认的,也是最容易使用的语言区域解析器。使用它,Spring MVC会读取浏览器的accept-language标题,来确定使用哪个语言区域。AcceptHeaderLocaleResolver可以不用显式配置,当然也可以显式配置。

示例:基于浏览器请求的国际化实现

首先,准备两个资源文件

message_enUs.properties

第一个资源文件是message_enUs.properties,该文件内容如

loginname= Login name:
password = Password:
submit = Submit
welcome = Welcom {0}
title = Login Page
username = administrator

message_zh_CN.properties

第二个资源文件的内容如下:

loginname=登录名:
password=密码:
submit=提交
welcome=欢迎 {0}
title=登录页面
username=管理员

将上面两个国际化资源文件保存为UTF-8编码.接下来在JSP页面中通过<spring:message/>标签来输出国际化消息。

loginForm.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@taglib prefix="form" uri="http://www.springframework.org/tags/form"%>
<%@taglib prefix="spring" uri="http://www.springframework.org/tags"%>
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>测试基于浏览器请求的国际化</title>
</head>
<body>
    <!-- 使用message标签来输出国际化信息 -->
    <h3>
        <spring:message code="title" />
    </h3>
    <form:form modelAttribute="user" method="post" action="login">
        <table>
            <tr>
                <td><spring:message code="loginname" /></td>
                <td><form:input path="loginname" /></td>
            </tr>
            <tr>
                <td><spring:message code="password" /></td>
                <td><form:input path="password" /></td>
            </tr>
            <tr>
                <td><input type="submit" value="<spring:message code="submit"/>" /></td>
            </tr>
        </table>
    </form:form>
</body>
</html>

springmvc-config.xml

接下来在Spring MVC配置文件中加载国际化资源文件。

<?xml version="1.0" encoding="UTF-8"?>
<beans
    xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:p="http://www.springframework.org/schema/p"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc-4.3.xsd
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context-4.3.xsd">
    <!-- spring可以自动去扫描base-pack下面的包或者子包下面的java文件，
        如果扫描到有Spring的相关注解的类，则把这些类注册为Spring的bean -->
    <context:component-scan base-package="org.fkit"/>
    <!-- 默认配置方案 -->
    <mvc:annotation-driven/>
    <!-- 静态资源处理 -->
    <mvc:default-servlet-handler/>
    <!-- 视图解析器 p:prefix属性表示前缀 p:suffix 表示后缀 -->
    <bean
        id="viewResolver"
        class="org.springframework.web.servlet.view.InternalResourceViewResolver"
        p:prefix="/WEB-INF/content/"
        p:suffix=".jsp"/>
    <!-- 国际化 p:basenames属性用于指定国际化资源文件名 -->
    <!-- 国际化 p:defaultEncoding属性指定国际化资源文件的编码 -->
    <bean
        id="messageSource"
        class="org.springframework.context.support.ResourceBundleMessageSource"
        p:basenames="message"
        p:defaultEncoding="UTF-8"/>
    <mvc:interceptors>
        <!-- 国际化操作拦截器 如果采用基于（Session/Cookie）则必需配置 -->
        <bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor"/>
    </mvc:interceptors>
    <!-- AcceptHeaderLocaleResolver 配置,因为AcceptHeaderLocaleResolver是默认语言区域解析器，不配置也可以 -->
    <bean
        id="localeResolver"
        class="org.springframework.web.servlet.i18n.AcceptHeaderLocaleResolver"/>
</beans>

国际化配置

国际化配置如下:

<!-- 国际化 p:basenames属性用于指定国际化资源文件名 -->
<!-- 国际化 p:defaultEncoding属性指定国际化资源文件的编码 -->
<bean
    id="messageSource"
    class="org.springframework.context.support.ResourceBundleMessageSource"
    p:basenames="message"
    p:defaultEncoding="UTF-8"/>

指定国际化资源文件路径

其中p:basenames属性用于指定国际化文件的路径,这个路径是相对于src目录的路径,例如这里对应的路径为:src/message_en_US.properties和message_zh_CN.properties,指定国际化路径的时候只需要指定文件的前缀就行类,后面的语言,地区以及文件名后缀不需要指出.也就是对于:

1 2	message_zh_CN.properties message_en_US.properties

指定国际化资源文件编码

p:defaultEncoding="UTF-8"这个属性用于指定这些国际化文件使用的编码,默认编码是ISO-8859-1,这样中文将会变成unicode代码,不方便我们阅读修改.所以我这里使用UTF-8编码
这组国际化资源文件,只需要指定message即可

UserController.java

@Controller
public class UserController {
    @RequestMapping(value = "/loginForm")
    public String loginForm(Model model)
    {
        // 创建一个user对象给表单标签库使用
        User user = new User();
        model.addAttribute("user", user);
        // 跳转页面
        return "loginForm";
    }
    @PostMapping(value = "/login")
    // @ModelAttribute User user:将提交表单的数据保存到user对象中
    public String login(@ModelAttribute User user, Model model, HttpServletRequest request)
    {
        System.out.println(user);
        // 如果登录名是xiaoming，密码是123456，则验证通过
        if (user.getLoginname() != null && user.getLoginname().equals("xiaoming")
                && user.getPassword() != null && user.getPassword().equals("123456"))
        {
            // 从后台代码获取国际化信息username
            RequestContext requestContext = new RequestContext(request);
            String username = requestContext.getMessage("username");
            // 将获取的username信息设置到User对象并设置到Model当中
            user.setUsername(username);
            model.addAttribute("user", user);
            return "success";
        }
        return "error";
    }
}

login()方法接收请求,如果验证通过,则使用RequestContext对象的getMessage()方法来获取国际化消息,并跳转到success.jsp页面。

success.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@taglib prefix="spring" uri="http://www.springframework.org/tags"%>
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>测试基于浏览器请求的国际化</title>
</head>
<body>
    <spring:message code="welcome" arguments="${requestScope.user.username}" />
</body>
</html>