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

Maven是什么

安装Maven
解压apache-maven-350-binzip

新建变量M2_HOME配置Maven主目录

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

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

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

Eclipse中设置本地配置的maven建议
添加maven

配置maven的配置文件

EclipseEE使用Maven构建Java web项目
新建Maven项目
报错the-superclass-javax-servlet-http-httpservlet-was-not-found-on-the-java-build

配置项目
添加source folder
报错The folder is already a source folder

调整Build Path 和 JDK版本

将项目转换为Dynamic Web Project
报错Cannot change version of project facet Dynamic Web Module to 30

设置Web Deployment Assembly
每次使用Maven Update project的时候JDK版本都恢复成15的解决办法

总结

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

总结

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