Maven之自定义archetype生成项目骨架(一)

今天药忘吃喽~ 2024-02-17 16:00 74阅读 0赞

**摘要**：使用过Maven的人都知道maven中有许多功能都是通过插件来提供的，今天我们来说一下其中的一个插件：maven-archetype-plugin，通过该插件可以自定义符合我们自己需求的archetype。

**一:什么是Archetype**

总之，原型是一个Maven项目模板工具包。一个原型被定义为从其中相同类型的所有其它事情是由一个原始图案或模型。名称配合，因为我们正在努力提供一种系统，该系统提供了一种生成Maven项目的一致的手段。原型将帮助作者为用户创建Maven项目模板，并为用户提供了手段，产生的这些项目模板参数化的版本。  
  
使用原型提供了一个很好的方式，迅速使开发人员在与您的项目或组织采用最佳实践一致的方法。在Maven的项目中，我们使用原型，试图让我们的用户和运行尽可能快地通过提供展示许多的Maven的功能，同时引入新的用户通过采用Maven的最佳实践的示例项目。在几秒钟内一个新的用户可以有一个工作Maven项目作为跳板用于调查更多的功能，Maven中。我们也试图使原型机制添加剂和由我们的意思是允许一个项目的一部分被捕获在一个原型，使得项目的部件或方面可以被添加到现有的项目。这方面的一个很好的例子是Maven站点原型。如果，例如，您使用的快速启动原型生成一个工作项目，你可以迅速通过使用现有项目中的网站原型创建网站的项目。你可以做这样的事与原型。  
  
您可能要在组织内部规范J2EE开发，所以你可能要提供原型为EJB，或者，或者您的Web服务的战争。一旦这些原型创建和部署在您的组织的资源库，他们都可以在组织内使用的所有开发人员。

上面是我根据maven官网在百度翻译出来的，大家将就着看，大概意思就是archetype是Maven项目模板工具包，也就是一个模板工程。

**二：使用archetype创建项目**

mvn archetype:generate

上面的命令执行后会输出很多maven官方提供的archetype，但是这些archetype生成的项目骨架都不能够满足我们的需求，所以这就需要我们自己开发一个archetype来满足我们自己的开发需求，下面我把我自己自定义这个archetype的过程记录一下方便日后回忆。

**三：创建自定义的archetype项目**

1.首先使用sts(spring的一款开发工具，下载地址到spring官网)创建一个maven project，然后把配置好的一些公用的东西放到相应的目录下面比如说会将一些常用的java代码存放到src/main/java目录下面；会将一些通用的配置文件放到src/main/resources目录下面；如果是javeEE工程，还会有一些jsp等等的文件存放到src/main/webapp目录下面，如下图所示:

![Center][]

2.然后在创建的maven project的pom.xml文件中添加archetype插件，如下面所示：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    	<modelVersion>4.0.0</modelVersion>
    
    	<parent>
    		<groupId>org.micaicms</groupId>
    		<artifactId>micaicms-pom</artifactId>
    		<version>1.0</version>
    	</parent>
    
    	<artifactId>micaicms-web-archetype</artifactId>
    	<packaging>jar</packaging>
    
    	<name>micaicms web archetype</name>
    	<description>micaicms-web-archetype</description>
    
    	<distributionManagement>
    		<repository>
    			<id>releases</id>
    			<name>Micaicms Releases</name>
    			<url>http://127.0.0.1:8081/nexus/content/repositories/releases/</url>
    		</repository>
    		<snapshotRepository>
    			<id>snapshots</id>
    			<name>Micaicms Releases</name>
    			<url>http://127.0.0.1:8081/nexus/content/repositories/snapshots/</url>
    		</snapshotRepository>
    	</distributionManagement>
    
    	<build>
    		<pluginManagement>
    			<plugins>
    				<plugin>
    					<groupId>org.apache.maven.plugins</groupId>
    					<artifactId>maven-archetype-plugin</artifactId>
    					<version>2.2</version>
    				</plugin>
    				<plugin>
    					<groupId>org.apache.maven.plugins</groupId>
    					<artifactId>maven-compiler-plugin</artifactId>
    					<configuration>
    						<source>1.5</source>
    						<target>1.5</target>
    					</configuration>
    				</plugin>
    				<plugin>
    					<groupId>org.apache.maven.plugins</groupId>
    					<artifactId>maven-resources-plugin</artifactId>
    					<configuration>
    						<encoding>UTF-8</encoding>
    					</configuration>
    				</plugin>
    			</plugins>
    		</pluginManagement>
    	</build>
    
    </project>

3.运行你自己配置好的自定义的archetype项目

先执行mvn clean install  
安装该archetype项目到你的本地仓库  
发布该archetype项目到你的本地私服(nexus)  
注意；这里如果你需要发布这个archetype到你的本地私服上去，那么需要在maven里面配置权限，主要是maven里面的settings.xml文件，我  
的settings.xml文件配置如下，配置好以后就可以执行发布命令了

![Center 1][]

再执行mvn deploy

4.查看你刚才发布到nexus私服上去的archetype，如下图：

![Center 2][]

**四：在eclipse/sts开发工具中配置你发布到私服上的自定义的archetype**

1.打开你的开发工具，eclipse或者sts，我这里是sts  
  
2.选择Window->Preferences->Maven->Archetypes

3.点击Add Remote Catalog，输入你的nexus私服中archetype的地址，我这里是  
http://127.0.0.1:8081/nexus/content/groups/public/archetype-catalog.xml  
输入Description，随便输入都可以，我这里是micaicms-web-archetype  
![Center 3][]  
  
4.点击Ok，点击Apply  
5.重新启动你的开发工具eclipse或者sts

**五：使用自定义的archetype生成自定义的项目骨架**

1.选择New->Maven Project->Next  
2.选择你配置好的archetype，如下图:

![Center 4][]

3.输入对应的groupId，artifactId，package，如下图：  
因为我已经新建过该项目了，所以我这里不能点击Finish，你们的应该可以

![Center 5][]

4.最后生成的项目骨架如下图:

![Center 6][]

5.修改数据库配置文件，导入初始化sql脚本，如下图：

![Center 7][]

6.部署项目到tomcat下面访问即可，默认的访问路径为：ht:tp://localhost:8080/micaicms-ssmb/project/list

**六：Maven的自定义archetype源码工程下载地址：**

[https://javaymw.com/post/83][https_javaymw.com_post_83]

**七：Maven的自定义archetype生成的基础项目骨架工程的下载地址：**

[https://github.com/sxdtzhaoxinguo/micaicms-ssmb][https_github.com_sxdtzhaoxinguo_micaicms-ssmb]

[Center]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/17435c00991b41fdbbfa2ff04b5a4dfa.png
[Center 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/8af54f74f92e47a5b9b4f6b49c74a2be.png
[Center 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/7a4909bebc1c4759a7d3f441b2c9a470.png
[Center 3]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/916f8d9e3e0d4696bd4b71da8bcd5db4.png
[Center 4]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/0d0e20c47e444df6a8f5407f665aa779.png
[Center 5]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/f937a85c63fd4995a31718278ae3579e.png
[Center 6]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/a783dbbb6d83425db5de6ead8a05f6d1.png
[Center 7]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/ef164c91a427450394fb40d8ebb43b3b.png
[https_javaymw.com_post_83]: https://javaymw.com/post/83
[https_github.com_sxdtzhaoxinguo_micaicms-ssmb]: https://github.com/sxdtzhaoxinguo/micaicms-ssmb