创建 Ma ven 项目

使用 Ma ven Archetype 生成项目

Ma ven 自带项目模板（Archetype）机制。

用它可以很快搭出一套规范的项目目录结构。

实际使用里，最常见的就是 ma ven-archetype-quickstart。

它通常被当作基础 Ja va 项目的入门模板。

执行命令：

mvn archetype:generate 
    -DgroupId=com.example 
    -DartifactId=my-first-app 
    -DarchetypeArtifactId=ma ven-archetype-quickstart 
    -DinteractiveMode=false

参数说明：

参数	说明
-DgroupId	组织名（如公司域名倒写）
-DartifactId	项目名称（会成为项目文件夹名）
-DarchetypeArtifactId	使用的模板（quickstart 是基础 Ja va 项目）
-DinteractiveMode=false	非交互模式（避免手动确认）

执行后生成的项目结构：

my-first-app/
├── pom.xml           # Ma ven 项目配置文件
├── src/
│   ├── main/         # 主代码目录
│   │   └── ja va/     # Ja va 源代码
│   │       └── com/example/App.ja va  # 自动生成的示例类
│   └── test/        # 测试代码目录
│       └── ja va/     # 测试类
│           └── com/example/AppTest.ja va  # 自动生成的测试类

项目结构解析

pom.xml 详解

pom.xml 是 Ma ven 的核心配置文件。

它定义了项目的基本信息和依赖。

生成的 pom.xml 示例：

    
    4.0.0

    com.example
    my-first-app
    1.0-SNAPSHOT

    jar

    my-first-app
    http://www.example.com

    
        
        
            junit
            junit
            4.12
            test  
        
    

源代码结构

目录	作用
src/main/ja va	主 Ja va 源代码
src/main/resources	配置文件（如 application.properties）
src/test/ja va	测试代码
src/test/resources	测试资源文件

示例代码

主类 App.ja va

实例

package com.example;
public class App {
    public static void main(String[] args) {
        System.out.println("Hello Ma ven!");
    }
}

测试类 AppTest.ja va:

实例

package com.example;
import org.junit.Test;
import static org.junit.Assert.*;
public class AppTest {
    @Test
    public void testApp() {
        assertTrue(true);  // 示例测试
    }
}

构建与运行

常用 Ma ven 命令

命令	作用
mvn compile	编译源代码
mvn test	运行测试
mvn package	打包（生成 .jar 文件）
mvn install	安装到本地仓库（供其他项目依赖）
mvn clean	清理 target 目录

完整构建流程

1、编译项目：

mvn compile

编译后的 .class 文件会放在 target/classes 目录。

2、运行测试：

mvn test

执行 src/test/ja va 下的测试类。

测试报告生成在 target/surefire-reports。

3、打包：

mvn package

生成 target/my-first-app-1.0-SNAPSHOT.jar。

4、运行程序：

ja va -cp target/my-first-app-1.0-SNAPSHOT.jar com.example.App

5、输出：

Hello Ma ven!

扩展：修改项目

添加依赖

例如，添加 Gson 用于 JSON 处理。

修改 pom.xml：

    
    
        junit
        junit
        4.12
        test
    

    
        com.google.code.gson
        gson
        2.8.9
    

运行 mvn compile，Ma ven 会自动下载 Gson。

修改主类使用 Gson

实例

package com.example;
import com.google.gson.Gson;
public class App {
    public static void main(String[] args) {
        Gson gson = new Gson();
        String json = gson.toJson("Hello Ma ven with Gson!");
        System.out.println(json);
    }
}

重新打包并运行：

mvn package
ja va -cp target/my-first-app-1.0-SNAPSHOT.jar com.example.App

输出：

"Hello Ma ven with Gson!"

常见问题

依赖下载失败

原因：网络问题或仓库不可用。

解决方案：

• 检查网络连接。

• 配置国内镜像仓库（如阿里云）：

    aliyun
    https://ma ven.aliyun.com/repository/public
    central

阿里云仓库的相关说明可参考这里：https://developer.aliyun.com/mvn/guide。

编译版本问题

错误：ja vac: invalid target release: 11

解决方案：在 pom.xml 中指定 Ja va 版本：

    11
    11

总结

• 创建项目：mvn archetype:generate 生成标准结构。

• 项目结构：

  • pom.xml 定义依赖和配置。

  • src/main/ja va 放主代码，src/test/ja va 放测试代码。

• 构建命令：

  • mvn compile → mvn test → mvn package。

• 运行：ja va -jar 或 ja va -cp 执行 .jar 文件。