Импорт POM в управлении зависимостями - PullRequest
Новая
       38

Импорт POM в управлении зависимостями

1 голос
/ 28 апреля 2019

Чтение из документа ,

  1. Не пытайтесь импортировать pom, определенный в подмодуле текущего pom. Попытка сделать это приведет к сборке сбой, так как он не сможет найти пом.
  2. Никогда не объявляйте pom, импортирующий pom, в качестве родителя (или прародителя и т. Д.) Целевого pom. Там нет никакого способа решить округлость и исключение будут выброшены.
  3. При обращении к артефактам, чьи компоненты имеют транзитивные зависимости, проекту необходимо будет указать версии этих артефактов как управляемые зависимости. Невыполнение этого требования приведет к сбою сборки поскольку у артефакта не может быть указана версия. (Это должно быть считается наилучшей практикой в ​​любом случае, поскольку она сохраняет версии артефакты от перехода от одной сборки к другой).

У меня есть следующие сомнения:

а) Что означает пункт 3?

б) Почему в 1-м пункте maven не может найти подмодуль pom? Разве субмодуль не собирается до родителя?

В пункте 3 мне нужно больше ясности по ...When referring to artifacts whose poms have transitive dependencies the project will need to specify versions of those artifacts as managed dependencies....

Итак, допустим, у нас есть project A, который мы будем импортировать в нашем разделе project B <dependencyManagement>. Теперь люди, создавшие проект A, должны упомянуть версии всех транзитивных зависимостей (не прямых) проекта A в разделе <dependencyManagement>? Как кто-нибудь может знать эти версии для всех переходных зависимостей проекта A?

У меня возникло еще одно сомнение по поводу пункта 1. Я создал в основном скелетный проект с супермодулем и субмодулем, практически без кода Java. Я поэтому поделюсь их poms. Мы увидим, что сборка прошла успешно, а это не должно быть в соответствии с пунктом 1.

Структура проекта выглядит следующим образом:

enter image description here

Пом супер-модуль выглядит следующим образом: 

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.home</groupId>
    <artifactId>my-project</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>

    <name>my-project</name>
    <url>http://www.example.com</url>

    <modules>
        <module>./sub-module1/pom.xml</module>
    </modules>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.7</maven.compiler.source>
        <maven.compiler.target>1.7</maven.compiler.target>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.home</groupId>
                <artifactId>sub-module1</artifactId>
                <version>1.0-SNAPSHOT</version>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>


    <licenses>
        <license>
            <name>The Apache Software License, Version 2.0</name>
            <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
            <distribution>repo</distribution>
        </license>
    </licenses>


    <build>
        <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
            <plugins>
                <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
                <plugin>
                    <artifactId>maven-clean-plugin</artifactId>
                    <version>3.1.0</version>
                </plugin>
                <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
                <plugin>
                    <artifactId>maven-resources-plugin</artifactId>
                    <version>3.0.2</version>
                </plugin>
                <plugin>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.8.0</version>
                </plugin>
                <plugin>
                    <artifactId>maven-surefire-plugin</artifactId>
                    <version>2.22.1</version>
                </plugin>
                <plugin>
                    <artifactId>maven-jar-plugin</artifactId>
                    <version>3.0.2</version>
                </plugin>
                <plugin>
                    <artifactId>maven-install-plugin</artifactId>
                    <version>2.5.2</version>
                </plugin>
                <plugin>
                    <artifactId>maven-deploy-plugin</artifactId>
                    <version>2.8.2</version>
                </plugin>
                <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
                <plugin>
                    <artifactId>maven-site-plugin</artifactId>
                    <version>3.7.1</version>
                </plugin>
                <plugin>
                    <artifactId>maven-project-info-reports-plugin</artifactId>
                    <version>3.0.0</version>
                </plugin>

            </plugins>
        </pluginManagement>
    </build>
</project>

Пом для подмодуля выглядит следующим образом: 

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.home</groupId>
    <artifactId>sub-module1</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>


    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
                <version>3.8.1</version>
            </dependency>
        </dependencies>
    </dependencyManagement>


    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
        </dependency>
    </dependencies>

</project>

Когда я делаю mvn clean compile, он прекрасно работает.

