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

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


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

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_02


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

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java开发_03


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

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_04


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

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

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

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_05


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-EclipseEE使用Maven构建Java web项目从0到1_Java开发_06

勾选本地的maven


配置maven的配置文件

User Setting 配置 maven的 配置文件

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_07

  • 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

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java开发_08

点击Next


Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_09

点击Next, 保持默认


Maven-EclipseEE使用Maven构建Java web项目从0到1_Java开发_10

选择 maven-archetype-webapp骨架

说明:

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

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

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


Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_11

填写项目信息,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 指定容器。

此时项目结构如下:

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_12


配置项目

添加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

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_13

报错:The folder is already a source folder

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_14

解决办法:

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

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java开发_15

重新创建即可

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_16

依次建立source folder后(src/main/java、src/test/java、src/test/resources),如下所示
Maven-EclipseEE使用Maven构建Java web项目从0到1_Java开发_17


调整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;

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_18


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

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_19


此时的目录结构如下:

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java开发_20


将项目转换为Dynamic Web Project

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

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_21

选择Servlet版本 和 JDK版本。


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

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

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java开发_22

修改

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_23

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

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_24

Maven-EclipseEE使用Maven构建Java web项目从0到1_Java教程_25

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-EclipseEE使用Maven构建Java web项目从0到1_Java开发_26


每次使用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-EclipseEE使用Maven构建Java web项目从0到1_Java教程_27

这是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

总结

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