Swagger/OpenAPI dengan springdoc

Penjelasan

springdoc-openapi (bukan bagian resmi Spring Boot core, tapi paling umum dipakai) men-generate dokumentasi API OTOMATIS dari Controller yang sudah ada — cukup tambahkan dependency-nya, dokumentasi interaktif langsung tersedia di /swagger-ui.html TANPA konfigurasi tambahan apa pun untuk kasus dasar.

Contoh Konsep

1. Tambahkan dependency di pom.xml (Maven):
   <dependency>
       <groupId>org.springdoc</groupId>
       <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
       <version>2.x.x</version>
   </dependency>
2. Jalankan aplikasi seperti biasa
3. Buka http://localhost:8080/swagger-ui.html — dokumentasi API interaktif OTOMATIS tersedia dari semua @RestController yang ada

// Memperkaya dokumentasi (opsional):
// @Operation(summary = "Ambil semua produk")
// @GetMapping
// public List<Produk> findAll() { ... }

Praktikum

Tulis (sebagai catatan) langkah-langkah mengaktifkan springdoc-openapi di project Spring Boot baru: dependency apa yang ditambahkan, dan URL default untuk mengaksesnya setelah aplikasi berjalan.

Editor Latihan

Ketik/edit bebas di sini untuk latihan — kode ini tidak dijalankan.

Tips

springdoc-openapi TIDAK BUTUH konfigurasi apa pun untuk mulai berfungsi — cukup dependency-nya ditambahkan, dokumentasi langsung ter-generate dari Controller yang sudah ada, mirip filosofi otomatis Swagger bawaan template ASP.NET Core, walau di Spring Boot butuh dependency eksternal terlebih dahulu.