Maven项目打Jar包,如何添加依赖

时间:2021-10-23 09:16:56

  之前介绍了使用spring-boot-maven-plugin插件打jar包,会把所有的依赖文件都导入,然后变成了一个可执行的jar包。这样的不好的地方就是,我实际上并不需要把依赖的jar包也打入到生成的jar包里面去,仅仅需要把当前项目的代码打包。生成的jar包只要能引用到它所依赖的jar包,并且可以执行就好了。

  那么一般情况下,打包时如何添加依赖呢?
  使用maven-dependency-plugin插件
  子项目中的pom.xml文件中,添加以下maven-dependency-plugin依赖,这个maven-dependency-plugin依赖的作用就是自动拷贝jar包到target目录

  这是我的Maven子项目打包,指定了将它的依赖的父项目中的jar包拷贝到target下的lib目录

 <plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<executions>
<execution>
<id>copy-dependencies</id>
<phase>prepare-package</phase>
<goals>
<goal>copy-dependencies</goal>
</goals>
<configuration>
<!-- ${project.build.directory}为Maven内置变量,缺省为target -->
<outputDirectory>${project.build.directory}/lib</outputDirectory>
<overWriteReleases>true</overWriteReleases>
<overWriteSnapshots>true</overWriteSnapshots>
<overWriteIfNewer>true</overWriteIfNewer>
</configuration>
</execution>
</executions>
</plugin>

  关于maven-dependency-plugin:用得最多的几个操作:copy, copy-dependencies和它们对应的unpack, unpack-dependencies
  描述:copy 和 unpack操作是由要拷某个包,这个包需要具体指定要拷哪个包,与当前工程的依赖没有关系。这两者区别-是否解压
     copy-dependencies和unpack-dependencies,但是它是用来拷当前工程的依赖包的。这两者区别-是否解压


  copy操作可以用来将某个(些)maven artifact(s)拷贝到某个目录下。添加phase和goal如下:

     <build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<version>2.8</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>copy</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>

  然后就是配置,copy可以的配置的项比较多,详细的请参考:copy配置。下面是一些常用项说明:

   ● artifactItems: 指定要拷贝的jar包
    ● prependGroupId: 用来指示拷出来的library名字需要不需要加上groupId,默认是不加
    ● outputDirectory: 用来指定拷出后Libraries的存放地

  这里除了artifactItems没有默认值,需要指定外,所有其他的选项都可以被忽略:

     <configuration>
<artifactItems>
<artifactItem>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
</artifactItem>
</artifactItems>
</configuration>

  以上配置会将junit包拷到target/dependency目录下,文件名为:junit-4.11.jar。

  unpack和copy类似,只不过它会把拷来的包解开。junit拷完以后,放到lib和lib2下的不再是Jar包,还是Jar包里的内容。

  copy-dependencies 和 unpack-dependencies
  上面介绍的copy 和 unpack操作是由要拷某个包,这个包需要具体指定要拷哪个包,与当前工程的依赖没有关系。copy-dependencies和它有点类似,但是它是用来拷当前工程的依赖包的,典型的,例如我们有一个web应用,当打成war包的时候,它所有的依赖也需要被打到应用中。
 
  copy-dependencies的参数有很多,详细的可以参考:copy-dependencies Doc,但是几乎所有都有默认值。所以一个最简单的定义如下:

 <plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<version>2.8</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>copy-dependencies</goal>
</goals>
</execution>
</executions>
</plugin>

这里没有指定任何配置,所有的参数都用默认值,则当前工程的所有依赖(直接、间接的)都会被拷到target/dependency目录下。
也可以使用outputDirectory指定存放在。另外,以下几个参数可以控制哪些依赖将被拷出(或排除):
excludeArtifactIds
excludeClassifiers
excludeGroupIds
excludeScope 
excludeTransitive
excludeTypes
includeArtifactIds
includeClassifiers
includeGroupIds
includeScope
includeTypes