搭建最简单的SpringMVC框架(使用maven)

本文说明：本文介绍使用maven搭建SpringMVC最简单的框架程序过程，适合初学者上手。

下载链接 点此进入下载链接

1.创建一个maven webapp工程。

2.修改WEB-INF目录下的web.xml文件：

内容如下，文中有注释

[html] view plain copy
 
 在CODE上查看代码片派生到我的代码片
  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.         xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"   
  5.         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"   
  6.         version="3.0">  
  7.   <display-name>Archetype Created Web Application</display-name>  
  8.     
  9.       
  10.   <!-- spring MVC的核心就是DispatcherServlet，使用springMVC的第一步就是将下面的servlet放入web.xml  
  11.         servlet-name属性非常重要，默认情况下，DispatchServlet会加载这个名字-servlet.xml的文件，如下，就会加载  
  12.         dispather-servlet.xml，也是在WEN-INF目录下。  
  13.    -->  
  14.   <servlet>  
  15.     <servlet-name>dispatcher</servlet-name>  
  16.     <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>  
  17.     <load-on-startup>1</load-on-startup>  
  18.   </servlet>  
  19.   <!-- 设置dispatchservlet的匹配模式，通过把dispatchservlet映射到/，默认servlet会处理所有的请求，包括静态资源 -->  
  20.   <servlet-mapping>  
  21.     <servlet-name>dispatcher</servlet-name>  
  22.     <url-pattern>/</url-pattern>  
  23.   </servlet-mapping>  
  24.   
  25.     <!-- 字符集过滤器 -->  
  26.     <filter>  
  27.         <filter-name>encodingFilter</filter-name>  
  28.         <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>  
  29.         <init-param>  
  30.             <param-name>encoding</param-name>  
  31.             <param-value>UTF-8</param-value>  
  32.         </init-param>  
  33.         <init-param>  
  34.             <param-name>forceEncoding</param-name>  
  35.             <param-value>true</param-value>  
  36.         </init-param>  
  37.     </filter>  
  38.     <filter-mapping>  
  39.         <filter-name>encodingFilter</filter-name>  
  40.         <url-pattern>/*</url-pattern>  
  41.     </filter-mapping>  
  42.     
  43.     
  44. </web-app>  

说明：其中字符集过滤器部分不是必须的，但是如果要处理中文的话，最好还是加上。

3.在WEN-INF目录下创建dispatcher-servlet.xml

内容如下，文中有注释。

[html] view plain copy
 
 在CODE上查看代码片派生到我的代码片
  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"  
  4.     xmlns:context="http://www.springframework.org/schema/context"  
  5.     xmlns:mvc="http://www.springframework.org/schema/mvc"  
  6.     xmlns:p="http://www.springframework.org/schema/p"  
  7.     xsi:schemaLocation="http://www.springframework.org/schema/beans  
  8.             http://www.springframework.org/schema/beans/spring-beans.xsd  
  9.             http://www.springframework.org/schema/mvc  
  10.             http://www.springframework.org/schema/mvc/spring-mvc.xsd  
  11.             http://www.springframework.org/schema/context  
  12.             http://www.springframework.org/schema/context/spring-context.xsd"  
  13.     default-lazy-init="true">  
  14.       
  15.     <!-- 通过mvc:resources设置静态资源，这样servlet就会处理这些静态资源，而不通过控制器 -->  
  16.     <!-- 设置不过滤内容，比如:css,jquery,img 等资源文件 -->  
  17.     <mvc:resources location="/*.html" mapping="/**.html" />  
  18.     <mvc:resources location="/css/*" mapping="/css/**" />  
  19.     <mvc:resources location="/js/*" mapping="/js/**" />  
  20.     <mvc:resources location="/images/*" mapping="/images/**" />  
  21.       
  22.     <!-- 添加注解驱动 -->  
  23.     <mvc:annotation-driven />  
  24.     <!-- 默认扫描的包路径 -->  
  25.     <context:component-scan base-package="com.my.web" />  
  26.       
  27.     <!-- mvc:view-controller可以在不需要Controller处理request的情况，转向到设置的View -->  
  28.     <!-- 像下面这样设置，如果请求为/，则不通过controller，而直接解析为/index.jsp -->  
  29.     <mvc:view-controller path="/" view-name="index" />  
  30.     <bean class="org.springframework.web.servlet.view.UrlBasedViewResolver">  
  31.         <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"></property>  
  32.         <!-- 配置jsp路径前缀 -->  
  33.         <property name="prefix" value="/"></property>  
  34.         <!-- 配置URl后缀 -->  
  35.         <property name="suffix" value=".jsp"></property>  
  36.     </bean>  
  37.       
  38. </beans>  
说明： 其中<!-- 默认扫描的包路径 -->
<context:component-scan base-package="com.my.web" />中的路径，com.my.web，是需要在src/main/java中创建的包，用来放Java代码。

4.使用maven引入SpringMVC所依赖的jar包。

修改pom.xml文件

4.1添加属性，在<project>标签中

[html] view plain copy
 
 在CODE上查看代码片派生到我的代码片
  1. <properties>  
  2.     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  
  3.     <spring.version>3.1.2.RELEASE</spring.version>  
  4. </properties>  

4.2添加依赖，在<dependencies>标签中
[html] view plain copy
 
 在CODE上查看代码片派生到我的代码片
  1.    <!-- spring begin -->  
  2. <dependency>  
  3.     <groupId>org.springframework</groupId>  
  4.     <artifactId>spring-webmvc</artifactId>  
  5.     <version>${spring.version}</version>  
  6. </dependency>  
  7.   
  8. <dependency>  
  9.     <groupId>org.springframework</groupId>  
  10.     <artifactId>spring-jdbc</artifactId>  
  11.     <version>${spring.version}</version>  
  12. </dependency>  
  13.   
  14. <dependency>  
  15.     <groupId>org.springframework</groupId>  
  16.     <artifactId>spring-context</artifactId>  
  17.     <version>${spring.version}</version>  
  18. </dependency>  
  19.   
  20. <dependency>  
  21.     <groupId>org.springframework</groupId>  
  22.     <artifactId>spring-aop</artifactId>  
  23.     <version>${spring.version}</version>  
  24. </dependency>  
  25.   
  26. <dependency>  
  27.     <groupId>org.springframework</groupId>  
  28.     <artifactId>spring-core</artifactId>  
  29.     <version>${spring.version}</version>  
  30. </dependency>  
  31.   
  32. <dependency>  
  33.     <groupId>org.springframework</groupId>  
  34.     <artifactId>spring-test</artifactId>  
  35.     <version>${spring.version}</version>  
  36. </dependency>  
  37. <!-- spring end -->  

添加完成之后，通过更新工程，就会自动引入所依赖的jar包。

做完上面的准备工作之后就可以写代码了。

5.写前台页面：

在maven工程中生成的有一个index.jsp，将其修改成一下内容，很简单，只是一个登陆框，提交一个form表单，中的用户名和密码。

[html] view plain copy
 
 在CODE上查看代码片派生到我的代码片
  1. <%@ page language="java" contentType="text/html; charset=UTF-8"  
  2.     pageEncoding="UTF-8"%>  
  3. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">  
  4.   
  5. <html>  
  6. <head>  
  7. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">  
  8. <title>欢迎</title>  
  9. </head>  
  10. <body>  
  11. <h2>Hello World!</h2>  
  12.   
  13. <form action="login">  
  14.     用户名：<input id="username" name="username" type="text"></input><br>  
  15.     密  码：<input id="username" name="password" type="password"></input><br>  
  16.     <input type="submit">  
  17. </form>  
  18. <span>当前IP：<%=request.getRemoteAddr() %></span>  
  19. </body>  
  20. </html>  
6.写controller层代码，用来响应前台请求。
[java] view plain copy
 
 在CODE上查看代码片派生到我的代码片
  1. package com.my.web.controller;  
  2.   
  3. import org.springframework.stereotype.Controller;  
  4. import org.springframework.web.bind.annotation.RequestMapping;  
  5. import org.springframework.web.bind.annotation.RequestParam;  
  6. import org.springframework.web.bind.annotation.ResponseBody;  
  7.   
  8. /** 
  9.  * TODO 控制层代码 
  10.  * @author 591791 
  11.  * @date 2014年11月27日 
  12.  */  
  13. @Controller  
  14. public class MyController {  
  15.       
  16.     @RequestMapping("login") //用来处理前台的login请求  
  17.     private @ResponseBody String hello(  
  18.             @RequestParam(value = "username", required = false)String username,  
  19.             @RequestParam(value = "password", required = false)String password  
  20.             ){  
  21.         return "Hello "+username+",Your password is: "+password;  
  22.           
  23.     }  
  24.   
  25. }  

7,部署到tomcat上之后，运行效果如下：



====Q&A====

评论区有朋友说到实践的时候会报错：

“Exception starting filter encodingFilter
java.lang.ClassNotFoundException: ”

这是由于编译环境配置的问题，这个encoder的jar包是通过maven的形式加进来的，可能maven依赖库没有告诉到tomcat，所以tomcat启动的时候就找不到这个类。

解决办法是在project的properties中“Deployment Assembly”中加上maven lib，就可以了。

如下图：

 
 
 
【推广】 免费学中医，健康全家人
原文地址：https://www.cnblogs.com/cnsanshao/p/5660306.html