maven相关

最新推荐文章于 2022-02-18 11:32:07 发布

LTC_1234

最新推荐文章于 2022-02-18 11:32:07 发布

阅读量630

点赞数

分类专栏： JAVA

本文链接：https://blog.csdn.net/LTC_1234/article/details/104247579

版权

JAVA 专栏收录该内容

41 篇文章 0 订阅

订阅专栏

文章目录

maven 介绍

Maven项目对象模型(POM)，可以通过一小段描述信息来管理项目的构建，报告和文档的项目管理工具软件。
Maven 除了以程序构建能力为特色之外，还提供高级项目管理工具。由于 Maven 的缺省构建规则有较高的可重用性，所以常常用两三行 Maven 构建脚本就可以构建简单的项目。由于 Maven 的面向项目的方法，许多 Apache Jakarta 项目发文时使用 Maven，而且公司项目采用 Maven 的比例在持续增长。
Maven这个单词来自于意第绪语（犹太语），意为知识的积累，最初在Jakata Turbine项目中用来简化构建过程。当时有一些项目（有各自Ant build文件），仅有细微的差别，而JAR文件都由CVS来维护。于是希望有一种标准化的方式构建项目，一个清晰的方式定义项目的组成，一个容易的方式发布项目的信息，以及一种简单的方式在多个项目中共享JARs。

Maven 主要帮助用户完成以下 3 个方面的工作：
生命周期管理，便捷的构建过程；
依赖管理，方便引入所需依赖 Jar 包；
仓库管理，提供统一管理所有 Jar 包的工具

Maven 构建生命周期

Maven 构建生命周期就是 Maven 将一个整体任务划分为一个个的阶段，类似于流程图，按顺序依次执行。也可以指定该任务执行到中间的某个阶段结束。
Maven 的内部有三个构建生命周期，分别是 clean, default, site。其中 default 生命周期的核心阶段如下所示：

default lifecycle

可以指定某个生命周期的阶段

执行 mvn install 命令，将完成 validate, compile, test, package, verify, install 阶段，并将 package 生成的包发布到本地仓库中。其中某些带有连字符的阶段不能通过 shell 命令单独指定。例如：(pre-, post-, or process-*)
mvn install

可以指定多个不同构建生命周期的阶段

执行 mvn clean deploy 命令，首先完成的 clean lifecycle，将以前构建的文件清理，然后再执行 default lifecycle 的 validate, compile, test, package, verify, insstall, deploy 阶段，将 package 阶段创建的包发布到远程仓库中。
mvn clean deploy

阶段与插件的关系

如上所述，Maven 将构建过程定义为 default lifecycle，并将 default lifecycle 划分为一个个的阶段 phase，这一系列 phase 仅仅是规定执行顺序，至于每个阶段做什么工作？由谁来做？答案就在插件（plugins）中。
Maven 对工程的所有操作实实在在的都是由插件来完成的。一个插件可以支持多种功能，称之为目标（goal），例如：compiler 插件有两个目标：compile 和 testCompile，分别实现编译源代码和编译测试代码。
如何将插件与 Maven 的构建生命周期绑定在一起呢？通过将插件的目标（goal）与 build lifecycle 中 phase 绑定到一起，这样，当要执行某个 phase 时，就调用插件来完成绑定的目标。
如下图所示：从图中可以看出，每一个阶段可以绑定0 个或多个目标，每个插件可以提供 1 个或多个目标。

maven build

maven-assembly-plugin
当你使用 Maven 对项目打包时，你需要了解以下 3 个打包 plugin，它们分别是
plugin function
maven-jar-plugin maven 默认打包插件，用来创建 project jar
maven-shade-plugin 用来打可执行包，executable(fat) jar
maven-assembly-plugin 支持定制化打包方式，例如 apache 项目的打包方式

这里主要介绍一下 maven-assembly-plugin。
简单的说，maven-assembly-plugin 就是用来帮助打包用的，比如说打出一个什么类型的包，包里包括哪些内容等等。目前至少支持以下打包类型：

