Mekanisme Dependency Injection dalam Meningkatkan Modularitas Arsitektur Sistem Mahjong Ways

Ketergantungan antar komponen yang tidak terkelola dengan baik menjadi hambatan utama dalam pengembangan sistem yang modular. Penelusuran ini menguraikan bagaimana mekanisme Dependency Injection diterapkan untuk meningkatkan fleksibilitas dan modularitas arsitektur sistem Mahjong Ways. Dalam arsitektur Mahjong Ways yang kompleks dengan puluhan komponen yang saling berinteraksi (GameEngine, BalanceManager, BonusManager, RNGService, NotificationService, dll), ketergantungan antar komponen dapat dengan mudah menjadi kusut. Tanpa manajemen yang baik, mengubah satu komponen dapat berdampak pada banyak komponen lain. Dependency Injection (DI) adalah pola desain dan mekanisme teknis yang menyelesaikan masalah ini dengan membalik tanggung jawab pembuatan dependensi: alih-alih komponen membuat dependensinya sendiri, dependensi "diinjeksi" dari luar.

Penerapan DI di Mahjong Ways menggunakan container (misalnya Spring Framework untuk Java, Google Wire untuk Go, atau InversifyJS untuk TypeScript). Container bertanggung jawab untuk membuat dan menghubungkan semua komponen, mendefinisikan scope (apakah dependensi dibuat setiap kali digunakan atau dibagikan), dan mengelola siklus hidup. Implementasi ini secara signifikan meningkatkan modularitas, memungkinkan penggantian implementasi tanpa mengubah kode klien, dan memfasilitasi pengujian dengan mudah mengganti dependensi nyata dengan mock.

Dari Hard-Coded Dependency ke Inversion of Control

Dalam kode tanpa DI, GameEngine mungkin membuat BalanceManager sendiri: `balanceManager = new BalanceManager()`. Ini adalah hard-coded dependency. Jika BalanceManager perlu diganti dengan implementasi yang berbeda (misalnya untuk testing), GameEngine harus dimodifikasi. Jika ada 10 kelas yang menggunakan BalanceManager, 10 kelas harus dimodifikasi. Ini melanggar prinsip Open-Closed (kelas terbuka untuk ekstensi, tertutup untuk modifikasi).

Dengan DI, GameEngine cukup mendeklarasikan dependensi: `public GameEngine(IBalanceManager balanceManager)`. Implementasi konkret BalanceManager diinjeksi oleh container. GameEngine tidak tahu dan tidak peduli implementasi mana yang digunakan, selama memenuhi kontrak IBalanceManager. Untuk testing, implementasi mock dapat diinjeksi. Untuk production, implementasi nyata. Ini adalah Inversion of Control: kontrol atas dependensi berpindah dari kelas ke container.

Container dan Konfigurasi: Pusat Kendali Dependensi

Container adalah jantung dari implementasi DI. Container bertanggung jawab untuk: mendaftarkan semua komponen dan dependensinya (wiring), menentukan scope (singleton: satu instance untuk seluruh aplikasi; transient: instance baru setiap kali), menangani siklus hidup (inisialisasi, destroy), serta menyelesaikan dependensi secara rekursif.

Dalam Mahjong Ways yang ditulis dengan Go, Google Wire digunakan. Wire membaca deklarasi dependensi dalam kode dan menghasilkan kode wire yang efisien tanpa reflection overhead. Konfigurasi didefinisikan dalam fungsi provider, misalnya `func ProvideGameEngine(balance IBalanceManager) *GameEngine`. Wire menganalisis grafik dependensi, mendeteksi siklus, dan menghasilkan inisialisasi yang optimal. Pendekatan compile-time ini lebih cepat daripada runtime reflection DI populer di Java (Spring).

Testing Menjadi Lebih Mudah dengan Mock Injection

DI sangat memudahkan unit testing. Dalam kode tanpa DI, untuk menguji GameEngine, Anda harus membuat BalanceManager nyata yang mungkin mengakses database. Test menjadi lambat dan bergantung pada lingkungan eksternal. Dengan DI, Anda cukup membuat mock BalanceManager yang mengimplementasikan antarmuka yang sama, dan menginjeksikannya ke GameEngine.

Mock dapat diprogram untuk mengembalikan nilai tertentu, memverifikasi bahwa method dipanggil dengan parameter yang benar, atau mensimulasikan error. Test menjadi cepat (tidak ada database), deterministik, dan dapat dijalankan secara paralel. Dalam Mahjong Ways, ribuan unit test memanfaatkan mock injection untuk mengisolasi komponen yang diuji. Ini adalah faktor penting yang memungkinkan test suite selesai dalam hitungan menit, bukan jam.

Trade-off: Kompleksitas Awal vs Kemudahan Pemeliharaan Jangka Panjang

DI tidak tanpa biaya. Konfigurasi DI dapat menjadi kompleks, terutama untuk aplikasi dengan puluhan komponen. Debugging masalah injeksi juga bisa sulit karena aliran kontrol tidak jelas (siapa yang membuat objek?). Namun trade-off ini sebanding untuk aplikasi skala besar seperti Mahjong Ways. Biaya awal (setup container, mendefinisikan wiring) dibayar sekali. Manfaat (kemudahan testing, fleksibilitas penggantian implementasi, modularitas) dinikmati setiap hari.

Pendekatan yang digunakan adalah hybrid: DI untuk komponen inti (GameEngine, BalanceManager, BonusManager), tetapi tidak untuk komponen yang sangat sederhana atau yang jarang berubah. Aturan praktis: jika sebuah komponen kemungkinan akan diganti (misalnya untuk testing) atau memiliki dependensi yang kompleks, gunakan DI. Jika komponen bersifat leaf (tidak memiliki dependensi) dan stabil, new() saja tidak masalah.

Kesimpulan: DI sebagai Fondasi Modularitas Jangka Panjang

Mekanisme Dependency Injection dalam meningkatkan modularitas arsitektur sistem Mahjong Ways menunjukkan bahwa DI bukan sekadar pola desain, tetapi fondasi teknis yang memungkinkan pengembangan sistem yang besar dan kompleks tetap terkelola. Dengan memindahkan tanggung jawab pembuatan dependensi ke container, komponen menjadi lebih independen, lebih mudah diuji, dan lebih fleksibel untuk diubah.

Pada akhirnya, setiap kali Mahjong Ways diperbarui tanpa merusak komponen lain, setiap kali test berjalan cepat tanpa database, setiap kali pengembang berani mengganti implementasi BalanceManager karena kontrak yang jelas, itu adalah hasil dari DI yang diterapkan dengan disiplin. Antara container yang mengelola dependensi dan antarmuka yang memisahkan kontrak dari implementasi, antara mock yang memungkinkan testing terisolasi dan wiring yang mendefinisikan hubungan antar komponen, Anda menemukan bahwa modularitas bukanlah kemewahan, tetapi kebutuhan untuk sistem yang terus berkembang. Dan DI adalah alat yang membuat modularitas itu mungkin, memungkinkan puluhan komponen bekerja bersama tanpa saling mengganggu, dan memungkinkan pengembang berinovasi tanpa takut merusak apa yang sudah ada.