Maven - Maven3实战学习笔记（2）坐标和依赖

1、maven坐标元素

maven坐标元素包括：groupId、artifactId、version、packaging、classifier。

classifier：定义输出的附属构件。groupId、artifactId、version是pom.xml中必须定义的，packaging是可选的，classifier是不能直接定义的。

2、dependency中的元素

<dependencies>
    <dependency>
      <groupId>...</groupId>
      <artifactId>...</artifactId>
      <version>...</version>
      <type>...</type>
      <scope>...</scope>
      <optional>...</optional>
      <exclusions>
         <exclusion>...</exclusion>
      </exclusions>
    </dependency>
</dependencies>

说明：
  type：依赖的类型，对应项目坐标定义的packaging。
  scope：依赖的范围。
  optional：标记依赖是否可选。
  exclusions：用来排除传递性依赖。

classpath类型：编译时classpath、测试时classpath、运行时classpath。

3、scope依赖范围：compile、test、provided、runtime、system、import

1》compile：编译依赖范围。默认的依赖范围。对编译、测试、运行的classpath都有效。

2》test：测试依赖范围。只对测试classpath有效，编译主代码、运行项目的使用时无法使用此类依赖。编译测试代码、运行测试的时候可以使用。

3》procided：已提供依赖范围。对于编译和测试classpath有效，但在运行时无效。举例servlet-api，编译和测试项目的时候需要该依赖，但在运行项目的时候，由于容器已经提供，就不需要maven重复的引入一遍。

4》runtime：运行时依赖范围。对于测试和运行有效，但在编译主代码时无效。举例jdbc驱动，项目主代码编译只需要jdk提供的jdbc接口，只有在执行测试或者运行项目的时候才需要实现上述接口的具体jdbc驱动。

5》system：系统依赖范围。该依赖与3种classpath的关系，和provided依赖范围完全一致。但是，使用system的依赖时必须通过systempath元素显式的指定依赖文件的路径。由于此类依赖不是通过maven仓库解析的，而且往往与本机系统绑定，可能造成构建的不可移植性。systempath元素可以引用环境变量，如：

<dependencies>
    <dependency>
      ...
      <scope>system</scope>
      <systemPath>{java.home}/lib/rt.jar</systemPath>
      ...
    </dependency>
</dependencies>

6》import（maven2.0.9及以上）：导入依赖范围。该依赖范围不会对3种classpath产生实际的影响。

4、传递性依赖

1》传递性依赖：A包依赖于B包，B包又依赖于C包，则A包传递性的依赖于C包。如account-email有一个compile范围的依赖spring-core，spring-core有一个compile范围的commons-logging的依赖，那么commons-logging就会成为account-email的compile范围依赖，commons-logging是account-email的一个传递依赖。

2》传递性依赖和依赖范围：依赖范围不仅可以控制依赖与3种classpath的关系，还对传递性依赖产生影响。如上面的account-email对于commons-logging这一传递性依赖的范围也就是compile。A依赖于B，B依赖于C，我们就说A对于B是第一直接依赖，B对于C是第二直接依赖，A对于C是传递性依赖。第一直接依赖的范围和第二直接依赖的范围决定了传递性依赖的范围。（如图：中间交叉范围为传递性依赖的范围）

第一直接依赖范围\第二直接依赖范围	compile	test	provided	runtime
compile	compile	-	-	runtime
test	test	-	-	test
provided	provided	-	provided	provided
runtime	runtime	-	-	runtime

3》依赖调解：

1>依赖调解第一原则：路径最近者优先

例如：A->B->C->X（1.0）、A->D->X（2.0），X（1.0）版本的路径长度为3，X（2.0）的路径长度为2，因此X（2.0）版本会被解析使用。

2>依赖调解第二原则：在路径相等的情况下，第一声明者优先，在pom中依赖声明的顺序决定了谁会被解析使用。

例如：A->B->Y（1.0）、A->C->Y（2.0），如果B的依赖声明在C之前，那么Y（1.0）就会被解析使用。

4》可选依赖

5》排除依赖

6》归类依赖

7》优化依赖

