阅读《Maven实战》许晓斌的一些笔记,便于自己和道友查阅
maven依赖
maven具有传递性依赖,比如 A 依赖 B 项目,B 项目依赖C项目,同时B项目可选依赖D项目,那么C就会成为A的范围依赖,而D不会成为A的范围依赖。A对于B是第一直接依赖,B对于C是第二直接依赖,A对与C是传递性依赖。
- 依赖范围影响传递性依赖图表, 最左边一列表示第一直接依赖范围,最上面一行表示第二直接依赖范围:
compile | test | provided | runtime | |
---|---|---|---|---|
compile | compile | — | — | runtime |
test | test | — | — | test |
provided | provided | — | provided | provided |
runtime | runtime | — | — | runtime |
- 依赖调解,第一原则:路径最近优先,第二原则:第二声明者优先。
- 可选依赖声明:
<project>
...
<dependency>
<group>mysql</group>
<artifactid>mysql-connector-java</artifactid>
<version>5.1.10</version>
<optional>true</optional><!-- 表示这个依赖为可选性依赖 -->
</dependency>
...
</project>
- 排除依赖,某些时候我们不需要某些传递性依赖,可以在在pom文件的<dependency>部分增加<exclusions> 标签排除:
<project>
...
<dependencies>
<dependency>
<groupId>sample.ProjectA</groupId>
<artifactId>Project-A</artifactId>
<version>1.0</version>
<scope>compile</scope>
<exclusions>
<exclusion> <!-- declare the exclusion here -->
<groupId>sample.ProjectB</groupId>
<artifactId>Project-B</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
</project>
- 优化依赖
使用mvn dependency:list
或者mvn dependency:tree
查看项目依赖详情
使用mvn dependency:analyze
进行分析。
maven的聚合和继承
- 聚合,
一个项目分为多个模块,即多个maven项目,聚合可以时多个模块同时执行mvn命令等。
<project>
...
<groupId>com.example</groupId>
<artifactId>module-0</artifactId>
<packaging>pom</packaging> <!-- packing 类型必须为 pom-->
<name>Parent Project</name>
<modules>
<module>module-1</module>
<module>module-2</module>
</modules>
...
<project>
这里的每个module的值都是一个当前POM的相对目录,比如module-0
的目录为/home/user/module-0
,则module-1
的目录应该为/home/user/module-0/module-1
,
module-2
的目录应该为/home/user/module-0/module-2
, module
的值为相对路径或者绝对路径,且是模块的目录名,而不是模块的artifactId
值。建议目录名即为artifactId
值。
- 继承
如果pom存在许多相同的配置,可以通过继承解决
一个例子
父pom
<?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>com.example</groupId>
<artifactId>parent-project</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>pom</packaging> <!-- packing 类型必须为 pom-->
<name>Parent Project</name>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<java.compiler.source>1.8</java.compiler.source>
<java.compiler.target>1.8</java.compiler.target>
<spring.version>4.3.8.RELEASE</spring.version>
</properties>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
</dependencies>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>${spring.version}</version>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<pluginManagement>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.6.1</version>
<configuration>
<encoding>${project.build.sourceEncoding}</encoding>
<source>${java.compiler.source}</source>
<target>${java.compiler.target}</target>
</configuration>
</plugin>
</plugins>
</pluginManagement>
</build>
</project>
子pom
<?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>
<parent>
<artifactId>parent-project</artifactId>
<groupId>com.example</groupId>
<version>1.0-SNAPSHOT</version>
<relativePath>../parent-project/pom.xml</relativePath>
</parent>
<artifactId>child-1</artifactId>
<name>Child Project 1</name>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
父pom的packaging
类型必须为pom
,父模块只是为了帮助消除配置的重复,所以它本身不包含除了pom之外的项目文件。
子pom继承的时候,parent
下的子元素groupId, artifactId, version
是必填的。元素relativePath
表示父模块pom的相对路径。项目构建时,maven首先根据relativePath检查父pom,如果没有,则在本地仓库查找(mvn install 即安装了本地仓库)。relativePath
的默认值是../pom.xml
,也就是说,maven默认父pom在上一层目录下。
可继承的pom元素有如下groupId, version, description, organization, inceptionYear, url, developers, contributors, distributionManagement, issueManagement, ciManagement, scm, mailingLists, properties, dependencies, dependencyManagement, repositories, build, reporting
在子pom文件中,所有的依赖和插件只配置了groupId 和 artifactId,省去了version, scope等。这样能够通过父pom统一依赖版本,范围等。如果子模块不声明依赖的使用,即使依赖已经在父pom的dependencyManagement
或者pluginManagement
,也不会对子模块产生影响。而不在父pom的dependencyManagement
或者pluginManagement
中的依赖,则会被子模块继承。
聚合和继承的关系
聚合是为了快速构建项目,而继承是为了消除重复配置。
同时一个pom既可以是聚合pom也可以是父pom。裁剪反应堆
当需要构建整个项目或者选择构建单个模块,就需要实时的裁剪反应堆。例如
-am
同时构建所列模块的依赖模块, 例如mvn clean -am
-amd
同时构建依赖于所列模块的模块
-pl
构建指定模块,模块间用英文逗号分隔
-rf
充只等的模块回复反应堆,
其他
推荐阅读
maven官方指南
可选的依赖和依赖排除
Maven 资源过滤相关
使用 Maven Profile 和 Filtering 打各种环境的包
profile介绍
使用Nexus创建私服
使用Hudson进行持续集成
Maven提高篇系列之(六)——编写自己的Plugin(本系列完)