Go实战--通过gin-gonic框架搭建restful api服务(github.com/gin-gonic/gin)

生命不止，继续 go go go !!!

先插播一条广告，给你坚持学习golang的理由：
《2017 软件开发薪酬调查：Go 和 Scala 是最赚钱的语言》

言归正传！

之前写过使用golang实现简单的restful api相关的博客：
Go实战–实现简单的restful api(The way to go)

其中，使用了github.com/gorilla/mux，今天要跟大家介绍的是gin-gonic/gin。

gin-gonic/gin
介绍：
Gin is a HTTP web framework written in Go (Golang). It features a Martini-like API with much better performance – up to 40 times faster. If you need smashing performance, get yourself some Gin.

github地址：
https://github.com/gin-gonic/gin

获取：

go get github.com/gin-gonic/gin

例子：

package main

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

func main() {
    r := gin.Default()
    r.GET("/ping", func(c *gin.Context) {
        c.JSON(200, gin.H{
            "message": "pong",
        })
    })
    r.Run()
}

运行：

[GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.
 - using env:   export GIN_MODE=release
 - using code:  gin.SetMode(gin.ReleaseMode)

[GIN-debug] GET    /ping                     --> main.main.func1 (3 handlers)
[GIN-debug] Environment variable PORT is undefined. Using port :8080 by default
[GIN-debug] Listening and serving HTTP on :8080

通过浏览器访问：
http://localhost:8080/ping

// 20170808110257
// http://localhost:8080/ping

{
  "message": "pong"
}

全局设置环境：

gin.SetMode(gin.DebugMode)

或

gin.SetMode(gin.ReleaseMode)

获得路由实例：

r := gin.Default()

构建restful api

创建五个routes：

package main

import (
       "github.com/gin-gonic/gin"
)
func main() {
router := gin.Default()
v1 := router.Group("/api/v1/userinfo")
{
  v1.POST("/", CreateUser)
  v1.GET("/", FetchAllUsers)
  v1.GET("/:id", FetchSingleUser)
  v1.PUT("/:id", UpdateUser)
  v1.DELETE("/:id", DeleteUser)
}
 router.Run()
}

下面我们要使用gin+mysql构建restful api。
如果对于golang中的MySQL不够熟悉的话，可以看看我之前写过的博文：
Go实战–go语言操作MySQL数据库(go-sql-driver/mysql)

先实现一个简单的根据id来FetchSingleUser吧：
我们事先通过命令行创建了user_info表以及一行数据，id=2, name=wangshubo

开始golang程序：
定义结构体：

type Person struct {
    Id   int
    Name string
}

check函数：

func checkErr(err error) {
    if err != nil {
        panic(err)
    }
}

FetchSingleUser方法：
我们要返回json, gin对json也进行了封装，所以不再需要我们提供类似encoding/json之类的package。

func FetchSingleUser(c *gin.Context) {

    id := c.Param("id")

    db, err := sql.Open("mysql", "root:wangshubo@/test?charset=utf8")
    checkErr(err)

    defer db.Close()

    err = db.Ping()
    checkErr(err)

    var (
        person Person
        result gin.H
    )
    row := db.QueryRow("select id, name from user_info where id = ?;", id)
    err = row.Scan(&person.Id, &person.Name)
    if err != nil {
        // If no results send null
        result = gin.H{
            "result": nil,
            "count":  0,
        }
    } else {
        result = gin.H{
            "result": person,
            "count":  1,
        }
    }
    c.JSON(http.StatusOK, result)
}

浏览器访问：
http://localhost:8080/api/v1/userinfo/1

// 20170808141904
// http://localhost:8080/api/v1/userinfo/1

{
  "count": 0,
  "result": null
}

浏览器访问：
http://localhost:8080/api/v1/userinfo/2

// 20170808141940
// http://localhost:8080/api/v1/userinfo/2

{
  "count": 1,
  "result": {
    "Id": 2,
    "Name": "wangshubo"
  }
}

gin输出log：

[GIN] 2017/08/08 - 14:19:03 | 200 |     16.0127ms |             ::1 |  GET     /api/v1/userinfo/1
[GIN] 2017/08/08 - 14:19:39 | 200 |     56.0381ms |             ::1 |  GET     /api/v1/userinfo/2

未完待续：
组织代码结构