SpringMVC快速入门第三讲——SpringMVC的配置文件

读者阅读过《SpringMVC快速入门第一讲——SpringMVC介绍与入门》这篇文章后，想必都能写出SpringMVC的入门小程序，在这个小程序中，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">

	<!-- 配置controller扫描包 -->
	<context:component-scan base-package="com.meimeixia.springmvc.controller" />

</beans>

读者可能怀疑这写的不对啊！怎么可能只配这点东西呢？SpringMVC的三大组件哪去了，它们不是要配置吗？且听我慢慢讲解。我们发现这几个组件并没有配置，但却是好使的，就是因为它有一个默认配置，DispatcherServlet.properties这个默认配置文件里面默认加载了，看下面这个图就知道了。

从上图可以看出我们使用了注解方式的处理器映射器和处理器适配器。

• 默认加载的是如下注解方式的处理器映射器：

  org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping
  

• 默认加载的是如下注解方式的处理器适配器：

  org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter
  

• 默认加载的是如下视图解析器（默认解析jsp视图的视图解析器）

  org.springframework.web.servlet.view.InternalResourceViewResolver
  

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

注解映射器和适配器

配置组件扫描器

使用组件扫描器可省去在Spring容器中配置每个Controller类的繁琐。我们只要在SpringMVC的核心配置文件中使用了<context:component-scan>标签，那么就能自动扫描标记有@Controller注解的控制器类了。

<context:component-scan base-package="com.meimeixia.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里面配置其他的属性。你在写代码时，经常会碰到@RequestMapping注解，而且上面也提到了该注解，之前一直都没对它进行描述，这里对它说明一下，@RequestMapping注解定义了url请求到处理器功能方法的映射。

配置RequestMappingHandlerAdapter

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

<!-- 配置（最新的）处理器适配器，处理器适配器是干嘛的呢？它帮我们实例化Controller，同时调用其相应的方法（配置完它之后，也不使用默认的了） -->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter" />

如果你想对以上注解式处理器适配器进行扩展，那么可以在上面的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">

	<!-- 配置controller扫描包 -->
	<context:component-scan base-package="com.meimeixia.springmvc.controller" />
	
	<!-- 配置（最新的）处理器映射器，处理器适配器是干嘛的呢？它用于绑定用户的请求（配置完它之后，就不使用默认的了） -->
	<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping" />
	
	<!-- 配置（最新的）处理器适配器，处理器适配器是干嘛的呢？它帮我们实例化Controller，同时调用其相应的方法（配置完它之后，也不使用默认的了） -->
	<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter" />

</beans>

发布咱们的项目到Tomcat服务器上，然后启动Tomcat服务器，接着在Google Chrome浏览器地址栏中输入url地址，例如http://localhost:8080/02-springmvc/itemList.action，就能看到如下图所示的效果了。

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

使用注解要注意一个问题，就是注解适配器和映射器必须配对使用，也就是说，不能一个用注解，一个用非注解，要用就一起用，要么就都不用。其实在SpringMVC中还有更加简便的配置，即使用<mvc:annotation-driven>标签自动加载RequestMappingHandlerMapping和RequestMappingHandlerAdapter，这样说来，就可以在SpringMVC核心配置文件中使用<mvc:annotation-driven>标签替代注解处理器和适配器的配置了，如下图所示。

温馨提示：如果配置了注解驱动之后，那么就可以不用配置处理器映射器和处理器适配器了。此时在Google Chrome浏览器地址栏中输入url地址，例如http://localhost:8080/02-springmvc/itemList.action，同样也能看到像上面那样的结果。

配置视图解析器

我们也可以在SpringMVC核心配置文件中自己手动配置视图解析器，如下：

<!-- 配置视图解析器（对jsp默认解析的视图解析器） -->
<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包（例如jstl-1.2.jar）。此属性可以不设置，默认就为JstlView；
• prefix和suffix：表示查找视图页面的前缀和后缀，最终视图的址为：前缀+逻辑视图名+后缀，逻辑视图名需要在Controller类返回的ModelAndView中指定，比如逻辑视图名为hello，则最终返回的jsp物理视图地址就为WEB-INF/jsp/hello.jsp。

这样一来，ItemController类的代码就要修改成下面这样了。

package com.meimeixia.springmvc.controller;

import java.util.Arrays;
import java.util.Date;
import java.util.List;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

import com.meimeixia.springmvc.pojo.Item;

@Controller
public class ItemController {

	//DefaultAnnotationHandlerMapping这个处理器映射器就是专门用于绑定咱们的url请求，该url请求到底由哪个控制器来处理？
	@RequestMapping("itemList")
	public ModelAndView itemList() {
		ModelAndView mav = new ModelAndView();
		//模拟查询商品列表
		List<Item> list = Arrays.asList(new Item(1, "冰箱", 1999, new Date(), "冰箱质量好"), new Item(2, "冰箱2", 1999, new Date(), "冰箱质量好2"), 
				new Item(3, "冰箱3", 1999, new Date(), "冰箱质量好3"), new Item(4, "冰箱4", 1999, new Date(), "冰箱很热"));
		mav.addObject("itemList", list);
		//配置完视图解析器之后只需要返回jsp的名称即可
		mav.setViewName("itemList");
		return mav;
	}
	
}

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