Maven Primer Proyecto

Crear un proyecto Maven

Generar un proyecto con Maven Archetype

Maven proporciona plantillas de proyecto (Archetype) que permiten generar rápidamente una estructura de proyecto estándar. La más utilizada es maven-archetype-quickstart (plantilla básica de proyecto Java).

Ejecutar el comando:

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

Descripción de parámetros:

Parámetro Descripción
-DgroupId Nombre de la organización (por ejemplo, el dominio de la empresa invertido)
-DartifactId Nombre del proyecto (se convierte en el nombre de la carpeta del proyecto)
-DarchetypeArtifactId Plantilla utilizada (quickstartes un proyecto Java básico)
-DinteractiveMode=false Modo no interactivo (evita la confirmación manual)

Estructura del proyecto generada tras la ejecución:

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

Análisis de la estructura del proyecto

Explicación detallada de pom.xml

Este es el archivo de configuración central de Maven, que define la información básica y las dependencias del proyecto.

Ejemplo del pom.xml generado:

<project>
    <!-- POM 模型版本,固定 4.0.0 -->
    <modelVersion>4.0.0</modelVersion>

    <!-- 项目坐标(唯一标识) -->
    <groupId>com.example</groupId>
    <artifactId>my-first-app</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!-- 项目打包方式(默认 jar,也可以是 war、pom 等) -->
    <packaging>jar</packaging>

    <!-- 项目名称和 URL(可选) -->
    <name>my-first-app</name>
    <url>http://www.example.com</url>

    <!-- 依赖管理 -->
    <dependencies>
        <!-- JUnit 测试依赖 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>  <!-- 仅用于测试 -->
        </dependency>
    </dependencies>
</project>

Estructura del código fuente

Directorio Función
src/main/java Código fuente principal de Java
src/main/resources Archivos de configuración (comoapplication.properties)
src/test/java Código de prueba
src/test/resources Archivos de recursos de prueba

Código de ejemplo:

Clase principal App.java

Ejemplo

package com.example;

public class App {
    public static void main(String[] args) {
        System.out.println("Hello Maven!");
    }
}

Clase de prueba AppTest.java:

Ejemplo

package com.example;

import org.junit.Test;
import static org.junit.Assert.*;

public class AppTest {
    @Test
    public void testApp() {
        assertTrue(true);  // Ejemplo de prueba
    }
}

Compilación y ejecución

Comandos Maven comunes

ComandoFunción
mvn compileCompilar el código fuente
mvn testEjecutar pruebas
mvn packageEmpaquetar (genera.jararchivo)
mvn installInstalar en el repositorio local (para que otros proyectos dependan de él)
mvn cleanLimpiartargetdirectorio

Flujo de compilación completo

1. Compilar el proyecto:

mvn compile

Los archivos .class compilados se colocan en el directorio target/classes.

2. Ejecutar pruebas:

mvn test

Ejecuta las clases de prueba en src/test/java.

El informe de pruebas se genera en target/surefire-reports.

3. Empaquetar:

mvn package

Genera target/my-first-app-1.0-SNAPSHOT.jar.

4. Ejecutar el programa:

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

5. Salida:

Hello Maven!

Extensión: modificar el proyecto

Agregar dependencias

Por ejemplo, agregarGsonpara procesamiento JSON:

Modificar pom.xml:

<dependencies>
    <!-- 原有 JUnit 依赖 -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
        <scope>test</scope>
    </dependency>

    <!-- 新增 Gson 依赖 -->
    <dependency>
        <groupId>com.google.code.gson</groupId>
        <artifactId>gson</artifactId>
        <version>2.8.9</version>
    </dependency>
</dependencies>

Ejecuta mvn compile y Maven descargará Gson automáticamente.

Modificar la clase principal para usar Gson

Ejemplo

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 Maven with Gson!");
        System.out.println(json);
    }
}

Volver a empaquetar y ejecutar:

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

Salida:

"Hello Maven with Gson!"

Preguntas frecuentes

Error al descargar dependencias

Causa: problemas de red o repositorio no disponible.

Solución:

Verificar la conexión de red.

Configurar un repositorio espejo nacional (como Alibaba Cloud):

<!-- 在 settings.xml 或 pom.xml 中配置 -->
<mirror>
    <id>aliyun</id>
    <url>https://maven.aliyun.com/repository/public</url>
    <mirrorOf>central</mirrorOf>
</mirror>

Introducción al repositorio de Alibaba Cloud:https://developer.aliyun.com/mvn/guide。

Problemas de versión de compilación

Error: javac: invalid target release: 11

Solución: especificar la versión de Java en pom.xml:

<properties>
    <maven.compiler.source>11</maven.compiler.source>
    <maven.compiler.target>11</maven.compiler.target>
</properties>

Resumen

  1. Crear un proyecto:mvn archetype:generateGenera una estructura estándar.

  2. Estructura del proyecto:

    • pom.xmlDefine dependencias y configuración.

    • src/main/javaColoca el código principal,src/test/javacoloca el código de prueba.

  3. Comando de compilación:

    • mvn compile → mvn test → mvn package。

  4. Ejecutar:java -jarojava -cpEjecutar.jararchivo.

Otras extensiones