Maven 變量及常見插件配置詳解

Maven 的 pom.xml 經常使用變量插件配置詳解apache

1、變量 - 自定義變量及內置變量

1. 自定義變量

<properties>
	<project.build.name>tools</project.build.name>
	<project.build.sourceencoding>UTF-8</project.build.sourceencoding>
</properties>

2. 內置變量

${basedir} 項目根目錄    
${project.build.directory} 構建目錄，缺省爲target    
${project.build.outputDirectory} 構建過程輸出目錄，缺省爲target/classes    
${project.build.finalName} 產出物名稱，缺省爲${project.artifactId}-${project.version}    
${project.packaging} 打包類型，缺省爲jar    
${project.xxx} 當前pom文件的任意節點的內容

2、常見插件配置

1. 編譯插件

<plugin>
	<groupid>org.apache.maven.plugins</groupid>
	<artifactid>maven-compiler-plugin</artifactid>
	<configuration>
		<source>1.6</source>
		<target>1.6</target>
		<encoding>${project.build.sourceEncoding}</encoding>
	</configuration>
</plugin>

source：源代碼編譯版本
target：目標平臺編譯版本
encoding：字符集編碼

2. 設置資源文件的編碼方式

<plugin>
	<groupid>org.apache.maven.plugins</groupid>
	<artifactid>maven-resources-plugin</artifactid>
	<version>2.4.3</version>
	<executions>
		<execution>
			<phase>compile</phase>
		</execution>
	</executions>
	<configuration>
		<encoding>${project.build.sourceEncoding}</encoding>
	</configuration>
</plugin>

xml、properties 文件都是資源文件，編碼的時候遇到中文總要進行轉碼！用什麼編碼？UTF-8，那就記得強制 <encoding>${project.build.sourceEncoding}</encoding> maven

3. 自動拷貝 jar 包到 target 目錄

<plugin>
	<groupId>org.apache.maven.plugins</groupId>
	<artifactId>maven-dependency-plugin</artifactId>
	<version>2.6</version>
	<executions>
		<execution>
			<id>copy-dependencies</id>
			<phase>compile</phase>
			<goals>
				<goal>copy-dependencies</goal>
			</goals>
			<configuration>
				<!-- ${project.build.directory}爲Maven內置變量，缺省爲target -->
				<outputDirectory>${project.build.directory}/lib</outputDirectory><!-- 表示是否不包含間接依賴的包 -->
				<excludeTransitive>false</excludeTransitive><!-- 表示複製的jar文件去掉版本信息 -->
				<stripVersion>true</stripVersion>
			</configuration>
		</execution>
	</executions>
</plugin>

關於 maven-dependency-plugin：用得最多的幾個操做： copy , copy-dependencies 和它們對應的 unpack , unpack-dependenciesui

描述：copy 和 unpack 操做是由要拷某個包，這個包須要具體指定要拷哪一個包，與當前工程的依賴沒有關係。這二者區別 - 是否解壓編碼

copy-dependencies 和 unpack-dependencies ，可是它是用來拷當前工程的依賴包的。這二者區別 - 是否解壓spa

參考連接：http://liugang594.iteye.com/blog/2093082.net

4. 生成源代碼 jar 包

<plugin>
	<artifactId>maven-source-plugin</artifactId>
	<version>2.1</version>
	<configuration>
		<!-- <finalName>${project.build.name}</finalName> -->
		<attach>true</attach>
		<encoding>${project.build.sourceEncoding}</encoding>
	</configuration>
	<executions>
		<execution>
			<phase>compile</phase>
			<goals>
				<goal>jar</goal>
			</goals>
		</execution>
	</executions>
</plugin>

5. 將項目打成 jar 包

<plugin>
	<groupId>org.apache.maven.plugins</groupId>
	<artifactId>maven-jar-plugin</artifactId>
	<version>2.4</version>
	<configuration>
		<archive>
			<manifest>
				<!-- 告知 maven-jar-plugin添加一個 Class-Path元素到 MANIFEST.MF文件，以及在Class-Path元素中包括全部依賴項 -->
				<addClasspath>true</addClasspath><!-- 全部的依賴項應該位於 lib文件夾 -->
				<classpathPrefix>lib/</classpathPrefix><!-- 當用戶使用 lib命令執行JAR文件時，使用該元素定義將要執行的類名 -->
				<mainClass>com.zhengtian.tools.service.phone.MobilePhoneTool</mainClass>
			</manifest>
		</archive>
	</configuration>
</plugin>

在將項目打成 jar 包時，有時會須要將項目打成能夠直接運行的 jar 包，所以就須要將項目依賴的 jar 包也打入 jar 包中，此時須要在 Eclipse 上安裝例外一個插件，用來打可執行 jar 包，詳情見連接 http://zheng12tian.iteye.com/blog/1765626 插件

更多 maven 配置詳見：https://my.oschina.net/zh119893/blog/276090code

關於 maven-assembly-plugin 的使用orm

「assembly」是把一組文件、目錄、依賴元素組裝成一個歸檔文件xml

參考連接：http://blog.csdn.net/WANGYAN9110/article/details/38646677

pom 中配置

<plugin>
	<artifactId>maven-assembly-plugin</artifactId>
	<version>2.4.1</version>
	<executions>
		<execution>
			<id>make-zip</id><!-- 綁定到package生命週期階段上 -->
			<phase>package</phase>
			<goals>
				<!-- 綁定到package生命週期階段上 -->
				<goal>single</goal>
			</goals>
			<configuration>
				<descriptors>
					<!--描述文件路徑-->
					<descriptor>src/assembly/assembly.xml</descriptor>
				</descriptors>
			</configuration>
		</execution>
	</executions>
</plugin>

assembly.xml 配置

<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2"          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"          xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2 http://maven.apache.org/xsd/assembly-1.1.2.xsd">
	<id>distribution</id>
	<formats>
		<format>zip</format>
	</formats>
	<fileSets>
		<fileSet>
			<directory>${project.basedir}\src\main\resources</directory>
			<outputDirectory>\</outputDirectory>
		</fileSet>
		<fileSet>
			<directory>${project.basedir}\src\bin</directory>
			<outputDirectory>\bin</outputDirectory>
		</fileSet>
	</fileSets>
	<dependencySets>
		<dependencySet>
			<useProjectArtifact>true</useProjectArtifact>
			<outputDirectory>lib</outputDirectory><!-- 將scope爲runtime的依賴包打包到lib目錄下。 -->
			<scope>runtime</scope>
		</dependencySet>
	</dependencySets>
</assembly>