Modernkan sistem lama terlebih dahulu dan bangun tangga kompatibilitas

Pertama kali saya membuka proyek Java dua puluh tahun yang lalu, hal pertama yang saya lihat bukanlah bau kode, tetapi bau usia. Build.xml masih ada, tetapi pom.xml tidak ada; struktur direktori sudah kuno, pintu masuk pengujian juga kuno, dan bahkan “apakah dapat membangun kembali produk yang dapat dijalankan” perlu dikonfirmasi ulang. Kesalahan paling umum pada tahap ini adalah fokus pada kelas dan metode dan mengabaikan bahwa yang sebenarnya menghalangi modernisasi adalah lingkungan dan pintu masuk.

Hal pertama yang harus dilakukan ketika memodernisasi sistem lama adalah membangun tangga kompatibilitas. Dasar tangga biasanya hanya mempunyai satu hal: membuat sistem lama berjalan stabil sesuai aturan lama, dan sebaiknya berfungsi sebagai kapsul waktu. Docker, JDK lama, alat build lama, perintah pengujian lama, hal-hal ini terlihat kasar, tetapi sangat efektif. Selama basis ini tidak tegak, setiap perubahan berikutnya akan menimbulkan gangguan baru: apakah itu kode yang rusak, atau JVM, gambar, arsitektur, dan plug-in yang rusak, tidak mungkin untuk mengatakannya.

Kemudian giliran memilih jembatan. Tujuan dari jembatan ini sangat spesifik: satu ujung terhubung ke kode sumber lama, dan ujung lainnya terhubung ke mesin baru. Proyek ini akhirnya jatuh ke tangan Java 8 dan Gradle 7.6, yang hanya terjebak pada batasan kedua ujungnya: Java 17 tidak lagi bersedia mengkompilasi kode sumber Java 1.5, dan Java 6 tidak dapat dijalankan di lingkungan asli ARM64. Jika jembatannya salah, modernisasi akan terjebak dalam rantai peralatan; jika jembatannya benar, migrasi berikutnya akan dapat dilakukan selangkah demi selangkah.

Hal yang paling berguna di sini adalah membiarkan model besar melakukan pengorganisasian dan penerjemahan. Ini dapat membantu menerjemahkan logika Ant ke dalam Gradle, memetakan direktori kembali ke tata letak lama, dan memindahkan konfigurasi berulang dan mekanis tersebut. Misalnya, secara eksplisit arahkan direktori kode sumber ke jalur lama, dan tambahkan tugas khusus untuk menjalankan pengujian main() lama:

java {
    sourceCompatibility = JavaVersion.VERSION_1_5
    targetCompatibility = JavaVersion.VERSION_1_5
}
sourceSets {
    main {
        java {
            srcDirs = ['java']
        }
    }
}
tasks.register('runLegacyTest', JavaExec) {
    mainClass.set(project.findProperty('mainClass'))
    classpath = sourceSets.main.runtimeClasspath
}

Arti penting dari konfigurasi ini adalah untuk membuat aturan-aturan dunia lama menjadi eksplisit. Hal yang paling menyusahkan dalam proyek-proyek lama seringkali bukanlah kurangnya kemampuan, tetapi kemampuan yang tersembunyi dalam kebiasaan. Pengujian dijalankan melalui entri main(), kode sumber ditempatkan di direktori lama, dan build ditulis dengan asumsi jalur di era Ant. Kopilot dapat menghemat waktu di sini, namun menghemat waktu penerjemahan, bukan waktu penilaian.

Waktu penilaian tidak dapat dialihdayakan. Gradle 8 terlihat lebih baru, Java 17 terlihat lebih modern, dan melompat langsung ke atas juga terlihat lebih bersih, namun opsi ini mungkin tidak memenuhi batasan kode sumber lama dan pengujian lama pada saat yang bersamaan. Ketakutan terbesar dalam modernisasi adalah menganggap peningkatan alat sebagai kemajuan dan menjalankan perintah sebagai pemahaman sistem. Selama sebuah proyek belum mencapai garis dasar operasionalnya, pengujian ramah lingkungan tidak dianggap sebagai sebuah kemenangan, hanya dapat dianggap tidak menyentuh permukaan yang terekspos untuk sementara waktu.

Pendekatan yang lebih saya percayai adalah pertama-tama memecah masalah menjadi empat tingkatan: apakah dapat dijalankan, apakah dapat diedit, apakah dapat diuji, dan apakah dapat dimodifikasi. Tingkat pertama adalah mereproduksi adegan, tingkat kedua adalah menentukan jembatan, tingkat ketiga adalah menentukan apa yang disimpan oleh pengujian lama, dan tingkat keempat adalah pemfaktoran ulang yang sebenarnya. Copilot sangat berguna pada dua level pertama. Cocok untuk pekerjaan fisik mengikuti log dan struktur direktori, dan untuk menyatukan petunjuk yang terfragmentasi ke dalam peta yang dapat dibaca. Pada tingkat keempat, model seharusnya hanya bertanggung jawab atas transportasi dan permintaan, dan masyarakat harus bergantung pada manusia untuk mengambil keputusan.

Hasil paling berharga dari modernisasi sistem lama adalah mengubah banyak hal yang “seharusnya berhasil” menjadi “hal-hal yang benar-benar berhasil dan kita tahu mengapa hal itu berhasil”. Setelah tangga kompatibilitas ini ditetapkan, pembongkaran selanjutnya akan memiliki ritme dan perubahan akan memiliki batasan. Copilot ibarat asisten di garis depan saat ini, memegang senter untuk melihat umur, pintu masuk, dan ketergantungan. Yang benar-benar menentukan arahnya adalah penilaian terhadap sejarah sistem lama.