Механизм зависимостей 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):

Текущая область видимости зависимости \ Область видимости транзитивной зависимостиcompileprovidedruntimetest
compilecompile-runtime-
providedprovidedprovidedprovided-
runtimeruntime-runtime-
test----

Как использовать зависимости Maven в проектах

1. Добавление зависимостей в pom.xml

Вpom.xmlфайле Maven-проекта,<dependencies>раздел используется для объявления зависимостей проекта:

Пример

<dependencies>
    <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-lang3</artifactId>
        <version>3.12.0</version>
    </dependency>
</dependencies>

2. Исключения зависимостей

Иногда может потребоваться исключить транзитивную зависимость; можно использовать<exclusions>тег:

Пример

<dependency>
    <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>для единообразного управления версиями зависимостей:

Пример

<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 разрешает их по следующим правилам:

  1. Ближайшее определение выигрывает (выбирается версия с кратчайшим путём в дереве зависимостей)
  2. Если длина пути одинакова, приоритет имеет зависимость, объявленная первой.

2. Влияние области действия зависимости

Зависимости с разными областями действия влияют на транзитивность:

  • зависимости с областью действия compile являются транзитивными
  • зависимости с областями действия provided и test не являются транзитивными
  • зависимости с областью действия runtime являются транзитивными с областью действия runtime

Итоговые результаты упаковки зависимостей с разными областями действия:

Область действияВключается ли в пакетТипичное использование
compileДаОсновные зависимости
providedнетПредоставляется контейнером
runtimeДаТребуется во время выполнения
testнетМодульные тесты

3. Необязательные зависимости

Зависимости, помеченные как необязательные, не являются транзитивными:

Пример

<dependency>
    <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настройте репозиторий:

Пример

<repositories>
    <repository>
        <id>my-repo</id>
        <url>http://repo.example.com/maven2</url>
    </repository>
</repositories>

Лучшие практики

  1. Явно указывайте версии зависимостей: избегайте использования динамических версий, таких как LATEST или RELEASE
  2. Регулярно обновляйте зависимости: Используйтеmvn versions:display-dependency-updatesдля проверки доступных обновлений
  3. Используйте BOM: Для больших фреймворков (например, Spring) используйте спецификацию состава для единообразного управления версиями
  4. Очищайте неиспользуемые зависимости: Регулярно запускайтеmvn dependency:analyzeдля проверки неиспользуемых зависимостей
Другие расширения