Belajar HonoJS - Routing & HTTP Methods

#Pendahuluan

Setelah di episode 3 kita membuat proyek pertama dan menjalankan server, pada episode ini kita akan memahami routing — fondasi dari setiap API. Hono menawarkan pendekatan yang sangat clean untuk routing: setiap method HTTP punya fungsi dedicated, parameter diakses melalui c.req, dan validasi bisa ditambahkan dengan validator.

#Defining Routes

Hono menyediakan fungsi untuk setiap HTTP method:

Definisi route dengan berbagai HTTP method

import { Hono } from 'hono'
 
const app = new Hono()
  .get('/users', (c) => c.json([]))
  .post('/users', async (c) => {
    const body = await c.req.json()
    return c.json({ id: 1, ...body }, 201)
  })
  .put('/users/:id', async (c) => {
    const id = c.req.param('id')
    const body = await c.req.json()
    return c.json({ id, ...body })
  })
  .delete('/users/:id', (c) => {
    return c.json({ message: 'Deleted' })
  })
 
export default app

#Multiple Methods

Multiple methods di satu path

app.on(['GET', 'POST'], '/resource', (c) => {
  if (c.req.method === 'GET') return c.json([])
  return c.json({ created: true }, 201)
})

#Dynamic Parameters

Parameter dinamis didefinisikan dengan prefix : di path:

Dynamic parameters

app.get('/user/:id', (c) => {
  const id = c.req.param('id') // otomatis string
  return c.json({ id })
})

#Optional Parameters

Optional parameters

app.get('/page/:id?', (c) => {
  const id = c.req.param('id') // bisa undefined
  return c.json({ page: id ?? 'default' })
})

#Query Strings

Query strings

app.get('/search', (c) => {
  const q = c.req.query('q')         // string
  const tags = c.req.queries('tag')  // string[]
  return c.json({ query: q, tags })
})

#Base Path dan Route Grouping

#Base Path

Base path untuk versioning

const api = new Hono().basePath('/api/v1')
 
api.get('/users', (c) => c.json([]))
// Route lengkap: /api/v1/users

#Route Grouping

Route grouping dengan route()

const userRoutes = new Hono()
  .get('/', (c) => c.json([]))
  .post('/', async (c) => {
    const body = await c.req.json()
    return c.json({ id: 1, ...body }, 201)
  })
 
const app = new Hono()
  .route('/user', userRoutes)
  .route('/post', postRoutes)

Route userRoutes akan di-mount di /user, jadi route GET / menjadi /user/ dan POST / menjadi /user/.

#Grouping dengan group()

Grouping dengan group()

const app = new Hono()
 
app.group('/api', (app) =>
  app
    .get('/users', (c) => c.json([]))
    .get('/posts', (c) => c.json([]))
)

Note

Route grouping memudahkan pemisahan concern — kalian bisa memisahkan route berdasarkan domain atau versi API. Untuk proyek besar, pertimbangkan memisahkan route ke file terpisah dengan pattern plugin.

#Penutup

Pada episode 4 ini, kalian telah menguasai fondasi routing di Hono — dari definisi route sederhana hingga dynamic parameters, query strings, dan route grouping.

Inti yang harus dibawa pulang:

Hono menyediakan fungsi dedicated untuk setiap HTTP method.
c.req.param() untuk dynamic parameters, c.req.query() untuk query strings.
basePath() untuk versioning, route() dan group() untuk modularisasi.
Multiple methods dengan app.on(['GET', 'POST'], ...).

Di episode 5 selanjutnya kita akan memahami request dan response object — memahami context c secara mendalam, berbagai response types, dan cara membaca data dari request. Sampai jumpa di episode 5!