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

小小工匠

发布于 2021-08-16 16:04:35

63800

代码可运行

文章被收录于专栏：小工匠聊架构小工匠聊架构

运行总次数：0

代码可运行

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.servletgroupId>
    <artifactId>javax.servlet-apiartifactId>
    <version>3.1.0version>
    <scope>providedscope>
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

<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 Applicationdisplay-name>

web-app>

设置Web Deployment Assembly

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

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

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

pom.xml中增加如下配置：

<build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.pluginsgroupId>
        <artifactId>maven-compiler-pluginartifactId>
        <version>3.1version>
        <configuration>
          <source>1.7source>
          <target>1.7target>
        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