Ma ven 使用 archetype(原型) 来创建自定义的项目结构，形成 Ma ven 项目模板。

在前面章节我们学到 Ma ven 使用下面的命令来快速创建 ja va 项目：

mvn archetype:generate

什么是 archetype？

archetype，中文通常叫“原型”，本质上是一个 Ma ven 插件。更准确一点说，它更像是一个项目模板，主要用来按照既定模板快速生成一套完整的项目结构。

接下来，就用 quickstart 这个原型插件来创建一个简单的 Ja va 应用程序。

使用项目模板

让我们打开命令控制台，跳转到 C:> MVN 目录并执行以下 mvn 命令:

C:MVN> mvn archetype:generate 

Ma ven 将开始处理，并要求选择所需的原型:

[INFO] Scanning for projects...
[INFO] Searching repository for plugin with prefix: 'archetype'.
[INFO] -------------------------------------------------------------------
[INFO] Building Ma ven Default Project
[INFO]task-segment: [archetype:generate] (aggregator-style)
[INFO] -------------------------------------------------------------------
[INFO] Preparing archetype:generate
...
600: remote -> org.trailsframework:trails-archetype (-)
601: remote -> org.trailsframework:trails-secure-archetype (-)
602: remote -> org.tynamo:tynamo-archetype (-)
603: remote -> org.wicketstuff.scala:wicket-scala-archetype (-)
604: remote -> org.wicketstuff.scala:wicketstuff-scala-archetype 
Basic setup for a project that combines Scala and Wicket,
depending on the Wicket-Scala project. 
Includes an example Specs test.)
605: remote -> org.wikbook:wikbook.archetype (-)
606: remote -> org.xaloon.archetype:xaloon-archetype-wicket-jpa-glassfish (-)
607: remote -> org.xaloon.archetype:xaloon-archetype-wicket-jpa-spring (-)
608: remote -> org.xwiki.commons:xwiki-commons-component-archetype 
(Make it easy to create a ma ven project for creating XWiki Components.)
609: remote -> org.xwiki.rendering:xwiki-rendering-archetype-macro 
(Make it easy to create a ma ven project for creating XWiki Rendering Macros.)
610: remote -> org.zkoss:zk-archetype-component (The ZK Component archetype)
611: remote -> org.zkoss:zk-archetype-webapp (The ZK wepapp archetype)
612: remote -> ru.circumflex:circumflex-archetype (-)
613: remote -> se.vgregion.ja vg.ma ven.archetypes:ja vg-minimal-archetype (-)
614: remote -> sk.seges.sesam:sesam-annotation-archetype (-)
Choose a number or apply filter 
(format: [groupId:]artifactId, case sensitive contains): 203:

按下 Enter 选择默认选项 (203:ma ven-archetype-quickstart)。

Ma ven 将询问原型的版本

Choose org.apache.ma ven.archetypes:ma ven-archetype-quickstart version:
1: 1.0-alpha-1
2: 1.0-alpha-2
3: 1.0-alpha-3
4: 1.0-alpha-4
5: 1.0
6: 1.1
Choose a number: 6:

按下 Enter 选择默认选项 (6:ma ven-archetype-quickstart:1.1)

Ma ven 将询问项目细节。按要求输入项目细节。如果要使用默认值则直接按 Enter 键。你也可以输入自己的值。

Define value for property 'groupId': : com.companyname.insurance
Define value for property 'artifactId': : health
Define value for property 'version': 1.0-SNAPSHOT
Define value for property 'package': com.companyname.insurance

Ma ven 将要求确认项目细节，按 Enter 或按 Y

Confirm properties configuration:
groupId: com.companyname.insurance
artifactId: health
version: 1.0-SNAPSHOT
package: com.companyname.insurance
Y:

现在 Ma ven 将开始创建项目结构，显示如下:

[INFO] -----------------------------------------------------------------------
[INFO] Using following parameters for creating project 
from Old (1.x) Archetype: ma ven-archetype-quickstart:1.1
[INFO] -----------------------------------------------------------------------
[INFO] Parameter: groupId, Value: com.companyname.insurance
[INFO] Parameter: packageName, Value: com.companyname.insurance
[INFO] Parameter: package, Value: com.companyname.insurance
[INFO] Parameter: artifactId, Value: health
[INFO] Parameter: basedir, Value: C:MVN
[INFO] Parameter: version, Value: 1.0-SNAPSHOT
[INFO] project created from Old (1.x) Archetype in dir: C:MVNhealth
[INFO] -----------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] -----------------------------------------------------------------------
[INFO] Total time: 4 minutes 12 seconds
[INFO] Finished at: Fri Jul 13 11:10:12 IST 2012
[INFO] Final Memory: 20M/90M
[INFO] -----------------------------------------------------------------------

创建的项目

接下来，把路径切到 C: > MVN 目录。这里会看到一个名为 health 的 Ja va 应用项目，名称正是创建项目时设置的 artifactId。

与此同时，Ma ven 也会按默认规范生成一套标准的项目目录结构，具体如下所示：

创建 pom.xml

Ma ven 为项目自动生成一个 pom.xml文件，如下所示:

  4.0.0
  com.companyname.insurance
  health
  1.0-SNAPSHOT
  jar
  health
  http://ma ven.apache.org
  
     UTF-8
  
  
     
     junit
        junit
        3.8.1
        test
     
  

App.ja va

Ma ven 会自动生成一个测试的 ja va 文件 App.ja va。

路径：C:MVNconsumerBankingsrcmainja vacomcompanynamebank

package com.companyname.insurance;
/**
* Hello world!
*
*/
public class App 
{
    public static void main( String[] args )
    {
        System.out.println( "Hello World!" );
    }
}

AppTest.ja va

Ma ven 会自动生成一个 ja va 文件 AppTest.ja va。

路径为： C:MVNconsumerBankingsrctestja vacomcompanynamebank

package com.companyname.insurance;
import junit.framework.Test;
import junit.framework.TestCase;
import junit.framework.TestSuite;
/**
* Unit test for simple App.
*/
public class AppTest 
   extends TestCase
{
   /**
   * Create the test case
   *
   * @param testName name of the test case
   */
  public AppTest( String testName )
  {
      super( testName );
  }
/**
  * @return the suite of tests being tested
  */
  public static Test suite()
  {
      return new TestSuite( AppTest.class );
  }
/**
  * Rigourous Test :-)
  */
  public void testApp()
  {
      assertTrue( true );
  }
}

就这样。现在你可以看到 Ma ven 的强大之处。

你可以用 ma ven 简单的命令创建任何类型的项目，并且可以启动您的开发。