摘要：
    Archetype是什么？它由哪些文件组成？如何创建和安装自己的archtype，如何使用自己创建的archetype？



一、Archetype是什么
    Archetype其实就是一个Maven的Project模板，以方便用户快速创建maven的Project。有官方提供的Archetype，用户也可以创建自己的Archetype，比如我们公司的所有工程都使用相同的groupId，都将包含相同的库文件，那么我们就可以创建一个自己的archetype，然后大家下载过去安装在自己的本地。或者放在一个内部服务器上，然后大家在自己的eclipse上配置好该服务器catogries.xml文件的路径；

    下图是官方提供的Archetype的生命周期，现在只要了解，后续将详细介绍。



二、Archetype工程的组成
一个典型的archetype包含如下组成部分：
1）Archetype descriptor（archetype.xml），这个文件位于路径src/main/resources/META-INF/maven/，那就除了所有将要包含在archetype中的文件，并且给他们做了分类以便Archetype的生成机制可以正确的处理它们;
2）Archetype插件将要拷贝的原型文件，位于路径，src/main/resources/archetype-resources/；
3）pom.xml原型文件，位于路径：src/main/resources/archetype-resources
4）这个工程本身自己的pom.xml；


三、如何生成Archetype
    首先基于一个用户已有的工程，使用mvn archetype:create-from-project 就可以在该project的target\generate-sources\archetype生成了一个archetype。
    比如我刚刚在gs-rest-service-yang工程内运行了mvn archetype:create-from-project命令，然后在target子目录下声称了generated-sources文件夹，文件夹内包含了archetype文件夹，该文件夹的内容如下：
  1. │  pom.xml
    2. 

  2. │  
    3. 

  3. ├─src
    4. 

  4. │  ├─main
    5. 

  5. │  │  └─resources
    6. 

  6. │  │      ├─archetype-resources
    7. 

  7. │  │      │  │  .classpath
    8. 

  8. │  │      │  │  .project
    9. 

  9. │  │      │  │  pom.xml
    10. 

  10. │  │      │  │  
    11. 

  11. │  │      │  ├─.settings
    12. 

  12. │  │      │  │      org.eclipse.core.resources.prefs
    13. 

  13. │  │      │  │      org.eclipse.jdt.core.prefs
    14. 

  14. │  │      │  │      org.eclipse.m2e.core.prefs
    15. 

  15. │  │      │  │      
    16. 

  16. │  │      │  └─src
    17. 

  17. │  │      │      ├─main
    18. 

  18. │  │      │      │  └─java
    19. 

  19. │  │      │      │          Application.java
    20. 

  20. │  │      │      │          Quote.java
    21. 

  21. │  │      │      │          Value.java
    22. 

  22. │  │      │      │          
    23. 

  23. │  │      │      └─test
    24. 

  24. │  │      │          └─java
    25. 

  25. │  │      │                  AppTest.java
    26. 

  26. │  │      │                  
    27. 

  27. │  │      └─META-INF
    28. 

  28. │  │          └─maven
    29. 

  29. │  │                  archetype-metadata.xml
    30. 

  30. │  │                  
    31. 

  31. │  └─test
    32. 

  32. │      └─resources
    33. 

  33. │          └─projects
    34. 

  34. │              └─basic
    35. 

  35. │                      archetype.properties
    36. 

  36. │                      goal.txt
    37. 

  37. │                      
    38. 

  38. └─target
    39. 

  39.     │  gs-rest-service-yang-archetype-0.0.1-SNAPSHOT.jar
    40. 

  40.     │  
    41. 

  41.     ├─classes
    42. 

  42.     │  ├─archetype-resources
    43. 

  43.     │  │  │  .classpath
    44. 

  44.     │  │  │  .project
    45. 

  45.     │  │  │  pom.xml
    46. 

  46.     │  │  │  
    47. 

  47.     │  │  ├─.settings
    48. 

  48.     │  │  │      org.eclipse.core.resources.prefs
    49. 

  49.     │  │  │      org.eclipse.jdt.core.prefs
    50. 

  50.     │  │  │      org.eclipse.m2e.core.prefs
    51. 

  51.     │  │  │      
    52. 

  52.     │  │  └─src
    53. 

  53.     │  │      ├─main
    54. 

  54.     │  │      │  └─java
    55. 

  55.     │  │      │          Application.java
    56. 

  56.     │  │      │          Quote.java
    57. 

  57.     │  │      │          Value.java
    58. 

  58.     │  │      │          
    59. 

  59.     │  │      └─test
    60. 

  60.     │  │          └─java
    61. 

  61.     │  │                  AppTest.java
    62. 

  62.     │  │                  
    63. 

  63.     │  └─META-INF
    64. 

  64.     │      └─maven
    65. 

  65.     │              archetype-metadata.xml
    66. 

  66.     │              
    67. 

  67.     ├─gs-rest-service-yang-archetype-0.0.1-SNAPSHOT
    68. 

  68.     │  ├─archetype-resources
    69. 

  69.     │  │  │  .classpath
    70. 

  70.     │  │  │  .project
    71. 

  71.     │  │  │  pom.xml
    72. 

  72.     │  │  │  
    73. 

  73.     │  │  ├─.settings
    74. 

  74.     │  │  │      org.eclipse.core.resources.prefs
    75. 

  75.     │  │  │      org.eclipse.jdt.core.prefs
    76. 

  76.     │  │  │      org.eclipse.m2e.core.prefs
    77. 

  77.     │  │  │      
    78. 

  78.     │  │  └─src
    79. 

  79.     │  │      ├─main
    80. 

  80.     │  │      │  └─java
    81. 

  81.     │  │      │          Application.java
    82. 

  82.     │  │      │          Quote.java
    83. 

  83.     │  │      │          Value.java
    84. 

  84.     │  │      │          
    85. 

  85.     │  │      └─test
    86. 

  86.     │  │          └─java
    87. 

  87.     │  │                  AppTest.java
    88. 

  88.     │  │                  
    89. 

  89.     │  └─META-INF
    90. 

  90.     │      └─maven
    91. 

  91.     │              archetype-metadata.xml
    92. 

  92.     │              
    93. 

  93.     └─test-classes
    94. 

  94.         └─projects
    95. 

  95.             └─basic
    96. 

  96.                     archetype.properties
    97. 

  97.                     goal.txt
