使用maven的都知道國外的maven下載一個是比較慢,一個是因為被牆,一些jar包無法下載,非常老火。
比如出現類似下面的錯誤:
Unknown host repo.maven.apache.org -> [Help 1] [ERROR
oschina.net搭建了國內 鏡像,經測試,速度很快。下面是oschina.net的介紹。
查找依賴包地址: OSChina Maven http://maven.oschina.net/home.html
http://maven.oschina.net/help.html
介紹
親愛的小伙伴們,開源中國的 Maven 庫上線咯!為了方便廣大開發同學,開源中國特別推出國內的 Maven 中央庫,提供高速穩定的網絡和服務,為國內 Maven 使用者提供便捷服務。本 Maven 庫是從 ibiblio 同步過來的,因為網絡等原因,保持每天一次更新。本 Maven 庫使用開源軟件 Nexus 搭建,對外鏡像鏈接地址為: http://maven.oschina.net/content/groups/public/ 。
使用
接下來將簡單介紹如何在您的項目中使用 Maven,以及使用 OSChina 提供的 Maven 服務。
1.安裝 Maven
如果需要使用到 Maven ,必須首先安裝 Maven , Maven 的下載地址在 Apache Maven 中有,您也可以點擊這里下載 zip ,tar.gz。
下載好 Maven 后,需要簡單安裝下。將下載的 zip 或者 tar.gz 包解壓到需要安裝到的目錄。 接下簡單配置下環境變量:
1、新建環境變量 M2_HOME ,輸入值為 Maven 的安裝目錄。
2、新建環境變量 M2 ,輸入值為: %M2_HOME%\bin 。
3、將 M2 環境變量加入 Path 的最后,如: ;%M2% ;。
環境變量就這么簡單配置下就可以了。打開命令行窗口輸入 mvn -version 。可以看到如下輸出:
看到以上輸出,您的 Maven 環境就已經搭建好了。
2.修改 settings.xml
在 Maven 中使用 OSChina 的 Maven 服務還需要簡單配置一下 Maven,在 Maven 的安裝目錄下的 conf 文件下有個 settings.xml 文件,接下來我們需要對這個文件做簡單的修改,修改前您可以簡單備份下該文件。 打開 settings.xml 文件,按下面內容修改。或者點擊 settings.xml 下載
01 |
<mirrors> |
02 |
<!-- mirror | Specifies a repository mirror site to use instead of a given |
03 |
repository. The repository that | this mirror serves has an ID that matches |
04 |
the mirrorOf element of this mirror. IDs are used | for inheritance and direct |
05 |
lookup purposes, and must be unique across the set of mirrors. | --> |
06 |
<mirror> |
07 |
<id>nexus-osc</id> |
08 |
<mirrorOf>*</mirrorOf> |
09 |
<name>Nexus osc</name> |
10 |
<url>http://maven.oschina.net/content/groups/public/</url> |
11 |
</mirror> |
12 |
</mirrors> |
補充: 如果還需要osc的thirdparty倉庫或多個倉庫,需要如下修改:詳情
01 |
<mirrors> |
02 |
<!-- mirror | Specifies a repository mirror site to use instead of a given |
03 |
repository. The repository that | this mirror serves has an ID that matches |
04 |
the mirrorOf element of this mirror. IDs are used | for inheritance and direct |
05 |
lookup purposes, and must be unique across the set of mirrors. | --> |
06 |
<mirror> |
07 |
<id>nexus-osc</id> |
08 |
<mirrorOf>central</mirrorOf> |
09 |
<name>Nexus osc</name> |
10 |
<url>http://maven.oschina.net/content/groups/public/</url> |
11 |
</mirror> |
12 |
<mirror> |
13 |
<id>nexus-osc-thirdparty</id> |
14 |
<mirrorOf>thirdparty</mirrorOf> |
15 |
<name>Nexus osc thirdparty</name> |
16 |
<url>http://maven.oschina.net/content/repositories/thirdparty/</url> |
17 |
</mirror> |
18 |
</mirrors> |
這里是配置 Maven 的 mirror 地址指向OSChina 的 Maven 鏡像地址。 在執行 Maven 命令的時候, Maven 還需要安裝一些插件包,這些插件包的下載地址也讓其指向 OSChina 的 Maven 地址。修改如下內容。
01 |
<profile> |
02 |
<id>jdk-1.4</id> |
03 |
04 |
<activation> |
05 |
<jdk>1.4</jdk> |
06 |
</activation> |
07 |
08 |
<repositories> |
09 |
<repository> |
10 |
<id>nexus</id> |
11 |
<name>local private nexus</name> |
12 |
<url>http://maven.oschina.net/content/groups/public/</url> |
13 |
<releases> |
14 |
<enabled>true</enabled> |
15 |
</releases> |
16 |
<snapshots> |
17 |
<enabled>false</enabled> |
18 |
</snapshots> |
19 |
</repository> |
20 |
</repositories> |
21 |
<pluginRepositories> |
22 |
<pluginRepository> |
23 |
<id>nexus</id> |
24 |
<name>local private nexus</name> |
25 |
<url>http://maven.oschina.net/content/groups/public/</url> |
26 |
<releases> |
27 |
<enabled>true</enabled> |
28 |
</releases> |
29 |
<snapshots> |
30 |
<enabled>false</enabled> |
31 |
</snapshots> |
32 |
</pluginRepository> |
33 |
</pluginRepositories> |
34 |
</profile> |
如果您需要修改 Maven 的默認文件保存路徑,需要在 settings.xml 文件中修改如下地方。
1 |
<localRepository>F:/Maven/repo/m2/</localRepository> |
按照如上修改 settings.xml 之后,您就可以在自己的 Maven 中使用 OSChina 為您提供的 Maven 服務了。
3.使用 Maven 創建項目
您可以創建一個屬於自己的 Maven 項目來簡單測試一下 OSChina 的 Maven 庫。創建 Maven 項目很簡單,只需要簡單一行命令就可以搞定。
下面是創建 Maven 項目的命令:
1 |
mvn archetype:create -DgroupId=oschina -DartifactId=simple -DpackageName=net.oschina.simple -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false |
其中 -DarchetypeArtifactId=maven-archetype-webapp 代表創建一個簡單的 webapp 項目。至於其他參數的意思,您可以查看下 Maven 的相關文檔。 在您需要創建 Maven 項目的文件夾下用命令行執行以上命令。可以看到如下輸出: 
如果順利創建成功的話,你會看到如下輸出:
如果創建失敗,就可能需要您去 Google 一下了。創建項目的時候,Maven 會下載一些需要用到的 Maven 插件。
4.添加包依賴
因為只是簡單介紹下使用 OSChina 的 Maven 庫,關於 Maven 的項目編譯,打包,測試,發布等具體細節就不多介紹了,您可以去查看 Maven 的相關文檔。
跟ant一樣,Maven 也需要通過 xml 來配置。在項目的根目錄下有一個 pom.xml 文件。
01 |
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
02 |
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> |
03 |
<modelVersion>4.0.0</modelVersion> |
04 |
<groupId>oschina</groupId> |
05 |
<artifactId>oschina.simple</artifactId> |
06 |
<packaging>war</packaging> |
07 |
<version>1.0</version> |
08 |
<name>oschina.simple Maven Webapp</name> |
09 |
<url>http://maven.apache.org</url> |
10 |
<dependencies> |
11 |
<dependency> |
12 |
<groupId>junit</groupId> |
13 |
<artifactId>junit</artifactId> |
14 |
<version>3.8.1</version> |
15 |
<scope>test</scope> |
16 |
</dependency> |
17 |
</dependencies> |
18 |
<build> |
19 |
<finalName>oschina.simple</finalName> |
20 |
</build> |
21 |
</project> |
在 pom.xml 中加入您需要添加的包,如果您需要查找依賴包有哪些版本,可以在 OSChina Maven 搜索。比如輸入 jedis 的結果會如下:
在右下角的 Maven 標簽下可以看到當前選中的版本的依賴 xml,copy 該依賴 xml 到 pom.xml 的 dependencies 結點下。如果需要其他依賴包,您也繼續搜索。當然,有些偏門的 jar 可能沒有,這主要可能是它沒有提交到 Maven 的中央庫中。
5.將項目安裝到本地 repository
添加好包的依賴之后,您就可以開始在您的 Maven 項目下開始工作了。如果一切准備就緒,您可能需要將項目安裝到本地 repository 。
執行命令: mvn clean & mvn install 就可以把項目安裝到您配置的本地鏡像地址 .m2/repository 下了。 執行命令可以看到如下輸出: 
執行完之后,如果安裝成功會出現如下結果: 
如果失敗了,就根據失敗結果 Google 一下吧! 接下來打開您配置的本地 repository 地址,可以看到您配置的各種依賴包都下載到您本地文件夾了,下次您再使用這些包的時候就不需要再次下載了,項目構建速度也會提高很多。
項目上傳說明
開源中國 Maven 庫的第三方庫中上傳的構件信息僅僅存在於本庫中,我們不向 Maven 中央庫推送任何有關您上傳的構件。如果有需要將您的構件上傳到 Maven 中央庫,請前往 Maven中央庫,如果您的構件在中央庫中申請通過,並且在本庫中存在版本,請通知 @卜祥龍 處理。鑒於上傳到本 Maven 庫中的構件信息直接放在對外開放的 public group 中會誤導用戶,此第三方庫未配置到 public group ,如果您的項目中有需要用到其中的構件,請在項目中單獨配置此地址:http://maven.oschina.net/content/repositories/thirdparty/ 。
感謝
以上就是關於 OSChina Maven 的簡單使用說明,多謝您的使用,您的支持就是我們最大的動力,同時也感謝天翼雲的服務支持。
===================================
注:
如果修改之后,eclipse 每次打開時 maven 不斷的去下載 pom.xml 文件,導致eclipse上的任何操作被阻塞時,可以將上面添加的 profile 元素整個注釋掉就行了。具體原因不明,請知道原因的同學指點一下。
