Как структурировать мультимодульный проект Maven для его компиляции сразу?

Ответ 1

Позвольте мне начать, как вы, но я называю вещи немного по-другому:

.
├── modules-root
│   ├── moduleA
│   │   └── pom.xml <--- Module A POM
│   ├── moduleB
│   │   └── pom.xml <--- Module B POM
│   └── pom.xml     <--- modules root
└── pom.xml         <--- project-root

Начнем с project-root, который будет выглядеть так:

<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/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.test</groupId>
    <artifactId>project-root</artifactId>
    <packaging>pom</packaging>
    <version>1.0.0-SNAPSHOT</version>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
                <version>4.11</version>
                <scope>test</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <modules>
       <module>modules-root</module>
    </modules>

</project>

module parent будет выглядеть следующим образом. Я хотел бы подчеркнуть, что это содержит только ссылку на moduleA и moduleB и наследует от project-root:

<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/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>

   <parent>
        <groupId>org.test</groupId>
        <artifactId>super-pom</artifactId>
        <version>1.0.0-SNAPSHOT</version>
    </parent>

    <groupId>org.test.module</groupId>
    <artifactId>modules-root</artifactId>
    <packaging>pom</packaging>

    <modules>
        <module>moduleA</module>
        <module>moduleB</module>
    </modules>
</project>

moduleA будет выглядеть следующим образом. Обратите внимание, что это наследует от module-parent (parent), который находится на одном уровне выше...

<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/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>org.test.module</groupId>
        <artifactId>module-parent</artifactId>
        <version>1.0.0-SNAPSHOT</version>
    </parent>

    <artifactId>moduleA</artifactId>
    <packaging>..</packaging>

    <....other dependencies..>
</project>

Если вы используете такую структуру, вы можете просто перейти на уровень project-root и сделать следующее:

mvn clean install

Кроме того, вы можете использовать такие вещи:

mvn -pl moduleA ...

... строить только moduleA (но оставаться на уровне уровня project-root...).

module-parent может выглядеть как лишний или лишний в этом примере, но если вы получите больше модулей, вы можете определить там дополнительные зависимости через dependencyManagement или изменить настройки плагинов с помощью pluginManagement которые будут использоваться только в этой подсекции (moduleA, moduleB,...). Если ваш проект станет больше, вы получите больше модулей-родителей параллельно... которые содержат разные части ваших приложений... и различные намерения, которые могут быть достигнуты с помощью этой структуры.

Еще одна вещь - упомянуть. Я изменил groupId из org.test на org.test.module в модуле-родительском. Это иногда полезно, если у вас есть большое количество модулей, потому что groupId представляет структуру папок в вашем репозитории (как java-пакеты в проекте Java)... это дает вам лучший обзор...

project-root - это место, где можно определить общие используемые зависимости через dependencyManagement т. Д.... и используемые плагины, которые должны быть определены с помощью pluginManagement... или могут использовать плагин maven-enforcer для определения общих правил проекта...

Типичными сценариями такой структуры являются проекты Java EE или другие крупные проекты (возможно, с 300... или 1000 модулями да, они существуют)...

Если вы получаете больше модулей, вы можете использовать многопоточные возможности maven и строить свой проект с помощью:

mvn -T 4 clean install 

от project-root что значительно сокращает время сборки.