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 spring MVC 项目全步骤

    !但是这里可能会遇到一个问题,就是我们的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(这些我们选择默认就好),直到这步
    eclipse下创建maven spring MVC 项目全步骤
    因为我们是要创建一个web项目,所以我们选择maven-archetype-webapp,然后next

    3. 接下来这步最重要的就是输入Group Id和Archetype Id
    eclipse下创建maven spring MVC 项目全步骤
    填完后点击finish。

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

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

    然后选择项目右击,选择properties
    eclipse下创建maven spring MVC 项目全步骤

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

eclipse下创建maven spring MVC 项目全步骤
web module 选择了3.1然后apply不了。这里教大家一个方法,先将java选择1.7或者1.8(个人使用的是1.8),然后将web module这个选项的√去掉,然后apply,然后再选择3.1,再将这个选项的√打上,就可以保存了。

还有一个问题,就是选择3.1和1.8以后会有这个选择
eclipse下创建maven spring MVC 项目全步骤
eclipse下创建maven spring MVC 项目全步骤

最后点击ok完成即可

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

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

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

二、选择项目,然后右击,选择properties ->java build path -> source , 删除还没有的目录,回去创建目录即可
eclipse下创建maven spring MVC 项目全步骤

7.修改web.xml版本和删除WebContext文件夹,因为我们将web修改为了3.1,所以我们需要将web.xml内容进行修改,并且我们创建的是maven项目,使用WebContext是不需要的,我们将其删除即可
eclipse下创建maven spring MVC 项目全步骤
eclipse下创建maven spring MVC 项目全步骤
3.1 web.xml内容我们可以在自己的tomcat安装目录里面的conf里面的web.xml里面找到或者WebContext 里面的web.xml。

8.修改Deployment Assembly 属性,删除部署时不需要包含的目录,最后maven -> update project即可
eclipse下创建maven spring MVC 项目全步骤

注意如果出现: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加上
eclipse下创建maven spring MVC 项目全步骤


到此时,第一步maven目录和配置就完成啦
eclipse下创建maven spring MVC 项目全步骤


二)搭建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文件,然后添加相关依赖的名称和坐标以及版本即可
    eclipse下创建maven spring MVC 项目全步骤

  2. 修改web.xml文件,加载spring mvc 的控制器
    eclipse下创建maven spring MVC 项目全步骤

  3. 创建和配置spring-web.xml文件
    .在对应web.xml里面配置的路径创建spring-web.xml文件
    eclipse下创建maven spring MVC 项目全步骤
    .打开新建的spring-web.xml,修改配置(头部的约束文件可以在spring的官方文档里面找到)
    eclipse下创建maven spring MVC 项目全步骤

  4. 创建对应的测试controller和jsp
    eclipse下创建maven spring MVC 项目全步骤
    对应的jsp
    eclipse下创建maven spring MVC 项目全步骤
    对应的controller
    eclipse下创建maven spring MVC 项目全步骤


三)测试

这里我使用jetty继续测试,在pom文件里面添加jetty的eclipse插件
eclipse下创建maven spring MVC 项目全步骤

然后选择项目,右击选择Run As,选择maven build,输入jetty:run,最后点击run即可
eclipse下创建maven spring MVC 项目全步骤


打开浏览器输入http://localhost:8080/hello
eclipse下创建maven spring MVC 项目全步骤
正常输出我们制定的页面和信息~~~,到这里我们就搭建好了maven spring MVC 项目 。


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