Кроме того, я вижу, что даже если тип упаковки pom подмодуля будет сохранен как jar, импорт области действия не выдает ошибку. Он все равно прекрасно компилируется.

Для будущих читателей я обобщу ответ. Обе точки 1 и 2 верны, но это даст ошибку только тогда, когда POM1 (родительский или супермодуль) импортирует POM2 (субмодуль или дочерний модуль), а затем POM2 требуется POM1 для разрешения зависимостей.

В пункте 1 это не будет найдено. В пункте 2 он будет найден из-за наследования, но создаст цикл.

Ниже я привожу пример, чтобы люди могли проверить.

Супер модуль ПОМ 

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.home</groupId>
    <artifactId>my-project</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>

    <name>my-project</name>
    <url>http://www.example.com</url>

    <modules>
        <module>./sub-module1/pom.xml</module>
    </modules>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.7</maven.compiler.source>
        <maven.compiler.target>1.7</maven.compiler.target>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.home</groupId>
                <artifactId>sub-module1</artifactId>
                <version>1.0-SNAPSHOT</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <dependency>
                <groupId>org.jsoup</groupId>
                <artifactId>jsoup</artifactId>
                <version>1.8.3</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
        </dependency>
    </dependencies>


    <licenses>
        <license>
            <name>The Apache Software License, Version 2.0</name>
            <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
            <distribution>repo</distribution>
        </license>
    </licenses>


    <build>
        <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
            <plugins>
                <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
                <plugin>
                    <artifactId>maven-clean-plugin</artifactId>
                    <version>3.1.0</version>
                </plugin>
                <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
                <plugin>
                    <artifactId>maven-resources-plugin</artifactId>
                    <version>3.0.2</version>
                </plugin>
                <plugin>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.8.0</version>
                </plugin>
                <plugin>
                    <artifactId>maven-surefire-plugin</artifactId>
                    <version>2.22.1</version>
                </plugin>
                <plugin>
                    <artifactId>maven-jar-plugin</artifactId>
                    <version>3.0.2</version>
                </plugin>
                <plugin>
                    <artifactId>maven-install-plugin</artifactId>
                    <version>2.5.2</version>
                </plugin>
                <plugin>
                    <artifactId>maven-deploy-plugin</artifactId>
                    <version>2.8.2</version>
                </plugin>
                <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
                <plugin>
                    <artifactId>maven-site-plugin</artifactId>
                    <version>3.7.1</version>
                </plugin>
                <plugin>
                    <artifactId>maven-project-info-reports-plugin</artifactId>
                    <version>3.0.0</version>
                </plugin>

            </plugins>
        </pluginManagement>
    </build>
</project>

Субмодуль POM 

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>


    <groupId>com.home</groupId>
    <artifactId>sub-module1</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>


    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
                <version>3.8.1</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
        </dependency>
        <dependency>
            <groupId>org.jsoup</groupId>
            <artifactId>jsoup</artifactId>
        </dependency>
    </dependencies>

</project>

1 Ответ

1 голос
/ 28 апреля 2019

б) Почему в 1-м пункте maven не может найти подмодуль pom?Разве подмодуль не собирается до родительского?

Подмодуль не установлен / не развернут в ссылках GAV (ваш кэш maven или удаленное хранилище Nexus)

Это означает, что любой проект, который будетссылка на подмодуль pom не найдет упомянутый pom в подмодуле GAV, поскольку то, что было построено, установлено и развернуто, было основным проектом GAV.

Как khmarbaise добавляет в комментариях:

Вы никогда не должны делать <scope>import</scope> внутри проекта, который уже определен как подмодуль, что означает, что в списке есть одна <module>..</module> запись.Поскольку разрешение импорта scope будет выполнено раньше остальных, что приведет к сбою сборки.

И:

а) Что указывает3 значит?

Это означает, что в разделе <dependencies> должно быть указано <dependency> только с <group> и <artifact>, , а не <version>.
Версия будетизвлечено из импортированного <dependencyManagement>.
См. также « Отслеживание версий управляемых зависимостей в Maven ».
Как показано здесь , управляемая зависимость используется для блокировки версии вродительский пом.

...