基于gin框架搭建的一个简单的web服务

刚把go编程基础知识学习完了，学习的时间很短，可能还有的没有完全吸收。不过还是在项目中发现知识，然后在去回顾已学的知识，现在利用gin这个web框架做一个简单的CRUD操作。

1.Go Web框架的技术选型

Top 6 web frameworks for Go as of 2017，可以看看这个go语言中Web框架的对比和老大的推荐，我选择gin框架作为学习go语言的框架。

image.png

2.Gin介绍

gin框架的中文文档，这个文档相当好，清晰明了解释gin框架的整个用法。下面是gin框架的全部特性：

image.png

3.建立一个web服务实现Hello Word

首先需要安装ginweb框架和gorm作为ORM层，然后利用go-sql数据库驱动，前提是要配置Gopath环境变量，使用go get安装即可：gin安装地址

//使用github上的gin托管地址
$ go get -u github.com/gin-gonic/gin
$ go get -u github.com/jinzhu/gorm
$ go get github.com/go-sql-driver/mysql

使用Gin实现Hello world非常简单，创建一个router（路由），然后执行Run方法即可：

package main
import (
    "github.com/gin-gonic/gin"
    "net/http"
)
func main() {
    router:=gin.Default()
    router.GET("/", func(c *gin.Context) {
        c.String(http.StatusOK,"Hello World")
    })
    router.Run(":8080")
}

结果如下：

image.png

image.png

是不是比Java方便多了！下面来仔细分析下上面的代码结构：

  • 1、router:=gin.Default()：这是默认的服务器。使用gin的Default方法创建一个路由Handler；
  • 2、然后通过Http方法绑定路由规则和路由函数。不同于net/http库的路由函数，gin进行了封装，把request和response都封装到了gin.Context的上下文环境中。
  • 3、最后启动路由的Run方法监听端口。还可以用http.ListenAndServe(":8080", router)，或者自定义Http服务器配置。

4.基于database/sql的CURD操作

1.建立数据库表

image.png

2.CURD操作，以查询为例

参考人世间

package main

import (
    "database/sql"
    _ "github.com/go-sql-driver/mysql"
    "log"
    "net/http"
    "github.com/gin-gonic/gin"
)
//利用的是原生的SQL的ORM层
var db *sql.DB

//定义person类型结构
type Person struct {
    Id int `json:"id"`
    FirstName string `json:"first_name"`
    LastName string `json:"last_name"`
}

//定义一个getALL函数用于回去全部的信息
func (p Person) getAll() (persons []Person,err error) {
    rows,err:=db.Query("SELECT id, first_name, last_name FROM person")
    if err!=nil {
        return
    }
    for rows.Next()  {
        var person Person
        //遍历表中所有行的信息
        rows.Scan(&person.Id,&person.FirstName,&person.LastName)
        //将person添加到persons中
        persons=append(persons,person)
    }
    //最后关闭连接
    defer rows.Close()
    return
}

func main() {
    var err error
    db,err =sql.Open("mysql","root:123456@tcp(127.0.0.1:3306)/test?parseTime=true")
    //错误检查
    if err!=nil{
        log.Fatal(err.Error())
    }
    //推迟数据库连接的关闭
    defer db.Close()

    //
    err = db.Ping()
    if err != nil {
        log.Fatal(err.Error())
    }
    //创建一个路由Handler
    router:=gin.Default()

    //get方法的查询
    router.GET("/person", func(c *gin.Context) {
        p:=Person{}
        persons,err:= p.getAll()
        if err !=nil {
            log.Fatal(err)
        }
        //H is a shortcut for map[string]interface{}
        c.JSON(http.StatusOK,gin.H{
            "result":persons,
            "count":len(persons),
        })
    })
    router.Run(":8080")
}

3.测试结果如下

image.png
image.png

完整代码如下：

package main

import (
    "database/sql"
    _ "github.com/go-sql-driver/mysql"
    "log"
    "net/http"
    "github.com/gin-gonic/gin"
    "strconv"
    "fmt"
)

var db *sql.DB

//定义person类型结构
type Person struct {
    Id        int    `json:"id"`
    FirstName string `json:"first_name"`
    LastName  string `json:"last_name"`
}

//定义一个getALL函数用于回去全部的信息
func (p Person) getAll() (persons []Person, err error) {
    rows, err := db.Query("SELECT id, first_name, last_name FROM person")
    if err != nil {
        return
    }
    for rows.Next() {
        var person Person
        //遍历表中所有行的信息
        rows.Scan(&person.Id, &person.FirstName, &person.LastName)
        //将person添加到persons中
        persons = append(persons, person)
    }
    //最后关闭连接
    defer rows.Close()
    return
}

