如何使用 Gin 和 Gorm 搭建一個簡單的 API 服務(wù) （二）

gin-gonic

??這是系列文章的第二篇乒省。下面是另外兩篇的鏈接：
??如何使用 Gin 和 Gorm 搭建一個簡單的 API 服務(wù)（一）
??如何使用 Gin 和 Gorm 搭建一個簡單的 API 服務(wù)（三）

創(chuàng)建 API

??我們之前已經(jīng)跑過 Gin 框架的代碼资盅，現(xiàn)在是時候加些功能進(jìn)去了古程。

讀取全部信息

??我們先從＂增刪改查＂中的＂查＂入手礁鲁，查詢我們之前添加的信息待侵。我接下來要刪除幾行代碼陌选，并把 Gin 的框架代碼加回來替蔬。

package main

import (
        "fmt"
        "github.com/gin-gonic/gin"
        "github.com/jinzhu/gorm"
        _ "github.com/jinzhu/gorm/dialects/sqlite"
)

var db *gorm.DB
var err error

type Person struct {
        ID        uint   `json:"id”`
        FirstName string `json:"firstname”`
        LastName  string `json:"lastname”`
}

func main() {
        // NOTE: See we’re using = to assign the global var
        // instead of := which would assign it only in this function
        db, err = gorm.Open("sqlite3", "./gorm.db")
        if err != nil {
                fmt.Println(err)
        }
        defer db.Close()
        db.AutoMigrate(&Person{})
        r := gin.Default()
        r.GET("g/", GetProjects)
        r.Run("g:8080")
}

func GetProjects(c *gin.Context) {
        var people []Person
        if err := db.Find(&people).Error; err != nil {
                c.AbortWithStatus(404)
                fmt.Println(err)
        } else {
                c.JSON(200, people)
        }
}

??那么運(yùn)行程序厨幻，并在瀏覽器中訪問 http://localhost:8080相嵌，你應(yīng)該看到：

[{“id”: 1,”firstname”: “John”,”lastname”: “Doe”}]

??喔，幾行代碼我們就可以拿到 API 服務(wù)器的響應(yīng)了况脆，而且大部分代碼都是用來錯誤處理的饭宾。

讀取特定信息

??好，為了把 API 接口寫的更符合 REST 規(guī)范格了，我們加入查詢特定信息的借口

package main

import (
    "fmt"
    "github.com/gin-gonic/gin"
    "github.com/jinzhu/gorm"
    _ "github.com/jinzhu/gorm/dialects/sqlite"
)

var db *gorm.DB
var err error

type Person struct {
    ID        uint   `json:"id”`
    FirstName string `json:"firstname”`
    LastName  string `json:"lastname”`
}

func main() {
    // NOTE: See we’re using = to assign the global var
    // instead of := which would assign it only in this function
    db, err = gorm.Open("sqlite3", "./gorm.db")
    if err != nil {
        fmt.Println(err)
    }
    defer db.Close()
    db.AutoMigrate(&Person{})
    r := gin.Default()

    r.GET("g/", GetProjects)
    r.GET("/people/:id", GetPerson)

    r.Run("g:8080")
}

func GetProjects(c *gin.Context) {
    var people []Person
    if err := db.Find(&people).Error; err != nil {
        c.AbortWithStatus(404)
        fmt.Println(err)
    } else {
        c.JSON(200, people)
    }
}

func GetPerson(c *gin.Context) {
    id := c.Params.ByName("id")
    var person Person
    if err := db.Where("id = ?", id).First(&person).Error; err != nil {
        c.AbortWithStatus(404)
        fmt.Println(err)
    } else {
        c.JSON(200, person)
    }
}

??現(xiàn)在運(yùn)行程序看铆，但請注意，如果要訪問全部信息盛末，你需要訪問的地址變成了 http://localhost:8080/people/ 弹惦，如果 在 URL 的末尾加入了 ID否淤，你就會得到特定的信息 http://localhost:8080/people/1

