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

以你之姓@ 2022-08-14 03:48 165阅读 0赞

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

下载链接 [点此进入下载链接][Link 1]

1.创建一个maven webapp工程。

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

内容如下，文中有注释

<?xml version="1.0" encoding="UTF-8"?>
    <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    		xmlns="http://java.sun.com/xml/ns/javaee" 
    		xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" 
    		xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" 
    		version="3.0">
      <display-name>Archetype Created Web Application</display-name>
      
        
      
      <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
      </servlet>
      
      <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
      </servlet-mapping>
    
    	
    	<filter>
    		<filter-name>encodingFilter</filter-name>
    		<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    		<init-param>
    			<param-name>encoding</param-name>
    			<param-value>UTF-8</param-value>
    		</init-param>
    		<init-param>
    			<param-name>forceEncoding</param-name>
    			<param-value>true</param-value>
    		</init-param>
    	</filter>
    	<filter-mapping>
    		<filter-name>encodingFilter</filter-name>
    		<url-pattern>/*</url-pattern>
    	</filter-mapping>
      
      
    </web-app>

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

3.在WEN-INF目录下创建dispatcher-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:context="http://www.springframework.org/schema/context"
    	xmlns:mvc="http://www.springframework.org/schema/mvc"
    	xmlns:p="http://www.springframework.org/schema/p"
    	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"
    	default-lazy-init="true">
    	
    	
    	
    	<mvc:resources location="/*.html" mapping="/**.html" />
    	<mvc:resources location="/css/*" mapping="/css/**" />
    	<mvc:resources location="/js/*" mapping="/js/**" />
    	<mvc:resources location="/images/*" mapping="/images/**" />
    	
    	
    	<mvc:annotation-driven />
    	
    	<context:component-scan base-package="com.my.web" />
    	
    	
    	
    	<mvc:view-controller path="/" view-name="index" />
    	<bean class="org.springframework.web.servlet.view.UrlBasedViewResolver">
    		<property name="viewClass" value="org.springframework.web.servlet.view.JstlView"></property>
    		
    		<property name="prefix" value="/"></property>
    		
    		<property name="suffix" value=".jsp"></property>
    	</bean>
    	
    </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>标签中

<properties>
      	<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
      	<spring.version>3.1.2.RELEASE</spring.version>
      </properties>

4.2添加依赖，在<dependencies>标签中

<dependency>
    		<groupId>org.springframework</groupId>
    		<artifactId>spring-webmvc</artifactId>
    		<version>${spring.version}</version>
    	</dependency>
    
    	<dependency>
    		<groupId>org.springframework</groupId>
    		<artifactId>spring-jdbc</artifactId>
    		<version>${spring.version}</version>
    	</dependency>
    
    	<dependency>
    		<groupId>org.springframework</groupId>
    		<artifactId>spring-context</artifactId>
    		<version>${spring.version}</version>
    	</dependency>
    
    	<dependency>
    		<groupId>org.springframework</groupId>
    		<artifactId>spring-aop</artifactId>
    		<version>${spring.version}</version>
    	</dependency>
    
    	<dependency>
    		<groupId>org.springframework</groupId>
    		<artifactId>spring-core</artifactId>
    		<version>${spring.version}</version>
    	</dependency>
    
    	<dependency>
    		<groupId>org.springframework</groupId>
    		<artifactId>spring-test</artifactId>
    		<version>${spring.version}</version>
    	</dependency>

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

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

5.写前台页面：

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

<%@ page language="java" contentType="text/html; charset=UTF-8"
    	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>欢迎</title>
    </head>
    <body>
    <h2>Hello World!</h2>
    
    <form action="login">
    	用户名：<input id="username" name="username" type="text"></input><br>
    	密  码：<input id="username" name="password" type="password"></input><br>
    	<input type="submit">
    </form>
    <span>当前IP：<%=request.getRemoteAddr() %></span>
    </body>
    </html>

6.写controller层代码，用来响应前台请求。

package com.my.web.controller;
    
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestParam;
    import org.springframework.web.bind.annotation.ResponseBody;
    
    /**
     * TODO 控制层代码
     * @author 591791
     * @date 2014年11月27日
     */
    @Controller
    public class MyController {
    	
    	@RequestMapping("login") //用来处理前台的login请求
    	private @ResponseBody String hello(
    			@RequestParam(value = "username", required = false)String username,
    			@RequestParam(value = "password", required = false)String password
    			){
    		return "Hello "+username+",Your password is: "+password;
    		
    	}
    
    }

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

![Image 1][]

![SouthEast][]

![SouthEast 1][]  
![Image 1][]

====Q&A====

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

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

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

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

如下图：

![Center][]

[Link 1]: http://download.csdn.net/detail/aitcax/8204053
[Image 1]: 
[SouthEast]: /images/20220810/8906474b61794db996d6998999577cf5.png
[SouthEast 1]: /images/20220810/e2d8598a70df42fdb42198e8a1178548.png
[Center]: /images/20220810/7e0a11b23d514ad4b652461a7a457e4c.png