Golang 的Gin框架入门教学
Gin 介紹
Gin 是一個 Golang 寫的 web 框架,具有高性能的優(yōu)點,,基于 httprouter, 它提供了類似martini但更好性能(路由性能約快40倍)的API服務(wù)。 官方地址:https://github.com/gin-gonic/gin安裝框架
配置好GOPATH,建議自己在GOPATH建個項目,這里我以aze.org作為項目目錄。
$ go get github.com/gin-gonic/gin
安裝mysql驅(qū)動
$ go get github.com/go-sql-driver/mysql
組織項目
經(jīng)過上面的model和handler的分離,代碼結(jié)構(gòu)變得更加清晰,可是我們還是單文件。下一步將進行封裝不同的包。
數(shù)據(jù)庫處理
在項目根目錄創(chuàng)建下面三個文件夾,apis,databases和models,并在文件夾內(nèi)創(chuàng)建文件。此時我們的目錄結(jié)果如下
apis文件夾存放我們的handler函數(shù),models文件夾用來存放我們的數(shù)據(jù)模型。mysql.go:
package databaseimport ("database/sql"_ "github.com/go-sql-driver/mysql""log" )var SqlDB *sql.DBfunc init() {var err errorSqlDB, err = sql.Open("mysql", "root:@tcp(127.0.0.1:3306)/test?parseTime=true")if err != nil {log.Fatal(err.Error())}err = SqlDB.Ping()if err != nil {log.Fatal(err.Error())} }因為我們需要在別的地方使用SqlDB這個變量,因此依照golang的習慣,變量名必須大寫開頭。
數(shù)據(jù)model封裝
修改models文件夾下的person.go,把對應(yīng)的Person結(jié)構(gòu)及其方法移到這里:
package modelsimport ("log"db "newland/database" )type Person struct {Id int `json:"id" form:"id"`FirstName string `json:"first_name" form:"first_name"`LastName string `json:"last_name" form:"last_name"` }func (p *Person) AddPerson() (id int64, err error) {rs, err := db.SqlDB.Exec("INSERT INTO person(first_name, last_name) VALUES (?, ?)", p.FirstName, p.LastName)if err != nil {return}id, err = rs.LastInsertId()return }func (p *Person) GetPersons() (persons []Person, err error) {persons = make([]Person, 0)rows, err := db.SqlDB.Query("SELECT id, first_name, last_name FROM person")defer rows.Close()if err != nil {return}for rows.Next() {var person Personrows.Scan(&person.Id, &person.FirstName, &person.LastName)persons = append(persons, person)}if err = rows.Err(); err != nil {return}return } ..............handler
然后把具體的handler函數(shù)封裝到api包中,因為handler函數(shù)要操作數(shù)據(jù)庫,所以會引用model包
package apisimport ("net/http""log""fmt""github.com/gin-gonic/gin". "aze.org/models" )func IndexApi(c *gin.Context) {c.String(http.StatusOK, "It works") }func AddPersonApi(c *gin.Context) {firstName := c.Request.FormValue("first_name")lastName := c.Request.FormValue("last_name")p := Person{FirstName: firstName, LastName: lastName}ra, err := p.AddPerson()if err != nil {log.Fatalln(err)}msg := fmt.Sprintf("insert successful %d", ra)c.JSON(http.StatusOK, gin.H{"msg": msg,}) }......路由
最后就是把路由抽離出來,修改router.go,我們在路由文件中封裝路由函數(shù)
package mainimport ("github.com/gin-gonic/gin". "aze.orgd/apis" )func initRouter() *gin.Engine {router := gin.Default()router.GET("/", IndexApi)router.POST("/person", AddPersonApi)router.GET("/persons", GetPersonsApi)router.GET("/person/:id", GetPersonApi)router.PUT("/person/:id", ModPersonApi)router.DELETE("/person/:id", DelPersonApi)return router }app入口
最后就是main函數(shù)的app入口,將路由導入,同時我們要在main函數(shù)結(jié)束的時候,關(guān)閉全局的數(shù)據(jù)庫連接池:
main.go
package mainimport (db "aze.org/database" )func main() {defer db.SqlDB.Close()router := initRouter()router.Run(":8000") }此時運行項目,不能像之前簡單的使用go run main.go,因為包main包含main.go和router.go的文件,因此需要運行g(shù)o run *.go命令編譯運行。如果是最終編譯二進制項目,則運行g(shù)o build -o app,生成app文件直接./app就可以運行項目了。
總結(jié)
1.通過上述的實踐,我們了解了Gin框架創(chuàng)建基本的的restful服務(wù)。
2.golang 關(guān)鍵字不多,但是語法還是挺多的,需要認真學習,打好基礎(chǔ)。
3.多看優(yōu)秀的框架,再進行思考有沒有更好的寫法。
參考教程:
Gin框架 詳細文檔地址:https://godoc.org/github.com/gin-gonic/gin
項目地址:
https://github.com/onebig32/gin-learn.git
轉(zhuǎn)載于:https://blog.51cto.com/onebig/2165621
總結(jié)
以上是生活随笔為你收集整理的Golang 的Gin框架入门教学的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 安装好的nginx安装新的模块
- 下一篇: equals的用法的注意事项