{"id": 1, "firstname": "John", "lastname": "Doe"}

添加信息

??只有一條記錄是看不大出來查詢?nèi)啃畔⒑筒樵儐螚l信息的區(qū)別的，所以咱們來把添加信息的功能加上吧棠隐。

package main

import (
    "fmt"
    "github.com/gin-gonic/gin"
    "github.com/jinzhu/gorm"
    _ "github.com/jinzhu/gorm/dialects/sqlite"
)

var db *gorm.DB
var err error

type Person struct {
    ID        uint   `json:"id”`
    FirstName string `json:"firstname”`
    LastName  string `json:"lastname”`
}

func main() {
    // NOTE: See we’re using = to assign the global var
    // instead of := which would assign it only in this function
    db, err = gorm.Open("sqlite3", "./gorm.db")
    if err != nil {
        fmt.Println(err)
    }
    defer db.Close()
    db.AutoMigrate(&Person{})
    r := gin.Default()

    r.GET("g/", GetProjects)
    r.GET("/people/:id", GetPerson)
    r.POST("/people", CreatePerson)

    r.Run("g:8080")
}

func GetProjects(c *gin.Context) {
    var people []Person
    if err := db.Find(&people).Error; err != nil {
        c.AbortWithStatus(404)
        fmt.Println(err)
    } else {
        c.JSON(200, people)
    }
}

func GetPerson(c *gin.Context) {
    id := c.Params.ByName("id")
    var person Person
    if err := db.Where("id = ?", id).First(&person).Error; err != nil {
        c.AbortWithStatus(404)
        fmt.Println(err)
    } else {
        c.JSON(200, person)
    }
}

func CreatePerson(c *gin.Context) {
    var person Person
    c.BindJSON(&person)
    db.Create(&person)
    c.JSON(200, person)
}

??接下來讓我們從終端運(yùn)行 curl 命令測試一下新加的功能是不是可用石抡，當(dāng)然還是先要把程序運(yùn)行起來。
??在終端運(yùn)行：

$ curl -i -X POST http://localhost:8080/people -d '{ "FirstName": "Elvis", "LastName": "Presley"}'

??應(yīng)該會看到成功的響應(yīng)消息：

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Sat, 03 Dec 2016 00:14:06 GMT
Content-Length: 50
{"id":2,"firstname":"Elvis","lastname":"Presley"}

??現(xiàn)在我們訪問一下查詢?nèi)啃畔⒌慕涌冢?a href="http://localhost:8080/people/" target="_blank" rel="nofollow">http://localhost:8080/people/

[{"id": 1,"firstname": "John","lastname": "Doe"},{"id": 2,"firstname": "Elvis","lastname": "Presley"}]

??太棒啦助泽，代碼沒問題啰扛。這回我們只發(fā)送 Person 結(jié)構(gòu)體的部分信息，看看程序會如何處理嗡贺。

$ curl -i -X POST http://localhost:8080/people -d '{ "FirstName": "Madison"}'

??刷新一下瀏覽器侠讯，發(fā)現(xiàn)只添加了我們發(fā)送的信息。

[{"id": 1,"firstname": "John","lastname": "Doe"},{"id": 2,"firstname": "Elvis","lastname": "Presley"},{"id": 3,"firstname": "Madison","lastname": ""}]

??這就是 Gin 如何工作的了暑刃，留意一下 c.BindJSON(&person) 這行厢漩，它會自動匹配請求消息中的數(shù)據(jù)信息。
??雖然請求消息里可能缺某些信息岩臣，就比如剛才那個例子溜嗜，而且大小寫不匹配也沒有關(guān)系，Gin 的容錯性非常高架谎。非常簡單炸宵！

更新信息

??我們不能把 Madison 這條記錄沒有姓氏啊，是時候加入更新功能了谷扣。

package main

import (
    "fmt"
    "github.com/gin-gonic/gin"
    "github.com/jinzhu/gorm"
    _ "github.com/jinzhu/gorm/dialects/sqlite"
)

