摘要：使用過Maven的人都知道maven中有許多功能都是通過外掛來提供的，今天我們來說一下其中的一個外掛：maven-archetype-plugin

，通過該外掛可以自定義符合我們自己需求的archetype。

一:什麼是Archetype

總之，原型是一個Maven專案模板工具包。一個原型被定義為從其中相同型別的所有其它事情是由一個原始圖案或模型。名稱配合，因為我們正在努力提供一種系統，該系統提供了一種生成Maven專案的一致的手段。原型將幫助作者為使用者建立Maven專案模板，併為使用者提供了手段，產生的這些專案模板引數化的版本。


使用原型提供了一個很好的方式，迅速使開發人員在與您的專案或組織採用最佳實踐一致的方法。在Maven的專案中，我們使用原型，試圖讓我們的使用者和執行儘可能快地通過提供展示許多的Maven的功能，同時引入新的使用者通過採用Maven的最佳實踐的示例專案。在幾秒鐘內一個新的使用者可以有一個工作Maven專案作為跳板用於調查更多的功能，Maven中。我們也試圖使原型機制新增劑和由我們的意思是允許一個專案的一部分被捕獲在一個原型，使得專案的部件或方面可以被新增到現有的專案。這方面的一個很好的例子是Maven站點原型。如果，例如，您使用的快速啟動原型生成一個工作專案，你可以迅速通過使用現有專案中的網站原型建立網站的專案。你可以做這樣的事與原型。


您可能要在組織內部規範J2EE開發，所以你可能要提供原型為EJB，或者，或者您的Web服務的戰爭。一旦這些原型建立和部署在您的組織的資源庫，他們都可以在組織內使用的所有開發人員。

上面是我根據maven官網在百度翻譯出來的，大家將就著看，大概意思就是archetype是Maven專案模板工具包，也就是一個模板工程。

二：使用archetype建立專案

1. mvn archetype:generate  

上面的命令執行後會輸出很多maven官方提供的archetype，但是這些archetype生成的專案骨架都不能夠滿足我們的需求，所以這就需要我們自己開發一個archetype來滿足我們自己的開發需求，下面我把我自己自定義這個archetype的過程記錄一下方便日後回憶。

三：建立自定義的archetype專案

1.首先使用sts(spring的一款開發工具，下載地址到spring官網)建立一個maven project，然後把配置好的一些公用的東西放到相應的目錄下面比如說會將一些常用的java程式碼存放到src/main/java目錄下面；會將一些通用的配置檔案放到src/main/resources目錄下面；如果是javeEE工程，還會有一些jsp等等的檔案存放到src/main/webapp目錄下面，如下圖所示:

2.然後在建立的maven project的pom.xml檔案中新增archetype外掛，如下面所示：

1. <projectxmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
2.     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
3.     <modelVersion>4.0.0</modelVersion>
4.     <parent
   >
5.         <groupId>org.micaicms</groupId>
6.         <artifactId>micaicms-pom</artifactId>
7.         <version>1.0</version>
8.     </parent>
9.     <artifactId>micaicms-web-archetype</artifactId>
10.     <packaging>jar</packaging>
11.     <name>micaicms web archetype</name>
12.     <description>micaicms-web-archetype</description>
13.     <distributionManagement>
14.         <repository>
15.             <id>releases</id>
16.             <name>Micaicms Releases</name>
17.             <url>http://127.0.0.1:8081/nexus/content/repositories/releases/</url>
18.         </repository>
19.         <snapshotRepository>
20.             <id>snapshots</id>
21.             <name>Micaicms Releases</name>
22.             <url>http://127.0.0.1:8081/nexus/content/repositories/snapshots/</url>
23.         </snapshotRepository>
24.     </distributionManagement>
25.     <build>
26.         <pluginManagement>
27.             <plugins>
28.                 <plugin>
29.                     <groupId>org.apache.maven.plugins</groupId>
30.                     <artifactId>maven-archetype-plugin</artifactId>
31.                     <version>2.2</version>
32.                 </plugin>
33.                 <plugin>
34.                     <groupId>org.apache.maven.plugins</groupId>
35.                     <artifactId>maven-compiler-plugin</artifactId>
36.                     <configuration>
37.                         <source>1.5</source>
38.                         <target>1.5</target>
39.                     </configuration>
40.                 </plugin>
41.                 <plugin>
42.                     <groupId>org.apache.maven.plugins</groupId>
43.                     <artifactId>maven-resources-plugin</artifactId>
44.                     <configuration>
45.                         <encoding>UTF-8</encoding>
46.                     </configuration>
47.                 </plugin>
48.             </plugins>
49.         </pluginManagement>
50.     </build>
51. </project>

3.執行你自己配置好的自定義的archetype專案

先執行mvn clean install
安裝該archetype專案到你的本地倉庫