#maven自动解析项目的直接依赖、传递性依赖、调解依赖冲突、确保依赖中
#只有唯一版本的依赖存在，得到的依赖称为已解析依赖。
#可以使用如下语句查看项目已解析依赖：
mvn dependency:list

C:\fyliu\lfyTemp\mvnProject\mvn-archetype-generate\hello-world>mvn dependency:li
st
[INFO] Scanning for projects...
[INFO]
[INFO] --------------------< com.lfy.mvnbook:hello-world >---------------------
[INFO] Building hello-world 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- maven-dependency-plugin:2.8:list (default-cli) @ hello-world ---
[INFO]
[INFO] The following files have been resolved:
[INFO]    junit:junit:jar:4.11:test
[INFO]    org.hamcrest:hamcrest-core:jar:1.3:test
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  6.593 s
[INFO] Finished at: --15T15::+:
[INFO] ------------------------------------------------------------------------

C:\fyliu\lfyTemp\mvnProject\mvn-archetype-generate\hello-world>

#查看项目的依赖树
mvn dependency:tree

C:\fyliu\lfyTemp\mvnProject\mvn-archetype-generate\hello-world>mvn dependency:tr
ee
[INFO] Scanning for projects...
[INFO]
[INFO] --------------------< com.lfy.mvnbook:hello-world >---------------------
[INFO] Building hello-world 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- maven-dependency-plugin:2.8:tree (default-cli) @ hello-world ---
[INFO] com.lfy.mvnbook:hello-world:jar:1.0-SNAPSHOT
[INFO] \- junit:junit:jar:4.11:test
[INFO]    \- org.hamcrest:hamcrest-core:jar:1.3:test
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  4.144 s
[INFO] Finished at: --15T15::+:
[INFO] ------------------------------------------------------------------------

C:\fyliu\lfyTemp\mvnProject\mvn-archetype-generate\hello-world>

#分析依赖，可以找出被隐式引用但是没有明确声明的依赖
#Unused declared dependencies found 指没有使用但是声明了的依赖，不一定完全正确
#Used declared dependencies 指项目中使用但没有显式声明的依赖
mvn dependency:analyze

C:\fyliu\lfyTemp\mvnProject\mvn-archetype-generate\hello-world>mvn dependency:an
alyze
[INFO] Scanning for projects...
[INFO]
[INFO] --------------------< com.lfy.mvnbook:hello-world >---------------------
[INFO] Building hello-world 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] >>> maven-dependency-plugin:2.8:analyze (default-cli) > test-compile @ he
llo-world >>>
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ hello-worl
d ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] skip non existing resourceDirectory C:\fyliu\lfyTemp\mvnProject\mvn-arche
type-generate\hello-world\src\main\resources
[INFO]
[INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ hello-world ---

[INFO] Nothing to compile - all classes are up to date
[INFO]
[INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ he
llo-world ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] skip non existing resourceDirectory C:\fyliu\lfyTemp\mvnProject\mvn-arche
type-generate\hello-world\src\test\resources
[INFO]
[INFO] --- maven-compiler-plugin:3.1:testCompile (default-testCompile) @ hello-w
orld ---
[INFO] Nothing to compile - all classes are up to date
[INFO]
[INFO] <<< maven-dependency-plugin:2.8:analyze (default-cli) < test-compile @ he
llo-world <<<
[INFO]
[INFO]
[INFO] --- maven-dependency-plugin:2.8:analyze (default-cli) @ hello-world ---
[WARNING] Unused declared dependencies found:
[WARNING]    org.springframework:spring-core:jar:2.5.:compile
[WARNING]    org.springframework:spring-beans:jar:2.5.:compile
[WARNING]    org.springframework:spring-context-support:jar:2.5.:compile
[WARNING]    javax.mail:mail:jar:1.4.:compile
[WARNING]    com.icegreen:greenmail:jar:1.3.1b:test
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  6.885 s
[INFO] Finished at: --15T16::+:
[INFO] ------------------------------------------------------------------------

C:\fyliu\lfyTemp\mvnProject\mvn-archetype-generate\hello-world>