可以看到上面有一些.setting, .class, .project的文件，这些是多余的。
所以我们在搭建好样板工程之后，在使用mvn archetype:create-from-project命令之前，要先把项目中不相关的工程文件、中间文件删除。
清除之后重新声称的结构如下：

  1. │  pom.xml
    2. 

  2. │  
    3. 

  3. ├─src
    4. 

  4. │  ├─main
    5. 

  5. │  │  └─resources
    6. 

  6. │  │      ├─archetype-resources
    7. 

  7. │  │      │  │  pom.xml
    8. 

  8. │  │      │  │  
    9. 

  9. │  │      │  └─src
    10. 

  10. │  │      │      ├─main
    11. 

  11. │  │      │      │  └─java
    12. 

  12. │  │      │      │          Application.java
    13. 

  13. │  │      │      │          Quote.java
    14. 

  14. │  │      │      │          Value.java
    15. 

  15. │  │      │      │          
    16. 

  16. │  │      │      └─test
    17. 

  17. │  │      │          └─java
    18. 

  18. │  │      │                  AppTest.java
    19. 

  19. │  │      │                  
    20. 

  20. │  │      └─META-INF
    21. 

  21. │  │          └─maven
    22. 

  22. │  │                  archetype-metadata.xml
    23. 

  23. │  │                  
    24. 

  24. │  └─test
    25. 

  25. │      └─resources
    26. 

  26. │          └─projects
    27. 

  27. │              └─basic
    28. 

  28. │                      archetype.properties
    29. 

  29. │                      goal.txt
    30. 

  30. │                      
    31. 

  31. └─target
    32. 

  32.     │  gs-rest-service-yang-archetype-0.0.1-SNAPSHOT.jar
    33. 

  33.     │  
    34. 

  34.     ├─classes
    35. 

  35.     │  ├─archetype-resources
    36. 

  36.     │  │  │  pom.xml
    37. 

  37.     │  │  │  
    38. 

  38.     │  │  └─src
    39. 

  39.     │  │      ├─main
    40. 

  40.     │  │      │  └─java
    41. 

  41.     │  │      │          Application.java
    42. 

  42.     │  │      │          Quote.java
    43. 

  43.     │  │      │          Value.java
    44. 

  44.     │  │      │          
    45. 

  45.     │  │      └─test
    46. 

  46.     │  │          └─java
    47. 

  47.     │  │                  AppTest.java
    48. 

  48.     │  │                  
    49. 

  49.     │  └─META-INF
    50. 

  50.     │      └─maven
    51. 

  51.     │              archetype-metadata.xml
    52. 

  52.     │              
    53. 

  53.     └─test-classes
    54. 

  54.         └─projects
    55. 

  55.             └─basic
    56. 

  56.                     archetype.properties
    57. 

  57.                     goal.txt

