# 前言
今天手把手来教大家如何搭建基于 Maven 的 SpringMVC WEB 项目。
# 正文
# 开发环境介绍
IDE: MyEclipse 2017
jdk: 1.7
maven:apache-maven-3.1.1
好了,基本环境只要上面这些就行,maven 不需要安装,只要有解压包就行。
# MyEclipse 2014 中 Maven 的配置
打开 myeclipse 中的 Window=>Preferences=>Java=>Installed JREs
配置 jdk,这里我们选择 1.7
配置好 maven 路径,也就是你之前存放 maven 解压包的路径
指定 User Settings , 对应 settings.xml 以及本地仓库地址,我这边是建在盘,路径为 D:\maven\repo3.1.1 。
# 创建 WEB 项目
新建一个 web 项目
配置项目基本信息,项目名,java EE,java 版本,其中记得要勾上 Add maven support,这样才会生成带有 maven 的工程。
创建成功后出正确的项目结构应该是这样,如果不是下图中这样,src 下面没有以下这些包也没事,自己创建 src/main/java , src/main/resources , src/test/java , src/test/resources , 然后指定以下这些包为 source 就行。
# 配置需要的安装包
下面列出目前需要用到包,直接在 pom.xml 里面添加就行
| <project xmlns="http://maven.apache.org/POM/4.0.0" | |
| xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" | |
| xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 | |
| http://maven.apache.org/xsd/maven-4.0.0.xsd"> | |
| <modelVersion>4.0.0</modelVersion> | |
| <groupId>SpringMVCMybatis</groupId> | |
| <artifactId>SpringMVCMybatis</artifactId> | |
| <version>0.0.1-SNAPSHOT</version> | |
| <packaging>war</packaging> | |
| <name>SpringMVCMybatis</name> | |
| <description/> | |
|   <properties> | |
| <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> | |
| <spring.version>4.1.1.RELEASE</spring.version> | |
| <cxf.version>2.7.15</cxf.version> | |
| <slf4j-version>1.7.12</slf4j-version> | |
| <log4j-version>1.2.17</log4j-version> | |
| <mybatis-version>3.3.0</mybatis-version> | |
| <mybatis-spring-version>1.2.3</mybatis-spring-version> | |
| </properties> | |
|   <dependencies> | |
| <!-- 日志配置--> | |
|     <dependency> | |
| <groupId>log4j</groupId> | |
| <artifactId>log4j</artifactId> | |
| <version>${log4j-version}</version> | |
| </dependency> | |
|     <dependency> | |
| <groupId>org.slf4j</groupId> | |
| <artifactId>slf4j-log4j12</artifactId> | |
| <version>${slf4j-version}</version> | |
| </dependency> | |
|       <dependency> | |
| <groupId>org.slf4j</groupId> | |
| <artifactId>slf4j-api</artifactId> | |
| <version>${slf4j-version}</version> | |
| </dependency> | |
|     <dependency> | |
| <groupId>javax.servlet</groupId> | |
| <artifactId>javax.servlet-api</artifactId> | |
| <version>3.1.0</version> | |
| </dependency> | |
|     <dependency> | |
| <groupId>org.apache.commons</groupId> | |
| <artifactId>commons-lang3</artifactId> | |
| <version>3.3</version> | |
| </dependency> | |
|     <dependency> | |
| <groupId>com.alibaba</groupId> | |
| <artifactId>fastjson</artifactId> | |
| <version>1.2.1</version> | |
| </dependency> | |
| <!-- 数据源配置 --> | |
|     <dependency> | |
| <groupId>com.mchange</groupId> | |
| <artifactId>c3p0</artifactId> | |
| <version>0.9.5.1</version> | |
| </dependency> | |
| <!--数据库相关, mysql, mybatis--> | |
|     <dependency> | |
| <groupId>mysql</groupId> | |
| <artifactId>mysql-connector-java</artifactId> | |
| <version>5.1.37</version> | |
| </dependency> | |
|     <dependency> | |
| <groupId>org.mybatis</groupId> | |
| <artifactId>mybatis-spring</artifactId> | |
| <version>${mybatis-spring-version}</version> | |
| </dependency> | |
|     <dependency> | |
| <groupId>org.mybatis</groupId> | |
| <artifactId>mybatis</artifactId> | |
| <version>${mybatis-version}</version> | |
| </dependency> | |
|     <dependency> | |
| <groupId>org.mybatis.generator</groupId> | |
| <artifactId>mybatis-generator-core</artifactId> | |
| <version>1.3.2</version> | |
| </dependency> | |
| <!-- spring用到的包 --> | |
|     <dependency> | |
| <groupId>org.springframework</groupId> | |
| <artifactId>spring-web</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-context</artifactId> | |
| <version>4.1.1.RELEASE</version> | |
| </dependency> | |
|     <dependency> | |
| <groupId>org.springframework</groupId> | |
| <artifactId>spring-beans</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-webmvc</artifactId> | |
| <version>${spring.version}</version> | |
| </dependency> | |
|     <dependency> | |
| <groupId>org.springframework</groupId> | |
| <artifactId>spring-tx</artifactId> | |
| <version>${spring.version}</version> | |
| </dependency> | |
| <!--测试--> | |
|     <dependency> | |
| <groupId>junit</groupId> | |
| <artifactId>junit</artifactId> | |
| <version>4.11</version> | |
| <scope>test</scope> | |
| </dependency> | |
|     <dependency> | |
| <groupId>org.springframework</groupId> | |
| <artifactId>spring-test</artifactId> | |
| <version>4.1.1.RELEASE</version> | |
| <scope>test</scope> | |
| </dependency> | |
|     <dependency> | |
| <groupId>javax</groupId> | |
| <artifactId>javaee-api</artifactId> | |
| <version>7.0</version> | |
| <scope>provided</scope> | |
| </dependency> | |
|     <dependency> | |
| <groupId>org.glassfish.web</groupId> | |
| <artifactId>javax.servlet.jsp.jstl</artifactId> | |
| <version>1.2.2</version> | |
| </dependency> | |
| </dependencies> | |
|   <build> | |
|     <plugins> | |
|       <plugin> | |
| <artifactId>maven-compiler-plugin</artifactId> | |
| <version>2.3.2</version> | |
|         <configuration> | |
| <source>1.7</source> | |
| <target>1.7</target> | |
| </configuration> | |
| </plugin> | |
|       <plugin> | |
| <artifactId>maven-war-plugin</artifactId> | |
| <version>2.2</version> | |
|         <configuration> | |
| <version>3.1</version> | |
| <failOnMissingWebXml>false</failOnMissingWebXml> | |
| </configuration> | |
| </plugin> | |
| </plugins> | |
| </build> | |
| </project> | 
# 配置 SpringMVC 需要的配置文件
web.xml 配置,注意里面配置 springMVC 需要用到的 DispatcherServlet ,指向的地址是 classpath:spring/applicationContext.xml ,当然此时还没创建这个 applicationCVontext.xml , 下一个步骤来创建
| <web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" | |
| xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" | |
| xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee | |
| http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"> | |
| <display-name>springmvctouchbaidu</display-name> | |
|     <servlet> | |
| <servlet-name>springmvctouchbaidu</servlet-name> | |
| <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> | |
| <init-param> | |
| <param-name>contextConfigLocation</param-name> | |
| <param-value>classpath:spring/applicationContext.xml</param-value> | |
| </init-param> | |
| <load-on-startup>1</load-on-startup> | |
| </servlet> | |
| <servlet-mapping> | |
| <servlet-name>springmvctouchbaidu</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> | |
| <session-config> | |
| <session-timeout>60</session-timeout> | |
| </session-config> | |
| </web-app> | 
在 src/main/resources 下面创建个 spring 目录用来存放 applicationContext.xml
后期会用的的配置很多,所以我一般会根据不同用途创建不同别名的 spring 配置文件,然后用 applicationContext.xml 统一起来。
这里我创建了 applicationContext.xml 以及 applicationContext-mvc.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" | |
| 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-3.0.xsd | |
| http://www.springframework.org/schema/context | |
| http://www.springframework.org/schema/context/spring-context-3.0.xsd | |
| http://www.springframework.org/schema/mvc | |
| http://www.springframework.org/schema/mvc/spring-mvc.xsd" | |
| default-lazy-init="true"> | |
| <context:component-scan base-package="com.lxl.demo"/> | |
| <mvc:resources location="/WEB-INF/pages/" mapping="/pages/**"/> | |
| <!-- 视图解析器 --> | |
| <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> | |
| <property name="prefix" value="/WEB-INF/pages/"/> | |
| <property name="suffix" value=".jsp"/> | |
| </bean> | |
| <!-- 默认的注解映射的支持 --> | |
| <mvc:annotation-driven> | |
| <mvc:message-converters register-defaults="true"> | |
| <bean class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter"> | |
| <property name="supportedMediaTypes"> | |
|                     <list> | |
| <value>text/plain;charset=utf-8</value> | |
| <value>application/json;charset=utf-8</value> | |
| <value>application/x-www-form-urlencoded</value> | |
| </list> | |
| </property> | |
| </bean> | |
| </mvc:message-converters> | |
| </mvc:annotation-driven> | |
| </beans> | 
其中一些重要的配置下篇文章详细的说明
context:component-scan 用来扫描指定的路径下的包,来加载组件用的
mvc:resources 指定静态资源路径
# 实现一个简单的 springMVC 请求
配置文件配置好了,我们就来测试一下,写一个 controller 来实现前后台交互
在 src/main/java 下面创建如下格式的文件夹。这是我习惯的写法。
common 用来存放公共的类
controller 控制层
service 层用来处理业务逻辑
dao 层用来处理数据库操作
dto 层用来存放 mybatis 根据表自动生成的实体对象
具体结构如下图:
在 controller包 下面创建一个类 SendToBaiduController
| package com.lxl.demo.controller; | |
| import org.springframework.stereotype.Controller; | |
| import org.springframework.web.bind.annotation.RequestMapping; | |
| import org.springframework.web.bind.annotation.RequestMethod; | |
| @Controller | |
| @RequestMapping(value="/sendBaidu") | |
| public class SendToBaiduController { | |
| @RequestMapping(value="/view",method = RequestMethod.GET) | |
| public String index(){ | |
| System.out.println("进来了"); | |
| return "index"; | |
|     } | |
| } | 
index.jsp 代码:
| <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> | |
| <% | |
| String path = request.getContextPath(); | |
| String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/"; | |
| %> | |
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> | |
| <html> | |
|   <head> | |
|     <base href="<%=basePath%>"> | |
| <title>My JSP 'index.jsp' starting page</title> | |
|     <meta http-equiv="pragma" content="no-cache"> | |
|     <meta http-equiv="cache-control" content="no-cache"> | |
|     <meta http-equiv="expires" content="0">     | |
|     <meta http-equiv="keywords" content="keyword1,keyword2,keyword3"> | |
|     <meta http-equiv="description" content="This is my page"> | |
|   </head> | |
|   <body> | |
| 跳转进来,表示springMVC流程成功! | |
|   </body> | |
| </html> | 
部署到 tomcat 启动服务看看 输入地址是否控制台会打印 “进来了” 这 3 字,并跳转到 index 界面
http://localhost:8080/springmvctouchbaidu/sendBaidu/view
大家看,如图表示 springMVC 整体流程成功了

# 总结
到此,基于 Maven 的 SpringMVC WEB 项目搭建算是成功了,后续会基于这个基础添加其他的功能,比如整合数据库框架 mybatis,多数据源处理,定时任务等等。下篇文章将整体上介绍 springMVC 的配置文件以及注解标签的使用。
