gin 框架介绍及基本使用

介绍

gin 是一个基于golang 标准net 库实现的的web 框架，现在已经被广泛使用，github 上非常活跃，是最流行的golang web 框架之一。具体数据对比可以在https://github.com/mingrammer/go-web-framework-stars 查看，gin 目前stars 高居第一，github地址：gin。

gin 框架和beego 框架不一样的是它是一个微框架，但重要和必须的功能都提供了，并且它的源代码也是非常简洁的，十分适合用来学习。

gin的特性包括：

• 快：路由使用基数树，低内存，不使用反射；
• 中间件注册：一个请求可以被一系列的中间件和最后的action处理
• 崩溃处理：gin可以捕获panic使应用程序可用
• JSON校验：将请求的数据转换为JSON并校验
• 路由组：更好的组织路由的方式，无限制嵌套而不影响性能
• 错误管理：可以收集所有的错误
• 内建渲染方式：JSON，XML和HTML渲染方式
• 可继承：简单的去创建中间件

gin 的基本使用

一个来自于gin github example 的最基本使用demo：

package main

import (
    "net/http"

    "github.com/gin-gonic/gin"
)

var db = make(map[string]string)

func setupRouter() *gin.Engine {
    // gin.Default 获取一个默认gin engine
    r := gin.Default()

    // 注册ping 路由handler，响应pong
    r.GET("/ping", func(c *gin.Context) {
        c.String(http.StatusOK, "pong")
    })

    // 通过gin Context 来获取参数然后响应
    r.GET("/user/:name", func(c *gin.Context) {
        user := c.Params.ByName("name")
        value, ok := db[user]
        if ok {
            c.JSON(http.StatusOK, gin.H{"user": user, "value": value})
        } else {
            c.JSON(http.StatusOK, gin.H{"user": user, "status": "no value"})
        }
    })

    // 路由分组
    authorized := r.Group("/", gin.BasicAuth(gin.Accounts{
        "foo":  "bar", // user:foo password:bar
        "manu": "123", // user:manu password:123
    }))

    authorized.POST("admin", func(c *gin.Context) {
        user := c