四、生成Archetype如何安装
    在上文创建了archetype之后，进入到target\generate-sources\archetype目录，然后在命令行执行：
    mvn install
    则输出如下信息，特别是installing这段，表示就安装成功了。
  1. [INFO] Scanning for projects...
    2. 

  2. [INFO]
    3. 

  3. [INFO] ------------------------------------------------------------------------
    4. 

  4. [INFO] Building gs-rest-service-yang-archetype 0.0.1-SNAPSHOT
    5. 

  5. [INFO] ------------------------------------------------------------------------
    6. 

  6. [INFO]
    7. 

  7. [INFO] --- maven-resources-plugin:3.0.2:resources (default-resources) @ gs-rest-service-yang-archetype ---
    8. 

  8. [WARNING] Using platform encoding (GBK actually) to copy filtered resources, i.e. build is platform dependent!
    9. 

  9. [INFO] Copying 6 resources
    10. 

  10. [INFO]
    11. 

  11. [INFO] --- maven-resources-plugin:3.0.2:testResources (default-testResources) @ gs-rest-service-yang-archetype ---
    12. 

  12. [WARNING] Using platform encoding (GBK actually) to copy filtered resources, i.e. build is platform dependent!
    13. 

  13. [INFO] Copying 2 resources
    14. 

  14. [INFO]
    15. 

  15. [INFO] --- maven-archetype-plugin:3.0.0:jar (default-jar) @ gs-rest-service-yang-archetype ---
    16. 

  16. [INFO] Building archetype jar: D:\WORK\personal\2.src\3.spring\gs-rest-service-yang-2\target\generated-sources\archetype
    17. 

  17. \target\gs-rest-service-yang-archetype-0.0.1-SNAPSHOT
    18. 

  18. [INFO]
    19. 

  19. [INFO] --- maven-archetype-plugin:3.0.0:integration-test (default-integration-test) @ gs-rest-service-yang-archetype ---
    20. 

  20. [INFO] Processing Archetype IT project: basic
    21. 

  21. [INFO] ----------------------------------------------------------------------------
    22. 

  22. [INFO] Using following parameters for creating project from Archetype: gs-rest-service-yang-archetype:0.0.1-SNAPSHOT
    23. 

  23. [INFO] ----------------------------------------------------------------------------
    24. 

  24. [INFO] Parameter: groupId, Value: archetype.it
    25. 

  25. [INFO] Parameter: artifactId, Value: basic
    26. 

  26. [INFO] Parameter: version, Value: 0.1-SNAPSHOT
    27. 

  27. [INFO] Parameter: package, Value: it.pkg
    28. 

  28. [INFO] Parameter: packageInPathFormat, Value: it/pkg
    29. 

  29. [INFO] Parameter: version, Value: 0.1-SNAPSHOT
    30. 

  30. [INFO] Parameter: package, Value: it.pkg
    31. 

  31. [INFO] Parameter: groupId, Value: archetype.it
    32. 

  32. [INFO] Parameter: artifactId, Value: basic
    33. 

  33. [INFO] Project created from Archetype in dir: D:\WORK\personal\2.src\3.spring\gs-rest-service-yang-2\target\generated-so
    34. 

  34. urces\archetype\target\test-classes\projects\basic\project\basic
    35. 

  35. [INFO]
    36. 

  36. [INFO] --- maven-install-plugin:2.5.2:install (default-install) @ gs-rest-service-yang-archetype ---
    37. 

  37. [INFO] Installing D:\WORK\personal\2.src\3.spring\gs-rest-service-yang-2\target\generated-sources\archetype\target\gs-re
    38. 

  38. st-service-yang-archetype-0.0.1-SNAPSHOT.jar to C:\Users\yangg\.m2\repository\com\huajiesolar\gs-rest-service-yang-arche
    39. 

  39. type\0.0.1-SNAPSHOT\gs-rest-service-yang-archetype-0.0.1-SNAPSHOT.jar
    40. 

  40. [INFO] Installing D:\WORK\personal\2.src\3.spring\gs-rest-service-yang-2\target\generated-sources\archetype\pom.xml to C
    41. 

  41. :\Users\yangg\.m2\repository\com\huajiesolar\gs-rest-service-yang-archetype\0.0.1-SNAPSHOT\gs-rest-service-yang-archetyp
    42. 

  42. e-0.0.1-SNAPSHOT.pom
    43. 

  43. [INFO]
    44. 

  44. [INFO] --- maven-archetype-plugin:3.0.0:update-local-catalog (default-update-local-catalog) @ gs-rest-service-yang-arche
    45. 

  45. type ---
    46. 

  46. [INFO] ------------------------------------------------------------------------
    47. 

  47. [INFO] BUILD SUCCESS
    48. 

  48. [INFO] ------------------------------------------------------------------------
    49. 

  49. [INFO] Total time: 2.073 s
    50. 

  50. [INFO] Finished at: 2017-02-21T22:35:47+08:00
    51. 

  51. [INFO] Final Memory: 14M/153M
    52. 

  52. [INFO] ------------------------------------------------------------------------

