Echo — bind, validasi & error terpusat

Echo memberi tiga hal yang benar-benar mengurangi kode di API besar: bind otomatis, validasi terpasang, dan satu error handler global. Harganya adalah tipe konteks sendiri.

Bentuknya

import "github.com/labstack/echo/v4"

func main() {
	e := echo.New()
	e.HideBanner = true
	e.HTTPErrorHandler = penanganError      // satu tempat untuk semua error

	e.Use(middleware.RequestID())
	e.Use(middleware.Recover())
	e.Use(middleware.Secure())
	e.Use(middleware.RateLimiter(
		middleware.NewRateLimiterMemoryStore(20)))

	api := e.Group("/api/v1")

	api.GET("/produk", h.DaftarProduk)
	api.GET("/produk/:id", h.AmbilProduk)

	priv := api.Group("", h.WajibLogin)
	priv.POST("/produk", h.BuatProduk)
	priv.PUT("/produk/:id", h.UbahProduk)

	e.Logger.Fatal(e.Start(":8080"))
}

Handler yang mengembalikan error

type buatProdukReq struct {
	Nama  string `json:"nama"  validate:"required,min=3,max=200"`
	Harga int64  `json:"harga" validate:"required,gt=0"`
}

func (h *Handler) BuatProduk(c echo.Context) error {
	var req buatProdukReq

	// Bind mengisi dari JSON/form/query/path sekaligus.
	if err := c.Bind(&req); err != nil {
		return echo.NewHTTPError(http.StatusBadRequest, "body tidak valid")
	}
	if err := c.Validate(&req); err != nil {
		return err
	}

	p, err := h.produk.Buat(c.Request().Context(), req.Nama, req.Harga)
	if err != nil {
		return err          // ← langsung ke HTTPErrorHandler
	}

	return c.JSON(http.StatusCreated, keResp(p))
}

Penanganan error terpusat

func penanganError(err error, c echo.Context) {
	if c.Response().Committed {
		return                       // respons sudah terkirim
	}

	status, pesan := http.StatusInternalServerError, "terjadi kesalahan"

	var (
		he *echo.HTTPError
		ve *domain.ErrValidasi
	)
	switch {
	case errors.As(err, &he):
		status = he.Code
		pesan = fmt.Sprint(he.Message)
	case errors.Is(err, domain.ErrTidakDitemukan):
		status, pesan = http.StatusNotFound, "tidak ditemukan"
	case errors.Is(err, domain.ErrTidakBerhak):
		status, pesan = http.StatusForbidden, "tidak berhak"
	case errors.As(err, &ve):
		status, pesan = http.StatusUnprocessableEntity, ve.Error()
	}

	if status >= 500 {
		slog.ErrorContext(c.Request().Context(), "permintaan gagal",
			"err", err, "path", c.Path())
	}
	_ = c.JSON(status, map[string]string{"error": pesan})
}

Memasang validator

type pemvalidasi struct{ v *validator.Validate }

func (p *pemvalidasi) Validate(i any) error {
	if err := p.v.Struct(i); err != nil {
		return &domain.ErrValidasi{Bidang: keBidang(err)}
	}
	return nil
}

e.Validator = &pemvalidasi{v: validator.New()}

Yang perlu diperhatikan