怎样快速创建一个工程
? Maven archetype 是 Maven Archetype Plugin 用来生成一套 Maven 项目的模板。使用该插件可以非常轻松的创建一个项目， 仅仅需要执行一个命令, 以创建一个简单的 webapp 项目为例：
mvn archetype:generate \ -B \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DarchetypeArtifactId=maven-archetype-webapp \ -DarchetypeVersion=1.0 \ -DgroupId=com.mycompany.webapp \ -DartifactId=myapp \ -Dversion=1.0
?? 命令会产生一个目录： myapp， 结构如下：
|-- pom.xml`-- src `-- main |-- resources `-- webapp |-- index.jsp `-- WEB-INF `-- web.xml
?
? 下面解释下命令的参数：
?
mvn archetype:generate， 执行 generate goal。 若要看详细说明，可以运行命令： mvn archetype:help -Ddetail=true -Dgoal=generate-B Batch mode, 与其相反的是默认的交互模式。当云行指令： mvn archetype:generate 没有任何参数时， Maven 会启用交互模式， 同时会列出所有已知的 ArcheType 供你选择。-DarchetypeGroupId=org.apache.maven.archetypes-DarchetypeArtifactId=maven-archetype-webapp-DarchetypeVersion=1.0? 以上三个参数指定了具体使用哪个 archetype 做为生成当前项目的模板-DgroupId=com.mycompany.webapp-DartifactId=myapp-Dversion=1.0? 以上三个参数指定了你要创建项目的 groupId 和 artifactId, version。如果你在模板（使用 velocity）文件中定义了其他变量，需要先在 archetype-metadata.xml 文件中指定，之后通过 -DvarName=value 的方式传入。详见下面的例子。?? 创建好了我们这个工程， 我们仅仅需要执行：
cd myappmvn package
?? 就能得到一个 myapp.war。
?? 使用 maven archetype 的好处显而易见，那就是快速创建工程，不需要一个个文件的创建， 更不许要去写很多 build 脚本。很多人喜欢用 ant + ivy 做为 build 的脚本，因为 ant 是 100% 自由，随意定义 target 和task， 而不像 Maven 给定死了很多 build 中的 phrase， 想做个扩展，还需要开发个 Mojo。但是， 当 Mojo 越来越多，你就发现 Maven 的价值了。 Ant 适合一个工程， 而 Maven 考虑的是一系列的工程。
?? 在上面的那个例子里，我使用的 archetype 是通过 archetypeGroupId, archetypeArtifactId, archetypeVersion 来指定的，那么我是怎么知道这个 archetype 呢？ 怎样才知道有哪些 Archetype 可以使用呢？这就需要 Archetype Catalog了。
? 我们上面提到过， 如果执行命令： mvn archetype:generate 不带参数的时候， Maven 会自动列出很多可用的 Archetype 供你选择， 这个列表实际上是从一个 XML 文件解析出来的， 叫做： archetype-catalog.xml, 默认是先后从： http://repo1.maven.org/maven2/archetype-catalog.xml, ~/.m2/repository/archetype-catalog.xml 获取。这个 archetype-catalog.xml 就是 archetype catalog， 其定义了当前 repository 里可用的 archetype 列表。我们大概看下这个 xml 文件的内容：
<?xml version="1.0" encoding="UTF-8"?><archetype-catalog> <archetypes> <archetype> <groupId>com.agilejava.docbkx</groupId> <artifactId>docbkx-quickstart-archetype</artifactId> <version>2.0.13</version> </archetype> ... <archetype> <groupId>org.apache.maven.archetypes</groupId> <artifactId>maven-archetype-webapp</artifactId> <version>1.0</version> <description>An archetype which contains a sample Maven Webapp project.</description> </archetype> ... </archetypes></archetype-catalog>
?
?其中：
<archetype> 定义一个 archetype<groupId> 定义 archetype 的 groupId<artifactId> 定义 archetype 的 artifactId<version> 定义 archetype 的 version<description> 说明了该 archetype 的用处。
??? 每个 Maven repository 都有自己的 archetype catalog 文件， 默认路经是： <Maven Repository URL>/archetype-catalog.xml。 在运行 mvn archetype:generate 的时候，我们可以通过指定 -DarchetypeCatalog=<Catalog Name or URL> 使用任意 Maven repository 下的 archetype-catalog。 Maven archetype plugin 还提供了几个 goals 用来更新本地的 archetype catalog。 具体请运行 mvn archetype:help 查看。
?
??? 虽然上面的例子很简单的创建了一个 webapp 的 war， 但是它过于简单了， 连个 servlet 都没有，也不是最新 Servlet 3 的规范。当已知的 archetype 不能满足你的要求的时候，你可以自己创建一个。
? 下面我们创建个 maven-archetype-webapp-servlet3 的 archetype 用来生成基于 Servlet 3 的简单的 webapp：
? 我们先看一下这个 archetype 的目录结构：
|-- pom.xml # 1`-- src `-- main `-- resources |-- archetype-resources # 2 | |-- pom.xml # 3 | `-- src | `-- main | |-- java | | `-- HelloWorldServlet.java | `-- webapp | |-- index.jsp | `-- WEB-INF | `-- web.xml `-- META-INF `-- maven # 2 `-- archetype-metadata.xml # 4?
? 其中：
? 我们主要看下 archetype-metadata.xml 总的内容：
<archetype-descriptor xmlns="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-descriptor/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-descriptor/1.0.0 http://maven.apache.org/xsd/archetype-descriptor-1.0.0.xsd" name="servlet 3 webapp" partial="false" > <requiredProperties> <requiredProperty key="description" > </requiredProperty> </requiredProperties> <fileSets> <fileSet filtered="true" packaged="true" encoding="UTF-8" > <directory>src/main/java/</directory> </fileSet> <fileSet filtered="true" packaged="false" encoding="UTF-8" > <directory>src/main/webapp/</directory> </fileSet> </fileSets></archetype-descriptor>
? ? 它的格式非常直白，requiredProperties/requiredProperty 指需要定义的属性名字， 可以有默认值，通过命令行中的 -DvarName=value 方式传入。在模板文件中 ${varName} 引用。 fileSets/fileSet 指定一个目录， 如果 filtered=true, 那么Maven把所有的文件作为 velocity 模板文件对待。 如果 packaged=true, 那么将会把该目录 copy 到项目的 package 对应的目录下。encoding=UTF-8 指定采用 UTF-8 编码。
? 其他文件内容，可以查看附件。
? 当我们建好了这个 archetype 后， 运行指令： mvn install 安装在本地的 repository 下， 就可以使用了。 因为 mvn archetype:generate 默认到 repo1.maven.org/maven2/ 上寻找 archetype, 我们需要额外增加一个参数：
-DarchetypeRepository=local, 整个的命令为：
mvn archetype:generate \ -B \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DarchetypeArtifactId=maven-archetype-webapp-servlet3 \ -DarchetypeVersion=1.0 \ -DarchetypeRepository=local \ -DgroupId=com.mycompany.webapp \ -DartifactId=myapp \ -Dversion=1.0 \ -Ddescription=Hello Servlet 3
? 之后运行： cd myapp; mvn package
? 如果本机正运行着 JBoss AS 7， 可以采用指令： ./jboss-admin.sh --connect --command="deploy .../target/myapp.war" 进行部署。非常简单快捷。
? 有关 JBoss AS 7 的文章， 推荐阅读 http://jbosscn.iteye.com
