Çok Modüllü Maven — common'ı Değiştirdim, Neyi Derlemeliyim?

Bir lokantada şef ana sosun tarifini değiştirdi ve sosu tattı: güzel. Akşam o sosla yapılan makarna tuzlu çıktı. Sosu tatmak yetmemişti; sosu kullanan yemekleri de tatmak gerekiyordu.

Reactor modülleri sırayla kurar

Çok modüllü bir projede reactor?Terimin tanımını açMaven reactorÇok modüllü bir Maven projesinde modülleri bağımlılık sırasına dizip tek komutla kuran mekanizma. Önce kütüphaneler, sonra onları kullananlar kurulur.Sözlükte gör →, modülleri bağımlılık sırasına dizer: önce kütüphaneler, sonra onları kullananlar. mvn verify hepsini sırayla kurar.

Büyük projede hepsini kurmak uzun sürer. Bu yüzden -pl ile yalnızca seçilen modül kurulabilir. Asıl soru, seçilen modülün yanına başka neyin ekleneceğidir.

-am mi, -amd mi?

İki bayrak iki ayrı yöne bakar. -am yukarıya, değişen modülün kullandıklarına bakar; -amd aşağıya, onu kullananlara bakar.

Değişikliği doğrulamak için aşağıya bakmak gerekir: -amd. İkisini birlikte vermek en güvenlisidir, çünkü onu kullananların ihtiyaç duyduğu diğer modüller de aynı build’de kurulur.

Aynı kütüphane, iki sürüm

Bir modül Jackson’ın bir sürümünü, başka bir modül bir geçişli bağımlılık?Terimin tanımını açgeçişli bağımlılıkSenin eklemediğin, eklediğin bir kütüphanenin kendi bağımlılığı olarak gelen kütüphane. Sürümünü çoğu zaman sen seçmezsin.Sözlükte gör → üzerinden başka bir sürümünü çekebilir. Maven ağaçta en yakın olanı seçer. Derleme geçer, hata çalışırken NoSuchMethodError olarak çıkar.

Çözüm, sürümü ana POM’daki dependencyManagement içinde bir kez yazmaktır. Birbirine bağlı kütüphane ailesi için bir BOM?Terimin tanımını açBOMBill of Materials: birbirine bağlı kütüphane ailesinin uyumlu sürümlerini tek bir POM'da toplayan liste. dependencyManagement içine import edilir.Sözlükte gör → içe aktarılır; o ailenin bütün sürümleri birlikte sabitlenir.

Kendin gör

1. Varsayılanla oynat. Yalnızca common derlendi, build yeşil. common’ı kullanan report-app hiç derlenmedi.
2. Komutu -am yap. Yine tek modül: common’ın bağımlı olduğu bir şey yok.
3. Komutu -amd yap. report-app derlendi ve kırıldı; ops-tool’a hiç dokunulmadı.
4. Değişen modülü pricing yap. Bu kez kırılan trading-app; onu da yalnızca -amd yakalar.

Tuzaklar

Eski SNAPSHOT. Reactor’a girmeyen bir modül, yerel depodaki (~/.m2) belki geçen haftadan kalmış kopyadan gelir. Değişen modülü -am -amd ile kur ki onu kullananlar bugünkü kodla derlensin.

Yalnızca değişen dosyalara bakmak. Jenkins’te git diff ile değişen modülleri bulmak iyi bir fikir. Bulduğun listeye -amd eklemezsen, kullananları yine kaçırırsın.

Baştan başlamak. Uzun bir build ortada kırıldıysa, -rf :modül ile kırılan modülden devam edebilirsin. Düzelttikten sonra bir kez de baştan sona koştur.

Aşağıda bir trading platformunun ana POM’u ve yalnızca değişen modülleri kuran Jenkins pipeline’ı var.

1
<project>
2
  <modelVersion>4.0.0</modelVersion>
3
  <groupId>com.bank.trading</groupId>
4
  <artifactId>trading-platform</artifactId>
5
  <version>4.2.0-SNAPSHOT</version>
6
  <packaging>pom</packaging>
7

8
  <modules>
9
    <module>common</module>
10
    <module>pricing</module>
11
    <module>report-app</module>
12
    <module>trading-app</module>
13
    <module>ops-tool</module>
14
  </modules>
15

16
  <dependencyManagement>
17
    <dependencies>
18
      <!-- One version for every Jackson artifact, in every module. -->
19
      <dependency>
20
        <groupId>com.fasterxml.jackson</groupId>
21
        <artifactId>jackson-bom</artifactId>
22
        <version>2.17.2</version>
23
        <type>pom</type>
24
        <scope>import</scope>
25
      </dependency>
26
      <dependency>
27
        <groupId>com.bank.trading</groupId>
28
        <artifactId>common</artifactId>
29
        <version>${project.version}</version>
30
      </dependency>
31
      <dependency>
32
        <groupId>com.bank.trading</groupId>
33
        <artifactId>pricing</artifactId>
34
        <version>${project.version}</version>
35
      </dependency>
36
    </dependencies>
37
  </dependencyManagement>
38
</project>

1
<project>
2
  <modelVersion>4.0.0</modelVersion>
3
  <parent>
4
    <groupId>com.bank.trading</groupId>
5
    <artifactId>trading-platform</artifactId>
6
    <version>4.2.0-SNAPSHOT</version>
7
  </parent>
8
  <artifactId>report-app</artifactId>
9

10
  <dependencies>
11
    <!-- No versions here: the parent decides. -->
12
    <dependency>
13
      <groupId>com.bank.trading</groupId>
14
      <artifactId>common</artifactId>
15
    </dependency>
16
    <dependency>
17
      <groupId>com.fasterxml.jackson.core</groupId>
18
      <artifactId>jackson-databind</artifactId>
19
    </dependency>
20
  </dependencies>
21
</project>

1
pipeline {
2
  agent any
3
  tools {
4
    jdk 'jdk-21'
5
    maven 'maven-3.9'
6
  }
7
  stages {
8
    stage('Affected modules') {
9
      steps {
10
        script {
11
          def changed = sh(script: 'git diff --name-only origin/main...HEAD', returnStdout: true)
12
            .split('\n')
13
            .findAll { it.contains('/') }
14
            .collect { it.split('/')[0] }
15
            .findAll { fileExists("${it}/pom.xml") }
16
            .unique()
17
          // A change to the parent POM or nothing found: build everything.
18
          env.MODULES = changed ? changed.join(',') : ''
19
        }
20
      }
21
    }
22
    stage('Build') {
23
      steps {
24
        script {
25
          if (env.MODULES) {
26
            // -am: what they use. -amd: what uses them.
27
            sh "mvn -B -pl ${env.MODULES} -am -amd verify"
28
          } else {
29
            sh 'mvn -B verify'
30
          }
31
        }
32
      }
33
    }
34
  }
35
}

Kendini sına