Spring MVC 学习笔记（三）

11.国际化

 ❤ 国际化概述

    • 默认情况下， SpringMVC根据Accept-Language参数判断客户端的本地化类型。

    • 当接受到请求时， SpringMVC 会在上下文中查找一个本 地化解析器（ LocalResolver ），找到后使用它获取请求所对应的本地化类型信息。

    • SpringMVC还允许装配一个 动态更改本地化类型的拦截 器，这样通过指定一个请求参数就可以控制单个请求的本地化类型。

 ❤ SessionLocaleResolver& LocaleChangeInterceptor工作原理

            

 ❤ 本地化解析器和本地化拦截器

   • AcceptHeaderLocaleResolver：根据HTTP 请求头的Accept-Language参数确定本地化类型，如果没有显式定义本地化解析器，SpringMVC使用该解析器。

    • CookieLocaleResolver：根据指定的Cookie 值确定本地化类型

    • SessionLocaleResolver：根据Session 中特定的属性确定本地化类型

    • LocaleChangeInterceptor：从请求参数中获取本次请求对应的本地化类型。

——————————————action——————————————————————————————————
@Autowired
    private ResourceBundleMessageSource messageSource;

    @RequestMapping("i18n")
    public String testI18n(Locale locale){
        String val = messageSource.getMessage("i18n.user", null, locale);
        System.out.println(val); 
        return "i18n";
    }
——————————————xml————————————————————————————————————
<!-- 配置国际化资源文件 -->
    <bean id="messageSource"
        class="org.springframework.context.support.ResourceBundleMessageSource">
        <property name="basename" value="i18n"></property>
    </bean>

    <!-- 配置 SessionLocalResolver -->
    <bean id="localeResolver"
        class="org.springframework.web.servlet.i18n.SessionLocaleResolver"></bean>

    <!-- 配置 LocaleChanceInterceptor -->
    <mvc:interceptors>
        <bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor"></bean>
    </mvc:interceptors>
————————————jsp——————————————————————————————————————
index:        
<!--  
        关于国际化:
        1. 在页面上能够根据浏览器语言设置的情况对文本(不是内容), 时间, 数值进行本地化处理
        2. 可以在 bean 中获取国际化资源文件 Locale 对应的消息
        3. 可以通过超链接切换 Locale, 而不再依赖于浏览器的语言设置情况

        解决:
        1. 使用 JSTL 的 fmt 标签
        2. 在 bean 中注入 ResourceBundleMessageSource 的示例, 使用其对应的 getMessage 方法即可
        3. 配置 LocalResolver 和 LocaleChangeInterceptor
    -->    
    <br><br>
    <a href="i18n">I18N PAGE</a>

i18n：       
        <fmt:message key="i18n.user"></fmt:message>
        <br><br>
        <a href="i18n2">I18N2 PAGE</a>
        <br><br>
        <a href="i18n?locale=zh_CH">中文</a>
        <br><br>
        <a href="i18n?locale=en_US">英文</a>
i18n2：
    <fmt:message key="i18n.password"></fmt:message>
    <br><br>
    <a href="i18n">I18N PAGE</a>
————————————————————————————————————————————————————
i18n_en_US.properties： 
        i18n.user=用户名
        i18n.password=密码
 i18n_zh_CN.properties：
        i18n.user=User
        i18n.password=Password   

1

2.文件的上传

  ❤ 文件上传

    • Spring MVC为文件上传提供了直接的支持，这种支持是通过即插即用的MultipartResolver（接口）实现的。Spring 用Jakarta Commons FileUpload技术实现了一个MultipartResolver实现类：CommonsMultipartResovlerSpring 

    • Spring MVC 上下文中默认没有装配MultipartResovler，因此默认情况下不能处理文件的上传工作，如果想使用Spring 的文件上传功能，需现在上下文中配置MultipartResolver

 

 ❤  配置MultipartResolver

    • defaultEncoding :  必须和用户 JSP  的 pageEncoding 属性 一致，以便正确解析表单的内容

    • 为了让 CommonsMultipartResovler 正确工作，必须先 将 Jakarta Commons FileUpload 及 Jakarta Commons io 的类包添加到类路径下。

<!-- 配置 MultipartResolver -->
    <bean id="multipartResolver"
        class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <property name="defaultEncoding" value="UTF-8"></property>
        <property name="maxUploadSize" value="1024000"></property>    
    </bean>      

 文件上传示例