釋出該archetype專案到你的本地私服(nexus)

注意；這裡如果你需要釋出這個archetype到你的本地私服上去，那麼需要在maven裡面配置許可權，主要是maven裡面的settings.xml檔案，我
的settings.xml檔案配置如下，配置好以後就可以執行釋出命令了

再執行mvn deploy

4.檢視你剛才釋出到nexus私服上去的archetype，如下圖：

四：在eclipse/sts開發工具中配置你釋出到私服上的自定義的archetype

1.開啟你的開發工具，eclipse或者sts，我這裡是sts


2.選擇Window->Preferences->Maven->Archetypes


3.點選Add Remote Catalog，輸入你的nexus私服中archetype的地址，我這裡是
http://127.0.0.1:8081/nexus/content/groups/public/archetype-catalog.xml
輸入Description，隨便輸入都可以，我這裡是micaicms-web-archetype


4.點選Ok，點選Apply


5.重新啟動你的開發工具eclipse或者sts

五：使用自定義的archetype生成自定義的專案骨架

1.選擇New->Maven Project->Next


2.選擇你配置好的archetype，如下圖:

3.輸入對應的groupId，artifactId，package，如下圖：
因為我已經新建過該專案了，所以我這裡不能點選Finish，你們的應該可以

4.最後生成的專案骨架如下圖:

5.修改資料庫配置檔案，匯入初始化sql指令碼，如下圖：

6.部署專案到tomcat下面訪問即可，預設的訪問路徑為：ht:tp://localhost:8080/micaicms-ssmb/project/list

六：Maven的自定義archetype原始碼工程下載地址：

七：Maven的自定義archetype生成的基礎專案骨架工程的下載地址：

==============參考二=================================

http://www.tuicool.com/articles/Bruu2a

Maven外掛之maven-archetype-plugin

學過Maven的人，都知道用MyEclipse的Maven外掛生成一個專案骨架，比如maven-archetype-quickstart，這個原型就是最常用的之一。

剛開始使用骨架的時候，感覺很好，減少了重複勞動，提高了開發效率。使用的時間久了，就會發現，Maven Archetype提供的專案骨架不能百分百的滿足公司規定的專案結構，不免要手動改些東西。

此時，自然而然的就會想到：如果能將公司(或專案組)規定的專案結構作為一個 骨架原型 上傳個私服，作為模版供專案使用，就無須修改任何的檔案。也減少了專案環境搭建時間、降低了出錯率等。

1、 進入模版專案的根目錄，執行命令：mvn archetype:create-from-project 生成以該專案為模版的專案原型(archetype)，具體的專案結構在target/generated-sources目錄下； 注意：生成的archetype包含模板專案中所有的文件，避免冗餘，可將多餘檔案刪除，並對其專案結構做一些整理！！！ a、修改archetype目錄下pom.xml，將archetype的名稱修改成你喜歡的； b、可將資料夾改成_rootArtifactId_，這樣生成專案結構時，這個目錄名稱就會變成新的專案名稱了； 這些都整理好了之後，可以將其釋出到nexus倉庫供其它同事使用了，釋出的方法如下： 2 、在archetype目錄下的pom.xml中新增maven倉庫配置: <distributionManagement> <repository> <id>releases</id> <url>http://192.168.10.254:8081/nexus/content/repositories/releases</url> </repository> <snapshotRepository> <id>snapshots</id> <url>http://192.168.10.254:8081/nexus/content/repositories/snapshots</url> </snapshotRepository> </distributionManagement> 3 、釋出archetype， 到${basedir}/target/generated-sources/archetype目錄下， 執行命令： mvn deploy 4 、使用該原型建立新專案， 任意目錄下執行 命令： mvn archetype:generate -DarchetypeGroupId=com.ktr -DarchetypeVersion=1.0 -DarchetypeArtifactId=ktr-archetype

注：表格的內容為轉載。

詳細介紹瞭如何快速建立和使用Archetype。

(最佳實踐)

實際應用中，項 目組(或者部門/公司)會有自己的私服，因此以下的介紹前提條件是配有自己的私服。

第一步 ： 選擇模版專案，生成原型。

選擇生成Archetype的模板專案，執行命令： mvn clean archetype:create-from-project

但實際應用中，模板專案選好後，一般無須指定任何引數。

此時專案的Archetype已經生成，位於${basedir}/target/generated-sources/archetype/目錄下。

第二步： 將Archetype上傳到私服，共享給其他人使用(需要有deploy許可權和scm配置)。

到${basedir}/target/generated-sources/archetype/目錄下執行命令： mvn deploy

將該原型上傳到私服，此時前期工作完成，以後可以使用該原型生成專案骨架。

第三步： 使用Archetype生成專案骨架。

任意目錄下，執行命令：

mvn archetype:generate

相關推薦