JDK 8'den 21'e Geçiş — Derleme Yeşil, Rapor Sunucusu Neden Açılmadı?

Evde yeni bir oynatıcı aldın ve tatil videosunu onun yeni formatında diske yazdın. Herkes izledi, sonra disk babaanneye gitti. Onun eski oynatıcısı diski okuyamadı.

Önce derleyiciyi değiştir, hedefi sonra

Bir JDK iki iş yapar: kodu derler ve üretilen sınıfları çalıştırır. Derleyiciye “bu sınıfları Java 8 için üret” demek mümkündür: Maven’da bu maven.compiler.release ayarıdır.

Bu yüzden geçiş iki adımdır. Önce bütün projeyi JDK 21 ile derle ama hedefi 8’de bırak; eski eklentiler ve araçlar bu adımda dökülür. Uygulamalar JDK 21 üstünde koşmaya başlayınca hedefi yükselt.

Ortak modül en eski runtime’a bakar

Çok modüllü bir Maven projesinde 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ıyla kurar: önce ortak kütüphane, sonra onu kullanan uygulamalar. Ortak modül birden çok uygulamaya gider.

Her derlenmiş sınıfın içinde bir sınıf dosyası sürümü?Terimin tanımını açsınıf dosyası sürümüDerlenmiş her .class dosyasında yazan sürüm numarası: Java 8 için 52, Java 21 için 65. Bir JVM kendinden yeni sürümü okumaz.Sözlükte gör → yazar: Java 8 için 52, Java 21 için 65. Bir JVM kendinden yeni sürümü okumaz. Derleme bunu yakalamaz, çünkü derleme JDK 21’de yapılır.

JDK’dan çıkanlar, kapanan kapılar

JDK 11 ile bazı Java EE parçaları JDK’dan çıkarıldı. XML’i nesneye çeviren JAXB bunlardan biridir: JDK 8’de hazır gelir, JDK 11 ve sonrasında açık bir bağımlılık olarak eklenmesi gerekir.

İkinci kırılma reflection’dadır. JDK 17 ile güçlü kapsülleme?Terimin tanımını açgüçlü kapsüllemeJDK 17 ile zorunlu olan kural: JDK'nın iç sınıflarına reflection ile erişilemez. Eski kütüphaneler InaccessibleObjectException alır.Sözlükte gör → zorunlu oldu: JDK’nın iç sınıflarına reflection ile uzanan eski kütüphaneler InaccessibleObjectException alır. Çözüm çoğu zaman kütüphanenin güncel sürümüdür; --add-opens yalnızca geçici bir yamadır.

Spring Boot 3 ayrıca en az Java 17 ister ve javax.* paketlerini jakarta.* olarak değiştirir. Bu, geçişi bir import değişikliğine de çevirir.

Kendin gör

1. Varsayılanla oynat. Dört modülden üçü kırıldı: biri derlemede, biri testte, biri sunucuda. Üç kırılmanın nedeni ayrı.
2. JAXB’yi ekle ve kütüphaneyi güncelle. Derleme ve testler yeşil; report.war yine açılmadı.
3. common’ı —release 8 yap. Dört modül de ayakta: ortak modül, en eski runtime’a göre derlendi.

Tuzaklar

Varsayılan karakter seti. JDK 18 ile varsayılan karakter seti her yerde UTF-8 oldu. Karakter seti vermeden dosya okuyan eski kod, Windows sunucuda Türkçe harfleri artık farklı okuyabilir; dosyayı okurken karakter setini açıkça yaz.

Eski build eklentileri. Eski bir JaCoCo ya da Surefire sürümü, yeni sınıf sürümünü tanımayabilir. JDK’yı değiştirmeden önce eklentileri güncelle.

Jenkins ajanları. Pipeline hangi JDK ile koşuyor, bunu şansa bırakma. maven-enforcer-plugin ile beklenen Java sürümünü build’in ilk adımında kontrol et.

Aşağıda bir trading projesinin geçiş ayarları var: ana POM, rapor modülü ve Jenkins pipeline.

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

8
  <modules>
9
    <module>common</module>
10
    <module>settlement</module>
11
    <module>trading</module>
12
    <module>report</module>
13
  </modules>
14

15
  <properties>
16
    <!-- Every module targets 21 unless it says otherwise. -->
17
    <maven.compiler.release>21</maven.compiler.release>
18
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
19
  </properties>
20

21
  <build>
22
    <plugins>
23
      <plugin>
24
        <groupId>org.apache.maven.plugins</groupId>
25
        <artifactId>maven-enforcer-plugin</artifactId>
26
        <version>3.5.0</version>
27
        <executions>
28
          <execution>
29
            <id>require-jdk-21</id>
30
            <goals><goal>enforce</goal></goals>
31
            <configuration>
32
              <rules>
33
                <requireJavaVersion><version>[21,)</version></requireJavaVersion>
34
              </rules>
35
            </configuration>
36
          </execution>
37
        </executions>
38
      </plugin>
39
    </plugins>
40
  </build>
41
</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.0.0</version>
7
  </parent>
8
  <artifactId>common</artifactId>
9

10
  <properties>
11
    <!-- report.war still runs on a JDK 8 server: class file version 52.
12
         Raise this only after that server moves to JDK 21. -->
13
    <maven.compiler.release>8</maven.compiler.release>
14
  </properties>
15
</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.0.0</version>
7
  </parent>
8
  <artifactId>settlement</artifactId>
9

10
  <dependencies>
11
    <dependency>
12
      <groupId>com.bank.trading</groupId>
13
      <artifactId>common</artifactId>
14
      <version>${project.version}</version>
15
    </dependency>
16
    <!-- JAXB left the JDK in 11; the settlement file writer needs it explicitly. -->
17
    <dependency>
18
      <groupId>jakarta.xml.bind</groupId>
19
      <artifactId>jakarta.xml.bind-api</artifactId>
20
      <version>4.0.2</version>
21
    </dependency>
22
    <dependency>
23
      <groupId>org.glassfish.jaxb</groupId>
24
      <artifactId>jaxb-runtime</artifactId>
25
      <version>4.0.5</version>
26
      <scope>runtime</scope>
27
    </dependency>
28
  </dependencies>
29
</project>

1
pipeline {
2
  agent any
3
  tools {
4
    jdk 'jdk-21'
5
    maven 'maven-3.9'
6
  }
7
  stages {
8
    stage('Build') {
9
      steps {
10
        // The enforcer stops the build here if the agent has the wrong JDK.
11
        sh 'mvn -B clean verify'
12
      }
13
    }
14
    stage('Class versions') {
15
      steps {
16
        // report.war must stay readable by its JDK 8 server: expect "major version: 52".
17
        sh 'javap -v -cp common/target/classes com.bank.trading.common.Money | grep "major version"'
18
      }
19
    }
20
  }
21
}

Kendini sına