Maven项目管理

maven快速入门

Maven是基于项目对象模型(POM),可以通过一小段描述信息来管理项目的构建、报告和文档的软件项目管理工具。

maven安装配置

下载好maven后,需要配置环境变量。

  1. 设置JAVA_HOMED:\program files\Java\jdk1.8.0_91, path添加%JAVA_HOME%\bin
  2. 新建M2_HOME,指向maven安装目录:D:\app\apache-maven-3.3.9
  3. 修改path,添加%M2_HOME%\bin
  4. 在命令行中输入mvn -v看看是否输出正确。

maven helloworld案例

maven目录结构结构

src
    -main
        -java
            -package
    -test
        -java
            -package
    -resources

按照上面的目录结构创建目录,package目录先不要创建package。

分别新建

package lx.maven.model;

public class HelloWorld{
    public String sayHello() {
        return "Helo world!";
    }
}

和测试

package lx.maven.model;

import org.junit.*;
import org.junit.Assert.*;

public class HelloWorldTest{
    @Test
    public void testHello() {
        Assert.assertEquals("Hello world!", new HelloWorld().sayHello());
    }
}

这里需要注意的是分别新建包。

然后需要新建pom.xml,保存在项目根目录下。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>lx.maven</groupId>
    <artifactId>maven01</artifactId>
    <version>1.0-SNAPSHOT</version>

    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.10</version>
        </dependency>
    </dependencies>

</project>

说明: - modelVersion:固定,不管 - groupId 项目的包名 - artifactId 模块名 - version 版本,SNAPSHOT快照版本

编译:mvn compile 运行测试用例:mvn test

运行后我们看到项目更目录下创建了target文件夹,这个文件夹下面又有几个子文件夹,分别是: - classes 生成的类文件字节码 - surefire-reports 测试报告

然后运行mvn package进行打包。打好的包在target根目录下。

Maven核心知识

常用的构建命令

之前我们已经学习了以下命令: - mvn -v:查看maven版本 - mvn compile: 编译 - mvn test: 测试 - mvn package:打包

本节主要学习以下两个命令: - mvn clean: 删除target - mvn install: 安装jar包到本地仓库中

我们新建一个项目maven02

package lx.maven02.util;

import lx.maven.model.HelloWorld;

public class Speak{
    public String sayHi() {
        return new HelloWorld().sayHello();
    }
}
package lx.maven02.util;

import org.junit.*;
import org.junit.Assert.*;

public class SpeakTest{
    @Test
    public void testsayHi() {
        Assert.assertEquals("Hello world!", new Speak().sayHi());
    }
}
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>lx.maven02</groupId>
    <artifactId>maven02-util</artifactId>
    <version>1.0-SNAPSHOT</version>

    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.10</version>
        </dependency>
    </dependencies>

</project>

此时运行mvn compile会报错,表示找不到对应的lx.maven.model包。之所以会这样是因为我们需要讲maven01的项目运行mvn install先安装到本地仓库,然后在maven02项目中添加依赖:

<dependency>
    <groupId>lx.maven</groupId>
    <artifactId>maven01</artifactId>
    <version>1.0-SNAPSHOT</version>
</dependency>

自动建立目录骨架

之前一直手动创建很麻烦,maven提供了archetype插件,用于创建符合maven规定的目录骨架。

我们先创建一个项目目录maven03,然后在命令行输入:

mvn archetype:generate

然后会让我们选择archetype版本,选择最大的就好了,然后要求我们输入groupId,我们输入lx.maven03artifactId我们输入maven03-serviceversion我们输入1.0-SNAPSHOT.然后会要求我们输入包名,不过会根据你之前输入的groupId自动提供一个,我们直接回车就可以了。最后会让我们确认信息,没问题就回车。

还有一种方法是一次性设置所有参数:

mvn archetype:generate -DgroupId=lx.maven03 -DartifactId=maven04-demo -Dversion=1.0SNAPSHOT -Dpackage=lx.maven03.demo