var db *gorm.DB
var err error

type Person struct {
    ID        uint   `json:"id"`
    FirstName string `json:"firstname"`
    LastName  string `json:"lastname"`
}

func main() {
    // NOTE: See we're using = to assign the global var
    // instead of := which would assign it only in this function
    db, err = gorm.Open("sqlite3", "./gorm.db")
    if err != nil {
        fmt.Println(err)
    }
    defer db.Close()
    db.AutoMigrate(&Person{})
    r := gin.Default()

    r.GET("g/", GetProjects)
    r.GET("/people/:id", GetPerson)
    r.POST("/people", CreatePerson)
    r.PUT("/people/:id", UpdatePerson)

    r.Run("g:8080")
}

func GetProjects(c *gin.Context) {
    var people []Person
    if err := db.Find(&people).Error; err != nil {
        c.AbortWithStatus(404)
        fmt.Println(err)
    } else {
        c.JSON(200, people)
    }
}

func GetPerson(c *gin.Context) {
    id := c.Params.ByName("id")
    var person Person
    if err := db.Where("id = ?", id).First(&person).Error; err != nil {
        c.AbortWithStatus(404)
        fmt.Println(err)
    } else {
        c.JSON(200, person)
    }
}

func CreatePerson(c *gin.Context) {
    var person Person
    c.BindJSON(&person)
    db.Create(&person)
    c.JSON(200, person)
}

func UpdatePerson(c *gin.Context) {
    var person Person
    id := c.Params.ByName("id")
    if err := db.Where("id = ?", id).First(&person).Error; err != nil {
        c.AbortWithStatus(404)
        fmt.Println(err)
    }
    c.BindJSON(&person)
    db.Save(&person)
    c.JSON(200, person)
}

??這次我們用類似的 curl 命令 進(jìn)行測試土全，但不同的是用 PUT 方法，而且是用在特定的信息上会涎。

$ curl -i -X PUT http://localhost:8080/people/3 -d '{ "FirstName": "Madison", "LastName":"Sawyer" }'
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Sat, 03 Dec 2016 00:25:35 GMT
Content-Length: 51
{"id":3,"firstname":"Madison","lastname":"Sawyer"}

??當(dāng)然更新瀏覽器后裹匙，我們就可以看見 "sawyer" 添加到了 "LastName" 一欄里。

[{"id": 1,"firstname": "John","lastname": "Doe"},{"id": 2,"firstname": "Elvis","lastname": "Presley"},{"id": 3,"firstname": "Madison","lastname": "Sawyer"}]

??這次我們只更新 "FirstName" 字段試試末秃。

$ curl -i -X PUT http://localhost:8080/people/3 -d '{ "FirstName": "Tom" }'

??顯示如下

[{"id": 1,"firstname": "John","lastname": "Doe"},{"id": 2,"firstname": "Elvis","lastname": "Presley"},{"id": 3,"firstname": "Tom","lastname": "Sawyer"}]

刪除

??這次輪到刪除功能了

package main

import (
    "fmt"
    "github.com/gin-gonic/gin"
    "github.com/jinzhu/gorm"
    _ "github.com/jinzhu/gorm/dialects/sqlite"
)

var db *gorm.DB
var err error

type Person struct {
    ID        uint   `json:"id"`
    FirstName string `json:"firstname"`
    LastName  string `json:"lastname"`
}

func main() {
    // NOTE: See we're using = to assign the global var
    // instead of := which would assign it only in this function
    db, err = gorm.Open("sqlite3", "./gorm.db")
    if err != nil {
        fmt.Println(err)
    }
    defer db.Close()
    db.AutoMigrate(&Person{})
    r := gin.Default()

    r.GET("g/", GetProjects)
    r.GET("/people/:id", GetPerson)
    r.POST("/people", CreatePerson)
    r.PUT("/people/:id", UpdatePerson)
    r.DELETE("/people/:id", DeletePerson)

    r.Run("g:8080")
}

