众所周知,pom.xml文件是maven工程的核心文件,是全局级别的配置文件;可以在该文件中添加jar包的依赖,使用plugin来配置一些规则;在执行task或goal时,maven会去项目根目录下读取pom.xml文件获取需要的配置信息。总而言之,了解pom文件里面的概念是很有必要的。

一、maven内置属性(maven预定义,用户可以直接使用)

  • ${basedir}表示项目根目录,既包含pom.xml文件的目录
  • ${version}表示项目版本
  • ${project.basedir},同${basedir}
  • ${project.baseuri}表示项目文件地址
  • ${maven.build.timestamp}表示项目构件开始时间
  • ${maven.build.timestamp.format}表示属性${maven.build.timestamp}的展示格式,默认值为yyyyMMdd-HHmm,可以自定义其格式。用法如下:
1
2
3
<properties>
<maven.build.timestamp.format>yyyy-MM-dd-HH-mm-ss</maven.build.timestamp.format>
</properties>

扩展:指定生成的jar包文件名并带时间戳

1
2
3
4
5
<build>
<finalName>
${project.artifactId}-${project.version}-${maven.build.timestamp}
</finalName>
</build>

二、maven添加外部依赖

如果在远程仓库和中央仓库中,依赖不能被满足,如何解决呢? Maven 使用外部依赖的概念来解决这个问题。

对maven项目做如下修改:

  • 在 src 文件夹下添加 lib 文件夹
  • 复制任何 jar 文件到 lib 文件夹下。我们使用的是 abc.jar。

现在你有了自己的工程库(library),通常情况下它会包含一些任何仓库无法使用,并且 maven 也无法下载的 jar 文件。

将外部依赖添加到maven pom.xml文件中

1
2
3
4
5
6
7
<dependency>
<groupId>ldapjdk</groupId>
<artifactId>ldapjdk</artifactId>
<scope>system</scope>
<version>1.0</version>
<systemPath>${basedir}\src\lib\abc.jar</systemPath>
</dependency>

上例中, <dependencies> 的第二个 <dependency> 元素 , 阐明了外部依赖的关键概念。

  • 外部依赖(library jar location)能够像其他依赖一样在 pom.xml 中配置。
  • 指定 groupId 为 library 的名称。
  • 指定 artifactId 为 library 的名称。
  • 指定作用域(scope)为系统。
  • 指定相对于工程位置的系统路径。

三、查看完整pom.xml文件内容

执行命令:

1
mvn help:effective-pom

四、pom文件中添加对jar包的复制

需求:将项目中src/resources/lib目录下的ant-1.7.1.jar复制到target目录下

方式一:<resources>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
<build>
<resources>
<resource>
<targetPath>${project.basedir}/target</targetPath>
<filtering>false</filtering>
<directory>${project.basedir}/src/main/resources/lib</directory>
<includes>
<include>ant-1.7.1.jar</include>
</includes>
<excludes>
</excludes>
</resource>
</resources>
</build>

说明:

  • targetPath:资源文件的目标路径
  • filtering:构建过程中是否对资源进行过滤,默认false
  • directory:资源文件的路径,默认位于${project.basedir}/src/main/resources/目录下
  • includes:一组文件名的匹配模式,被匹配的资源文件将被构建过程处理
  • excludes:一组文件名的匹配模式,被匹配的资源文件将被构建过程忽略。同时被·includes和excludes匹配的资源文件将被忽略
方式二:<plugin>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
<plugins>
<plugin>
<artifactId>maven-resources-plugin</artifactId>
<version>2.6</version>
<executions>
<execution>
<id>copy-ant-jar</id>
<phase>compile</phase>
<goals>
<goal>copy-resources</goal>
</goals>
<configuration>
<outputDirectory>${project.basedir}/target</outputDirectory>
<resources>
<resource>
<directory>${project.basedir}/src/main/resources/lib</directory>
<includes>
<include>ant-1.7.1.jar</include>
</includes>
</resource>
</resources>
</configuration>
</execution>
</executions>
</plugin>
</plugins>

说明:

  • 上述方法使用了maven-resources-plugin插件对一些静态资源进行操作。

具体pom文件的解析,可参考博客:Maven之(七)pom.xml配置文件详解