maven中的坐标和仓库

坐标:构件的唯一标识。groupId,artifactId,version构成了坐标的基本要素。

仓库:管理项目依赖,分为两种: - 本地仓库 - 远程仓库:如果本地仓库找不到,会到maven的全球仓库去找。

镜像仓库:打开maven/conf/settings.xml文件,在mirrors节添加:

<mirror>
     <id>maven.oschina.net</id>
     <mirrorOf>central</mirrorOf>
     <name>oschina maven mirror</name>
      <url>http://maven.oschina.net/content/groups/public</url>
   </mirror>

mirrorOf表示为哪个仓库指定镜像,默认是central,也可以使用*通配符。

现在看如何修改仓库位置: 默认情况下,仓库是在用户文件夹下的.m2文件中,我们可以修改settings.xml的settings下的位置:

<localRepository>D:/mavenrepo</localRepository>

然后将settings.xml文件复制到d:/mavenrepo下,这样以后要是修改maven版本就不用再次修改settings.xml.

maven的声明周期和插件

完整的项目构建过程包括: 清理、编译、测试、打包、集成测试、验证、部署 clean\compile\test\package\install maven声明周期: - clean 清理项目 - default 构建项目 - site 生成项目站点

对于clean清理项目 - pre-clean 执行清理前的工作 - clean 清理上一次构建生成的所有文件 - post-clean 执行清理后的文件

default构建项目(最核心) compile test package install都属于default阶段

site生成项目站点 - pre-site - site - post-site - site-deploy

现在加入我们要添加插件source,让打包时同时打包源码。我们修改pom.xml,加入:

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-source-plugin</artifactId>
            <version>3.0.0</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>jar-no-fork</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

说明: - plugin的phase表明阶段 - goal表示目标

具体请看apache官方文档。

然后运行mvn clean package看到会生成源码的jar包。

pom.xml常用元素介绍

pom.xml用于项目描述、组织管理、依赖管理和项目信息的管理。下面我们来介绍一下常用元素。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <!--指定了当前的POM版本-->
    <modelVersion>4.0.0</modelVersion>
    <!--主项目标识:反写公司网址+项目名-->
    <groupId></groupId>
    <!--项目名+模块名-->
    <artifactId></artifactId>
    <!--当前版本项目本:大版本号.分支版本号.小版本号;SNAPSHOT:快照,ALPHA:内部测试,BETA:公测,RELEASE:稳定版,GA:正式发布-->
    <version>0.0.1-SNAPSHOT</version>
    <!--打包方式,默认为jar .war,zip,pom-->
    <packaging>jar</packaging>

    <!--项目描述名,产生文档时使用-->
    <name>hi</name>
    <!--项目地址-->
    <url></url>
    <!--项目描述-->
    <description></description>
    <!--开发人员信息-->
    <developers></developers>
    <!--许可证信息-->
    <licenses></licenses>
    <!--组织信息-->
    <organization></organization>

    <!-- 依赖列表 -->
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>3.8.1</version>
            <type></type>
            <!-- 只在一个范围内使用 -->
            <scope>test</scope>
            <!-- 设置依赖是否可选,默认为false,默认是继承的 -->
            <optional></optional>
            <!-- 排除依赖传递列表。如果A依赖B,B依赖C,A就传递依赖C -->
            <exclusions>
                <exclusion>
                    <groupId></groupId>
                    <artifactId></artifactId>
                    <version></version>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>

    <!-- 依赖的管理.不会实际被引入,主要用于定义在父模块,用于子模块继承 -->
    <dependencyManagement>
        <dependencies>
            <dependency></dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <!-- 插件列表 -->
        <plugins>
            <plugin>
                <groupId></groupId>
                <artifactId></artifactId>
                <version></version>
            </plugin>
        </plugins>
    </build>

    <!-- 在子模块中对父模块POM的继承 -->
    <parent></parent>

    <!-- 多模块 -->
    <modules></modules>
</project>

依赖范围

