原文網址：http://blog.csdn.net/cuker919/article/details/5922007
原文作者：cuker919
前面我講到爲什麼要使用Maven, Maven的安裝，以及如何與IDE集成等，前面的介紹可以認爲是一個Hello World，教你如何利用Maven來進行項目開發，如何結合IDE實現一鍵式DEBUG，從現在開始我們開始深入探討Maven的一些高級內容。
這一個章節，我分兩部分來介紹，首先介紹一下Maven的倉庫，然後在說一下如何通過Nexus來建立我們自己的倉庫，以及如何使用。
Maven 倉庫
在以前使用Ant的時候，我們會建立一個lib目錄在存放我們的jar包，比如項目所依賴的第三方包，每建立一個項目都要建立一個lib，不停的做copy工作，不僅是對於磁盤的浪費，而且也造成了版本管理上的麻煩。而且我們還需要通過提交到svn上來對lib進行管理，但是svn對於這種二進制文件的管理並不出色。
Maven倉庫的初中就是爲了解決這個問題，是所有常用的第三方包的集中營。這樣所有的Maven項目就可以從這個倉庫中獲取所需要的資源，Maven倉庫中對jar通過Group Id, Atifact Id, version 來管理，所以Maven項目可以很方便的進行依賴管理。你不需要自己來管理這個龐大的資源倉庫，當然你可以創建一個公司層面的倉庫管理器，這個我在這個章節的後面會介紹。
Maven 倉庫的兩個概念：本地倉庫和遠程倉庫
本地倉庫是遠程倉庫的一個緩衝和子集，當你構建Maven項目的時候，首先會從本地倉庫查找資源，如果沒有，那麼Maven會從遠程倉庫下載到你本地倉庫。這樣在你下次使用的時候就不需要從遠程下載了。如果你所需要的jar包版本在本地倉庫沒有，而且也不存在於遠程倉庫，Maven在構建的時候會報錯，這種情況可能發生在有些jar包的新版本沒有在Maven倉庫中及時更新。
Maven缺省的本地倉庫地址爲${user.home}/.m2/repository 。也就是說，一個用戶會對應的擁有一個本地倉庫。當然你可以通過修改${user.home}/.m2/settings.xml 配置這個地址：
Xml代碼
- <settings>
- …
- <localRepository> D:/java/repository</localRepository>
- …
- </settings>
如果你想讓所有的用戶使用統一的配置那麼你可以修改Maven主目錄下的setting.xml:
${M2_HOME}/conf/setting.xml
還可以通過在運行時指定目錄，但是並不推薦這麼做：
mvn clean install -Dmaven.repo.local=/home/juven/myrepo/
當我們創建一個簡單的Maven項目後(只需要在pom.xml配置好依賴)，運行mvn clean install就可以把項目構建好，不需要我們手工下載任何jar，這全靠中央倉庫的存在，它會自動從倉庫下載。這個倉庫的定義是在${M2_HOME}/lib/maven-2.0.10-uber.jar 裏面。你可以在裏面找到/org/apache/maven/project/pom-4.0.0.xml 這個文件，在這個文件裏面定義了中央倉庫的地址：
- <repositories>
- <repository>
- <id> central</id>
- <name> Maven Repository Switchboard</name>
- <layout> default</layout>
- <url> http://repo1.maven.org/maven2</url>
- <snapshots>
- <enabled> false</enabled>
- </snapshots>
- </repository>
- </repositories>
在 POM 中配置遠程倉庫
下面我介紹下如何在pom.xml裏面配置遠程倉庫，我們需要在什麼時候配置遠程倉庫呢？當你連接中央倉庫的速度比較慢時，或者你爲你的公司搭建了自己的倉庫，比如Nexus倉庫管理(後面我會介紹)，又或者你蘇需要的jar存在另外一個公共倉庫，比如我們配置一個國內的鏡像地址：
- <project>
- …
- <repositories>
- <repository>
- <id> maven-net-cn</id>
- <name> Maven China Mirror</name>
- <url> http://maven.net.cn/content/groups/public/</url>
- <releases>
- <enabled> true</enabled>
- </releases>
- <snapshots>
- <enabled> false</enabled>
- </snapshots>
- </repository>
- </repositories>
- <pluginRepositories>
- <pluginRepository>
- <id> maven-net-cn</id>
- <name> Maven China Mirror</name>
- <url> http://maven.net.cn/content/groups/public/</url>
- <releases>
- <enabled> true</enabled>
- </releases>
- <snapshots>
- <enabled> false</enabled>
- </snapshots>
- </pluginRepository>
- </pluginRepositories>
- …
- </project>
這裏我們可以看到，允許配置多個repository和 plugin repository，<releases><enabled>true</enabled></releases>告訴Maven可以從這個倉庫下載releases版本的構件，而<snapshots><enabled>false</enabled></snapshots>告訴Maven不要從這個倉庫下載snapshot版本的構件,之所以不讓你從這個倉庫下載snapshot版本，是因爲這些版本是不穩定的，但是snapshot版本在我們內部項目開發的時候可是作用巨大，後面的問文章我會討論這個問題。至於<pluginRepositories>，這是配置Maven從什麼地方下載插件構件，Maven的所有行爲都是通過插件來完成的，其內部配置與<repository>類似，這裏就不多說了。
儘管pom.xml中可以方便的哦配置中央倉庫，但是我並不推薦大家這麼做，尤其是在大的公司中，因爲一個公司會有很多的項目，如果每個項目都這樣配置，那麼又開始做重複的copy工作了，如何解決呢，我們往下走
在 settings.xml 中配置遠程倉庫
Pom.xml的作用範圍是一個項目，一個公司不可能只做一個項目，那麼爲了避免重複配置，那麼我們需要把一些公共信息配置在setting.xml中。但是setting.xml中並不支持<repositories>及<pluginRepositories>，爲了解決這個問題我們使用profile：
- <settings>
- …
- <profiles>
- <profile>
- <id> myProfiel</id>
- <!—在這裏加入<repositories>及<pluginRepositories>–>
- </profile>
- </profiles>
- <activeProfiles>
- <activeProfile> myProfiel </activeProfile>
- </activeProfiles>
- …
- </settings>
這裏通過<activeProfile>元素來激活這個profile，這樣我們就可以全局的使用這個配置，不再需要爲每個POM做重複的配置了。
在實際的操作過程中，這裏我們最好不要配置遠程倉庫，最好能夠通過nexus建立公司或者組織自己的倉庫，然後這把把地址指向自己的倉庫，後面我會介紹爲什麼要這麼做，怎麼做。
配置鏡像
如果你想覆蓋中央倉庫的默認地址，那麼這裏我們就會使用的鏡像了，還在setting.xml裏面配置：
- <settings>
- …
- <mirrors>
- <mirror>
- <id> maven-net-cn</id>
- <name> Maven China Mirror</name>
- <url> http://maven.net.cn/content/groups/public/</url>
- <mirrorOf> central</mirrorOf>
- </mirror>
- </mirrors>
- …
- </settings>
這裏解釋一下<mirrorOf>,表示只爲central倉庫做鏡像，如果想爲所有的倉庫做鏡像那麼可以改爲：<mirrorOf>*</mirrorOf>
如果你看到這裏，請先不要着急，實際的項目經驗告訴我，只是這些還不夠，我們需要更快捷和高效的管理：
利用 Nexus 來構建企業級 Maven 倉庫
Nex u s 簡介
Nexus是Maven倉庫管理器，用來搭建一個本地倉庫服務器，這樣做的好處是便於管理，節省網絡資源，速度快，還有一個非常有用的功能就是可以通過項目的SNAPSHOT版本管理，來進行模塊間的高效依賴開發，下面會一一描述。
雖然你可以通過中央倉庫來獲取你所需要的jar包，但是現實往往是存在很多問題：
- 網速慢，你可能需要花很長的時間來下載你所需要的jar
- 如果你的公司很大，有幾百甚至幾千人再用Maven，那麼這些人都去通過中央倉庫來獲取jar，那麼這是一個很大的資源浪費
- 如果存在模塊之間的依賴開發，你的snapshot版本是不能夠被你的夥伴很方便的獲取。
- 在實際開發過程中，有些jar的版本可能在中央倉庫裏面不存在，或者更新不及時，你是獲取不到這個jar的。
所有以上問題，通過Nexus這個日益流行的倉庫管理器可以輕鬆的解決。
-
- 這個倉庫是本地的，下載的速度是從遠程下載不可比的。
- 可以爲你公司所有的Maven使用者服務，可以進行統一管理
- 後面我會介紹如何通過nexus來進行存在模塊依賴的項目的開發
- 你可以添加自己的第三方包。
安裝 Nexus
我們從http://nexus.sonatype.org/downloads/ 來獲取最新版本，目前最新版本爲1.3.4
Nexus提供了兩種安裝方式，一種是內嵌Jetty的bundle，只要你有JRE就能直接運行。第二種方式是WAR，你只須簡單的將其發佈到web容器中即可使用。
1）Bundle 方式安裝
解壓nexus-webapp-1.3. 4 -bundle.zip 至任意目錄，如D:/ tools ，轉到目錄D:/ tools/nexus-webapp-1.3. 4 /bin/jsw/windows-x86-32 ，運行Nexus.bat ，如果你是在linux下安裝，那麼就下載nexus-webapp-1.3. 4 -bundle. tar .gz， 解壓後轉到${NEXUS_HOME}/ nexus-webapp-1.3.3/bin/jsw/linux-x86-32,它還支持solaris,macos等操作系統。當你看到“Started [email protected]:8081”之後，說明Nexus啓動成功了，然後打開瀏覽器，訪問http://127.0.0.1:8081/nexus，通過admin的帳號(admin)和密碼(admin123)登錄你會看到如下的頁面：
如果有新版本發佈，會有提示在默認頁面上。
這裏，可以管理倉庫，配置Nexus系統，管理任務，管理用戶，角色，權限，查看系統的RSS源，管理及查看系統日誌，等等。
War 方式安裝
你可以同過war的方式以web應用的形式發佈到你的應用服務器，比如tomcat。你所要做的就是下載war版本的文件，然後放到應用服務器的發佈目錄即可，這裏就不多講了。
到此我們已經安裝好Nexus,下面我來介紹下一些我們常用的功能和使用：
配置 中央倉庫
先看一下界面：
在左邊菜單欄裏選擇Repositories，然後會出現右邊的畫面，右邊上半部分是列出來的repository，黑體字是類型爲group的repository. 這裏簡單介紹下幾種repository的類型:
- hosted，本地倉庫，通常我們會部署自己的構件到這一類型的倉庫。比如公司的第二方庫。
- proxy，代理倉庫，它們被用來代理遠程的公共倉庫，如maven中央倉庫。
- group，倉庫組，用來合併多個hosted/proxy倉庫，當你的項目希望在多個repository使用資源時就不需要多次引用了，只需要引用一個group即可。
Maven central是Maven的中央倉庫，點擊它並選擇configuration標籤欄，我們會看到下面的頁面：
這裏有幾個項目是我們可能會經常用到的：
- Override local storage location: 在這個選項你可以配置你的Nexus本地倉庫的存放地址，用來覆蓋其默認的存放地址
- Remote storage location: 這裏是遠程倉庫的地址，爲了提高代理速度，你可以修改爲國內的鏡像地址。默認值是http://repo1.maven.org/maven2/
- Download remote indexes: 這裏配置是否下載遠程索引文件，模式是false, 建議配置爲true，這樣我們便可以通過索引文件來搜索我們需要的構件。
添加代理倉庫
Maven central是一個比較大的代理倉庫，如果你需要添加的一個代理倉庫，那麼可以在點擊左邊慘淡欄裏面的Repositories,然後右邊的頁面點擊add -> add proxy repository, 之後出現以下頁面：
填寫相關信息保存即可。通常情況下,使用預設的代理倉庫已經能夠滿足大部分項目的需求了, 只有在特殊需求的情況下才會參加代理倉庫.
管理本地倉庫
我們前面講到類型爲hosted的爲本地倉庫，Nexus預定義了3個本地倉庫，分別是Releases, Snapshots, 3rd Party. 分別講一下這三個預置的倉庫都是做什麼用的:
- Releases: 這裏存放我們自己項目中發佈的構建, 通常是Release版本的, 比如我們自己做了一個FTP Server的項目, 生成的構件爲ftpserver.war, 我們就可以把這個構建發佈到Nexus的Releases本地倉庫. 關於符合發佈後面會有介紹.
- Snapshots: 這個倉庫非常的有用, 它的目的是讓我們可以發佈那些非release版本, 非穩定版本, 比如我們在trunk下開發一個項目,在正式release之前你可能需要臨時發佈一個版本給你的同伴使用, 因爲你的同伴正在依賴你的模塊開發, 那麼這個時候我們就可以發佈Snapshot版本到這個倉庫, 你的同伴就可以通過簡單的命令來獲取和使用這個臨時版本.
- 3rd Party: 顧名思義, 第三方庫, 你可能會問不是有中央倉庫來管理第三方庫嘛, 沒錯, 這裏的是指可以讓你添加自己的第三方庫, 比如有些構件在中央倉庫是不存在的. 比如你在中央倉庫找不到Oracle 的JDBC驅動, 這個時候我們就需要自己添加到3rd party倉庫.
- 你也可以創建自己的本地倉庫，點擊Repository面板上方的Add按鈕，然後選擇Hosted Repository，然後在下方的配置面板中輸入相關信息, 這裏我們不再需要填寫遠程倉庫地址，根據自己的需要選擇Release或者Snapshot，如圖：
Maven 倉庫組
倉庫組的概念是Maven沒有的,通過前面介紹可以瞭解到, 我們可以建立多個proxy代理倉庫,hosted本地倉庫, 如果沒有倉庫組的概念,我們如果需要引用這些倉庫的是時候需要一一加入到我們的setting.xml裏面去, 有了倉庫的組的概念, 我們只需要做一次引用就可以了,把我們需要的倉庫加入到倉庫組即可.像這樣:
<repositories>
<repository>
<id>nexus</id>
<url>http://127.0.0.1:8081/nexus/content/groups/public/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
Nexus中預設了2個倉庫組,public repositories和public snapshot repositories. 如圖:
這個倉庫組默認包含本地倉庫Releases, snapshots, 3rd party和代理倉庫Maven Central. 你可以在Configuration配置頁添加倉庫到這個倉庫組. 如果需要你還可以創建一個倉庫組,如圖:
點擊 Add->Repository Group
出現New Repository Group界面後,填入ID, name 等相關信息, 在右邊Available Repositories 欄裏可以選擇你要添加的倉庫到你新建的倉庫組.
通過 Nexus 搜索構件
在我們實際使用構件的過程中通常遇到一個問題,有時候我緊緊知道我所需要的構建的大致名字,並不知道全稱或group id, 這是件非常頭疼的事情. Nexus基於Nexus indexer的搜索功能幫我們解決了這個問題.
要是用搜索功能, 必須要有索引文件, Nexus默認是不建立索引文件的,因爲像中央倉庫這樣的索引文件的建立需要耗費比較大的網絡資源,僅索引文件就要幾十兆. 要開啓中央倉庫的索引文件下載功能需要在Maven Central的配置頁面, 把Download Remote Indexes選擇true. 如圖:
這樣設置以後, Nexus會自動從遠程中央倉庫下載索引文件, 爲了檢驗索引文件自動下載是否生效,可以卻換到Browse:
如果出現先以上文件夾,那說明索引文件已經建立.
下面我試一下搜索功能, 在左邊菜單欄裏面有個Artifact Search, 在輸入框裏面輸入你想要搜索的構件名字,比如: testing, 那麼查詢結果如下：
這是模糊查詢的結果，當然如果你知道更多信息，比如版本號等，你可以使用高級搜索，點擊高級搜索後，右邊界面會提供集中搜索方式：keyword, classname, GAV, checksum
比如我們這裏選擇GAV模式, 而且我只知道artiface name : testng和版本號5.8, 其他的我不知道, 那麼就在artifact 和 version處分別輸入testng 和 5.8 , 搜索結果如下:
你如果你不知道知道構件的名稱, 只知道classname, 那麼你也可以通過class name 的方式搜索,這裏就不再贅述
當你選擇一項搜索結果,在頁面的下方會出現這個構件的詳細信息, 並且會列出這個構件的Maven依賴配置, 你可以直接拷貝到你的pom文件中使用,這是個非常實用的功能:
在 Maven 中使用 Nexus
到此爲止我們介紹瞭如何安裝和使用Nexus以及其基本配置, 下面我們介紹下如何讓Maven來使用Nexus本地倉庫用來替代使用遠程倉庫. 在Maven使用Nexus本地倉庫只需稍作配置, 在settings.xml中加入以下代碼:
<profile>
<id>dev</id>
<repositories>
<repository>
<id>nexus</id>
<url>http://127.0.0.1:8081/nexus/content/groups/public/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>nexus</id>
<url>http://127.0.0.1:8081/nexus/content/groups/public</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>
</profile>
</profiles>
<activeProfiles>
<activeProfile>dev</activeProfile>
</activeProfiles>
這裏配置了repository和pluginRepository, Maven在使用第三方構件和插件時是分開來配置的,所以如果我們也希望插件的下載也通過我們的本地倉庫來下載,那麼我們就需要配置pluginRepository.
紅色字體部分就是我們之前安裝的Nexus的地址, 這個地址可以是你們公司局域網內部的一臺倉庫服務器.
<releases> <enabled>true</enabled></releases>這個標籤的作用是設定是否允許下載
release版本的載構件, 同樣snapshots標籤可以設定是否允許下載snapshot版本的構件.
通常,我們不建議下載snapshot版本的構件,因爲它是不穩定的版本, 除非你有特殊的需
求.
構件部署
有些時候我們需要部署構件到Nexus的3rd party, 比如我們在中央倉庫找不到我們需要的構件, 我們可以通過Nexus的UI來上傳構件:
點擊左邊菜單欄的 Repositories, 然後點擊右邊界面的3rd party, 選擇界面下方的Artifact Upload, 這個時候出現以下界面:
上傳構件需要兩個步驟,一個是定義文件的上傳,再就是構件的實體文件.
第一部分定義文件可以是POM文件, 這也是比較推薦的方式, 如果沒有pom文件,可以
選擇以參數的形式輸入.
第二部分是上傳構件的實體文件,這裏簡單說一下Classifier和Extension, 這兩個都是選
填相, Classifier用來區別同功能的構件用於不同的場景, 比如這個構件是分別針對JDK14
和JDK15做了2個功能一樣的Jar, 這個時候你就需要指定這個構件的Classifier爲JDK14
還是JDK15. Extension是指擴展名,如果不提供,那麼會自動取這個構件的Packaging Type
作爲擴展名, 比如 ear, jar, war 等等. (Packaging Type是在第一步中通過pom文件或者手
工輸入得到的)
剛纔說了3rd party的部署, 關於releases 和 snapshots的UI部署也是一樣的操作過程.
我們之前也講過, 這裏的releases和snapshots是用來部署我們自己的項目構件的, 通過
UI部署是可以,但是不是最高效的, 我們可以通過配置Maven來自動部署我們的項目構
件,這也是我們建立自己的倉庫的一個非常重要的原因, 下面就讓我們看看如何配置:
首先需要在POM文件中加入以下代碼:
- <project>
- …
- <distributionManagement>
- <repository>
- <id> nexus-releases</id>
- <name> Nexus Release Repository</name>
- <url> http://127.0.0.1:8081/nexus/content/repositories/releases/</url>
- </repository>
- <snapshotRepository>
- <id> nexus-snapshots</id>
- <name> Nexus Snapshot Repository</name>
- <url> http://127.0.0.1:8081/nexus/content/repositories/snapshots/</url>
- </snapshotRepository>
- </distributionManagement>
- …
- </project>
這裏配置,讓Maven知道當我要發佈release版本或者snapshot版本是需要發佈到哪個地址.
然後我們需要在setting.xml裏面配置一下Nexus的帳號和密碼:
- <settings>
- …
- <servers>
- <server>
- <id> nexus-releases</id>
- <username> admin</username>
- <password> admin123</password>
- </server>
- <server>
- <id> nexus-snapshots</id>
- <username> admin</username>
- <password> admin123</password>
- </server>
- </servers>
- …
- </settings>
到此爲止, 我們就可以通過命令mvn deploy或者通過IDE的可視化界面點擊deploy來發布我們項目到本地倉庫了. 通過這種方式我們可以很方便的進行模塊間的依賴開發, 在後面的文章中我會詳細介紹如何通過snapshot來讓我們的依賴開發變得簡單.
小結
本文介紹了Maven倉庫, 如何通過Nexus建立自己本地倉庫, 通過和遠程倉庫的比較, 我們知道Nexus給我帶來很多方便之處, 方便我們管理, 方便我們的項目構件部署, 項目的依賴開發等. 還在等什麼, 創建你自己的倉庫吧.
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
補充提示：
一、發現配置後，下載構件拋異常。
0-10-3 下午05時09分43秒: Build error for /com.newyulong.iptv.domain.entity/pom.xml; org.apache.maven.plugin.PluginResolutionException: Plugin org.apache.maven.plugins:maven-resources-plugin:2.4.1 or one of its dependencies could not
be resolved: Missing:
----------
1) org.apache.maven.plugins:maven-resources-plugin:maven-plugin:2.4.1
Try downloading the file manually from the project website.
Then, install it using the command:
mvn install:install-file -DgroupId=org.apache.maven.plugins -DartifactId=maven-resources-plugin -Dversion=2.4.1 -Dpackaging=maven-plugin -Dfile=/path/to/file
Alternatively, if you host your own repository you can deploy the file there:
mvn deploy:deploy-file -DgroupId=org.apache.maven.plugins -DartifactId=maven-resources-plugin -Dversion=2.4.1 -Dpackaging=maven-plugin -Dfile=/path/to/file -Durl=[url] -DrepositoryId=[id]
----------
1 required artifact is missing.
for artifact:
org.apache.maven.plugins:maven-resources-plugin:maven-plugin:2.4.1
from the specified remote repositories:
Nexus (http://localhost:8181/nexus/content/groups/public , releases=true, snapshots=false)
二、主要原因是配置nexus裏面的 Public Repositories 順序和條件出錯，導致不能下載構件。
這個是正確的配置順序，左邊的是正在使用的定義好的倉庫組，一邊是可選的。下載構件的順序是先在本地releases找有沒有，再snapshots，再3rd party，最後是本地機子都沒有構件就到遠程（外網）提供的網站下載構件。
好多公司處於安全考慮，用代理上網，而nexus 經常需要往maven repository中心下載東西，所以需要給nexus設置代理。 開始沒找到地方，後來發現可以從nexus後臺管理器界面上直接設置，地方很隱蔽：
登陸後進入管理頁面，從左邊菜單欄選擇Server 打開右邊tab頁，發現還是找不到，彆着急，仔細找會發現有行：
default http proxy settings 前面有個checkbox 未勾選， 速度勾選之，馬上出現了您熟悉的 proxy host,proxy port , username , passowrd. okay 代理設置完成，現在nexus能通過互聯網從maven repository中心下載東西了！
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
linux 下安裝部署 nexus
1.nexus的下載地址
http://nexus.sonatype.org/downloads/
解壓後得到2個文件：
nexus-oss-webapp-1.8.0 －－ 包含了nexus的運行環境和應用程序
sonatype-work －－包含了你自己的配置和數據
2.啓動nexus
# cd nexus-oss-webapp-1.8.0/bin/jsw/linux-x86-32/2、在這個目錄下包含了一個文件夾和三個文件：lib、nexus、platform和wrapper，其中nexus就是啓動命令。
執行 Linxu代碼
得到nexus到提示命令 如 start，stop，status，restart 等。
輸入 Linux代碼
# ./nexus
