美文网首页Java程序那些事
Maven的build生命周期和常用plugin

Maven的build生命周期和常用plugin

作者: flydean程序那些事 | 来源:发表于2020-05-26 06:59 被阅读0次

    简介

    Maven和gradle应该是现代java程序员中使用的最多的两种构建工具。在它们出现之前,则是ant的天下。

    Maven为我们封装了很多构建中非常有用的操作,我们只需要执行简单的几个mvn命令即可。

    今天我们要讨论一下mvn命令之下的生命周期的构建。

    更多精彩内容且看:

    更多内容请访问www.flydean.com

    lifecycle和Phases

    所谓lifecycle,可以理解为可以执行一组命令的集合,用来执行具体的某些操作。

    Maven默认有三种lifecycle:default,clean和site。default主要用来处理项目的开发,clean主要用来负责项目的清理,site主要用来生成项目的文档。

    lifecycle是由一个或者多个phase组成的。

    以default为例,它大概由23个phases组成,这些phases将会按顺序执行来完成default的lifecycle。

    我们选取default lifecycle中非常常见的几个phase来说明一下:

    • validate - 用来验证项目是否正确或者项目所需要的信息是否可用。
    • compile - 用来编译项目代码
    • test - 执行代码中的单元测试
    • package - 将编译后的代码进行打包,打包可有很多种方式,比如:jar,war等
    • verify - 执行集成测试
    • install - 将项目安装到本地仓库中,供有依赖关系的其他项目使用
    • deploy - 将项目部署到远程仓库,以便共享给其他的用户

    上面的phase执行是有顺序的,比如我们如果执行mvn verify,则会顺序执行validate,compile,test和package。

    Phases和Goals

    Phases是一种任务的集合,它是由一个或者多个Goals组成的。Goals可以包含在Phases里面执行,也可以单独用命令执行。

    那么Goals又是从哪里来的呢?Goals是定义在maven中的plugin中的。

    我们看下面一张直观的图:

    image

    下图列出了现有lifecycle中的phase,和相应phase所对应的plugin。

    我们可以看到基本每个phase都和一个plugin中的golas是相对于应的。

    除了使用命名直接指定要执行的phase以外,还可以直接指定goals:

    mvn clean dependency:copy-dependencies package
    

    上面的命令中clean和package是phase,而copy-dependencies则是goals。

    常用plugin介绍

    这里我们介绍两个非常常用的maven plugin,maven-dependency-plugin和maven-jar-plugin。

    maven-dependency-plugin

    maven中的依赖jar包是存放在maven的本地仓库中的,如果项目中依赖了某些jar包,在部署的时候还需要这些依赖的jar包拷贝出来,非常不方便,有了maven-dependency-plugin,则可以借用它的copy-dependencies来将项目的依赖jar包拷贝出啦,如下所示:

     <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-dependency-plugin</artifactId>
                <version>3.1.2</version>
                <executions>
                    <execution>
                        <id>copy</id>
                        <phase>package</phase>
                        <goals>
                            <goal>copy-dependencies</goal>
                        </goals>
                        <configuration>
                            <outputDirectory>
                                ${project.build.directory}/lib
                            </outputDirectory>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
    

    goals是和相应的phase相关联的,在上面的例子中,我们将copy-dependencies和package相关联,则在我们执行mvn package的时候就会自动执行copy-dependencies,从配置文件可以知道,我们将会把项目的依赖jar包拷贝到项目的build目录的lib目录下。

    maven-jar-plugin

    有了依赖的lib,可以将main程序打包成为一个可执行的jar包。这时候我们就需要使用到maven-jar-plugin。

    <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.2.0</version>
                <configuration>
                    <archive>
                        <manifest>
                            <mainClass>com.flydean.MavenClass</mainClass>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
    

    为了生成可执行的jar包,我们需要在MANIFEST.MF文件中添加mainClass文件的路径,这样在执行jar包的时候,无需额外的参数即可运行。

    遗憾的是,如果我们的class文件用到了外部jar包的依赖时候,jar包直接运行会出错,因为找不到所依赖的jar包。

    在介绍maven-dependency-plugin的时候,我们已经把所用到的lib拷贝出来了,这里我们可以直接使用:

    <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.2.0</version>
                <configuration>
                    <archive>
                        <manifest>
                            <addClasspath>true</addClasspath>
                            <classpathPrefix>lib/</classpathPrefix>
                            <mainClass>com.flydean.MavenClass</mainClass>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
    

    多加了两个addClasspath的参数,我们将打包好的jar包解压缩。

    可以看到里面多了一个MANIFEST.MF的文件:

    Manifest-Version: 1.0
    Created-By: Maven Jar Plugin 3.2.0
    Build-Jdk-Spec: 14
    Class-Path: lib/lombok-1.18.10.jar lib/logback-classic-1.2.3.jar lib/log
     back-core-1.2.3.jar lib/slf4j-api-1.7.25.jar
    Main-Class: com.flydean.MavenClass
    

    这个文件里面包含了一些jar包的元数据,并且里面添加了Class-Path和Main-Class文件,这时候执行运行jar包就可以直接执行了。

    总结

    本文介绍了maven构建时候的生命周期,并介绍了两个经常会使用到的plugin。

    本文的例子https://github.com/ddean2009/
    learn-java-base-9-to-20

    本文作者:flydean程序那些事

    本文链接:http://www.flydean.com/apache-maven-lifecycle/

    本文来源:flydean的博客

    欢迎关注我的公众号:程序那些事,更多精彩等着您!

    相关文章

      网友评论

        本文标题:Maven的build生命周期和常用plugin

        本文链接:https://www.haomeiwen.com/subject/hogpahtx.html