從零開始用好Maven：從HelloWorld到日常使用

2018-12-21 來源：importnew

本文作者： ImportNew - 唐尤華未經(jīng)許可，禁止轉(zhuǎn)載！

1. Maven簡介

Apache Maven 是一個(gè)軟件項(xiàng)目管理工具。基于項(xiàng)目對象模型（POM）的理念，通過一段核心描述信息來管理項(xiàng)目構(gòu)建、報(bào)告和文檔信息。

Maven 是一個(gè)意第緒語（猶太人使用的國際語）單詞，意思是知識(shí)的累加器。它最開始是被用來簡化 Jakarta Turbine 項(xiàng)目的構(gòu)建過程。在 Jakarta Turbine 項(xiàng)目中有幾個(gè)不同的項(xiàng)目，雖然它們的Ant構(gòu)建文件差異很小，但是 jar 包都在 CVS 上。于是想要找到一個(gè)標(biāo)準(zhǔn)而又簡單的項(xiàng)目構(gòu)建方法，既可以清晰地定義出這個(gè)項(xiàng)目由什么構(gòu)成并發(fā)布項(xiàng)目信息，又能在不同項(xiàng)目間共享Jar包。

現(xiàn)在，任何一個(gè)基于Java的項(xiàng)目都能使用Maven來構(gòu)建和管理，使 Java 開發(fā)人員的日常工作變得更輕松，讓Java項(xiàng)目更容易被理解。

2. Maven使用

2.1 安裝

必備條件： 已安裝JDK

注意事項(xiàng)： Maven 3.3 及更高版本要求 JDK1.7 或者更高版本

2.2 Windows

下載解壓縮

打開下載頁面：http://maven.apache.org/download.cgi
選擇最新的版本，或者到這里 https://archive.apache.org/dist/maven/maven-3/ 找到你中意的版本
下載 apache-maven-{版本號(hào)}-bin.zip
找到合適的目錄：最好無空格和中文，解壓，內(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通過 settings.xml 進(jìn)行配置

完整的參數(shù)說明可查看 http://maven.apache.org/ref/3.6.0/maven-settings/settings.html

2.5.1 自定義倉庫位置(可選)

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è)置國內(nèi)鏡像(可選)

Maven 默認(rèn)從中央倉庫 central 下載

改為國內(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è)過程能有助于理解在 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
測試源碼：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í)行測試：

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 倉庫：https://search.maven.org/
Aliyun 鏡像倉庫：http://maven.aliyun.com/mvn/search
其他搜索倉庫
- https://repository.apache.org
- https://mvnrepository.com

注意： 類似 slf4j 這樣依賴其他實(shí)現(xiàn)的包，需要查看官方文檔，確認(rèn)需要配合使用的 jar 包。否則會(huì)出現(xiàn)編譯通過，運(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 和測試代碼：

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)目

新建 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
添加依賴
- pom.xml 右鍵菜單 > Maven > Add Dependency
- 在輸入框中輸入，比如 slf4j 會(huì)自動(dòng)列出匹配結(jié)果，OK
- 加入新的依賴保存文件，會(huì)在 Maven Dependencies 中列出 jar 及路徑，并添加到項(xiàng)目的 classpath 中
編碼
- 編寫 Java 代碼，調(diào)試
構(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

新建 Maven 項(xiàng)目
- File > New > Project
- 選擇 Maven
- （可選）項(xiàng)目類型 maven-archetype-simple 或其他類型
- 輸入 Group Id, Artifact Id
- 輸入項(xiàng)目名稱，F(xiàn)inish
添加依賴
- pom.xml 手動(dòng)添加依賴信息
- 加入新的依賴保存文件，會(huì)在 External Libraries 中列出 jar 及路徑，并添加到項(xiàng)目的 classpath 中
編碼
- 編寫 Java 代碼，調(diào)試
構(gòu)建
- pom.xml 右鍵菜單 > Build module’module name’
- Maven build 會(huì)提示警告：Warning:java: 源值1.5已過時(shí), 將在未來所有發(fā)行版中刪除：可加入配置項(xiàng)解決

4. 常見問題與辦法

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)？

可以通過設(shè)置 <build> 節(jié)點(diǎn)下 <sourceDirectory>, <resources> 參數(shù)指定。

4.3 在 pom 文件中配置了依賴，編譯時(shí)還會(huì)報(bào)錯(cuò)。

下載的 jar 文件可能有問題。

檢查 maven 倉庫地址，在搜索條件中檢查 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>

