golang-frameworks

Go Framework Patterns

Gin

func NewRouter(svc *OrderService) *gin.Engine {
    r := gin.New()
    r.Use(gin.Recovery(), gin.Logger())

    v1 := r.Group("/api/v1")
    {
        orders := v1.Group("/orders")
        orders.POST("", createOrderHandler(svc))
        orders.GET("/:id", getOrderHandler(svc))
    }
    return r
}

func createOrderHandler(svc *OrderService) gin.HandlerFunc {
    return func(c *gin.Context) {
        var req CreateOrderRequest
        if err := c.ShouldBindJSON(&req); err != nil {
            c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
            return
        }
        order, err := svc.Create(c.Request.Context(), req)
        if err != nil {
            c.JSON(http.StatusInternalServerError, gin.H{"error": "internal error"})
            return
        }
        c.JSON(http.StatusCreated, order)
    }
}

Echo

func NewRouter(svc *OrderService) *echo.Echo {
    e := echo.New()
    e.Use(middleware.Recover(), middleware.Logger())

    v1 := e.Group("/api/v1")
    v1.POST("/orders", createOrderHandler(svc))
    v1.GET("/orders/:id", getOrderHandler(svc))
    return e
}

Chi

func NewRouter(svc *OrderService) chi.Router {
    r := chi.NewRouter()
    r.Use(middleware.Recoverer, middleware.Logger)

    r.Route("/api/v1/orders", func(r chi.Router) {
        r.Post("/", createOrderHandler(svc))
        r.Get("/{id}", getOrderHandler(svc))
    })
    return r
}

Common Patterns

• Handler signature: accept dependencies via closure, return HandlerFunc
• Request binding: always validate input before processing
• Response: consistent JSON structure with error wrapping
• Graceful shutdown: use signal.NotifyContext with http.Server.Shutdown
• Health check: /health returning 200 with dependency status