來(lái)源：lmportNew - 唐尤華
1. Maven簡(jiǎn)介
Apache Maven 是一個(gè)軟件項(xiàng)目管理工具?；陧?xiàng)目對(duì)象模型（POM）的理念，通過(guò)一段核心描述信息來(lái)管理項(xiàng)目構(gòu)建、報(bào)告和文檔信息。
Maven 是一個(gè)意第緒語(yǔ)（猶太人使用的國(guó)際語(yǔ)）單詞，意思是知識(shí)的累加器。它最開始是被用來(lái)簡(jiǎn)化 Jakarta Turbine 項(xiàng)目的構(gòu)建過(guò)程。在 Jakarta Turbine 項(xiàng)目中有幾個(gè)不同的項(xiàng)目，雖然它們的Ant構(gòu)建文件差異很小，但是 jar 包都在 CVS 上。于是想要找到一個(gè)標(biāo)準(zhǔn)而又簡(jiǎn)單的項(xiàng)目構(gòu)建方法，既可以清晰地定義出這個(gè)項(xiàng)目由什么構(gòu)成并發(fā)布項(xiàng)目信息，又能在不同項(xiàng)目間共享Jar包。
現(xiàn)在，任何一個(gè)基于Java的項(xiàng)目都能使用Maven來(lái)構(gòu)建和管理，使 Java 開發(fā)人員的日常工作變得更輕松，讓Java項(xiàng)目更容易被理解。
2. Maven使用
2.1 安裝
必備條件： 已安裝JDK
注意事項(xiàng)： Maven 3.3 及更高版本要求 JDK1.7 或者更高版本
2.2 Windows
下載解壓縮
打開下載頁(yè)面：http://maven.apache.org/download.cgi
選擇最新的版本，或者到這里 https://archive.apache.org/dist/maven/maven-3/ 找到你中意的版本
下載 apache-maven-{版本號(hào)}-bin.zip
找到合適的目錄：最好無(wú)空格和中文，解壓，內(nèi)容如下
bin\
boot\
conf\
lib\
README.txt
NOTICE
LICENSE
配置環(huán)境變量
計(jì)算機(jī) > 屬性 > 高級(jí)系統(tǒng)設(shè)置 > 環(huán)境變量 > 系統(tǒng)變量
新建 M2_HOME 變量，內(nèi)容為 {解壓路徑}\apache-maven-{版本號(hào)}
編輯 Path 變量，在內(nèi)容結(jié)尾加上 ;%M2_HOME%\bin;
2.3 Linux
包管理器安裝
$ sudo apt install maven
下載安裝
下載 apache-maven-{版本號(hào)}-bin.tar.gz
配置環(huán)境變量 export PATH=/opt/apache-maven-{版本號(hào)}/bin:$PATH
2.4 驗(yàn)證
Windows 打開 Cmd，Linux 運(yùn)行 Shell，看到下面信息表示安裝成功。
$ mvn -version
Apache Maven 3.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-11T00:41:47 08:00)
Maven home: D:\software\java\apache-maven-3.3.9
Java version: 1.8.0_191, vendor: Oracle Corporation
Java home: c:\Program Files\java\jdk1.8.0_191\jre
Default locale: zh_CN, platform encoding: GBK
OS name: 'windows 7', version: '6.1', arch: 'amd64', family: 'dos'
2.5 設(shè)置Maven
Maven通過(guò) settings.xml 進(jìn)行配置
完整的參數(shù)說(shuō)明可查看
http://maven.apache.org/ref/3.6.0/maven-settings/settings.html
2.5.1 自定義倉(cāng)庫(kù)位置(可選)
Maven 下載的 jar 包默認(rèn)存儲(chǔ)到 ${user.home}/.m2/repository
編輯 {安裝路徑}\config\settings.xml，在下面增加一行填入自定義位置：
<!-- localRepository
| The path to the local repository maven will use to store artifacts.
|
| Default: ${user.home}/.m2/repository
<localRepository>/path/to/local/repo</localRepository>
-->
<localRepository>{自定義位置}\repository</localRepository>
Linux 查看安裝路徑
$ ls -lsa /usr/share/maven
...
0 lrwxrwxrwx 1 root root 10 12月 10 2015 conf -> /etc/maven
$ ls -lsa /etc/maven
4 drwxr-xr-x 2 root root 4096 11月 27 11:45 logging
4 -rw-r--r-- 1 root root 222 11月 19 2015 m2.conf
12 -rw-r--r-- 1 root root 10216 11月 19 2015 settings.xml
4 -rw-r--r-- 1 root root 3649 11月 19 2015 toolchains.xml
2.5.2 設(shè)置國(guó)內(nèi)鏡像(可選)
Maven 默認(rèn)從中央倉(cāng)庫(kù) central 下載
改為國(guó)內(nèi)鏡像速度更快
編輯 {安裝路徑}\config\settings.xml，在 <mirrors></mirrors> 標(biāo)簽里加入新的鏡像：
<mirrors>
<mirror>
<id>alimaven</id>
<mirrorOf>central</mirrorOf>
<name>aliyun maven</name>
<url>https://maven.aliyun.com/repository/central</url>
</mirror>
</mirrors>
3. 使用
3.1 快速上手
3.1.1 新建示例項(xiàng)目
命令行不是必須的，但這個(gè)過(guò)程能有助于理解在 IDE 中的操作。
命令行新建項(xiàng)目
Windows 打開 Cmd，Linux 運(yùn)行 Shell，執(zhí)行下面指令。
mvn archetype:generate -DgroupId=org.tyh.mvn.quickstart -DartifactId=mvn-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.3 -DinteractiveMode=false
執(zhí)行成功可以看到下面字樣：
[INFO] BUILD SUCCESS
POM.xml 包含了命令中的信息
<groupId>org.tyh.mvn.quickstart</groupId>
<artifactId>mvn-quickstart</artifactId>
<version>1.0-SNAPSHOT</version>
<name>mvn-quickstart</name>
目錄結(jié)構(gòu)
quickstart 項(xiàng)目的結(jié)構(gòu)如下：
項(xiàng)目源碼：src/main/java
Web 項(xiàng)目源碼：src/main/webapp
測(cè)試源碼：src/test/java
Maven 項(xiàng)目結(jié)構(gòu)(Project Object Model POM)：pom.xml
注意： 配置文件，如 log4j.properties 需要新建 src\main\resources 目錄。這樣編譯時(shí)會(huì)打包到生成的 jar 中。
mvn-quickstart
│ pom.xml
│
└─src
├─main
│ └─java
│ └─org
│ └─tyh
│ └─mvn
│ └─quickstart
│ App.java
│
└─test
└─java
└─org
└─tyh
└─mvn
└─quickstart
AppTest.java
提示： 生成目錄結(jié)構(gòu)，Windows 在 Cmd 中輸入 tree /f，Linux 安裝 tree 程序后可直接輸入 tree。
有關(guān)目錄結(jié)構(gòu)完整介紹可以查看
http://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html
3.1.2 構(gòu)建項(xiàng)目
Windows 打開 Cmd，Linux 運(yùn)行 Shell，執(zhí)行下面指令。
mvn package
執(zhí)行成功可以看到下面字樣：
[INFO] BUILD SUCCESS
查看生成結(jié)果，在項(xiàng)目中新增了 target 目錄，里面主要關(guān)注以下文件：
class 文件：target\classes\org\tyh\mvn\quickstart\App.class
test-classes 文件：target\test-classes\org\tyh\mvn\quickstart\AppTest.class
jar 文件：target\mvn-quickstart-1.0-SNAPSHOT.jar
mvn-quickstart
│ pom.xml
│
└─target
│ mvn-quickstart-1.0-SNAPSHOT.jar
│
├─classes
│ └─org
│ └─tyh
│ └─mvn
│ └─quickstart
│ App.class
│
├─generated-sources
│ └─annotations
├─generated-test-sources
│ └─test-annotations
├─maven-archiver
│ pom.properties
│
├─maven-status
│ └─maven-compiler-plugin
│ ├─compile
│ │ └─default-compile
│ │ createdFiles.lst
│ │ inputFiles.lst
│ │
│ └─testCompile
│ └─default-testCompile
│ createdFiles.lst
│ inputFiles.lst
│
├─surefire-reports
│ org.tyh.mvn.quickstart.AppTest.txt
│ TEST-org.tyh.mvn.quickstart.AppTest.xml
│
└─test-classes
└─org
└─tyh
└─mvn
└─quickstart
AppTest.class
3.1.3 運(yùn)行
Windows 打開 Cmd，Linux 運(yùn)行 Shell，執(zhí)行下面指令。
java -cp target/mvn-quickstart-1.0-SNAPSHOT.jar org.tyh.mvn.quickstart.App
Hello World!
執(zhí)行測(cè)試：
mvn test
執(zhí)行成功可以看到下面的結(jié)果：
[INFO] -------------------------------------------------------
[INFO] T E S T S
[INFO] -------------------------------------------------------
[INFO] Running org.tyh.mvn.quickstart.AppTest
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.133 s - in org.tyh.mvn.quickstart.AppTest
[INFO]
[INFO] Results:
[INFO]
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
3.2 新增依賴
3.2.1 搜索Maven
為項(xiàng)目添加一個(gè)依賴，比如 Apache Commons Lang 和 Slf4j 日志。
搜索
搜索時(shí)可采用高級(jí)搜索，g:{groupId} a:{artifactId}。例如 g:log4j a:log4j 就會(huì)列出 log4j 的最新版本。
Maven central 倉(cāng)庫(kù)：https://search.maven.org/
Aliyun 鏡像倉(cāng)庫(kù)：http://maven.aliyun.com/mvn/search
其他搜索倉(cāng)庫(kù)
https://repository.apache.org
https://mvnrepository.com
注意： 類似 slf4j 這樣依賴其他實(shí)現(xiàn)的包，需要查看官方文檔，確認(rèn)需要配合使用的 jar 包。否則會(huì)出 現(xiàn)編譯通過(guò)，運(yùn)行報(bào)錯(cuò) 的情況。
3.2.2 加入依賴項(xiàng)
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
<!--Slf4j(slf4j-log4j12)-->
<!--添加后，會(huì)同時(shí)引入 log4j 和 slf4j-api-->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>1.8.0-beta2</version>
</dependency>
<!--Apache Commons Lang (commons-lang3)-->
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.8.1</version>
</dependency>
</dependencies>
3.2.3 驗(yàn)證
修改 App 類，加入 Log 和 測(cè)試代碼：
package org.tyh.mvn.quickstart;
import org.apache.commons.lang3.ArrayUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* ArrayUtils Demo
*
*/
public class App
{
public static void main( String[] args )
{
Logger logger = LoggerFactory.getLogger(App.class);
float[] farr = {1.1f, 1.2f, 1.3f};
logger.info(ArrayUtils.toString(farr));
farr = ArrayUtils.removeElements(farr, 1.1f);
logger.info(ArrayUtils.toString(farr));
}
}
執(zhí)行程序之前，要找到依賴的 jar 文件所在的目錄。默認(rèn)是在 {用戶主目錄}/.m2/ 目錄 下，利用 dependency:copy 插件 可以拷貝到 target\dependency 目錄：
mvn dependency:copy-dependencies
查看結(jié)果：
├─dependency
│ commons-lang3-3.8.1.jar
│ hamcrest-core-1.3.jar
│ junit-4.11.jar
│ log4j-1.2.17.jar
│ slf4j-api-1.8.0-beta2.jar
│ slf4j-log4j12-1.8.0-beta2.jar
在命令行運(yùn)行時(shí)，用 -cp 加入依賴的 jar 所在目錄：
java -cp .;dependency/*;mvn-quickstart-1.0-SNAPSHOT.jar org.tyh.mvn.quickstart.App
注意： 編譯前需要加入 log4j.properties 到 src\main\resources 目錄。下面是一個(gè) Windows 下的 log4j.properties。
# Root logger option
log4j.rootLogger=INFO, file, stdout
# Direct log messages to a log file
log4j.appender.file=org.apache.log4j.RollingFileAppender
log4j.appender.file.File=C:\\temp\\logging.log
log4j.appender.file.MaxFileSize=10MB
log4j.appender.file.MaxBackupIndex=10
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
# Direct log messages to stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
3.3 IDE中使用
3.3.1 Eclipse
新建項(xiàng)目
1. 新建 Maven 項(xiàng)目
File > New > Project
選擇 Maven Project (目錄報(bào)錯(cuò)及解決辦法*)
（可選）項(xiàng)目類型 maven-archetype-simple 或其他類型
輸入 Group Id, Artifact Id, Name，F(xiàn)inish
2. 添加依賴
pom.xml 右鍵菜單 > Maven > Add Dependency
在輸入框中輸入，比如 slf4j 會(huì)自動(dòng)列出匹配結(jié)果，OK
加入新的依賴保存文件，會(huì)在 Maven Dependencies 中列出 jar 及路徑，并添加到項(xiàng)目的 classpath 中
3. 編碼
編寫 Java 代碼，調(diào)試
4. 構(gòu)建
項(xiàng)目 右鍵菜單 > Run As > Maven build
第一次運(yùn)行會(huì)提示輸入 Maven build 的目標(biāo)：Goal 里填寫 package 進(jìn)行構(gòu)建 （支持的常用命令可以在這里找到 Maven in 5 Minutes：Maven Phases）
導(dǎo)入項(xiàng)目
File > Import
選擇 Maven > Existing Maven Project
選擇項(xiàng)目 pom.xml 目錄，Projects: 下面勾選 target
點(diǎn)擊完成
3.3.2 Idea
1. 新建 Maven 項(xiàng)目
File > New > Project
選擇 Maven
（可選）項(xiàng)目類型 maven-archetype-simple 或其他類型
輸入 Group Id, Artifact Id
輸入項(xiàng)目名稱，F(xiàn)inish
2. 添加依賴
pom.xml 手動(dòng)添加依賴信息
加入新的依賴保存文件，會(huì)在 External Libraries 中列出 jar 及路徑，并添加到項(xiàng)目的 classpath 中
3. 編碼
編寫 Java 代碼，調(diào)試
4. 構(gòu)建
pom.xml 右鍵菜單 > Build module’module name’
Maven build 會(huì)提示警告：Warning:java: 源值1.5已過(guò)時(shí), 將在未來(lái)所有發(fā)行版中刪除：可加入配置項(xiàng)解決
4. 常見問(wèn)題與辦法
4.1 如何設(shè)置編譯支持的 JDK 版本？
全局指定
下面的腳本指定編譯版本兼容 JDK 1.7
<project>
...
<properties>
<maven.compiler.source>1.7</maven.compiler.source>
<maven.compiler.target>1.7</maven.compiler.target>
</properties>
...
</project>
指定插件
在不改變?nèi)旨嫒菪缘那闆r下，可以在插件中指定。例如，下面的腳本指定了 maven-compiler-plugin 編譯的版本兼容 JDK 1.7。
<project>
...
<build>
...
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.3</version>
<configuration>
<source>1.7</source>
<target>1.7</target>
</configuration>
</plugin>
</plugins>
...
</build>
...
</project>
4.2 如何指定自己的目錄結(jié)構(gòu)？
可以通過(guò)設(shè)置 <build> 節(jié)點(diǎn)下 <sourceDirectory>, <resources> 參數(shù)指定。
4.3 在 pom 文件中配置了依賴，編譯時(shí)還會(huì)報(bào)錯(cuò)。
下載的 jar 文件可能有問(wèn)題。
檢查 maven 倉(cāng)庫(kù)地址，在搜索條件中檢查 groupId 和 artifactId 是否正確。
mvn clean 清理文件。
mvn package 重新編譯。
4.4 [WARNING] File encoding has not been set, using platform encoding UTF-8, i.e. build is platform dependent!
POM 文件中沒有指定編譯時(shí)編碼格式，可加入下面屬性指定為 UTF-8。
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
類似的問(wèn)題： [WARNING] Using platform encoding (Cp1252 actually) to copy filtered resources, i.e. build is platform dependent!
4.5 Invalid project description. … overlaps the workspace …
Eclipse 新建 Maven 項(xiàng)目時(shí)，可能會(huì)報(bào)告此錯(cuò)誤。解決辦法兩種：
選擇 workspace 以外的目錄作為項(xiàng)目目錄；
新建 Java Project，然后轉(zhuǎn)為 Maven 項(xiàng)目：右鍵菜單 Config -> Convert to Maven Project
4.6 Warning:java: 源值1.5已過(guò)時(shí), 將在未來(lái)所有發(fā)行版中刪除
Idea 在 Maven Build 時(shí)發(fā)出警告，在 pom.xml 中加入以下內(nèi)容：
<build>
<sourceDirectory>src</sourceDirectory>
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.0</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
</plugins>
</build>
【關(guān)于投稿】
如果大家有原創(chuàng)好文投稿，請(qǐng)直接給公號(hào)發(fā)送留言。
① 留言格式：
【投稿】 《 文章標(biāo)題》 文章鏈接
② 示例：
【投稿】《不要自稱是程序員，我十多年的 IT 職場(chǎng)總結(jié)》：http://blog.jobbole.com/94148/
③ 最后請(qǐng)附上您的個(gè)人簡(jiǎn)介哈~
聯(lián)系客服