@RequestMapping("/testFileUpload")
    public String testFileUpload(@RequestParam("desc") String desc, 
            @RequestParam("file") MultipartFile file) throws IOException{
        System.out.println("desc: " + desc);
        System.out.println("OriginalFilename: " + file.getOriginalFilename());
        System.out.println("InputStream: " + file.getInputStream());
        return "success";
    }
————————————————jsp——————————————
<form action="testFileUpload" method="POST" enctype="multipart/form-data">
        File: <input type="file" name="file"/>
        Desc: <input type="text" name="desc"/>
        <input type="submit" value="Submit"/>
    </form>
     

13.使用拦截器

 ❤  自定义拦截器

    • Spring MVC也可以使用拦截器对请求进行拦截处理，用户可以自定义拦截器来实现特定的功能，自定义的拦截器必须实现HandlerInterceptor接口

    – preHandle()：这个方法在业务处理器处理请求之前被调用，在该方法中对用户请求request 进行处理。如果程序员决定该拦截器对请求进行拦截处理后还要调用其他的拦截器，或者是业务处理器去进行处理，则返回true；如果程序员决定不需要再调用其他的组件去处理请求，则返回false。

    – postHandle()：这个方法在业务处理器处理完请求后，但–是DispatcherServlet向客户端返回响应前被调用，在该方法中对用户请求request进行处理。

    – afterCompletion()：这个方法在DispatcherServlet完全处理完请求后被调用，可以在该方法中进行一些资源清理的操作。

❤ 拦截器方法执行顺序

               

    配置自定义拦截器

<mvc:interceptors>
        <!-- 配置自定义的拦截器 -->
        <bean class="com.atguigu.springmvc.interceptors.FirstInterceptor"></bean>

        <!-- 配置拦截器(不)作用的路径 -->
        <mvc:interceptor>
            <mvc:mapping path="/emps"/>
            <bean class="com.atguigu.springmvc.interceptors.SecondInterceptor"></bean>
        </mvc:interceptor>

        <!-- 配置 LocaleChanceInterceptor -->
        <bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor"></bean>
    </mvc:interceptors>
——————————————————————————————————————————————
public class FirstInterceptor implements HandlerInterceptor{

    /**
     * 该方法在目标方法之前被调用.
     * 若返回值为 true, 则继续调用后续的拦截器和目标方法. 
     * 若返回值为 false, 则不会再调用后续的拦截器和目标方法. 
     * 
     * 可以考虑做权限. 日志, 事务等. 
     */
    @Override
    public boolean preHandle(HttpServletRequest request,
            HttpServletResponse response, Object handler) throws Exception {
        System.out.println("[FirstInterceptor] preHandle");
        return true;
    }

    /**
     * 调用目标方法之后, 但渲染视图之前. 
     * 可以对请求域中的属性或视图做出修改. 
     */
    @Override
    public void postHandle(HttpServletRequest request,
            HttpServletResponse response, Object handler,
            ModelAndView modelAndView) throws Exception {
        System.out.println("[FirstInterceptor] postHandle");
    }

    /**
     * 渲染视图之后被调用. 释放资源
     */
    @Override
    public void afterCompletion(HttpServletRequest request,
            HttpServletResponse response, Object handler, Exception ex)
            throws Exception {
        System.out.println("[FirstInterceptor] afterCompletion");
    }
}

4.异常处理

    • Spring MVC通过HandlerExceptionResolver处理程序的异常，包括Handler 映射、数据绑定以及目标方法执行时发生的异常。

    • SpringMVC提供的HandlerExceptionResolver的实现类

       

❤  HandlerExceptionResolver

    • DispatcherServlet默认装配的HandlerExceptionResolver：

        – 没有使用<mvc:annotation-driven/> 配置：

 

        – 使用了<mvc:annotation-driven/> 配置：

  

 ❤  ExceptionHandlerExceptionResolver

    • 主要处理Handler 中用@ExceptionHandler注解定义的方法。

    • @ExceptionHandler注解定义的方法优先级问题：例如发生的是NullPointerException，但是声明的异常有RuntimeException和Exception，此时会根据异常的最近继承关系找到继承深度最浅的那个@ExceptionHandler注解方法，即标记了RuntimeException的方法ExceptionHandlerMethodResolver内部若找不到@ExceptionHandler注解的话，会找@ControllerAdvice中的@ExceptionHandler注解方法