func GetProjects(c *gin.Context) {
    var people []Person
    if err := db.Find(&people).Error; err != nil {
        c.AbortWithStatus(404)
        fmt.Println(err)
    } else {
        c.JSON(200, people)
    }
}

func GetPerson(c *gin.Context) {
    id := c.Params.ByName("id")
    var person Person
    if err := db.Where("id = ?", id).First(&person).Error; err != nil {
        c.AbortWithStatus(404)
        fmt.Println(err)
    } else {
        c.JSON(200, person)
    }
}

func CreatePerson(c *gin.Context) {
    var person Person
    c.BindJSON(&person)
    db.Create(&person)
    c.JSON(200, person)
}

func UpdatePerson(c *gin.Context) {
    var person Person
    id := c.Params.ByName("id")
    if err := db.Where("id = ?", id).First(&person).Error; err != nil {
        c.AbortWithStatus(404)
        fmt.Println(err)
    }
    c.BindJSON(&person)
    db.Save(&person)
    c.JSON(200, person)
}

func DeletePerson(c *gin.Context) {
    id := c.Params.ByName("id")
    var person Person
    d := db.Where("id = ?", id).Delete(&person)
    fmt.Println(d)
    c.JSON(200, gin.H{"id #" + id: "deleted"})
}

??我們用 curl 的 Delete 方法測試一下

$ curl -i -X DELETE http://localhost:8080/people/1

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Sat, 03 Dec 2016 00:32:40 GMT
Content-Length: 20

{"id #1":"deleted"}

??刷新瀏覽器概页，John Doe 這條記錄已經(jīng)刪掉了。

