手把手构建 Spring MVC 工程

SI 前文有述，Spring MVC + MyBatis 的简称，因为 Spring MVC 内部已有注入功能，故不考虑其是否是利用了 Spring （用脚叉子想也是利用了 Spring ，不过想太多，容易遭雷击，那么就当不存在好了，就是 Spring MVC 自已的注入功能）。

大体过程应该是：

一、web.xml 配置

Java Web 容器通过 Web 应用的 web.xml 找到请求响应的 Servlet

1、Java Web 容器收到请求，根据 web.xml 中配置的 Servlet 和匹配模式，找到请求对应的 Servlet ，并将请求转发给该 Servlet 处理；

2、我们配置 Spring MVC 的分发器来处理所有预期的请求匹配模式，web.xml 的完整可用配置如下：

[html]  view plain copy print ?

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
3.     xmlns="http://java.sun.com/xml/ns/javaee"  
4.     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"  
5.     id="WebApp_ID" version="3.0">  
6.     <display-name>TestSI</display-name>  
7.     <welcome-file-list>  
8.         <welcome-file>index.html</welcome-file>  
9.         <welcome-file>index.htm</welcome-file>  
10.         <welcome-file>index.jsp</welcome-file>  
11.         <welcome-file>default.html</welcome-file>  
12.         <welcome-file>default.htm</welcome-file>  
13.         <welcome-file>default.jsp</welcome-file>  
14.     </welcome-file-list>  
15.   
16.     <servlet>  
17.         <servlet-name>TestSI</servlet-name>  
18.         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>  
19.         <init-param>  
20.             <!-- 与 Spring 分别指定 上下文配置文件位置 -->  
21.             <param-name>contextConfigLocation</param-name>  
22.             <param-value>classpath:spring-controller.xml, classpath:TestSI-servlet.xml</param-value>  
23.         </init-param>  
24.         <load-on-startup>1</load-on-startup>  
25.     </servlet>  
26.   
27.     <servlet-mapping>  
28.         <servlet-name>TestSI</servlet-name>  
29.         <url-pattern>/*</url-pattern>  
30.     </servlet-mapping>  
31.   
32. </web-app>  

以上完成了 Java Web 部分的配置，请求有人处理了，完事大吉，容器放权，爱谁扎腾谁就来扎腾，它可不爱管这闲事儿，接下来就得 Spring MVC 来扎腾了吧！

3、切忌画蛇添足，把 Spring 的监听器给配上，然后在 Spring 的全局上下文配置文件中配置要注入的 Bean ，结果 Spring MVC 并未用得上注入的 Bean，而是自已创建的；相反，应该把 Spring 配置文件配置给 Spring MVC ，Spring MVC 会根据配置来实现注入，并从注入中找到想要用的 Bean ，这时注入功能才起作用。

二、TestSI-servlet.xml 配置

这里的 TestSI 是根据 Spring MVC 的分发器 DispatcherServlet 在 web.xml 中定义的 <servlet-name/> 来定，就是这个名儿 + -servlet.xml，DispatcherServlet 接受请求后，查找该配置文件，来确定在哪个类包中搜索控制器类，当然这些类是需要注解驱动的：

TestSI-servlet.xml 完整可用配置如下：

[html]  view plain copy print ?

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <beans xmlns="http://www.springframework.org/schema/beans"  
3.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"  
4.     xmlns:context="http://www.springframework.org/schema/context"  
5.     xmlns:mvc="http://www.springframework.org/schema/mvc"  
6.     xsi:schemaLocation="     
7.            http://www.springframework.org/schema/beans     
8.            http://www.springframework.org/schema/beans/spring-beans-3.1.xsd     
9.            http://www.springframework.org/schema/context     
10.            http://www.springframework.org/schema/context/spring-context-3.1.xsd    
11.            http://www.springframework.org/schema/mvc     
12.            http://www.springframework.org/schema/mvc/spring-mvc-3.1.xsd">  
13.   
14.     <!-- 扫描 Controller 的根包 -->  
15.     <context:component-scan base-package="com.testsi.controller" />  
16.     <!-- 简写配置注解驱动 -->  
17.     <mvc:annotation-driven/>  
18.   
19.     <!-- 控制器返回字符串匹配页面 -->  
20.     <bean  
21.         class="org.springframework.web.servlet.view.InternalResourceViewResolver">  
22.         <property name="prefix" value="/WEB-INF/view/"></property>  
23.         <property name="suffix" value=".jsp"></property>  
24.     </bean>  
25. </beans>  

以上配置， DispatcherServlet 就会到 com.testsi.controller 包下去找控制器类中配匹的方法，当然这要当注解，任何类胆缀上  @Controller ，都能成为控制器类，被  DispatcherServlet 搜索到，具体是文件解析还是怎样，俺还没有研究过，那是注解的相关内容，有兴趣后续再研究；

具体到请求分派给哪个控制器的哪个方法，那就要看方法前的注解了，简单地，

@RequestMapping(value = "", method = RequestMethod.GET)

这一行，可以匹配任何内容？关于 @RequestMapping 这个注解，是匹配请求递交下一站的关键，这个也需要深入研究一番。

由上面的 web.xml 中配置可知，TestSI-servlet.xml  配置文件位置在类路径根包下，我们在 Java Resources 下和 src 平级建一个任意名称的目录，它就和 src 起到同样的分组作用，最终这些 Java Resources  下的分组中的内容都会按目录结构拷贝到 WEB-INF/classes 目录下:

当然了，.java 类源文件一定是要编译成 .class 之后才会和 src 同级的其它目录中的内容按原目录结构一同拷入 WEB-INF 中新建的 classes 目录下。

类的包以目录层次来代替存储相应的 .class 文件。

当然了，这些配置文件或一些资源文件，也可以放在类根包之下的任意一级包中，或者在 src 下，与 com 同级，src 就代表了根包，这样，在配置文件中只要使用 classpath: 来限定就可以了，当然还有一种用法 classpath*:，这是表示根包下任何子层级下的这样的结构都能匹配。

在 java 代码中可以使用类加载器的 getResource(“/”) 来获得根包所在磁盘路径，或者 getResource(“”) 可获得当前类所在包路径，有多种用法，可以达到通过类路径来定位类资源的目的，解除了硬编码路径带来的迁移隐患。

三、按以上两步规划，实作细节

上面描述的够多，够细了，我们来看看，有哪些事情是需要实作一下的：

1、就是 web.xml 中两个配置文件的路径，那就按上面图中所示建个目录吧，然后分别把那两个配置文件都按名称建好并放在那个位置；

2、将上面  TestSI-servlet.xml  的内容拷贝粘贴进去，其中需要在 WEB-INF 下建一个 view 子目录，并在其中创建一个 index.jsp 文件；

3、控制器搜索类包的建立 com.testsi.controller，这个在 src 下建就是了；

4、在 com.testsi.controller 下建立 IndexController 类，然后在类上一行输入 @Controller 注解；

[java]  view plain copy print ?

1. @Controller  
2. public class IndexController {  
3.       
4. }  

5、在 IndexController 类中建立方法 index，并如下图在方法上一行加上 @RequestMapping 注解：

[java]  view plain copy print ?

1. @Controller  
2. public class IndexController {  
3.     @RequestMapping(value = "", method = RequestMethod.GET)  
4.     public String index(HttpServletRequest request) throws Exception {  
5.         return "index";  
6.     }  
7. }  

保存后，clean 并自动编译后，出现相应错误提示，提示缺少相应的类库，接下来我们就把需要的类库找齐。

四、最简 Spring MVC 所需类库

1、首先，这些类库可以从 mvnrepository.com 下载，这个Maven 的资源库的优点：

一是能按名称搜到必要的 Jar 包，

二是每一个 Jar 包所依赖的包也提供了列表及下载链接以及 Jar 包的适用版本。

2、我们预先知道要用到 DispatcherServlet ，不过注意其全包结构：org.springframework.web.servlet.DispatcherServlet，所从头手写下来，竟然把 org 写成 com了，导致 Tomcat 6 启动报错找不到这个 DispatcherServlet。

那么我们需要先下载的就是 springframework 中的 spring-webmvc ，其实这些我也花了些时间一点点地找，一点点地加，而没有用别人现成的，就是想知道最简的是什么，由自已实测得来，记忆和理解比较深刻。

下图中的这 7 个 Jar 包，我先搜到的 spring-webmvc 并找到 3.2.9 版本，后发现直接搜 springframework 会找到相关的所有分类。

spring-webmvc 是 web.xml 中配置的，spring-context 和 spring-web 是给类和方法加注解以及参数时，出现的错误提示，并按提示找到的；

其它四个完全是每运行一次提示一次找不到类，就按提示搜到并下载下来，凑齐了最简所需 7 个包。

然而，上面还是有问题的，在控制器中返回 “index" 字符串，会在控制台提示相关警告，而且也无法显示 index.jsp 页：

[plain]  view plain copy print ?

1. 警告: No mapping found for HTTP request with URI [/TestSI/WEB-INF/view/index.jsp] in DispatcherServlet with name 'TestSI'  

问题出在 web.xml 中对 DispatcherServlet 的匹配模型的设定面：

[html]  view plain copy print ?

1. <servlet-mapping>  
2.     <servlet-name>TestSI</servlet-name>  
3.     <url-pattern>/*</url-pattern>  
4. </servlet-mapping>  

“/*”，会将所有的请求都转交给   DispatcherServlet；

“/”，只会将 host/servlet 这种形式的请求转交给 DispatcherServlet 来处理；
这种解释，我尚且也没弄得太清楚，感兴趣可移步这里。
改过来，再运行一下吧，保准儿没问题了，有问题的话，那就是还没想到的问题，欢迎回贴。

后续，会接着把今天调通的 Spring MVC 注入 MyBatis 的映射器，再接着以上工程实做一遍，包括 Jar 包等细节问题，从头来过。

下周末见！

工程代码已打包，有空儿研究一下 CSDN 的上传，分享给大家。