————————————————————————————————————————————————
@ControllerAdvice
public class SpringMVCTestExceptionHandler {
    @ExceptionHandler({ArithmeticException.class})
    public ModelAndView handleArithmeticException(Exception ex){
        System.out.println("----> 出异常了: " + ex);
        ModelAndView mv = new ModelAndView("error");
        mv.addObject("exception", ex);
        return mv;
    }
}
——————————————error.jsp————————————————————————————————
    <h4>Error Page</h4>
    ${requestScope.exception }
——————————————index.jsp————————————————————————————————
<a href="testExceptionHandlerExceptionResolver?i=10">Test ExceptionHandlerExceptionResolver</a>
——————————————handler————————————————————————————————
//    @ExceptionHandler({RuntimeException.class})
//    public ModelAndView handleArithmeticException2(Exception ex){
//        System.out.println("[出异常了]: " + ex);
//        ModelAndView mv = new ModelAndView("error");
//        mv.addObject("exception", ex);
//        return mv;
//    }

    /**
     * 1. 在 @ExceptionHandler 方法的入参中可以加入 Exception 类型的参数, 该参数即对应发生的异常对象
     * 2. @ExceptionHandler 方法的入参中不能传入 Map. 若希望把异常信息传导页面上, 需要使用 ModelAndView 作为返回值
     * 3. @ExceptionHandler 方法标记的异常有优先级的问题. 
     * 4. @ControllerAdvice: 如果在当前 Handler 中找不到 @ExceptionHandler 方法来出来当前方法出现的异常, 
     * 则将去 @ControllerAdvice 标记的类中查找 @ExceptionHandler 标记的方法来处理异常. 
     */
//    @ExceptionHandler({ArithmeticException.class})
//    public ModelAndView handleArithmeticException(Exception ex){
//        System.out.println("出异常了: " + ex);
//        ModelAndView mv = new ModelAndView("error");
//        mv.addObject("exception", ex);
//        return mv;
//    }

❤ ResponseStatusExceptionResolver

    • 在异常及异常父类中找到@ResponseStatus注解，然后使用这个注解的属性进行处理。

    • 定义一个@ResponseStatus注解修饰的异常类

   

    • 若在处理器方法中抛出了上述异常：

        若ExceptionHandlerExceptionResolver不解析述异常。由于触发的异常UnauthorizedException带有@ResponseStatus注解。因此会被ResponseStatusExceptionResolver解析到。最后响应HttpStatus.UNAUTHORIZED代码给客户端。HttpStatus.UNAUTHORIZED代表响应码401，无权限。关于其他的响应码请参考HttpStatus枚举类型源码。

——————————————handler    @ResponseStatus放在方法上—————————————————— 
  @ResponseStatus(reason="测试",value=HttpStatus.NOT_FOUND)
    @RequestMapping("/testResponseStatusExceptionResolver")
    public String testResponseStatusExceptionResolver(@RequestParam("i") int i){
        if(i == 13){
            throw new UserNameNotMatchPasswordException();
        }
        System.out.println("testResponseStatusExceptionResolver...");
        return "success";
    }
——————————————@ResponseStatus放在类上————————————————————————
@ResponseStatus(value=HttpStatus.FORBIDDEN, reason="用户名和密码不匹配!")
public class UserNameNotMatchPasswordException extends RuntimeException{
    private static final long serialVersionUID = 1L;
}
——————————————index.jsp————————————————————————————————
<a href="testResponseStatusExceptionResolver?i=10">Test ResponseStatusExceptionResolver</a>

 ❤  DefaultHandlerExceptionResolver

    • 对一些特殊的异常进行处理，比如NoSuchRequestHandlingMethodException、                                                         HttpRequestMethodNotSupportedException、HttpMediaTypeNotSupportedException、HttpMediaTypeNotAcceptableException等。

❤  SimpleMappingExceptionResolver

    • 如果希望对所有异常进行统一处理，可以使用SimpleMappingExceptionResolver，它将异常类名映射为视图名，即发生异常时使用对应的视图报告异常

<!-- 配置使用 SimpleMappingExceptionResolver 来映射异常 -->
    <bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
        <property name="exceptionAttribute" value="ex"></property>
        <property name="exceptionMappings">
            <props>
                <prop key="java.lang.ArrayIndexOutOfBoundsException">error</prop>
            </props>
        </property>
    </bean>    
——————————————index.jsp——————————————————————
<a href="testSimpleMappingExceptionResolver?i=2">Test SimpleMappingExceptionResolver</a>
———————————————handler———————————————————————
@RequestMapping("/testSimpleMappingExceptionResolver")
    public String testSimpleMappingExceptionResolver(@RequestParam("i") int i){
        String [] vals = new String[10];
        System.out.println(vals[i]);
        return "success";
    }