之前已经见过junit依赖:

<dependency>
  <groupId>junit</groupId>
  <artifactId>junit</artifactId>
  <version>3.8.1</version>
  <scope>test</scope>
</dependency>

我们平时在开发时,如果要使用某个框架就需要将该框架的jar包添加到项目的classpath中,maven为我们提供了3种classpath,分别是: - 编译 - 测试 - 运行

所以scope就是用来指定依赖范围的。maven官方文档上说scope有六种取值:

  • compile:编译,默认的范围,编译测试运行都有效
  • provided:测试和编译时有效,运行时不会用
  • runtime:测试和运行时有效
  • test:测试,只在测试时有效
  • system:测试和编译时有效,可移植性差,与本机想关联
  • import:导入的范围,只使用在dependencyManagement中,表示从其他的pom中导入dependency的配置

依赖传递

A依赖B,B依赖C,则就可以说A间接依赖C。

首先,我们在B中引入对C的依赖(C应该mvn compile install).

<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>3.8.1</version>
    <type></type>
    <!-- 只在一个范围内使用 -->
    <scope>test</scope>
    <!-- 设置依赖是否可选,默认为false,默认是继承的 -->
    <optional></optional>
    <!-- 排除依赖传递列表。如果A依赖B,B依赖C,A就传递依赖C -->
    <exclusions>
        <exclusion>
         <groupId></groupId>
         <artifactId></artifactId>
         <version></version>
        </exclusion>
    </exclusions>
</dependency>

有时我们需要指定JDK默认版本,在settings.xml中的profile配置版本。

依赖冲突

  1. 短路优先 A->B-C-X(jar)A->D->X(jar),则A优先引用D所指向的X。
  2. 先声明先优先 如果路径长度相同,则谁先声明,先解析谁。

聚合和继承

先来说聚合。

如果有多个项目,A\B\C,我们想要把他们聚合起来,一起安装,我们新建一个项目D,修改它的pom.xml:

<modules>
    <module>../A</module>
    <module>../B</module>
    <module>../C</module>
</modules>

然后运行mvn clean install就能直接安装A/B/C了。

再来说继承。 在父pom中添加:

<!-- 指定类型为POM -->
<packaging>pom</packaging>
<properties>
    <!-- 定义变量 -->
    <junit.version>3.8.1</junit.version>
</properties>
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>${junit.version}</version>
        </dependency>
    </dependencies>
</dependencyManagement>

在子POM中使用:

<parent>
    <groupId></groupId>
    <artifactId></artifactId>
    <version></version>
</parent>

使用maven构建web项目

我们使用maven创建一个web项目,然后发布到jetty中。

使用IDEA创建一个maven项目,选择maven-archetype-webapp类型,GroupId输入lx.webdemo,artifectId输入webdemo。 在http://mvnrepository.com/ 中添加 我们打开pom.xml,添加Java Servlet API依赖,注意,servlet的f范围是provided

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>lx.webdemo</groupId>
    <artifactId>webdemo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>war</packaging>

    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <!--只在编译时和测试时运行-->
            <scope>provided</scope>
        </dependency>
    </dependencies>
</project>

然后添加Jetty maven plugin

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>lx.webdemo</groupId>
  <artifactId>webdemo</artifactId>
  <packaging>war</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>webdemo Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
      <dependency>
          <groupId>javax.servlet</groupId>
          <artifactId>javax.servlet-api</artifactId>
          <version>3.1.0</version>
      </dependency>
  </dependencies>
  <build>
    <finalName>webdemo</finalName>
      <plugins>
          <plugin>
              <groupId>org.eclipse.jetty</groupId>
              <artifactId>jetty-server</artifactId>
              <version>9.4.0.M0</version>
              <executions>
                  <execution>
                      <phase>package</phase>
                      <goals>
                          <goal>run</goal>
                      </goals>
                  </execution>
              </executions>
          </plugin>
      </plugins>
  </build>
</project>

然后运行mvn clean package即可。