類似的問題： [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已過時(shí), 將在未來所有發(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>

我喜歡程序員，他們單純、固執(zhí)、容易體會(huì)到成就感；面對壓力，能夠挑燈夜戰(zhàn)不眠不休；面對困難，能夠迎難而上挑戰(zhàn)自我。他們也會(huì)感到困惑與傍徨，但每個(gè)程序員的心中都有一個(gè)比爾蓋茨或是喬布斯的夢想“用智慧開創(chuàng)屬于自己的事業(yè)”。我想說的是，其實(shí)我是一個(gè)程序員。（新浪微博：@唐尤華）

查看唐尤華的更多文章 >>

標(biāo)簽： linux 代碼腳本搜索

版權(quán)申明：本站文章部分自網(wǎng)絡(luò)，如有侵權(quán)，請聯(lián)系：west999com@outlook.com
特別注意：本站所有轉(zhuǎn)載文章言論不代表本站觀點(diǎn)！
本站所提供的圖片等素材，版權(quán)歸原作者所有，如需使用，請與原作者聯(lián)系。

上一篇:完美解決：Java微信語音amr格式轉(zhuǎn)mp3格式，兼容Linux/Mac/Windows，支持Maven

下一篇:每周10道Java面試題：面向?qū)ο? 類加載器, JDBC, Spring 基礎(chǔ)概念

相關(guān)文章

最新資訊

熱門推薦

為學(xué)習(xí)和知識(shí)分享目的，本站文章部分自網(wǎng)絡(luò)，本站文章部分自網(wǎng)絡(luò)，如有侵權(quán)，請聯(lián)系：2653426586@qq.com QQ：2653426586

如有其他需求，請聯(lián)系：2653426586@qq.com QQ：2653426586

友情鏈接：網(wǎng)絡(luò)安全運(yùn)維經(jīng)驗(yàn) IT技術(shù)分享運(yùn)維隨筆錄鮮花東郊到家往約到家

中文字幕在线观看,亚洲а∨天堂久久精品9966,亚洲成a人片在线观看你懂的,亚洲av成人片无码网站,亚洲国产精品无码久久久五月天

從零開始用好Maven：從HelloWorld到日常使用

1. Maven簡介

2. Maven使用

2.1 安裝

2.2 Windows

2.3 Linux

2.4 驗(yàn)證

2.5 設(shè)置Maven

2.5.1 自定義倉庫位置(可選)

2.5.2 設(shè)置國內(nèi)鏡像(可選)

3. 使用

3.1 快速上手

3.1.1 新建示例項(xiàng)目

3.1.2 構(gòu)建項(xiàng)目

3.1.3 運(yùn)行

3.2 新增依賴

3.2.1 搜索Maven

3.2.2 加入依賴項(xiàng)

3.2.3 驗(yàn)證

3.3 IDE中使用

3.3.1 Eclipse

3.3.2 Idea

4. 常見問題與辦法

4.1 如何設(shè)置編譯支持的 JDK 版本？

4.2 如何指定自己的目錄結(jié)構(gòu)？

4.3 在 pom 文件中配置了依賴，編譯時(shí)還會(huì)報(bào)錯(cuò)。

4.4 [WARNING] File encoding has not been set, using platform encoding UTF-8, i.e. build is platform dependent!

4.5 Invalid project description. … overlaps the workspace …

4.6 Warning:java: 源值1.5已過時(shí), 將在未來所有發(fā)行版中刪除

關(guān)于作者：唐尤華

中文字幕在线观看,亚洲а∨天堂久久精品9966,亚洲成a人片在线观看你懂的,亚洲av成人片无码网站,亚洲国产精品无码久久久五月天

從零開始用好Maven：從HelloWorld到日常使用

1. Maven簡介

2. Maven使用

2.1 安裝

2.2 Windows

2.3 Linux

2.4 驗(yàn)證

2.5 設(shè)置Maven

2.5.1 自定義倉庫位置(可選)

2.5.2 設(shè)置國內(nèi)鏡像(可選)

3. 使用

3.1 快速上手

3.1.1 新建示例項(xiàng)目

3.1.2 構(gòu)建項(xiàng)目

3.1.3 運(yùn)行

3.2 新增依賴

3.2.1 搜索Maven

3.2.2 加入依賴項(xiàng)

3.2.3 驗(yàn)證

3.3 IDE中使用

3.3.1 Eclipse

3.3.2 Idea

4. 常見問題與辦法

4.1 如何設(shè)置編譯支持的 JDK 版本？

4.2 如何指定自己的目錄結(jié)構(gòu)？

4.3 在 pom 文件中配置了依賴，編譯時(shí)還會(huì)報(bào)錯(cuò)。

4.4 [WARNING] File encoding has not been set, using platform encoding UTF-8, i.e. build is platform dependent!

4.5 Invalid project description. … overlaps the workspace …

4.6 Warning:java: 源值1.5已過時(shí), 將在未來所有發(fā)行版中刪除

關(guān)于作者： 唐尤華

4.1 如何設(shè)置編譯支持的 JDK 版本？

4.2 如何指定自己的目錄結(jié)構(gòu)？

4.3 在 pom 文件中配置了依賴，編譯時(shí)還會(huì)報(bào)錯(cuò)。

關(guān)于作者：唐尤華