使用國內 maven 映象 代替國外 mirror
使用
接下來將簡單介紹如何在您的專案中使用 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
環境變數就這麼簡單配置下就可以了。開啟命令列視窗輸入 mvn -version 。可以看到如下輸出：
看到以上輸出，您的 Maven 環境就已經搭建好了。
2.修改 settings.xml
在 Maven 中使用 OSChina 的 Maven 服務還需要簡單配置一下 Maven，在 Maven 的安裝目錄下的 conf 檔案下有個 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 地址，可以看到您配置的各種依賴包都下載到您本地檔案夾了，下次您再使用這些包的時候就不需要再次下載了，專案構建速度也會提高很多。