安装之后主要做了两件事情：
1） 将文件安装到mvn缓存目录，在我本机就是C:\Users\yangg\.m2\repository\com\huajiesolar\gs-rest-service-yang-archetype，该文件夹下的目录结构如下：
  1. |   maven-metadata-local.xml
    2. 

  2. |   
    3. 

  3. \---0.0.1-SNAPSHOT
    4. 

  4.         gs-rest-service-yang-archetype-0.0.1-SNAPSHOT.jar
    5. 

  5.         gs-rest-service-yang-archetype-0.0.1-SNAPSHOT.pom
    6. 

  6.         maven-metadata-local.xml
    7. 

  7.         _remote.repositories
2）创建了文件 C:\Users\yangg\.m2\repository\archetype-catalog.xml文件，文件内容如下：
  1. <?xml version="1.0" encoding="UTF-8"?>
    2. 

  2. <archetype-catalog xsi:schemaLocation="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-catalog/1.0.0 http://maven.apache.org/xsd/archetype-catalog-1.0.0.xsd"
    3. 

  3.     xmlns="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-catalog/1.0.0"
    4. 

  4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    5. 

  5.   <archetypes>
    6. 

  6.     <archetype>
    7. 

  7.       <groupId>com.huajiesolar</groupId>
    8. 

  8.       <artifactId>gs-rest-service-yang-archetype</artifactId>
    9. 

  9.       <version>0.0.1-SNAPSHOT</version>
    10. 

  10.       <description>Parent pom providing dependency and plugin management for applications
    11. 

  11. 		built with Maven</description>
    12. 

  12.     </archetype>
    13. 

  13.   </archetypes>
    14. 

  14. </archetype-catalog>

