Maven Archetype 是什么？如何使用和自定义 Archetype？

Maven Archetype（原型）是 Maven 提供的项目模板机制，用于快速创建标准化的项目结构。Archetype 定义了项目的基本结构、默认配置和初始代码，开发者可以基于原型快速创建新项目。

Archetype 的作用：

1. 标准化项目结构，确保团队使用一致的项目布局
2. 减少重复配置，提高项目创建效率
3. 提供最佳实践模板，帮助新手快速上手
4. 支持自定义原型，满足特定项目需求

常用 Archetype：

1. maven-archetype-quickstart：创建简单的 Java 项目

bash
mvn archetype:generate \
  -DgroupId=com.example \
  -DartifactId=my-project \
  -DarchetypeArtifactId=maven-archetype-quickstart \
  -DinteractiveMode=false

1. maven-archetype-webapp：创建 Web 应用项目

bash
mvn archetype:generate \
  -DgroupId=com.example \
  -DartifactId=my-webapp \
  -DarchetypeArtifactId=maven-archetype-webapp \
  -DinteractiveMode=false

1. spring-boot-starter-parent：创建 Spring Boot 项目

bash
mvn archetype:generate \
  -DgroupId=com.example \
  -DartifactId=spring-boot-app \
  -DarchetypeGroupId=org.springframework.boot \
  -DarchetypeArtifactId=spring-boot-starter-parent \
  -DarchetypeVersion=2.7.0 \
  -DinteractiveMode=false

Archetype 命令参数：

• -DgroupId：项目组 ID
• -DartifactId：项目构件 ID
• -Dversion：项目版本号
• -Dpackage：基础包名
• -DarchetypeGroupId：原型组 ID
• -DarchetypeArtifactId：原型构件 ID
• -DarchetypeVersion：原型版本号
• -DinteractiveMode：是否交互模式

交互式创建项目：

bash
mvn archetype:generate

Maven 会列出可用的原型，开发者可以选择并输入项目信息。

自定义 Archetype：

1. 创建 Archetype 项目：

bash
mvn archetype:generate \
  -DgroupId=com.example \
  -DartifactId=my-archetype \
  -DarchetypeArtifactId=maven-archetype-archetype \
  -DinteractiveMode=false

1. 配置 Archetype 描述文件（archetype-metadata.xml）：

xml
<archetype-descriptor>
    <requiredProperties>
        <requiredProperty key="groupId">
            <defaultValue>com.example</defaultValue>
        </requiredProperty>
        <requiredProperty key="artifactId">
            <defaultValue>my-project</defaultValue>
        </requiredProperty>
    </requiredProperties>
    <fileSets>
        <fileSet filtered="true" packaged="true">
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.java</include>
            </includes>
        </fileSet>
    </fileSets>
</archetype-descriptor>

1. 安装自定义 Archetype：

bash
mvn clean install

1. 使用自定义 Archetype：

bash
mvn archetype:generate \
  -DarchetypeGroupId=com.example \
  -DarchetypeArtifactId=my-archetype \
  -DarchetypeVersion=1.0.0

Archetype Catalog： Archetype Catalog 是原型的索引文件，可以本地或远程托管：

• 本地 Catalog：~/.m2/archetype-catalog.xml
• 远程 Catalog：通过 URL 访问

最佳实践：

• 为团队创建统一的 Archetype，确保项目结构一致
• 在 Archetype 中包含常用的依赖和插件配置
• 使用参数化配置，提高 Archetype 的灵活性
• 定期更新 Archetype，反映最新的最佳实践
• 在 CI/CD 流程中使用 Archetype 自动化项目创建

Maven Archetype 是提高团队开发效率和项目标准化的重要工具。