Ikhtisar

Saya bekerja di backend dan frontend secara bersamaan. Saat membuat satu fitur, saya menulis endpoint dan DTO request/response di Java WebFlux, dan kemudian di frontend saya harus menulis URL dan tipe TypeScript yang sama. Untuk menyesuaikan dokumen Swagger, saya harus memindahkan informasi yang sudah ada di backend ke format lain sekali lagi.

Titik tersumbat terbesar adalah proses menulis ulang kontrak API yang dibuat di backend agar dapat digunakan oleh frontend. Jika salah satu dari URL, metode HTTP, parameter path/query, atau struktur request/response diubah secara berbeda di kedua sisi, masalah baru terdeteksi setelah kompilasi. Ini bukan hanya pekerjaan yang merepotkan, tetapi ketidaksesuaian yang muncul karena orang mengelola informasi yang sama dua kali menjadi masalah yang lebih besar.

Saya juga ingin mengurangi pengulangan saat membuat RouterFunction dan handler baru. Jika saya menambahkan referensi seperti ApiAccountHandler::search ke router, saya pikir kerangka kelas handler dan metode yang tidak ada seharusnya dibuat secara otomatis. Saat menulis query MongoDB, mengulangi nama field entitas sebagai string seperti "username" juga merepotkan dan rentan terhadap kesalahan ketik, jadi saya juga menambahkan fitur untuk membaca sumber entitas dan membuatnya menjadi enum Java dalam alat yang sama.

Dengan demikian, pembuatan Swagger/OpenAPI, pembuatan kerangka handler, dan pembuatan enum field entitas Mongo telah dibuat terlebih dahulu, dan setelah itu, saat menggunakan RSocket, pembuatan AsyncAPI juga ditambahkan. Meskipun masing-masing tampak seperti ide terpisah, titik awalnya sama. Ini adalah tentang tidak menulis ulang fakta yang sudah ditulis di sumber backend oleh manusia, dan membiarkan alat pengembangan membuat bagian yang dapat dibaca mesin.