SpringMVC学习(三)——SpringMVC的配置文件

墨蓝 2022-06-01 12:40 228阅读 0赞

本文是转载文章，文章的来源：csdn博客  
博主：李阿昀  
文章：  SpringMVC学习(三)——SpringMVC的配置文件  
博文地址：http://blog.csdn.net/yerenyuan\_pku/article/details/72231527

读者阅读过[SpringMVC学习(一)——SpringMVC介绍与入门][SpringMVC_SpringMVC]这篇文章后，想必都会写写SpringMVC的入门小程序，在这个小程序中，SpringMVC的核心配置文件——springmvc.xml为：

读者可能怀疑这写的不对啊！怎么可能只配这点东西呢？SpringMVC的三大组件哪去了，它们不是要配置吗？且听我慢慢讲解。我们发现这几个组件并没配置，但却是好使的，就是因为它有一个默认配置，DispatcherServlet.properties这个默认配置文件里面默认加载了，看图：   
![这里写图片描述][SouthEast]   
可以看出我们使用了注解方式的处理器映射器和处理器适配器。

*  默认加载的注解方式的处理器映射器
    
        org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping
 *  默认加载的注解方式的处理器适配器
    
        org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter
 *  默认加载的视图适配器(默认解析JSP视图的视图解析器)
    
        org.springframework.web.servlet.view.InternalResourceViewResolver

我们如果使用默认加载的注解方式的映射器和适配器，那么对它们的可控制性是比较小的，所以一般来说，我们都是自己配置的，因为有的时候我们需要扩展一些其他的组件。

# 注解映射器和适配器 #

## 配置组件扫描器 ##

使用组件扫描器可省去在Spring容器中配置每个Controller类的繁琐。使用`<context:component-scan>`自动扫描标记`@controller`注解的控制器类，配置如下：

<context:component-scan base-package="com.itheima.springmvc.controller"/>

注意：如果要扫描多个包，多个包中间使用半角逗号分隔。很明显在入门小程序中我已经配置了。

## 配置RequestMappingHandlerMapping ##

注解式处理器映射器，对类中标记@ResquestMapping注解的方法进行映射，根据@ResquestMapping注解定义的url匹配@ResquestMapping注解标记的方法，匹配成功返回HandlerMethod对象给前端控制器，HandlerMethod对象中封装了url对应的方法Method。   
从Spring3.1版本开始，废除了DefaultAnnotationHandlerMapping的使用，推荐使用RequestMappingHandlerMapping完成注解式处理器映射。配置如下：

<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"></bean>

推荐使用最新版本的注解式处理器映射器，如果你想对其扩展，可以在这个bean里面配置其他的属性。   
`@RequestMapping`注解的描述：定义请求url到处理器功能方法的映射。

## 配置RequestMappingHandlerAdapter ##

注解式处理器适配器，对标记@ResquestMapping注解的方法进行适配。   
从Spring3.1版本开始，废除了AnnotationMethodHandlerAdapter的使用，推荐使用RequestMappingHandlerAdapter完成注解式处理器适配。配置如下：

<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"></bean>

推荐使用最新版本的注解式处理器适配器，如果你想对其扩展，可以在这个bean里面配置其他的属性。   
当我们配置完注解式处理器映射器和注解式处理器适配器之后，SpringMVC的核心配置文件——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:p="http://www.springframework.org/schema/p" 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-4.0.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd">
    
        <context:component-scan base-package="com.itheima.springmvc.controller"/>
    
        
        <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"></bean>
    
        
        <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"></bean>
    
    </beans>

然后在浏览器地址栏中输入url地址——`http://localhost:8080/springmvc-first/itemList.action`，回车，也能同样看到如下效果：   
![这里写图片描述][SouthEast 1]

## 继续优化注解，配置`<mvc:annotation-driven>` ##

使用注解要注意一个问题，就是注解适配器和映射器必须配对使用，也就是说，不能一个用注解，一个用非注解。要用一起用，要么都不用。其实在SpringMVC中还有更加简便的注解，SpringMVC使用`<mvc:annotation-driven>`自动加载RequestMappingHandlerMapping和RequestMappingHandlerAdapter，可在springmvc.xml配置文件中使用`<mvc:annotation-driven>`替代注解处理器和适配器的配置，如下图所示：   
![这里写图片描述][SouthEast 2]   
注意：如果配置一个注解驱动之后，那么就可以不用配置处理器映射器和处理器适配器了。   
此时在浏览器地址栏中输入url地址——`http://localhost:8080/springmvc-first/itemList.action`，回车，同样也能看到如上效果。

## 配置视图解析器 ##

我们也可在springmvc.xml配置文件中自己手动配置视图解析器，如下：

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        
        <property name="prefix" value="/WEB-INF/jsp/"></property>
        
        <property name="suffix" value=".jsp"></property>
    </bean>

*  InternalResourceViewResolver：支持JSP视图解析。
 *  viewClass：JstlView表示JSP模板页面需要使用JSTL标签库，所以classpath中必须包含jstl的相关jar 包。此属性可以不设置，默认为JstlView。
 *  prefix和suffix：查找视图页面的前缀和后缀，最终视图的址为：前缀+逻辑视图名+后缀，逻辑视图名需要在Controller返回的ModelAndView中指定，比如逻辑视图名为hello，则最终返回的jsp物理视图地址就为 “WEB-INF/jsp/hello.jsp”。

这样一来，ItemController类的代码就要修改为：

@Controller
    public class ItemController { 
        // .action可以省略 (请求的url地址)
        @RequestMapping("/itemList.action")
        public ModelAndView itemList() {
            // 查询商品列表，使用静态数据生成一个商品列表
            List<Items> itemList = new ArrayList<Items>();
            itemList.add(new Items(1, "imac", 20000, new Date(), "苹果本很贵"));
            itemList.add(new Items(2, "imac1", 20000, new Date(), "苹果本很贵"));
            itemList.add(new Items(3, "imac2", 20000, new Date(), "苹果本很贵"));
            itemList.add(new Items(4, "imac3", 20000, new Date(), "苹果本很贵"));
            itemList.add(new Items(5, "imac4", 20000, new Date(), "卧槽，苹果本很贵啦！"));
            // 把商品列表传递给jsp
            ModelAndView modelAndView = new ModelAndView();
            modelAndView.addObject("itemList", itemList);
    
            // 配置完视图解析器之后只需要返回返回jsp的名称即可
            modelAndView.setViewName("itemList");
    
            // 返回结果
            return modelAndView;
        }
    }

如果这时返回全路径，即/WEB-INF/jsp/itemList.jsp，那就不好使了。   
到这就基本总结完了SpringMVC中使用注解方式的适配器和映射器了，很明显，开发中我们就使用注解配置，那样非常方便。

[SpringMVC_SpringMVC]: http://blog.csdn.net/yerenyuan_pku/article/details/72231272
[SouthEast]: /images/20220601/4b109d37ccae46a5ab505f611cba1652.png
[SouthEast 1]: /images/20220601/c8f5a372b19c43a7ac25a8269735cb6e.png
[SouthEast 2]: /images/20220601/51225f9ef72040aaa937b6e6388f31e3.png