eclipse下创建maven spring MVC 项目全步骤

eclipse下创建maven spring MVC 项目全步骤

因为之前学习的需要导致经常接触到maven依赖管理，但是一直都没有认真记录下整个框架的搭建，这段时间突然重新去搭建整个框架出现了一堆问题，所以特写下这篇笔记加强学习。废话不多说，下面一步步来搭建最简单的 maven + spring MVC 项目。

一）创建maven项目

1. 创建准备工作
   -eclipse （本人使用的是Neon.3 Release (4.6.3)版本，此版本用使用jdk 1.8）
   -jdk1.8.0_101
   -maven-3.5.0
   上面这些不要求一样，其他版本大致也是一样的。

2. 新建maven项目
   1、打开eclipse New Project ，这里我们选择创建maven项目

   ！但是这里可能会遇到一个问题，就是我们的eclipse里面没有maven项目这个选项…，因为有些比较旧的版本可能需要我们手动在eclipse中安装maven
   遇到这种情况有两种安装方法
   一、在线安装：Help –> Install New Software然后输入 HTTP 地址（http://m2eclipse.sonatype.org/sites/m2e）来安装，但是这个真的很慢啊~~。
   二、离线安装：下载eclipse maven 插件，然后解压后把文件拷贝到eclipse的安装目录下的dropins即可，然后重启eclipse

   我们继续走~

   2、第一步选择完maven project后，我们选择next，然后继续next（这些我们选择默认就好），直到这步
   
   因为我们是要创建一个web项目，所以我们选择maven-archetype-webapp，然后next

   3. 接下来这步最重要的就是输入Group Id和Archetype Id
   
   填完后点击finish。

   4. 创建完的maven项目大概如下图结构（可能存在差异，但是并没什么关系）
   
   注意：这里会出现报错的情况，但是没关系，只是因为JSP需要servlet的Jar包
   我们选择最后那个pom.xml，双击打开，然后加入servlet 3.1的依赖坐标保存即可
   

   5. 将项目修改成web项目，并且修改一下web的版本，因为eclipse默认为我们创建的2.3版本，但是这个版本比较老了，而且2.3版本默认是不支持el表达式的。首先修改build path 和 Java compiler
   

   然后选择项目右击，选择properties
   

这里大家可能会遇到一个问题，就是这样

web module 选择了3.1然后apply不了。这里教大家一个方法，先将java选择1.7或者1.8（个人使用的是1.8），然后将web module这个选项的√去掉，然后apply，然后再选择3.1，再将这个选项的√打上，就可以保存了。

还有一个问题，就是选择3.1和1.8以后会有这个选择

最后点击ok完成即可

6. 完善maven目录结构，完善的maven目录结构应该有 src/main/java 、 src/main/resources 、src/test/java，我们只需要新创建没有的就可以了

这里可能出行新增不了目录的情况，有两种解决方法
一、点击Navigator，然后创建对应的目录，完成后返回project Explorer，选择项目右击，选择maven -> update project 即可出现对应的目录结构

二、选择项目，然后右击，选择properties ->java build path -> source ， 删除还没有的目录，回去创建目录即可

7.修改web.xml版本和删除WebContext文件夹，因为我们将web修改为了3.1，所以我们需要将web.xml内容进行修改，并且我们创建的是maven项目，使用WebContext是不需要的，我们将其删除即可


3.1 web.xml内容我们可以在自己的tomcat安装目录里面的conf里面的web.xml里面找到或者WebContext 里面的web.xml。

8.修改Deployment Assembly 属性，删除部署时不需要包含的目录，最后maven -> update project即可

注意如果出现：Dynamic Web Module 3.1 requires Java 1.7 or newer这个错误，有下面几个解决方法
1. 在eclipse 构建 web中关于java版本有三处需要修改统一。
（1）在 Java Build Path的libraries中修改
（2）在Java Compiler 中修改
（3）在Project Facet中修改
2.maven项目总会意外的：）
在pom.xml加上

---

到此时，第一步maven目录和配置就完成啦

---

二）搭建spring mvc项目

1. 添加spring mvc 的相关依赖包
   包括（spring相关依赖版本为：4.1.6.RELEASE）spring-core、spring-context、spring-beans、spring-web、spring-webmvc、spring-aop、commons-logging（1.2版本）
   打开项目的pom文件，然后添加相关依赖的名称和坐标以及版本即可
   

2. 修改web.xml文件，加载spring mvc 的控制器
   

3. 创建和配置spring-web.xml文件
   .在对应web.xml里面配置的路径创建spring-web.xml文件
   
   .打开新建的spring-web.xml，修改配置（头部的约束文件可以在spring的官方文档里面找到）
   

4. 创建对应的测试controller和jsp
   
   对应的jsp
   
   对应的controller
   

---

三）测试

这里我使用jetty继续测试，在pom文件里面添加jetty的eclipse插件

然后选择项目，右击选择Run As,选择maven build，输入jetty:run，最后点击run即可

---

打开浏览器输入http://localhost:8080/hello

正常输出我们制定的页面和信息~~~，到这里我们就搭建好了maven spring MVC 项目 。

---

注：这是最基础的maven + spring mvc 项目，实际的项目还需要配置其它，例如事务，以及和其它框架的整合。