Apache Maven ToolChains的使用

簡介

Maven是java中非常有用和常用的構建工具，基本上現在大型的java項目都是Maven和gradle的天下了。

因爲JDK的版本現在以每半年一次的速度在飛速發展。不同的JDK版本就有不同的java路徑，我們在使用Maven的過程中，可能經常會需要切換JDK的版本。

一般來說我們可以在maven-compiler-plugin中配置好executable的路徑。如下所示：

更多內容請訪問www.flydean.com

<build>
	<plugins>
		<!-- target Java 14 -->
		<plugin>
			<artifactId>maven-compiler-plugin</artifactId>
			<configuration>
				<!-- fork compilation and use the
						 specified executable -->
				<fork>true</fork>
				<executable>/usr/bin/javac14</executable>
			</configuration>
		</plugin>
	</plugins>
</build>

看起來還不錯，但是如果想切換executable的路徑可能就比較麻煩。更有問題的是，如果你是團隊來發，一個人在mac環境一個人在windows環境，兩邊的executable的路徑完全是不同的，這會導致代碼衝突，和代碼難以維護。

Toolchains的介紹

爲了解決這個問題，Maven爲我們推出了Toolchains。使用Toolchains,我們可以將這些可執行文件的路徑，版本號，還有類型都定義在一個toolchains.xml文件裏面。

而在pom.xml文件中只需要引用toolchains.xml中定義的別名就可以了。

針對上面的windows和linux路徑不一致的問題，我們可以保證pom.xml是完全一致的，大家只需要適配自己的toolchains.xml文件即可。

Toolchains的例子

Toolchains是和pom中其他的plugin結合起來使用的，比如最常用的maven-compiler-plugin。

下面我們舉一個例子來說明。首先定義toolchains.xml文件，這個文件最好放在${user.home}/.m2/中。

<?xml version="1.0" encoding="UTF8"?>
<toolchains>
  <!-- JDK toolchains -->
  <toolchain>
    <type>jdk</type>
    <provides>
      <version>14</version>
      <vendor>oracle</vendor>
    </provides>
    <configuration>
      <jdkHome>/path/to/jdk/14</jdkHome>
    </configuration>
  </toolchain>
  <toolchain>
    <type>jdk</type>
    <provides>
      <version>11</version>
      <vendor>oracle</vendor>
    </provides>
    <configuration>
      <jdkHome>/path/to/jdk/11</jdkHome>
    </configuration>
  </toolchain>
</toolchains>

上面的例子中，我們定義了2個JDK的toolchains。一個JDK14，一個JDK11。下面看下怎麼在pom文件中使用。

<plugins>
 ...
  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.1</version>
  </plugin>
  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-toolchains-plugin</artifactId>
    <version>1.1</version>
    <executions>
      <execution>
        <goals>
          <goal>toolchain</goal>
        </goals>
      </execution>
    </executions>
    <configuration>
      <toolchains>
        <jdk>
          <version>14</version>
          <vendor>oracle</vendor>
        </jdk>
      </toolchains>
    </configuration>
  </plugin>
  ...
</plugins>

上面的pom配置文件中，我們通過簡單的引用toolchains中的定義，即可無縫的進行JDK版本的切換。

Toolchains支持

Toolchains需要Maven 2.0.9以上版本的支持。

Toolchains是需要和pom中的plugin一起使用的，下面的圖中列出了toolchains支持的plugin名字和最低的版本要求。

總結

本文介紹了Apache Maven中toolchain的使用，希望大家能夠在實際工作中用起來。

更多精彩內容且看：

• 區塊鏈從入門到放棄系列教程-涵蓋密碼學,超級賬本,以太坊,Libra,比特幣等持續更新
• Spring Boot 2.X系列教程:七天從無到有掌握Spring Boot-持續更新
• Spring 5.X系列教程:滿足你對Spring5的一切想象-持續更新
• java程序員從小工到專家成神之路（2020版）-持續更新中,附詳細文章教程

本文作者：flydean程序那些事

本文鏈接：http://www.flydean.com/apache-maven-toolchains/

本文來源：flydean的博客

歡迎關注我的公衆號:程序那些事，更多精彩等着您！