zip
tar
tar.gz
tar.bz2
jar
dir
war

默认情况下，打jar包时，只有在类路径上的文件资源会被打包到jar中，并且文件名是 ${artifactId}-$ {version}.jar，下面看看怎么用maven-assembly-plugin插件来定制化打包。

首先需要添加插件声明：

<plugin> 
 
    <groupId>org.apache.maven.plugins</groupId> 
 
    <artifactId>maven-assembly-plugin</artifactId> 
 
    <version>2.4</version> 
 
    <executions> 
        <execution> 
 
            <phase>package</phase> 
 
            <goals> 
 
                <goal>single</goal> 
 
            </goals> 
 
        </execution> 
 
    </executions> 
 
</plugin>

使用内置的Assembly Descriptor

要使用maven-assembly-plugin，需要指定至少一个要使用的assembly descriptor 文件，对于当前使用的版本(2.4)对应的assembly descriptor的schema定义为：Assembly Schema ，其中assembly descriptor中又可以包括 component 的定义 (component 可以很方便的用于多个assembly descriptor之间共享)，component 的schema 定义在：Component Schema 。关于assembly descriptor的component descriptor的更详细的说明，请见：Component Descriptor 和 Assembly Descriptor 。

默认情况下，maven-assembly-plugin内置了几个可以用的assembly descriptor：
bin ：类似于默认打包，会将bin目录下的文件打到包中
jar-with-dependencies ：会将所有依赖都解压打包到生成物中
src ：只将源码目录下的文件打包
project ：将整个project资源打包

自定义Assembly Descriptor

一般来说，内置的assembly descriptor都不满足需求，这个时候就需要写自己的assembly descriptor的实现了。先从一个最简单的定义开始：

<?xml version='1.0' encoding='UTF-8'?> 
<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0 
 http://maven.apache.org/xsd/assembly-1.1.0.xsd"> 
 
    <id>demo</id> 
 
    <formats> 
 
        <format>jar</format> 
 
    </formats> 
 
    <includeBaseDirectory>false</includeBaseDirectory> 
 
    <fileSets> 
 
        <fileSet> 
 
            <directory>${project.build.directory}/classes</directory> 
 
            <outputDirectory>/</outputDirectory> 
 
        </fileSet> 
 
    </fileSets> 
 
</assembly>

这个定义很简单：
format：指定打包类型
includeBaseDirectory：指定是否包含打包层目录（比如finalName是output，当值为true，所有文件被放在output目录下，否则直接放在包的根目录下）
fileSets：指定要包含的文件集，可以定义多个fileSet
directory：指定要包含的目录
outputDirectory：指定当前要包含的目录的目的地要使用这个assembly descriptor，需要如下配置：

<configuration> 
 
    <finalName>demo</finalName> 
 
    <descriptors> 
 
        <descriptor>assemblies/demo.xml</descriptor> 
 
    </descriptors> 
 
    <outputDirectory>output</outputDirectory> 
 
</configuration>

指定Main-Class
archive的一个重要用处就是配置生成的MANIFEST.MF文件。默认会生成一个MANIFEST.MF文件，不过这个文件默认值没什么意义。如果想指定生成jar的Main-Class，可以如下配置：

<archive> 
 
    <manifest> 
 
        <mainClass>demo.DemoMain</mainClass> 
 
    </manifest> 
 
</archive>

maven生成可以直接运行的jar

Maven可以使用mvn package指令对项目进行打包，如果使用Java -jar xxx.jar执行运行jar文件，会出现"no main manifest attribute, in xxx.jar"（没有设置Main-Class）、ClassNotFoundException（找不到依赖包）等错误。

要想jar包能直接通过Java -jar xxx.jar运行，需要满足：

1、在jar包中的META-INF/MANIFEST.MF中指定Main-Class，这样才能确定程序的入口在哪里；

