Penanganan Berbagai Parameter Permintaan dalam Kerangka Kerja Go Fiber
Contoh Sederhana
Semua parameter permintaan dalam kerangka kerja Fiber diperoleh melalui objek konteks Ctx
.
app.Get("/user/:name?", func(c *fiber.Ctx) error {
// Dapatkan parameter melalui parameter Ctx dari fungsi rute dan panggil metode yang sesuai
// Di sini, parameter nama diperoleh melalui Params
return c.SendString(c.Params("name"))
})
Memperoleh Parameter Rute
Memperoleh parameter dari jalur URL
// GET http://example.com/user/fenny
app.Get("/user/:name", func(c *fiber.Ctx) error {
c.Params("name") // "fenny"
// ...
})
// GET http://example.com/user/fenny/123
app.Get("/user/*", func(c *fiber.Ctx) error {
c.Params("*") // "fenny/123"
c.Params("*1") // "fenny/123"
c.Params("*", "nilai default") // Nilai default dapat diatur dengan parameter kedua
})
Mendapatkan parameter rute tipe Int
// GET http://example.com/user/123
app.Get("/user/:id", func(c *fiber.Ctx) error {
id, err := c.ParamsInt("id") // int 123 dan tidak ada kesalahan
// ...
})
Memperoleh Parameter Permintaan Query GET
// GET http://example.com/?order=desc&brand=nike
app.Get("/", func(c *fiber.Ctx) error {
c.Query("order") // "desc"
c.Query("brand") // "nike"
// Parameter kedua dapat digunakan untuk mengatur nilai default, yang akan dikembalikan jika parameter tidak ada
c.Query("kosong", "nike") // "nike"
// ...
})
Mengembalikan semua parameter query
// GET http://example.com/?name=alex&want_pizza=false&id=
app.Get("/", func(c *fiber.Ctx) error {
m := c.Queries()
m["name"] // "alex"
m["want_pizza"] // "false"
m["id"] // ""
// ...
})
Mengikat parameter query ke objek struct
// Tentukan struct untuk menerima parameter
// Gunakan tag query untuk menentukan nama parameter yang akan diikat
type Person struct {
Name string `query:"name"`
Pass string `query:"pass"`
Products []string `query:"products"`
}
app.Get("/", func(c *fiber.Ctx) error {
// Tentukan variabel struct untuk menerima parameter
p := new(Person)
// Gunakan QueryParser untuk mengikat parameter query ke variabel p
if err := c.QueryParser(p); err != nil {
return err
}
log.Println(p.Name) // john
log.Println(p.Pass) // doe
log.Println(p.Products) // [sepatu, topi]
// ...
})
// Jalankan perintah curl berikut untuk menguji
// curl "http://localhost:3000/?name=john&pass=doe&products=sepatu,topi"
Memperoleh Parameter Formulir Permintaan POST
app.Post("/", func(c *fiber.Ctx) error {
// Dapatkan nilai pertama dari bidang formulir "name":
c.FormValue("name")
// => "john" atau "" jika tidak ada
// ...
})
## Menangani Parameter Tubuh
Ini digunakan terutama untuk memproses permintaan POST/PUT dan mendukung parameter JSON, XML, dan form.
```go
// Mendefinisikan struct untuk menerima parameter, dan mendefinisikan nama field parameter yang ingin Anda terima melalui tag json, xml, dan form
// json, xml, form dapat dipilih sesuai kebutuhan; tidak perlu menyertakan semuanya
type Person struct {
Name string `json:"name" xml:"name" form:"name"`
Pass string `json:"pass" xml:"pass" form:"pass"`
}
app.Post("/", func(c *fiber.Ctx) error {
// Mendefinisikan variabel struct untuk menerima parameter
p := new(Person)
// Gunakan BodyParser untuk mengikat parameter tubuh ke variabel p
if err := c.BodyParser(p); err != nil {
return err
}
log.Println(p.Name) // john
log.Println(p.Pass) // doe
// ...
})
// Contoh berbagai jenis permintaan; untuk permintaan parameter format JSON, ingat untuk mengatur Content-Type: application/json
// curl -X POST -H "Content-Type: application/json" --data "{\"name\":\"john\",\"pass\":\"doe\"}" localhost:3000
// curl -X POST -H "Content-Type: application/xml" --data "<login><name>john</name><pass>doe</pass></login>" localhost:3000
// curl -X POST -H "Content-Type: application/x-www-form-urlencoded" --data "name=john&pass=doe" localhost:3000
// curl -X POST -F name=john -F pass=doe http://localhost:3000
// curl -X POST "http://localhost:3000/?name=john&pass=doe"
Cara mengambil data tubuh asli adalah sebagai berikut:
// curl -X POST http://localhost:8080 -d user=john
app.Post("/", func(c *fiber.Ctx) error {
// Gunakan BodyRaw untuk mengembalikan data tubuh mentah
return c.Send(c.BodyRaw()) // []byte("user=john")
})
Mengambil Header Permintaan
app.Get("/", func(c *fiber.Ctx) error {
c.Get("Content-Type") // "text/plain"
c.Get("CoNtEnT-TypE") // "text/plain"
c.Get("something", "john") // "john"
// ...
})
Mengambil IP Klien
app.Get("/", func(c *fiber.Ctx) error {
c.IP() // "127.0.0.1"
// ...
})
Jika Anda ditempatkan pada server yang menggunakan proxy atau penyeimbang beban, Anda perlu mengambil IP klien melalui header x-forwarded-for dengan pengaturan berikut:
app := fiber.New(fiber.Config{
ProxyHeader: fiber.HeaderXForwardedFor,
})
Membaca Cookie
app.Get("/", func(c *fiber.Ctx) error {
// Dapatkan cookie berdasarkan kunci:
c.Cookies("name") // "john"
c.Cookies("empty", "doe") // "doe"
// ...
})