Instalasi Swagger di Spring Boot

Masi sama seperti yang ditulis di post sebelumnya tentang presentasi gw mengenai thread modelling di springboot. Gw memikirkan gimana caranya untuk ga bolak-balik pakai postman untuk presentasi cara kerja thread ketika harus call rest API. Untung di kantor standardnya menggunakan swagger untuk memudahkan test, akhirnya gw memutuskan untuk mencoba install swagger di project buat presentasi. Ternyata tidak semudah itu fergusso hehe. Jadi kali ini gw sedikit menjelaskan bagaimana cara installnya.

Disini gw akan menggunakan gradle untuk dependency managementnya, bagi yang ingin menggunakan maven ga ada bedanya juga. Yang perlu diperhatikan disini adalah dependecies apa yang dipakai untuk membuat swagger.

Sebenarnya selain springfox, masi ada library lain yang bisa digunakan. Cuma ya balik lagi, kan cuma gamau ribet jadi cukup ngikutin yang biasa dipake di kantor hehe. Setelah menambahkan dependecies, kita bisa langsung membuat configurationnya agar bisa segera digunakan. Untuk nama filenya biar gampang kita buat swaggerConfiguration.java. Berikut snippet codenya :

Yang perlu diperhatikan disini adalah annotation @EnableSwagger2 dan @Configuration. Tujuannya adalah agar aplikasi swagger dapat dijalankan pada startup. Setelah itu kita langsung bisa membuat docket API dan API Info untuk informasi mengenai Swagger tersebut. Secara tampilan bentuknya akan sepert ini.

Swagger UI

Jika masi belum mengerti, bisa langsung cek codenya disini. Demikian sedikit tutorial swagger, kalau ada yang tidak setuju atau ada sanggahan bisa langsung tulis di kolom komentar ya hehe.

Leave a Reply