Механизм зависимостей Maven
Механизм зависимостей Maven — одна из ключевых функций инструмента сборки Apache Maven. Он может автоматически загружать и управлять внешними библиотеками (JAR-файлами), необходимыми проекту, и их зависимостями.
Механизм зависимостей Maven значительно упрощает процесс сборки проектов Java, позволяя разработчикам избежать ручной загрузки и управления различными сторонними библиотеками.
Maven хранит миллионы библиотек с открытым исходным кодом в Maven Central Repository. Когда вы объявляете зависимость в проекте, Maven автоматически загружает эту библиотеку и все её зависимости из репозитория.
Объявление зависимости
Объявите её в pom.xml с помощью тега <dependency>:
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
</dependencies>
Основные понятия зависимостей Maven
1. Система координат (координаты)
Maven использует три базовые координаты для однозначной идентификации зависимости:
- groupId: Определяет организацию или компанию, которой принадлежит проект (например,
org.apache) - artifactId: Определяет имя проекта (например,
commons-lang3) - version: Определяет версию проекта (например,
3.12.0)
Вместе эти три элемента образуют уникальный идентификатор зависимости Maven.
2. Область видимости зависимости
Maven определяет различные области видимости зависимостей, которые определяют, на каких этапах зависимость доступна:
- compile(по умолчанию): Доступна при компиляции, тестировании и во время выполнения
- provided: Доступна во время компиляции и тестирования, но предоставляется JDK или контейнером во время выполнения
- runtime: Нужна только при тестировании и во время выполнения
- test: Нужна только во время компиляции и выполнения тестов
- system: Аналогична provided, но требует явного пути к JAR
3. Транзитивные зависимости
Когда проект A зависит от проекта B, а проект B зависит от проекта C, Maven автоматически добавляет проект C как зависимость проекта A. Эта функция автоматической обработки зависимостей называется транзитивными зависимостями.
Правила транзитивности зависят от области видимости (Scope):
| Текущая область видимости зависимости \ Область видимости транзитивной зависимости | compile | provided | runtime | test |
|---|---|---|---|---|
| compile | compile | - | runtime | - |
| provided | provided | provided | provided | - |
| runtime | runtime | - | runtime | - |
| test | - | - | - | - |
Как использовать зависимости Maven в проектах
1. Добавление зависимостей в pom.xml
Вpom.xmlфайле Maven-проекта,<dependencies>раздел используется для объявления зависимостей проекта:
Пример
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.12.0</version>
</dependency>
</dependencies>
2. Исключения зависимостей
Иногда может потребоваться исключить транзитивную зависимость; можно использовать<exclusions>тег:
Пример
<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. Управление зависимостями
В многомодульных проектах можно использовать в родительском POM<dependencyManagement>для единообразного управления версиями зависимостей:
Пример
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>5.3.20</version>
</dependency>
</dependencies>
</dependencyManagement>
Когда дочерние модули ссылаются на зависимости, им нужно только объявить groupId и artifactId, не указывая версию.
Расширенные возможности управления зависимостями
Управление версиями зависимостей
ИспользуйтеdependencyManagementдля единообразного управления версиями:
<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>
Импорт BOM
Управление версиями набора связанных зависимостей:
<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>
Необязательные зависимости
Пометить зависимости как необязательные и нетранзитивные:
<dependency>
<groupId>com.example</groupId>
<artifactId>optional-lib</artifactId>
<version>1.0</version>
<optional>true</optional>
</dependency>
Механизм разрешения зависимостей Maven
1. Разрешение конфликтов зависимостей
Когда возникают конфликты версий, Maven разрешает их по следующим правилам:
- Ближайшее определение выигрывает (выбирается версия с кратчайшим путём в дереве зависимостей)
- Если длина пути одинакова, приоритет имеет зависимость, объявленная первой.
2. Влияние области действия зависимости
Зависимости с разными областями действия влияют на транзитивность:
- зависимости с областью действия compile являются транзитивными
- зависимости с областями действия provided и test не являются транзитивными
- зависимости с областью действия runtime являются транзитивными с областью действия runtime
Итоговые результаты упаковки зависимостей с разными областями действия:
| Область действия | Включается ли в пакет | Типичное использование |
|---|---|---|
compile | Да | Основные зависимости |
provided | нет | Предоставляется контейнером |
runtime | Да | Требуется во время выполнения |
test | нет | Модульные тесты |
3. Необязательные зависимости
Зависимости, помеченные как необязательные, не являются транзитивными:
Пример
<groupId>com.example</groupId>
<artifactId>optional-lib</artifactId>
<version>1.0</version>
<optional>true</optional>
</dependency>
Команды, связанные с зависимостями
Просмотр дерева зависимостей:
mvn dependency:tree
Анализ проблем с зависимостями:
mvn dependency:analyze
Загрузка зависимостей в каталог:
mvn dependency:copy-dependencies
Репозиторий Maven
1. Типы репозиториев
- Локальный репозиторий: Расположен в домашнем каталоге пользователя в
.m2/repositoryкаталога - Центральный репозиторий: Публичный репозиторий Maven по умолчанию
- Удалённый репозиторий: Приватный репозиторий, созданный компанией или организацией
2. Конфигурация репозитория
Вы можете настроить вpom.xmlилиsettings.xmlнастройте репозиторий:
Пример
<repository>
<id>my-repo</id>
<url>http://repo.example.com/maven2</url>
</repository>
</repositories>
Лучшие практики
- Явно указывайте версии зависимостей: избегайте использования динамических версий, таких как LATEST или RELEASE
- Регулярно обновляйте зависимости: Используйте
mvn versions:display-dependency-updatesдля проверки доступных обновлений - Используйте BOM: Для больших фреймворков (например, Spring) используйте спецификацию состава для единообразного управления версиями
- Очищайте неиспользуемые зависимости: Регулярно запускайте
mvn dependency:analyzeдля проверки неиспользуемых зависимостей