Mecanismo de dependencias de Maven
El mecanismo de dependencias de Maven es una de las funciones principales de la herramienta de compilación Apache Maven. Permite descargar y gestionar automáticamente las bibliotecas externas (archivos JAR) requeridas por el proyecto y sus relaciones de dependencia.
El mecanismo de dependencias de Maven simplifica enormemente el proceso de compilación de proyectos Java, liberando a los desarrolladores de la necesidad de descargar y gestionar manualmente diversas bibliotecas de terceros.
Maven almacena millones de bibliotecas de código abierto a través del repositorio central (Maven Central Repository). Cuando declaras una dependencia en tu proyecto, Maven descarga automáticamente esa biblioteca y todas sus dependencias desde el repositorio.
Declaración de dependencias
En pom.xml se declara mediante la etiqueta <dependency>:
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
</dependencies>
Conceptos básicos de las dependencias de Maven
1. Sistema de coordenadas (Coordinates)
Maven utiliza tres coordenadas básicas para identificar de forma única una dependencia:
- groupId: define la organización o empresa a la que pertenece el proyecto (por ejemplo
org.apache) - artifactId: define el nombre del proyecto (por ejemplo
commons-lang3) - version: define la versión del proyecto (por ejemplo
3.12.0)
La combinación de estos tres elementos forma el identificador único de la dependencia de Maven.
2. Alcance de dependencia (Scope)
Maven define diferentes alcances de dependencia, que determinan en qué fases está disponible la dependencia:
- compile(por defecto): disponible en compilación, pruebas y ejecución
- provided: disponible en compilación y pruebas, pero en tiempo de ejecución lo proporciona el JDK o el contenedor
- runtime: solo se necesita en pruebas y en tiempo de ejecución
- test: solo se necesita en la compilación y ejecución de pruebas
- system: similar a provided, pero se debe especificar explícitamente la ruta del JAR
3. Dependencias transitivas (Transitive Dependencies)
Cuando el proyecto A depende del proyecto B, y el proyecto B a su vez depende del proyecto C, Maven introduce automáticamente el proyecto C como dependencia del proyecto A. Esta característica de manejo automático de dependencias se denomina dependencia transitiva.
Las reglas de transmisión dependen del Scope:
| Scope de dependencia actual \ Scope de dependencia transitiva | compile | provided | runtime | test |
|---|---|---|---|---|
| compile | compile | - | runtime | - |
| provided | provided | provided | provided | - |
| runtime | runtime | - | runtime | - |
| test | - | - | - | - |
Cómo utilizar dependencias de Maven en el proyecto
1. Agregar dependencias en pom.xml
En el proyecto Mavenpom.xmlen el archivo,<dependencies>la sección se utiliza para declarar dependencias del proyecto:
Ejemplo
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.12.0</version>
</dependency>
</dependencies>
2. Exclusión de dependencias (Exclusions)
A veces puede ser necesario excluir una dependencia transitiva, se puede utilizar<exclusions>la etiqueta:
Ejemplo
<groupId>com.example</groupId>
<artifactId>example-library</artifactId>
<version>1.0</version>
<exclusions>
<exclusion>
<groupId>org.unwanted</groupId>
<artifactId>unwanted-dependency</artifactId>
</exclusion>
</exclusions>
</dependency>
3. Gestión de dependencias (Dependency Management)
En proyectos multimódulo, se puede utilizar en el POM padre<dependencyManagement>para gestionar de manera unificada las versiones de dependencias:
Ejemplo
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>5.3.20</version>
</dependency>
</dependencies>
</dependencyManagement>
Al hacer referencia en un submódulo, solo es necesario declarar groupId y artifactId, sin especificar la versión.
Características avanzadas de la gestión de dependencias
Gestión de versiones de dependencias
UsardependencyManagementpara gestionar versiones de manera uniforme:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>5.3.18</version>
</dependency>
</dependencies>
</dependencyManagement>
<!-- 子模块使用时无需指定版本 -->
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
</dependency>
</dependencies>
Importación de BOM
Gestionar las versiones de un conjunto de dependencias relacionadas:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>2.6.4</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
Dependencias opcionales (Optional)
Marca la dependencia como opcional; no se transmite:
<dependency>
<groupId>com.example</groupId>
<artifactId>optional-lib</artifactId>
<version>1.0</version>
<optional>true</optional>
</dependency>
Mecanismo de resolución de dependencias de Maven
1. Mediación de dependencias (Dependency Mediation)
Cuando surgen conflictos de versiones, Maven utiliza las siguientes reglas para resolverlos:
- Prioridad a la definición más cercana (se selecciona la versión con la ruta más corta en el árbol de dependencias)
- Si la longitud de la ruta es la misma, la dependencia declarada primero tiene prioridad
2. Influencia del alcance de la dependencia
Las dependencias con diferentes alcances afectan la transitividad:
- Las dependencias de alcance compile se transmiten
- Las dependencias de alcance provided y test no se transmiten
- Las dependencias de alcance runtime se transmiten con alcance runtime
Resultado del empaquetado final de dependencias con diferentes Scope:
| Scope | ¿Se empaqueta? | Aplicación típica |
|---|---|---|
compile | Sí | Dependencia central |
provided | no | Proporcionada por el contenedor |
runtime | Sí | Necesaria en tiempo de ejecución |
test | no | Pruebas unitarias |
3. Dependencias opcionales (Optional Dependencies)
Las dependencias marcadas como optional no se transmiten:
Ejemplo
<groupId>com.example</groupId>
<artifactId>optional-lib</artifactId>
<version>1.0</version>
<optional>true</optional>
</dependency>
Comandos relacionados con dependencias
Ver el árbol de dependencias:
mvn dependency:tree
Analizar problemas de dependencias:
mvn dependency:analyze
Descargar dependencias a un directorio:
mvn dependency:copy-dependencies
Repositorio de Maven (Repository)
1. Tipos de repositorios
- Repositorio local: ubicado en el directorio principal del usuario
.m2/repositorydirectorio - Repositorio central: el repositorio público predeterminado de Maven
- Repositorio remoto: repositorio privado creado por una empresa u organización
2. Configuración del repositorio
Se puedenpom.xmlosettings.xmlconfigurar repositorios en:
Ejemplo
<repository>
<id>my-repo</id>
<url>http://repo.example.com/maven2</url>
</repository>
</repositories>
Mejores prácticas
- Especifica explícitamente la versión de la dependencia: evita usar versiones dinámicas como LATEST o RELEASE
- Actualiza las dependencias periódicamente: usa
mvn versions:display-dependency-updatespara comprobar las actualizaciones disponibles - Usa BOM: para frameworks grandes (como Spring), usa Bill of Materials para gestionar versiones de manera uniforme
- Limpia las dependencias innecesarias: ejecuta periódicamente
mvn dependency:analyzepara comprobar dependencias no utilizadas