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
public class App {
public static void main(String[] args) {
System.out.println("Hello Maven!");
}
}
Clase de prueba AppTest.java:
Ejemplo
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
| Comando | Función |
|---|---|
mvn compile | Compilar el código fuente |
mvn test | Ejecutar pruebas |
mvn package | Empaquetar (genera.jararchivo) |
mvn install | Instalar en el repositorio local (para que otros proyectos dependan de él) |
mvn clean | Limpiartargetdirectorio |
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
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
Crear un proyecto:
mvn archetype:generateGenera una estructura estándar.Estructura del proyecto:
pom.xmlDefine dependencias y configuración.src/main/javaColoca el código principal,src/test/javacoloca el código de prueba.
Comando de compilación:
mvn compile→mvn test→mvn package。
Ejecutar:
java -jarojava -cpEjecutar.jararchivo.