//通过id查询
func (p Person) get() (person Person, err error) {
    row := db.QueryRow("SELECT id, first_name, last_name FROM person WHERE id=?", p.Id)
    err = row.Scan(&person.Id, &person.FirstName, &person.LastName)
    if err != nil {
        return
    }
    return
}
func (p Person) add() (Id int, err error) {
    stmt, err := db.Prepare("INSERT INTO person(first_name, last_name) VALUES (?, ?)")
    if err != nil {
        return
    }
    //执行插入操作
    rs, err := stmt.Exec(p.FirstName, p.LastName)
    if err != nil {
        return
    }
    //返回插入的id
    id, err := rs.LastInsertId()
    if err != nil {
        log.Fatalln(err)
    }
    //将id类型转换
    Id = int(id)
    defer stmt.Close()
    return
}
//通过id删除
func (p Person) del() (rows int, err error) {
    stmt, err := db.Prepare("DELETE FROM person WHERE id=?")
    if err != nil {
        log.Fatalln(err)
    }

    rs, err := stmt.Exec(p.Id)
    if err != nil {
        log.Fatalln(err)
    }
    //删除的行数
    row, err := rs.RowsAffected()
    if err != nil {
        log.Fatalln(err)
    }
    defer stmt.Close()
    rows = int(row)
    return
}

func main() {

    var err error
    db, err = sql.Open("mysql", "root:123456@tcp(127.0.0.1:3306)/test?parseTime=true")
    //错误检查
    if err != nil {
        log.Fatal(err.Error())
    }
    //推迟数据库连接的关闭
    defer db.Close()

    //
    err = db.Ping()
    if err != nil {
        log.Fatal(err.Error())
    }
    //创建一个路由Handler
    router := gin.Default()

    //get方法的查询
    router.GET("/person", func(c *gin.Context) {
        p := Person{}
        persons, err := p.getAll()
        if err != nil {
            log.Fatal(err)
        }
        //H is a shortcut for map[string]interface{}
        c.JSON(http.StatusOK, gin.H{
            "result": persons,
            "count":  len(persons),
        })
    })
    //利用get方法通过id查询
    router.GET("/person/:id", func(c *gin.Context) {
        var result gin.H
        //c.Params方法可以获取到/person/:id中的id值
        id := c.Param("id")
        Id, err := strconv.Atoi(id)
        if err != nil {
            log.Fatal(err)
        }
        //定义person结构
        p := Person{
            Id: Id,
        }
        person, err := p.get()
        if err != nil {
            result = gin.H{
                "result": nil,
                "count":  0,
            }
        } else {
            result = gin.H{
                "result": person,
                "count":  1,
            }
        }
        c.JSON(http.StatusOK, result)

    })
    //利用post方法新增数据
    router.POST("/person", func(c *gin.Context) {
        var p Person
        err := c.Bind(&p)
        if err != nil {
            log.Fatal(err)
        }
        Id, err := p.add()
        fmt.Print("id=", Id)
        name := p.FirstName + " " + p.LastName
        c.JSON(http.StatusOK, gin.H{
            "message": fmt.Sprintf("%s 插入成功", name),
        })
    })
    //利用DELETE请求方法通过id删除
    router.DELETE("/person/:id", func(c *gin.Context) {
        id := c.Param("id")

        Id, err := strconv.ParseInt(id, 10, 10)
        if err != nil {
            log.Fatalln(err)
        }
        p := Person{Id: int(Id)}
        rows, err := p.del()
        if err != nil {
            log.Fatalln(err)
        }
        fmt.Println("delete rows ", rows)

        c.JSON(http.StatusOK, gin.H{
            "message": fmt.Sprintf("Successfully deleted user: %s", id),
        })
    })
    router.Run(":8080")
}

下一篇博客在学习下实际项目中的基于gorm的ORM层的SQL写法，以及规范的项目结构分层！

参考资料

https://godoc.org/github.com/gin-gonic/gin

https://gist.github.com/rsj217/26492af115a083876570f003c64df118

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 215,874评论 6赞 498
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 92,102评论 3赞 391
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 161,676评论 0赞 351
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 57,911评论 1赞 290
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 66,937评论 6赞 388
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 50,935评论 1赞 295
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 39,860评论 3赞 416
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 38,660评论 0赞 271
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 45,113评论 1赞 308
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,363评论 2赞 331
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,506评论 1赞 346
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 35,238评论 5赞 341
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 40,861评论 3赞 325
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,486评论 0赞 21
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,674评论 1赞 268
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 47,513评论 2赞 368
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 44,426评论 2赞 352