[{"id": 2,"firstname": "Elvis","lastname": "Presley"},{"id": 3,"firstname": "Tom","lastname": "Sawyer"}]
最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 人面猴
    序言：七十年代末练慕，一起剝皮案震驚了整個濱河市惰匙，隨后出現(xiàn)的幾起案子，更是在濱河造成了極大的恐慌铃将，老刑警劉巖项鬼，帶你破解...
    沈念sama閱讀 222,252評論 6贊 516
  • 死咒
    序言：濱河連續(xù)發(fā)生了三起死亡事件，死亡現(xiàn)場離奇詭異劲阎，居然都是意外死亡绘盟，警方通過查閱死者的電腦和手機(jī)，發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,886評論 3贊 399
  • 救了他兩次的神仙讓他今天三更去死
    文/潘曉璐 我一進(jìn)店門，熙熙樓的掌柜王于貴愁眉苦臉地迎上來奥此，“玉大人弧哎，你說我怎么就攤上這事≈苫ⅲ” “怎么了撤嫩？”我有些...
    開封第一講書人閱讀 168,814評論 0贊 361
  • 道士緝兇錄：失蹤的賣姜人
    文/不壞的土叔 我叫張陵，是天一觀的道長蠢终。 經(jīng)常有香客問我序攘，道長，這世上最難降的妖魔是什么寻拂？ 我笑而不...
    開封第一講書人閱讀 59,869評論 1贊 299
  • ?港島之戀（遺憾婚禮）
    正文 為了忘掉前任程奠，我火速辦了婚禮，結(jié)果婚禮上祭钉，老公的妹妹穿的比我還像新娘瞄沙。我一直安慰自己，他們只是感情好慌核，可當(dāng)我...
    茶點(diǎn)故事閱讀 68,888評論 6贊 398
  • 惡毒庶女頂嫁案：這布局不是一般人想出來的
    文/花漫 我一把揭開白布距境。 她就那樣靜靜地躺著，像睡著了一般垮卓。 火紅的嫁衣襯著肌膚如雪垫桂。 梳的紋絲不亂的頭發(fā)上，一...
    開封第一講書人閱讀 52,475評論 1贊 312
  • 城市分裂傳說
    那天粟按，我揣著相機(jī)與錄音诬滩，去河邊找鬼。 笑死灭将，一個胖子當(dāng)著我的面吹牛疼鸟，可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播宗侦，決...
    沈念sama閱讀 41,010評論 3贊 422
  • 雙鴛鴦連環(huán)套：你想象不到人心有多黑
    文/蒼蘭香墨 我猛地睜開眼愚臀，長吁一口氣：“原來是場噩夢啊……” “哼！你這毒婦竟也來了矾利？” 一聲冷哼從身側(cè)響起，我...
    開封第一講書人閱讀 39,924評論 0贊 277
  • 萬榮殺人案實(shí)錄
    序言：老撾萬榮一對情侶失蹤馋袜，失蹤者是張志新（化名）和其女友劉穎男旗，沒想到半個月后，有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體欣鳖，經(jīng)...
    沈念sama閱讀 46,469評論 1贊 319
  • ?護(hù)林員之死
    正文 獨(dú)居荒郊野嶺守林人離奇死亡察皇，尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,552評論 3贊 342
  • ?白月光啟示錄
    正文 我和宋清朗相戀三年，在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片什荣。...
    茶點(diǎn)故事閱讀 40,680評論 1贊 353
  • 活死人
    序言：一個原本活蹦亂跳的男人離奇死亡矾缓，死狀恐怖，靈堂內(nèi)的尸體忽然破棺而出稻爬，到底是詐尸還是另有隱情嗜闻，我是刑警寧澤，帶...
    沈念sama閱讀 36,362評論 5贊 351
  • ?日本核電站爆炸內(nèi)幕
    正文 年R本政府宣布桅锄，位于F島的核電站琉雳，受9級特大地震影響，放射性物質(zhì)發(fā)生泄漏友瘤。R本人自食惡果不足惜翠肘，卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,037評論 3贊 335
  • 男人毒藥：我在死后第九天來索命
    文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望辫秧。 院中可真熱鬧束倍，春花似錦、人聲如沸盟戏。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,519評論 0贊 25
  • 一樁弒父案，背后竟有這般陰謀
    文/蒼蘭香墨 我抬頭看了看天上的太陽抓半。三九已至喂急，卻和暖如春，著一層夾襖步出監(jiān)牢的瞬間笛求，已是汗流浹背廊移。 一陣腳步聲響...
    開封第一講書人閱讀 33,621評論 1贊 274
  • 情欲美人皮
    我被黑心中介騙來泰國打工， 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留探入，地道東北人狡孔。 一個月前我還...
    沈念sama閱讀 49,099評論 3贊 378
  • 代替公主和親
    正文 我出身青樓，卻偏偏與公主長得像蜂嗽，于是被迫代替她去往敵國和親苗膝。 傳聞我的和親對象是個殘疾皇子，可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,691評論 2贊 361

推薦閱讀更多精彩內(nèi)容

  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具（例如配置管理植旧，服務(wù)發(fā)現(xiàn)辱揭，斷路器，智...
    卡卡羅2017閱讀 134,711評論 18贊 139
  • ??今天工作上的事情比較多病附，所以就把工作中參考的英文文章搬運(yùn)過來了问窃，這是我參考文章的鏈接：??Developing...
    blackpiglet閱讀 15,071評論 1贊 30
  • 時間是一架成長機(jī)器，會細(xì)細(xì)雕琢出長大的樣子完沪。 轉(zhuǎn)眼我的小乖寶都六個月了域庇。從出生時只會張張小嘴動動眼嵌戈，到后來的轉(zhuǎn)轉(zhuǎn)頭...
    唯陌私語閱讀 477評論 0贊 1
  • 1.字符串中包含多個轉(zhuǎn)義字符的時候 多行字符串前面添加r，把這個多行字符串也變成一個raw字符串 r'''Pyth...
    急躁的假漢子閱讀 729評論 0贊 0
  • 世界三大著名美食國家分別是:土耳其,法國,中國. 土耳其 土耳其是一個非常注重美食的國家听皿。名列世界三大著名美食國家...
    涼城x染瞳閱讀 1,825評論 0贊 0