Maven-EclipseEE使用Maven构建Java web项目从0到1

Maven是什么

简单的说：Maven是一个开源的构建工具，它可以帮助我们管理项目的构建过程，管理项目的生命周期，jar包依赖关系等。Maven配合持续集成可以实现自动化的编译、测试、打包、发布等强大的功能，尤其在持续集成上有为我们带来了很大便利

---

安装Maven

官方下载地址: https://maven.apache.org/download.cgi

目前最新版本： apache-maven-3.5.0-bin.zip

解压apache-maven-3.5.0-bin.zip

---

新建变量M2_HOME,配置Maven主目录

---

在 Path 变量中添加 Maven的bin目录

---

命令窗口mvn -v查看是否成功

---

修改maven默认的仓库地址(可选)

默认情况下Mavne 会将jar包插件等下载到${user.home}/.m2/repository 下，

通过修改 Maven的配置文件 M2_HOME/conf/setting.xml 中的localRepository来更改默认的本地仓库位置

---

Eclipse中设置本地配置的maven(建议)

如果是web项目，需要下载支持JavaEE的 Eclipse版本，不要使用JavaSE的Eclipse版本。

我使用的是

Eclipse Java EE IDE for Web Developers.Version: Mars Release (4.5.0)

不建议使用eclipse自带的maven，我们在这里使用我们本地安装的maven。

添加maven

路径：Windows->Preferences->Maven->Installations->add

勾选本地的maven

---

配置maven的配置文件

User Setting 配置 maven的 配置文件

• Global Setting 为全局设置，一般为M2_HOME/conf/setting.xml

• User Setting 是用户设置，一般copy 一份 setting.xml 到任意位置,根据自己的需求修改配置文件

• Maven的配置文件遵循”就近原则”,也就是说 User Setting会覆盖 Global Setting；

---

EclipseEE使用Maven构建Java web项目

新建Maven项目

File —- New —- Other 选择Maven Project

点击Next

---

点击Next， 保持默认

---

选择 maven-archetype-webapp骨架

说明：

• 每一个骨架都会建相应的目录结构和一些通用文件，最常用的是maven-archetype-quickstart和maven-archetype-webapp骨架。

• maven-archetype-quickstart骨架是用来创建一个Java Project，

• maven-archetype-webapp骨架则是用来创建一个JavaWeb Project。

---

填写项目信息，Artifact ID将作为项目名称。

点击Finish即可。

报错：the-superclass-javax-servlet-http-httpservlet-was-not-found-on-the-java-build

当新建完web项目后，如果报错如上

原因： There is no Target Runtimes under Facets

解决办法一：

pom.xml 添加依赖，自动下载servlet包

<dependency>    <groupId>javax.servlet</groupId>    <artifactId>javax.servlet-api</artifactId>    <version>3.1.0</version>    <scope>provided</scope></dependency>

解决办法二：

Project → Properties → Target Runtimes → Apache Tomcat 指定容器。

此时项目结构如下：

---

配置项目

添加source folder

Maven的项目有一些约定：src/main/java , src/main/resources , src/test/java , src/test/resources 。

创建好的JavaWeb项目中目前只有src/main/resources目录，因此还需要手动添加src/main/java、src/test/java、src/test/resources

选中项目，右键单击，依次添加Source Folder

报错：The folder is already a source folder

解决办法：

项目上右键build path –>Configure Build path –> source ，选择 src/main/java、src/test/java，remove掉，最后重新new source folder即可。

重新创建即可

依次建立source folder后（src/main/java、src/test/java、src/test/resources），如下所示

---

调整Build Path 和 JDK版本

选中项目，右键–> Build Path ->Configure Build Path 选择 Source标签，会显示4个Source Folder ，修改对应的 OutPut folder

双击每个文件夹的Output folder，选择路径
src/main/java，src/main/resources，选择target /classes;
src/test/java ，src/test/resources, 选择target/test-classes;

---

修改JDK版本：选择 libraries 标签，选中JRE library，单击Edit按钮

---

此时的目录结构如下：

---

将项目转换为Dynamic Web Project

选中项目，右键单击，选择 Properties，左侧选择 Project Facets

选择Servlet版本 和 JDK版本。

---

报错：Cannot change version of project facet Dynamic Web Module to 3.0?

解决办法：
找到这个工程的 org.eclipse.wst.common.project.facet.core.xml

修改

然后:选中项目 右键 选择 Maven » Update Project (or press Alt+F5)

web.xml

<?xml version="1.0" encoding="UTF-8"?><web-app     xmlns="http://java.sun.com/xml/ns/javaee"     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    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></web-app>

---

设置Web Deployment Assembly

选中项目，右键单击，选择Properties，在左侧选择Deployment Assembly

这里是管理 部署项目时，文件发布的路径。

---

每次使用Maven > Update project的时候JDK版本都恢复成1.5的解决办法

pom.xml中增加如下配置：

<build>    <plugins>      <plugin>        <groupId>org.apache.maven.plugins</groupId>        <artifactId>maven-compiler-plugin</artifactId>        <version>3.1</version>        <configuration>          <source>1.7</source>          <target>1.7</target>        </configuration>      </plugin>    </plugins></build>

这是Maven已知的一个特性。除非在你的POM文件中显示的指定一个版本，否则会使用编译器默认的source/target版本1.5。主要还是在于Eclipse中Maven的集成方式起到了关键作用, 它会从POM文件中生成项目的.project,.classpath以及.settings, 因此除非POM文件指定了正确的JDK版本, 否则你每次更新项目配置的时候它都会重置到1.5版本。

参考： http://maven.apache.org/plugins/maven-compiler-plugin/index.html

总结

至此，环境的搭建就部署完成了。