Belajar Fiber - Route Groups dan Domain Routing

#Pendahuluan

Semakin besar aplikasi, semakin penting mengorganisasi route. Episode 8 membahas group dan domain routing di Fiber v3: mengelompokkan route dengan prefix, nested group, mount sub-app, serta fitur baru RouteChain dan domain routing berbasis hostname.

Kemampuan ini menjaga route tetap terstruktur saat jumlah endpoint bertambah. Kalian bisa memisahkan area admin dari publik, memberi middleware khusus per group, hingga mengarahkan route berbeda untuk hostname berbeda.

#RouteGroup dan Prefix

#Mengorganisasi Route dengan Group

RouteGroup menggabungkan route dengan prefix dan middleware bersama. Ini cara paling umum membagi area aplikasi:

api := app.Group("/api", requestID)
 
v1 := api.Group("/v1", logger.New())
v1.Get("/users", listUsers)
v1.Post("/users", createUser)

app.Group("/api", requestID) membuat group berprefix /api; semua route di dalamnya akan menjalankan middleware requestID dan dipanggil sebagai /api/users. Group bisa di-nest: api.Group("/v1") menghasilkan path /api/v1/users dan menambahkan logger.New() untuk area v1 saja.

#Group dengan Middleware Khusus

Group tidak hanya soal prefix. Middleware yang diberikan saat membuat group hanya berlaku untuk route di dalamnya:

admin := app.Group("/admin", jwtAuth())
admin.Get("/stats", statsHandler)
 
public := app.Group("/")
public.Get("/products", listProducts)

jwtAuth() diterapkan pada semua route /admin/*, sedangkan route /products tidak terpengaruh. Pola ini membuat autentikasi area admin terpusat tanpa mengotori setiap handler.

#Mounting Sub-App

Fiber v3 mendukung mount sub-app — aplikasi Fiber lain dijalankan dalam route tertentu. Sub-app memiliki instance tersendiri:

api := fiber.New()
api.Get("/users", func(c fiber.Ctx) error {
    return c.JSON(fiber.Map{"message": "hello api"})
})
api.Get("/", func(c fiber.Ctx) error {
    return c.JSON(fiber.Map{"message": "hello root api"})
})
 
app.Mount("/api", api)

Route /api/users dan /api/ di-handle oleh sub-app api, sementara /api2 dihandle aplikasi utama. Mounting memudahkan integrasi aplikasi yang sebelumnya berdiri sendiri — misalnya layanan mikros, panel admin, atau dashboard.

#RouteChain di Fiber v3

#Merangkai Route

Fiber v3 memperkenalkan RouteChain, cara baru mendaftarkan route dengan gaya berantai. Panggilan diawali app.Get() untuk membuat instance, lalu dilanjutkan dengan method route:

app.Get("/", func(c fiber.Ctx) error {
    return c.JSON(fiber.Map{"message": "hello"})
}, "main", func(c fiber.Ctx) error {
    return c.JSON(fiber.Map{"message": "hello main"})
})

RouteChain memungkinkan mendaftarkan route berikutnya langsung dari hasil method sebelumnya. Hasilnya kode yang lebih ringkas untuk sekumpulan route sederhana — cukup satu panggilan untuk beberapa route dengan handler masing-masing.

#Domain Routing

#Route Berdasarkan Hostname

Domain routing di Fiber v3 memungkinkan route dipisahkan berdasarkan hostname atau subdomain. Route yang cocok hanya dijalankan untuk domain tersebut:

app.Get("/info", func(c fiber.Ctx) error {
    return c.JSON(fiber.Map{"app": "default"})
}, "sub.example.com/info", func(c fiber.Ctx) error {
    return c.JSON(fiber.Map{"app": "sub"})
})

Request ke /info pada sub.example.com memicu handler kedua; domain lain mendapatkan handler pertama. Fitur ini berguna untuk menangani banyak tenant, halaman khusus subdomain, atau eksperimen A/B tanpa menambah rute global.

#Constraint Kustom pada Route

Constraint di Fiber v3 juga bisa diterapkan pada path domain dengan mendefinisikan atribut tambahan di struct RouteAttribute:

var customRouteConstraint = fiber.RouteAttribute{At: "custom", Name: "A-Z0-9+"}
 
app.Get("/test", func(c fiber.Ctx) error {
    return c.JSON(fiber.Map{"message": "constraint kustom"})
}, customRouteConstraint)

RouteAttribute{At: "custom", Name: "A-Z0-9+"} mendefinisikan constraint regex kustom yang dipakai sebagai pengecualian pada path route. Pendekatan ini memberikan fleksibilitas penuh saat aturan bawaan seperti :id<int> belum cukup.

#Uji Coba

curl http://localhost:3000/api/v1/users
curl http://localhost:3000/api/users
curl -H "Host: sub.example.com" http://localhost:3000/info

Request pertama memicu handler listUsers dengan middleware requestID dan logger.New(). Request ke /api/users tidak cocok karena prefix group v1, dan request dengan header Host: sub.example.com memicu handler khusus subdomain.

#Penutup

Inti yang harus dibawa pulang:

• RouteGroup menggabungkan prefix dan middleware bersama dengan method app.Group().
• Group bisa di-nest menghasilkan path berlapis seperti /api/v1/users.
• Middleware diberikan saat membuat group hanya berlaku untuk route di dalamnya.
• app.Mount(path, subApp) menjalankan sub-app Fiber pada path tertentu.
• RouteChain di v3 mendaftarkan banyak route dalam satu panggilan berantai.
• Domain routing mencocokkan route berdasarkan hostname seperti sub.example.com.
• Constraint kustom didefinisikan lewat fiber.RouteAttribute.

Di episode 9 selanjutnya kita membahas error handling dan logger — custom error handler, ErrorHandler default di v3, fungsi NewError, serta integrasi middleware logger dengan template kustom.