本项目旨在搭建一个简单的Spring MVC框架，了解Spring MVC的基础配置等内容。

一、项目结构

本项目使用idea intellij创建，配合maven管理。整体的目录结构如图：

其中java文件夹是sources文件夹，resources是资源文件夹。spring文件夹里是Spring上下文配置和Spring MVC配置文件。

 

需要注意的是，项目自动生成以后会有两个web文件目录，一个是web文件夹（我这里已经删除了），另一个是默认的webapp文件夹。我这里使用默认的目录，也就是说webapp文件夹。页面文件都放在该目录里面。

                                                                                         *如图可配置默认的web文件默认路径。*

二、配置文件

maven配置，添加各种依赖

省略，这个不是重点。需要注意的是，添加依赖的时候不能重复添加不同版本的包。

web.xml文件配置

首先，添加spring 上下文配置，指定Spring Context由classpath下的spring文件夹中的app-context.xml提供：

1. <context-param>
       <param-name>contextConfigLocation</param-name>
       <param-value>classpath:spring/app-context.xml</param-value>
   </context-param>

   然后添加Spring监听器：

1. <listener>
       <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
   </listener>
   <listener>
       <listener-class>org.springframework.web.context.request.RequestContextListener</listener-class>
   </listener>
   <listener>
       <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
   </listener>

   接下来配置Spring MVC的dispatherservlet，同时配置该servlet要拦截的URL。

1. <servlet>
       <servlet-name>springmvc</servlet-name>
       <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
       <init-param>
           <param-name>contextConfigLocation</param-name>
           <param-value>classpath:spring/mvc-servlet.xml</param-value>
       </init-param>
       <load-on-startup>1</load-on-startup>
   </servlet>
   <!-- 配置要拦截的URL -->
   <servlet-mapping>
       <servlet-name>springmvc</servlet-name>
       <url-pattern>/</url-pattern>
   </servlet-mapping>            

   最后，配置一个welcom-file-list。

web.xml全部的代码如下：

1. <?xml version="1.0" encoding="UTF-8"?>
   <web-appxmlns="http://java.sun.com/xml/ns/j2ee"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"version="2.4"
   xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
       <!-- spring context 配置文件 -->
       <context-param>
           <param-name>contextConfigLocation</param-name>
           <param-value>classpath:spring/app-context.xml</param-value>
       </context-param>
       <!-- spring 监听器配置 -->
       <listener>
           <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
       </listener>
       <listener>
           <listener-class>org.springframework.web.context.request.RequestContextListener</listener-class>
       </listener>
       <!--spring 防内存溢出监听器 -->
       <listener>
           <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
       </listener>
       <!-- spring mvc servlet配置文件 -->
       <servlet>
           <servlet-name>springmvc</servlet-name>
           <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
       <init-param>
           <param-name>contextConfigLocation</param-name>
           <param-value>classpath:spring/mvc-servlet.xml</param-value>
       </init-param>
       <load-on-startup>1</load-on-startup>
       </servlet>
       <!-- 配置要拦截的URL -->
       <servlet-mapping>
           <servlet-name>springmvc</servlet-name>
           <url-pattern>/</url-pattern>
       </servlet-mapping>
       <welcome-file-list>
       <welcome-file></welcome-file>
       </welcome-file-list>
   </web-app>            

   配置Spring MVC文件

这里主要配置自动注解、mvc资源引用、视图解析器等

代码如下：

1. <?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:mvc="http://www.springframework.org/schema/mvc"
          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/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd ">
   
       <mvc:resources location="/js/" mapping="/js/**"/>
   
       <bean class="org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor"/>
       <mvc:annotation-driven/>
       <context:annotation-config/>
       <mvc:default-servlet-handler/>
   
       <!--添加component扫描，使package下面的注解生效 -->
       <context:component-scan base-package="com.wxspringmvc.controller"/>
   
       <!--添加页面视图解析器-->
       <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
           <property name="prefix" value="/WEB-INF/page/"/>
           <property name="suffix" value=".jsp"/>
           <property name="contentType" value="text/html;charset=UTF-8"/>
       </bean>
   </beans>

   配置applicationContext.xml

这里主要是提供默认的上下文，不需要额外的配置，直接使用生成的文件就可以。代码就省略了。

要注意的是，applicationContext.xml是一定要配置的。在web.xml文件中如果不配置，系统会自动到WEB-INF目录下寻找。

View和Controller

这里使用一个简单的用户登录，完成后在页面显示用户名和密码的流程来展示。

View：index.jsp

1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
   <html>
   <head>
       <title>请登录</title>
   </head>
   <body>
   <h5>this is index.jsp</h5>
   <form action="/user/index" method="post">
     <p>用户名：</p><input type="text" id="username" name="username">
     <p>密码：</p><input type="password" id="password" name="password">
     <p><input type="submit" value="提交"></p>
   </form>
   </body>
   </html>

   表单使用post的方式提交到/user/index路径。

Controller：UserController.java

1. @Controller
   @RequestMapping(value = "/user")
   public class UserController {
       @RequestMapping(value = "/index" ,method= RequestMethod.POST)
       public ModelAndView userIndex(String username,String password){
           ModelAndView mav = new ModelAndView("user/success");
          
           mav.addObject("username",username);
           mav.addObject("password",password);
           return mav;
       }
   
   }

   这里可以添加一个简单的校验，如果用户名和密码有一个为空，则不能提交：

修改UserController.java的代码如下：

1. @Controller
   @RequestMapping(value = "/user")
   public class UserController {
       @RequestMapping(value = "/index" ,method= RequestMethod.POST)
       public ModelAndView userIndex(String username,String password){
           ModelAndView mav = new ModelAndView("user/success");
           if(!matchParams( username, password)){
               return new ModelAndView("/index");
           }
           mav.addObject("username",username);
           mav.addObject("password",password);
           return mav;
       }
   
       private boolean matchParams(String username,String password){
           if(isEmpty(username)||isEmpty(password))
               return false;
           else
               return true;
       }
   
       private boolean isEmpty(String s){
           if(s==null || "".equals(s))
               return true;
           else
               return false;
       }
   }

   View：登录成功界面：success.jsp

1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
   <html>
     <head>
       <title>用户首页</title>
     </head>
     <body>
   <p>用户名：${username}</p>
   <p>密码：${password}</p>
     </body>
   </html>

   效果展示

默认页：

输入不正确，提交结果：

输入正确提交：

 

----------------------------------------------------------------------------------------------------------------------------

 

以上就是一个简单的Spring MVC演示了。