架构师必备技能:Maven Archetype生成项目模板

待我称王封你为后i 2022-09-09 11:59 197阅读 0赞

![5394d82b08125b6d4584e1dc35b08a47.gif][]

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

## 集成项目模板插件 ##

首先需要在模板项目中集成Maven原型插件：

<plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-archetype-plugin</artifactId>
                    <version>3.2.0</version>
                </plugin>

## 从项目生成模板 ##

从项目生成模板只需要三步。

### 生成模板原型文件 ###

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`的坐标变成了：

<groupId>cn.felord</groupId>
    <artifactId>template-archetype</artifactId>
    <version>1.0</version>
    <packaging>maven-archetype</packaging>
    
    <name>template-archetype</name>

### 安装生成的原型 ###

我们需要跳转的`target/generated-sources/archetype`下执行`mvn install`

![ada152945951370090911c050cced20d.png][] 安装原型库到本地

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

<?xml version="1.0" encoding="UTF-8"?>
    <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"
        xmlns="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-catalog/1.0.0"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <archetypes>
        <archetype>
          <groupId>cn.felord</groupId>
          <artifactId>template-archetype</artifactId>
          <version>1.0</version>
          <description>spring security learning demo</description>
        </archetype>
      </archetypes>
    </archetype-catalog>

后续使用时maven会从这里检索我们本地的模板。

### 利用原型生成项目 ###

接下来验证一下效果，从本地原型生成项目需要执行：

mvn archetype:generate -DarchetypeCatalog=local

![b955ff61b105f0b6d456541f647d0fb7.png][] 创建项目步骤都在这里

然后一个新项目就诞生了。

## 分享模板 ##

模板分享基于Maven远程仓库，首先你要在你的`setting.xml`中配置一个远程仓库并且拥有**deploy**的权限。然后在`target/generated-sources/archetype`下执行`mvn deploy`就行了。这里有两种方式来使用远程的原型模版。

### IDEA添加Maven原型模板 ###

点击**New Project**然后选择**Maven**，勾选**Create from archetype**点击**Add Archetype**弹出对话框：

![26ef9b6ec6ede7de5a19c8f23fca64fc.png][] IDEA添加原型模板

然后模板就被添加到模板列表了，选中添加的模板点击**下一步**就可以使用了。

### 命令行 ###

就像使用本地原型创建项目一样，这里给你一套命令执行就可以了：

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

> ❝
> 
> 如果你想通过交互命令生成，就把前三个选项和最后一个`DinteractiveMode`去掉试试。

不要忘了把下面的远程仓库配置到`setting.xml`;

<repository>
        <id>archetype</id>
           
        <url>https://repository.domain.com/path/to/repo/</url>
      </repository>
      
      
      <server>
        <id>archetype</id>
        <username>repousername</username>
        <password>xxx.felord.cn</password>
      </server>

项目模版生成在项目研发中很重要，可以让我们的项目能保持一致性，也方便后续转微服务或者维护升级，是每一个立志成为Java架构师的开发者必备的一个技能。

![46a8cdd590a0ea58533eb822ebeef1ee.png][]

[如果你使用了这个Stream流操作，升级Java17有可能会出问题。][Stream_Java17]

[2021-08-26][Stream_Java17]

[![4f0f0c1914857ebb545f5d411d8a2c57.png][] ][Stream_Java17]

[这段代码我猜76.85%的Java程序员都看不懂][76.85_Java]

[2021-08-24][76.85_Java]

[![306c13ddc29373010d226afc153a20ff.png][] ][76.85_Java]

![14657afac5181468316b133af6f2525b.gif][]

[5394d82b08125b6d4584e1dc35b08a47.gif]: /images/20220829/d9bc44c496254a83847bfe096437166b.png
[ada152945951370090911c050cced20d.png]: /images/20220829/be46d7124d894ce5ac23b6a4d36ab379.png
[b955ff61b105f0b6d456541f647d0fb7.png]: /images/20220829/be9a44f5daac49fe874b85c2fd00185b.png
[26ef9b6ec6ede7de5a19c8f23fca64fc.png]: /images/20220829/f25587692c0d41699d0e59b1213aa703.png
[46a8cdd590a0ea58533eb822ebeef1ee.png]: /images/20220829/7bf473fb179e410798b8c17576aabf78.png
[Stream_Java17]: http://mp.weixin.qq.com/s?__biz=MzUzMzQ2MDIyMA%3D%3D&chksm=faa2fa16cdd573005ce53f73eb7e60f1e83254978200797b9d16ebfade518fef358373636ee5&idx=1&mid=2247491461&scene=21&sn=936e54f65754f7b3c70e815d08365574#wechat_redirect
[4f0f0c1914857ebb545f5d411d8a2c57.png]: /images/20220829/4e578f2013f0435ca064215ee31d71e2.png
[76.85_Java]: http://mp.weixin.qq.com/s?__biz=MzUzMzQ2MDIyMA%3D%3D&chksm=faa2fac4cdd573d25619bab656610afe1bae93d3562f68d31b65c959313cef3e2a3b80797278&idx=1&mid=2247491415&scene=21&sn=899a932bdf9a7fea13f0e432c3dbc312#wechat_redirect
[306c13ddc29373010d226afc153a20ff.png]: /images/20220829/cd112c4c9cb34b4b9b6169901df6a023.png
[14657afac5181468316b133af6f2525b.gif]: /images/20220829/ad32c11a6b294c96ad316777f0e87593.png