第一个Spring MVC入门实例

作为Spring MVC入门，现以XML配置的方式为例。

实例文件结构：

首先配置Web工程的web.xml文件，代码如下：

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
         
    <!-- 配置Spring IoC配置文件路径-->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/applicationContext.xml</param-value>
    </context-param>
    
    <!-- 配置ContextLoaderListener用以初始化Spring IoC容器-->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    
    <!--配置DispatcherServlet -->
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>2</load-on-startup>
    </servlet>
    
    <!-- Servlet 拦截配置-->
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>*.do</url-pattern>
    </servlet-mapping>
</web-app>

论述一下这个文件的配置内容：

• 系统变量contextConfigLocation的配置，他会告诉Spring MVC其Spring IoC的配置文件在哪里，这样Spring就会找到这些配置文件去加载它们。如果是多个配置文件，可以使用逗号将他们分割开来，并且它还支持正则式匹配，进行模糊匹配，这样就更加灵活了，其默认值是/WEB-INF/applicationContext.xml。
• ContextLoaderListener实现了接口ServletContextListener，通过Java Web容器的学习，我们知道ServletContextListener的作用是可以在整个Web工程前后加入自定义代码，所以可以在Web工程初始化之前，他先完成对Spring IoC容器的初始化，也可以在Web工程关闭之时完成Spring IoC容器的资源进行释放。
• 配置DispatcherServlet，首先式配置了servlet-name为dispatcher，这就意味着需要一个/WEB-INF/dispatcher-servlet.xml文件（注意，servlet-name和文件名的对应关系）与之对应，并且我们配置了在服务器启动期间就初始化它。
• 配置DispatcherServlet拦截以 后缀“do"结束的请求，这样所有以后缀”do“结尾的请求都会被它拦截。

由于这是最简单的入门实例，applicationContext.xml就不需要配置任何内容了，代码如下：

applicationContext.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"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">

</beans>

这样Spring IoC容器就没有装载自己的类，根据之前的论述，他还会加载一个/WEB-INF/dispatch-servlet.xml文件，它是与Spring MVC配置相关的内容，代码如下：

dispatch-servlet.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:tx="http://www.springframework.org/schema/tx"
       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/tx
        http://www.springframework.org/schema/tx/spring-tx.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <!-- 使用注解驱动-->
    <mvc:annotation-driven />
    <!-- 定义扫描装载的包-->
    <context:component-scan base-package="com.*" />
    <!-- 定义视图解析器-->
    <!-- 找到Web工程/WEB-INF/JSP文件夹，且文件结尾为jsp的文件作为映射-->
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"
          p:prefix="/WEB-INF/jsp/" p:suffix=".jsp" />

</beans>

这里的配置也比较简单：

• <mvc:annotation-driven />表示使用注解驱动Spring MVC
• 定义一个扫描的包，用它来扫描对应的包，用以加载对应的控制器和其它的一些组件。
• 定义是视图解析器，解析器中定义了前缀和后缀，这样视图就知道去Web工程的/WEB-INF/jsp文件夹中找到对应的JSP文件作为视图响应用户请求。

控制器配置了注解驱动，并且定义了扫描的包，那我们就可以编写一个简单的Controller，代码如下：

myController.java

package com.ssm.example1.controller;

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

//注解@Controller表示他是一个控制器
@Controller("myController")
//表明当请求的URL在/my下的时候才有该控制器响应
@RequestMapping("/my")
public class MyController {
    //表明URL是/index的时候该方法才请求
    @RequestMapping("/index")
    public ModelAndView index(){
        //模型和视图
        ModelAndView mv=new ModelAndView();
        //试图逻辑名称为index
        mv.setViewName("index");
        //返回模型和视图
        return mv;
    }
}

由于我们已经配置了前缀/WEB-INF/jsp，后缀是jsp，再加上返回的视图逻辑名称为index。所以我们会选择使用/WEN-INF/jsp/index.jsp作为最后的响应。

index.jsp

<%@ page contentType="text/html" pageEncoding="UTF-8"  %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
      "http://www.w3.org/TR/html4/loose.dtd">
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
    <title>Welcome to Spring Web MVC project</title>
  </head>
  <body>
    <h1>Hello,Spring MVC</h1>
  </body>
</html>

最后启动服务器Tomcat，输入对应的URL，这里是http://localhost:8080/my/index.do，就能看到对应的响应了。