——————————————error————————————————————————
${requestScope.ex }      /.ex和配置文件中的value属性需要一致，就可打印出错误信息

15.SpringMVC运行流程

16.在Spring的环境下使用SpringMVC

 Bean 被创建两次？

    • Spring 的IOC 容器不应该扫描SpringMVC中的bean, 对应的SpringMVC的IOC 容器不应该扫描Spring 中的bean

  ——————————web.xml————————————————————————————————————
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
    id="WebApp_ID" version="2.5">

    <!-- 配置启动 Spring IOC 容器的 Listener -->
    <!-- needed for ContextLoaderListener -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:beans.xml</param-value>
    </context-param>

    <!-- Bootstraps the root web application context before servlet initialization -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <servlet>
        <servlet-name>springDispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>springDispatcherServlet</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

</web-app>
——————————————springmvc.xml———————————————————————————————
<?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:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="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.0.xsd
        http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">

    <!--  
        需要进行 Spring 整合 SpringMVC 吗 ?
        还是否需要再加入 Spring 的 IOC 容器 ?
        是否需要在 web.xml 文件中配置启动 Spring IOC 容器的 ContextLoaderListener ?

        1. 需要: 通常情况下, 类似于数据源, 事务, 整合其他框架都是放在 Spring 的配置文件中(而不是放在 SpringMVC 的配置文件中).
        实际上放入 Spring 配置文件对应的 IOC 容器中的还有 Service 和 Dao. 
        2. 不需要: 都放在 SpringMVC 的配置文件中. 也可以分多个 Spring 的配置文件, 然后使用 import 节点导入其他的配置文件
    -->

    <!--  
        问题: 若 Spring 的 IOC 容器和 SpringMVC 的 IOC 容器扫描的包有重合的部分, 就会导致有的 bean 会被创建 2 次.
        解决:
        1. 使 Spring 的 IOC 容器扫描的包和 SpringMVC 的 IOC 容器扫描的包没有重合的部分. 
        2. 使用 exclude-filter 和 include-filter 子节点来规定只能扫描的注解
    -->

    <!--  
        SpringMVC 的 IOC 容器中的 bean 可以来引用 Spring IOC 容器中的 bean. 
        返过来呢 ? 反之则不行. Spring IOC 容器中的 bean 却不能来引用 SpringMVC IOC 容器中的 bean!
    -->

    <context:component-scan base-package="com.atguigu.springmvc" use-default-filters="false">
        <context:include-filter type="annotation" 
            expression="org.springframework.stereotype.Controller"/>
        <context:include-filter type="annotation" 
            expression="org.springframework.web.bind.annotation.ControllerAdvice"/>
    </context:component-scan>

    <!-- 配置视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/"></property>
        <property name="suffix" value=".jsp"></property>
    </bean>

    <mvc:default-servlet-handler/>
    <mvc:annotation-driven></mvc:annotation-driven>
</beans>
————————————spring的配置文件  bean.xml——————————————————————————
<?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"
    xsi:schemaLocation="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.0.xsd">

    <context:component-scan base-package="com.atguigu.springmvc">
        <context:exclude-filter type="annotation" 
            expression="org.springframework.stereotype.Controller"/>
        <context:exclude-filter type="annotation" 
            expression="org.springframework.web.bind.annotation.ControllerAdvice"/>
    </context:component-scan>

    <!-- 配置数据源, 整合其他框架, 事务等. -->
</beans>

  在Spring MVC 配置文件中引用业务层的Bean

    • 多个Spring IOC 容器之间可以设置为父子关系，以实现良好的解耦。

    • Spring MVC WEB 层容器可作为“业务层”Spring 容器的子容器：即WEB 层容器可以引用业务层容器的Bean，而业务层容器却访问不到WEB 层容器的Bean

                       

17.SpringMVC对比Struts2

    • ①. Spring MVC 的入口是Servlet, 而Struts2 是Filter

    • ②. Spring MVC 会稍微比Struts2 快些. Spring MVC 是基于方法设计, 而Sturts2 是基于类, 每次发一次请求都会实例一个Action.

    • ③. Spring MVC 使用更加简洁, 开发效率Spring MVC确实比struts2 高: 支持JSR303, 处理ajax的请求更方便

    • ④. Struts2 的OGNL 表达式使页面的开发效率相比Spring MVC 更高些.