Halo teman-teman semuanya, pada kesempatan kali ini kita semua akan belajar membuat Restful API menggunakan Go (Golang). Dan disini kita akan menggunakan salah satu web framework yang populer di Go, yaitu Gin dan untuk mempermudah dalam mengelola basis data, kita akan gunakan library ORM yang bernama Gorm.
Apa itu Gin ?
Gin Web Framework adalah framework web yang ditulis dengan bahasa pemrograman Go. Dikenal karena performanya yang cepat dan API yang mirip dengan Martini, framework lain di Go. Gin diklaim hingga 40 kali lebih cepat dari Martini.
Berikut beberapa kelebihan menggunakan Gin Web Framework:
-
Performa: Gin dikenal dengan performanya yang sangat cepat, menjadikannya pilihan yang baik untuk aplikasi web yang membutuhkan kecepatan tinggi.
-
Kemudahan Penggunaan: Gin memiliki API yang bersih dan minimalis, membuatnya mudah dipelajari dan digunakan.
-
Fitur Lengkap: Meskipun minimalis, Gin menyediakan fitur-fitur yang diperlukan untuk membangun aplikasi web yang kompleks, seperti routing, middleware, dan manajemen request.
-
Komunitas Aktif: Gin memiliki komunitas pengembang yang aktif, yang berarti kita dapat dengan mudah menemukan bantuan dan sumber daya secara online.
Singkatnya, Gin Web Framework adalah pilihan yang menarik untuk developer Go yang ingin membangun aplikasi web berperforma tinggi dengan cepat dan mudah.
Langkah 1 - Membuat Project Go
Setelah mengetahui apa itu Gin, maka kita akan lanjutkan belajar bagaimana cara membuat project baru menggunaka Go.
Sebelum itu, pastikan teman-teman sudah menginstall Go di dalam komputer dan jika teman-teman belum menginstall-nya, silahkan bisa ikuti cara installnya melalui situs resminya di https://go.dev/doc/install
Untuk memastikan apakah Go sudah terinstall, maka teman-teman bisa menjalankan perintah berikut ini di dalam terminal/CMD.
go version
Sekarang, silahkan teman-teman buat folder baru dengan nama golang-restful-api. Untuk lokasinya bebas dimana saja. Kemudian buka terminal/CMD dan arahkan ke dalam folder tersebut dan jalankan perintah berikut ini.
go mod init santrikoding/backend-api
Perintah di atas, akan menginisialisasi project dengan nama module santrikoding/backend-api dan juga membuatkan kita file baru dengan nama go.mod.
Langkah 2 - Installasi Gin
Setelah berhasil menginisialisasi project Go, langkah berikutnya adalah menginstall web framework Gin.
Silahkan teman-teman jalankan perintah berikut ini di dalam terminal/CMD dan pastikan berada di dalam project Go-nya.
go get -u github.com/gin-gonic/gin
Langkah 3 - Membuat Hello World dengan Gin
Setelah semua librray berhasil terinstall, sekarang kita akan coba membuat Rest API untuk menampilkan pesan Hello World! menggunakan Gin.
Silahkan teman-teman buat file baru dengan nama main.go, kemudian masukkan kode berikut ini di dalamnya.
main.go
package main
import (
"github.com/gin-gonic/gin"
)
func main() {
//inisialiasai Gin
router := gin.Default()
//membuat route dengan method GET
router.GET("/", func(c *gin.Context) {
//return response JSON
c.JSON(200, gin.H{
"message": "Hello World!",
})
})
//mulai server dengan port 3000
router.Run(":3000")
}
Dari penambahan kode di atas, pertama kita tentukan bahwa ini adalah program utama, yaitu ditandai dengan package main.
package main
Kemudian kita import library Gin, yang nanti akan kita gunakan untuk membuat routing Rest API.
import (
"github.com/gin-gonic/gin"
)
Setelah itu, kita buat function baru dengan nama main, fungsi ini yang akan dijalankan saat program dieksekusi.
func main() {
//...
}
Di dalam fungsi tersebut, pertama kita melakukan inisialisasi Gin di dalam variable yang bernama router.
//inisialiasai Gin
router := gin.Default()
Setelah itu, kita membuat route baru dengan method GET dan path atau endpoint yang digunakan adalah /.
//membuat route dengan method GET
router.GET("/", func(c *gin.Context) {
//....
}
Di dalam route di atas, kita akan mengembalikan sebuah response dalam format JSON dan menampilkan teks: Hello World!.
//return response JSON
c.JSON(200, gin.H{
"message": "Hello World!",
})
Dan setelah itu, jangan lupa kita jalankan Gin menggunakan method Run dan kita akan tentukan port yang digunakan adalah 3000.
//mulai server dengan port 3000
router.Run(":3000")
Langkah 4 - Uji Coba Aplikasi
Sekarang, silahkan teman-teman jalankan perintah berikut ini di dalam terminal/CMD dan pastikan sudah berada di dalam project Go-nya.
go run main.go
Jika berhasil, maka aplikasi kita akan dijalankan di dalam localhost menggunakan port 3000, silahkan teman-teman bisa membukanya di http://localhost:3000.
Kesimpulan
Pada artikel kali ini, kita semua telah belajar mengenal apa itu Gin dan belajar bagaimana cara install dan menjalanakn project baru menggunakan Go dan Gin.
Pada artikel berikutnya, kita semua akan belajar bagaimana cara melakukan konfigurasi database di Go menggunakan Gorm.
Terima Kasih