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

举报
码农小胖哥 发表于 2022/03/31 23:45:40 2022/03/31
【摘要】 基本每个公司的项目都有一套模板,只要开新项目直接复制一份改改包名和一些配置就初始化了一个新项目。这种方式有点繁琐,有没有通过命令甚至是可视化的方式从一个模板项目初始化项目。Maven其实有提供这种能力,这就是基于原型(Archetype)的生成项目。 集成项目模板插件 首先需要在模板项目中集成Maven原型插件: &nb...

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

集成项目模板插件

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


   
  1.             <plugin>
  2.                 <groupId>org.apache.maven.plugins</groupId>
  3.                 <artifactId>maven-archetype-plugin</artifactId>
  4.                 <version>3.2.0</version>
  5.             </plugin>

从项目生成模板

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

生成模板原型文件

Maven插件允许我们从已有项目生成一个模板项目。在项目根目录下执行mvn archetype:create-from-project命令即可将该项目生成一个项目模板,生成的项目原型被保存在路径target/generated-sources/archetype下。

但是这个存在一个问题,一些和项目模板源码无关的文件也会被加入模板中,比如IDEA中的.iml文件、.idea目录下的文件。这些“垃圾”文件需要在生成模板时被忽略。

maven-archetype-plugin提供了一个属性配置可以帮助我们实现该能力。在原始项目的根目录(或者你喜欢的其它目录)编写一个.properties文件:


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

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

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

  

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

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


   
  1. <groupId>cn.felord</groupId>
  2. <artifactId>template-archetype</artifactId>
  3. <version>1.0</version>
  4. <packaging>maven-archetype</packaging>
  5. <name>template-archetype</name>

安装生成的原型

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

安装原型库到本地

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


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

后续使用时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弹出对话框:

IDEA添加原型模板

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

命令行

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


   
  1. mvn archetype:generate \
  2.  -DgroupId=cn.felord.demo    \
  3.  -DartifactId=demo-project   \
  4.  -Dversion=1.0.0       \
  5.  -Dpackage=cn.felord.demo   \
  6.  -DarchetypeGroupId=cn.felord  \
  7.  -DarchetypeArtifactId=template-archetype  \
  8.  -DarchetypeVersion=1.0  \
  9.  -DinteractiveMode=false    

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

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


   
  1.   <repository>
  2.     <id>archetype</id>
  3.      <!-- 仓库地址 -->  
  4.     <url>https://repository.domain.com/path/to/repo/</url>
  5.   </repository>
  6.   
  7.   <!-- 仓库的认证信息 -->
  8.   <server>
  9.     <id>archetype</id>
  10.     <username>repousername</username>
  11.     <password>xxx.felord.cn</password>
  12.   </server>

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

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

2021-08-26

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

2021-08-24

文章来源: felord.blog.csdn.net,作者:码农小胖哥,版权归原作者所有,如需转载,请联系作者。

原文链接:felord.blog.csdn.net/article/details/120030366

【版权声明】本文为华为云社区用户转载文章,如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。