五、使用上文创建的archetype
有2种使用方式：
1）通过命令行使用
    找到一个空目录，然后执行如下命令：
    mvn archetype:generate -DarchetypeCatalog=local
    此时会给出上文安装的archetype，选择即可，如下：
  1. [INFO] Scanning for projects...
    2. 

  2. [INFO]
    3. 

  3. [INFO] ------------------------------------------------------------------------
    4. 

  4. [INFO] Building Maven Stub Project (No POM) 1
    5. 

  5. [INFO] ------------------------------------------------------------------------
    6. 

  6. [INFO]
    7. 

  7. [INFO] >>> maven-archetype-plugin:3.0.0:generate (default-cli) > generate-sources @ standalone-pom >>>
    8. 

  8. [INFO]
    9. 

  9. [INFO] <<< maven-archetype-plugin:3.0.0:generate (default-cli) < generate-sources @ standalone-pom <<<
    10. 

  10. [INFO]
    11. 

  11. [INFO] --- maven-archetype-plugin:3.0.0:generate (default-cli) @ standalone-pom ---
    12. 

  12. [INFO] Generating project in Interactive mode
    13. 

  13. [INFO] No archetype defined. Using maven-archetype-quickstart (org.apache.maven.archetypes:maven-archetype-quickstart:1.0)
    14. 

  14. Choose archetype:
    15. 

  15. 1: local -> com.huajiesolar:gs-rest-service-yang-archetype (Parent pom providing dependency and plugin management for applications
    16. 

  16.                 built with Maven)
    17. 

  17. Choose a number or apply filter (format: [groupId:]artifactId, case sensitive contains): :
2）通过eclipse使用
    因为C:\Users\yangg\.m2\repository\archetype-catalog.xml是新创建的，所以需要在ecliplse的 file -》new-》maven projects对话框中，在选择archetype页面上，如下图
 点击上文的config按钮，弹出如下界面：
 点击add local catalog ...按钮，在弹出的对话框中选择上文新声称的catalog文件：
 点击Ok即可。

然后在界面上就可以选择新创建的archetype模板了。
 

  《Maven实战》











学习笔记：Maven的ArcheType的学习笔记的更多相关文章

  1. 《Java学习笔记(第8版)》学习指导

    <Java学习笔记(第8版)>学习指导 目录 图书简况 学习指导 第一章 Java平台概论 第二章 从JDK到IDE 第三章 基础语法 第四章 认识对象 第五章 对象封装 第六章 继承与多 ...

  2. 20145213《Java程序设计学习笔记》第六周学习总结

    20145213<Java程序设计学习笔记>第六周学习总结 说在前面的话 上篇博客中娄老师指出我因为数据结构基础薄弱,才导致对第九章内容浅尝遏止地认知.在这里我还要自我批评一下,其实我事后 ...

  3. 强化学习读书笔记 - 06~07 - 时序差分学习(Temporal-Difference Learning)

    强化学习读书笔记 - 06~07 - 时序差分学习(Temporal-Difference Learning) 学习笔记: Reinforcement Learning: An Introductio ...

  4. 学习笔记TF045:人工智能、深度学习、TensorFlow、比赛、公司

    人工智能,用计算机实现人类智能.机器通过大量训练数据训练,程序不断自我学习.修正训练模型.模型本质,一堆参数,描述业务特点.机器学习和深度学习(结合深度神经网络). 传统计算机器下棋,贪婪算法,Alp ...

  5. Hadoop学习笔记(10) ——搭建源码学习环境

    Hadoop学习笔记(10) ——搭建源码学习环境 上一章中,我们对整个hadoop的目录及源码目录有了一个初步的了解,接下来计划深入学习一下这头神象作品了.但是看代码用什么,难不成gedit?,单步 ...

  6. 20145230《java学习笔记》第七周学习总结

    20145230 <Java程序设计>第7周学习总结 教材学习内容 Lambda语法概览 我们在许多地方都会有按字符串长度排序的需求,如果在同一个方法内,我们可以使用一个byName局部变 ...

  7. 【笔记】MySQL的基础学习（二）

    [笔记]MySQL的基础学习(二) MySQL 老男孩  一 视图 视图其实就是给表起个别名 1.创建视图 格式:CREATE VIEW 视图名称 AS SQL语句 CREATE VIEW v1 AS ...

  8. 【笔记】MySQL的基础学习

    [笔记]MySQL的基础学习 老男孩 MySQL  一 安装与配置 1 下载安装 官网:http://dev.mysql.com/downloads/mysql/ 下载相应版本的压缩包 解压压缩包至任 ...

  9. 【学习笔记】jQuery的基础学习

    [学习笔记]jQuery的基础学习 新建 模板 小书匠  什么是jQuery对象? jQuery 对象就是通过jQuery包装DOM对象后产生的对象.jQuery 对象是 jQuery 独有的. 如果 ...

