使用Maven Archetype插件快速生成Java项目脚手架 java

![]()
基本每个公司的项目都有一套模板，只要开新项目直接复制一份改改包名和一些配置就初始化了一个新项目。这种方式有点繁琐，有没有通过命令甚至是可视化的方式从一个模板项目初始化项目。Maven其实有提供这种能力，这就是基于原型（Archetype）的生成项目。
集成项目模板插件首先需要在模板项目中集成Maven原型插件：

org.apache.maven.plugins maven-archetype-plugin 3.2.0

从项目生成模板从项目生成模板只需要三步。
生成模板原型文件
Maven插件允许我们从已有项目生成一个模板项目。在项目根目录下执行mvn archetype:create-from-project命令即可将该项目生成一个项目模板，生成的项目原型被保存在路径target/generated-sources/archetype下。
但是这个存在一个问题，一些和项目模板源码无关的文件也会被加入模板中，比如IDEA中的.iml文件、.idea目录下的文件。这些“垃圾”文件需要在生成模板时被忽略。
maven-archetype-plugin提供了一个属性配置可以帮助我们实现该能力。在原始项目的根目录（或者你喜欢的其它目录）编写一个.properties文件：

# 原型的坐标必须声明 archetype.groupId=cn.felord # 最好按照约定以-archetype结尾 archetype.artifactId=template-archetype archetype.version=1.0 # 需要忽略的文件夹和文件类型英文逗号隔开 excludePatterns=**/.idea/**,**/*.iml

这时候执行生成的命令就需要指定该配置文件了：

mvn archetype:create-from-project -Darchetype.properties=./archetype.properties

注意：路径为配置文件和根目录的相对路径。

这样生成的原型就忽略掉那些无用的文件了。细心的同学会发现生成原型中的pom.xml的坐标变成了：

cn.felord template-archetype 1.0maven-archetypetemplate-archetype

安装生成的原型
我们需要跳转的target/generated-sources/archetype下执行mvn install

文章图片

在我们本地maven repository目录（通常是~/.m2）下会把当前原型注册到archetype-catalog.xml中：

cn.felord template-archetype 1.0 spring security learning demo

后续使用时maven会从这里检索我们本地的模板。
利用原型生成项目
接下来验证一下效果，从本地原型生成项目需要执行：

mvn archetype:generate -DarchetypeCatalog=local

文章图片

然后一个新项目就诞生了。
分享模板模板分享基于Maven远程仓库，首先你要在你的setting.xml中配置一个远程仓库并且拥有deploy的权限。然后在target/generated-sources/archetype下执行mvn deploy就行了。这里有两种方式来使用远程的原型模版。
IDEA添加Maven原型模板
点击New Project然后选择Maven，勾选Create from archetype点击Add Archetype弹出对话框：

文章图片

然后模板就被添加到模板列表了，选中添加的模板点击下一步就可以使用了。
命令行
就像使用本地原型创建项目一样，这里给你一套命令执行就可以了：

mvn archetype:generate \ -DgroupId=cn.felord.demo\ -DartifactId=demo-project\ -Dversion=1.0.0\ -Dpackage=cn.felord.demo\ -DarchetypeGroupId=cn.felord\ -DarchetypeArtifactId=template-archetype\ -DarchetypeVersion=1.0\ -DinteractiveMode=false