2、要能加载到依赖包。

使用Maven有以下几种方法可以生成能直接运行的jar包，可以根据需要选择一种合适的方法。
1)使用maven-assembly-plugin插件打包


    <build>  
        <plugins>  
      
            <plugin>  
                <groupId>org.apache.maven.plugins</groupId>  
                <artifactId>maven-assembly-plugin</artifactId>  
                <version>2.5.5</version>  
                <configuration>  
                    <archive>  
                        <manifest>  
                            <mainClass>com.xxg.Main</mainClass>  
                        </manifest>  
                    </archive>  
                    <descriptorRefs>  
                        <descriptorRef>jar-with-dependencies</descriptorRef>  
                    </descriptorRefs>  
                </configuration>  
            </plugin>  
      
        </plugins>  
    </build>

打包后会在target目录下生成一个xxx-jar-with-dependencies.jar文件，这个文件不但包含了自己项目中的代码和资源，还包含了所有依赖包的内容。所以可以直接通过java -jar来运行。
2)使用maven-shade-plugin插件打包


    <build>  
        <plugins>  
      
            <plugin>  
                <groupId>org.apache.maven.plugins</groupId>  
                <artifactId>maven-shade-plugin</artifactId>  
                <version>2.4.1</version>  
                <executions>  
                    <execution>  
                        <phase>package</phase>  
                        <goals>  
                            <goal>shade</goal>  
                        </goals>  
                        <configuration>  
                            <transformers>  
                                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">  
                                    <mainClass>com.xxg.Main</mainClass>  
                                </transformer>  
                            </transformers>  
                        </configuration>  
                    </execution>  
                </executions>  
            </plugin>  
      
        </plugins>  
    </build>

配置完成后，执行mvn package即可打包。在target目录下会生成两个jar包，注意不是original-xxx.jar文件，而是另外一个。和maven-assembly-plugin一样，生成的jar文件包含了所有依赖，所以可以直接运行。
3)
使用maven-jar-plugin和maven-dependency-plugin插件打包


    <build>  
        <plugins>  
      
            <plugin>  
                <groupId>org.apache.maven.plugins</groupId>  
                <artifactId>maven-jar-plugin</artifactId>  
                <version>2.6</version>  
                <configuration>  
                    <archive>  
                        <manifest>  
                            <addClasspath>true</addClasspath>  
                            <classpathPrefix>lib/</classpathPrefix>  
                            <mainClass>com.xxg.Main</mainClass>  
                        </manifest>  
                    </archive>  
                </configuration>  
            </plugin>  
            <plugin>  
                <groupId>org.apache.maven.plugins</groupId>  
                <artifactId>maven-dependency-plugin</artifactId>  
                <version>2.10</version>  
                <executions>  
                    <execution>  
                        <id>copy-dependencies</id>  
                        <phase>package</phase>  
                        <goals>  
                            <goal>copy-dependencies</goal>  
                        </goals>  
                        <configuration>  
                            <outputDirectory>${project.build.directory}/lib</outputDirectory>  
                        </configuration>  
                    </execution>  
                </executions>  
            </plugin>  
      
        </plugins>  
    </build>

maven-jar-plugin用于生成META-INF/MANIFEST.MF文件的部分内容，com.xxg.Main指定MANIFEST.MF中的Main-Class，true会在MANIFEST.MF加上Class-Path项并配置依赖包，lib/指定依赖包所在目录
只是生成MANIFEST.MF文件还不够，maven-dependency-plugin插件用于将依赖包拷贝到${project.build.directory}/lib指定的位置，即lib目录下。

配置完成后，通过mvn package指令打包，会在target目录下生成jar包，并将依赖包拷贝到target/lib目录下
指定了Main-Class，有了依赖包，那么就可以直接通过java -jar xxx.jar运行jar包。
这种方式生成jar包有个缺点，就是生成的jar包太多不便于管理