随机推荐

  1. P4745 B’s problem(b)

    P4745 B’s problem(b) 时间: 1000ms / 空间: 655360KiB / Java类名: Main 背景 NOIP春季系列课程 描述 题目描述 小B生活在一个很奇怪的国家里, ...

  2. Good Bye 2016 F.New Year and Finding Roots(交互)

    题目链接 \(Description\) 有一棵高度为\(h\)的满二叉树,点从\(1\)到\(2^h-1\)编号(无序).每次你可以询问一个点的编号,交互库会返回其所有邻接点的编号.你需要在\(16 ...

  3. BZOJ.3257.树的难题(树形DP)

    题目链接 状态只与黑.白两点的颜色有关,于是用 \(f[x][i][j]\)表示当前以x为根节点,有\(i\)个黑点\(j\)个白点,使得x子树满足该条件的最小花费. 最后答案就是 \(min\{f[ ...

  4. POJ.2774.Long Long Message/SPOJ.1811.LCS(后缀自动机)

    题目链接 POJ2774 SPOJ1811 LCS - Longest Common Substring 确实比后缀数组快多了(废话→_→). \(Description\) 求两个字符串最长公共子串 ...

  5. 在vi 按了Ctrl s 之后..

    习惯了在windows下写程序,也习惯了按ctrl+s 保存代码,在用vi的时候,也习惯性的按了ctrl+s 然后vi终端就像卡住了一样. 原来: ctrl+s 终止屏幕输出(即停止回显),你敲的依然 ...

  6. 【转载】GetDeviceCaps()函数相关说明

    CDC::GetDeviceCaps()物理长度与屏幕像素间的转换 作用:读取DC的一些打印区域信息,主要是像素和英寸方面的数据. 声明:GetDeviceCaps(int ) 使用例子://所有像素 ...

  7. Xtreme9.0 - Pattern 3 KMP

    Pattern 3 题目连接: https://www.hackerrank.com/contests/ieeextreme-challenges/challenges/car-spark Descr ...

  8. 安装node.js / npm / express / KMC

    http://www.cnblogs.com/seanlv/archive/2011/11/22/2258716.html 1. 下载Node.js官方Windows版程序: http://nodej ...

  9. How to convert a byte to its binary string representation

    How to convert a byte to its binary string representation For example, the bits in a byte B are 1000 ...

  10. 未能加载文件或程序集“System.Web.Mvc, Version=5.2.3.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35”或它的某一个依赖项

    在发布网站时遇到如题错误. 错误消息详细信息:未能加载文件或程序集“System.Web.Mvc, Version=5.2.3.0, Culture=neutral, PublicKeyToken=3 ...