文/朱季謙
環境準備：安裝Gin與Gorm
本文搭建準備環境：Gin+Gorm+MySql。
Gin是Go語言的一套WEB框架，在學習一種陌生語言的陌生框架，最好的方式，就是用我們熟悉的思維去學。作為一名後端Java開發，在最初入門時，最熟悉的莫過於MVC分層結構，可以簡單歸納成controller層，model層，dao層，而在SpringBoot框架裡，大概也經常看到以下的分層結構——
這個結構分為java根目錄與resources資源目錄。
在學習Go語言的Gin框架時，是否也可以參照這樣的分層結構來搭建一套簡單的後端系統呢。
答案是，肯定的。
接下來，我們就按照這個MVC分層結構，搭建一套基於Gin+Gorm框架的Go語言後端。
搭建之前，先簡單介紹一下Gin和Gorm分別是什麼。
Gin是一個golang的WEB框架，很輕量，依賴到很少，有些類似Java的SpringMVC，通過路由設定，可以將請求轉發到對應的處理器上。
Gorm是Go語言的ORM框架，提供一套對資料庫進行增刪改查的介面，使用它，就可以類似Java使用Hibernate框架一樣，可對資料庫進行相應操作。
若要用到這兩套框架，就需要import依賴進來，依賴進來前，需要Go命令安裝Gin和Gorm。
go get -u github.com/gin-gonic/gin
go get -u github.com/jinzhu/gorm
最好放在GOPATH目錄下。
我的GOPATH目錄在C:\Users\Administrator\go下：
通過Go命令安裝的依賴包放在這個目錄底下C:\Users\Administrator\go\src下：
現在，我們就參考SpringBoot的分層結構，搭建一套MVC分層結構系統。
一、搭建根目錄與資源目錄。
先建立一個Go專案，這裡，我取名為go-admin，底下建立一個go目錄，用於存放Go程式碼；一個resources資源目錄，存放配置檔案，結構如下——
go根目錄底下，建立controller、service、dao、entity包，另外，還需要一個router包，用於存放路由檔案，可能你對路由檔案不是很理解，那麼，你可以簡單理解為，這個路由的作用，就類似SpringMVC的@RequestMapping("/user")和@GetMapping("/list")註解組合起到的作用，通過路由，就可以找到需要呼叫的後端方法。建立完這些包後，若在SpringBoot專案裡，是否還缺少一個xxxxxApplication.java的啟動類，沒錯，在Go裡，同樣需要一個啟動類，該啟動類檔案可以直接命名為main.go。
建立以上包與類後，go根目錄底下結構如下：
接下來，是在resources資源目錄建立一個application.yaml配置檔案，當然，這個配置檔案可以隨便命名，不用像SpringBoot那樣需要考慮其命名背後所代表的優先順序。
這個配置檔案裡，就存放需要用到的Mysql資料庫連線資訊：
url: 127.0.0.1
userName: root
password: root
dbname: example
post: 3306
這些基礎工作做好後，就可以填充程式碼了。
二、dao層的搭建。
在dao層下，建立一個mysql.go檔案，這個檔案在dao的包下，最初的效果如下
按照以往jdbc連線資料庫的步驟，首先需要載入jdbc驅動程式，然後再建立資料庫的連線，其實，在Go連線資料庫，同樣需要類似這樣的操作。
首先，需要匯入資料庫驅動程式。
Gorm已經包含了驅動程式，只需要將它匯入進來即可：
import _ "github.com/jinzhu/gorm/dialects/mysql"
進入到這個依賴包的原始碼，根據命名就可以看到出，這是一個go語言的mysql驅動包——
除此之外，還提供了mssql、postgres、sqlite的驅動包。
底層使用到的是GORM 框架，自然也要把它依賴進來：
import "github.com/jinzhu/gorm"
另外，還需要依賴以下幾個包，用於讀取yaml配置檔案資料與拼接成url字串：
import "io/ioutil"
import "gopkg.in/yaml.v2"
import "fmt"
當依賴的包過多時，我們可以統一放到一個（）號裡，例如這樣：
import (
"github.com/jinzhu/gorm"
_ "github.com/jinzhu/gorm/dialects/mysql"
"io/ioutil"
"gopkg.in/yaml.v2"
"fmt"
)
到這一步，效果如下：
這裡爆紅色是正常的，Go語言與Java不同的一個地方是，若依賴進來的包，沒有被用到話，會直接出現紅色異常提示，後面寫到用到它們的程式碼時，就正常了。
接下來，定義一個用於接收yaml配置引數的struct結構體，你可以簡單將它理解為Java的類。
type conf struct {
Url string `yaml:"url"`
UserName string `yaml:"userName"`
Password string `yaml:"password"`
DbName string `yaml:"dbname"`
Port string `yaml:"post"`
}
然後提供一個讀取解析該yaml配置的方法，將讀取到的配置引數資料轉換成上邊的結構體conf
func (c *conf) getConf() *conf {
//讀取resources/application.yaml檔案
yamlFile, err := ioutil.ReadFile("resources/application.yaml")
//若出現錯誤，列印錯誤提示
if err != nil {
fmt.Println(err.Error())
}
//將讀取的字串轉換成結構體conf
err = yaml.Unmarshal(yamlFile, c)
if err != nil {
fmt.Println(err.Error())
}
return c
}
後面可以通過debug觀察一下，這個返回的c變數，它就類似Java的物件，裡邊是key-value形式的值——
最後，就可以根據這些解析到的配置引數，用來驅動連線資料庫了。
建立一個類似舊版mybatis全域性的SqlSession變數，就取名為SqlSession即可，該變數起到作用於mybatis的SqlSession例項類似，在資料庫驅動連線成功後，即可提供select/insert/update/delete方法。
var SqlSession *gorm.DB
然後定義一個初始化連線資料庫的方法，該方法用於在啟動專案時執行——
func InitMySql()(err error) {
var c conf
//獲取yaml配置引數
conf:=c.getConf()
//將yaml配置引數拼接成連線資料庫的url
dsn := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8mb4&parseTime=True&loc=Local",
conf.UserName,
conf.Password,
conf.Url,
conf.Port,
conf.DbName,
)
//連線資料庫
SqlSession,err =gorm.Open("mysql",dsn)
if err !=nil{
panic(err)
}
//驗證資料庫連線是否成功，若成功，則無異常
return SqlSession.DB().Ping()
}
最後，還需要提供一個可以關閉資料庫連線的方法——
func Close() {
SqlSession.Close()
}
到這裡，我們就完成了Dao層的搭建，該層裡的程式碼主要負責連線資料庫，建立一個取名為SqlSession全域性的*gorm.DB變數，該變數作用類似SqlSession,提供了操作資料庫的方法，最後，整塊dao層的mysql.go程式碼就如下：
package dao
import (
"github.com/jinzhu/gorm"
"io/ioutil"
)
import (
"github.com/jinzhu/gorm"
_ "github.com/jinzhu/gorm/dialects/mysql"
"io/ioutil"
"gopkg.in/yaml.v2"
"fmt"
)
//指定驅動
const DRIVER = "mysql"
var SqlSession *gorm.DB
//配置引數對映結構體
type conf struct {
Url string `yaml:"url"`
UserName string `yaml:"userName"`
Password string `yaml:"password"`
DbName string `yaml:"dbname"`
Port string `yaml:"post"`
}
//獲取配置引數資料
func (c *conf) getConf() *conf {
//讀取resources/application.yaml檔案
yamlFile, err := ioutil.ReadFile("resources/application.yaml")
//若出現錯誤，列印錯誤提示
if err != nil {
fmt.Println(err.Error())
}
//將讀取的字串轉換成結構體conf
err = yaml.Unmarshal(yamlFile, c)
if err != nil {
fmt.Println(err.Error())
}
return c
}
//初始化連線資料庫，生成可操作基本增刪改查結構的變數
func InitMySql()(err error) {
var c conf
//獲取yaml配置引數
conf:=c.getConf()
//將yaml配置引數拼接成連線資料庫的url
dsn := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8mb4&parseTime=True&loc=Local",
conf.UserName,
conf.Password,
conf.Url,
conf.Port,
conf.DbName,
)
//連線資料庫
SqlSession,err =gorm.Open(DRIVER,dsn)
if err !=nil{
panic(err)
}
//驗證資料庫連線是否成功，若成功，則無異常
return SqlSession.DB().Ping()
}
//關閉資料庫連線
func Close() {
SqlSession.Close()
}
三、entity層定義模型。
Gorm是全特性的ORM框架，即物件關係對映，這樣，就需要類似Java那樣建立與資料庫對映的類，在Go語言當中，我們稱之為結構體。
首先，先建立一張用於驗證的資料庫表結構——
CREATE TABLE `sys_user` (
`id` int(50) unsigned NOT NULL AUTO_INCREMENT,
`name` varchar(50) NOT NULL COMMENT '使用者名稱',
`nick_name` varchar(150) DEFAULT NULL COMMENT '暱稱',
`avatar` varchar(150) DEFAULT NULL COMMENT '頭像',
`password` varchar(100) DEFAULT NULL COMMENT '密碼',
`email` varchar(100) DEFAULT NULL COMMENT '郵箱',
`mobile` varchar(100) DEFAULT NULL COMMENT '手機號',
`create_time` bigint(50) DEFAULT NULL COMMENT '更新時間',
`del_status` tinyint(4) DEFAULT '0' COMMENT '是否刪除 -1：已刪除 0：正常',
PRIMARY KEY (`id`),
UNIQUE KEY `name` (`name`)
) ENGINE=InnoDB AUTO_INCREMENT=11 DEFAULT CHARSET=utf8 COMMENT='使用者表';
然後建立一個User.go檔案，裡邊定義一個User結構體——
type User struct {
Id int `json:"id"`
Name string `json:"name"`
NickName string `json:"nickName"`
Avatar string `json:"avatar"`
Password string `json:"password"`
Email string `json:"email"`
Mobile string `json:"mobile"`
DelStatus int `json:"delStatus"`
CreateTime int64 `json:"createTime"`
}
注意一點，這裡需要明確指出，其struct結構體對映到哪一張表，如果沒有顯示指出，它會預設生成一張命名為users的資料庫表——
// 資料庫表明自定義，預設為model的複數形式，比如這裡預設為 users
func (User) TableName() string {
return "sys_user"
}
到這一步，我們就完成了user模型關係建立。
package entity
// 資料庫表明自定義，預設為model的複數形式，比如這裡預設為 users
func (User) TableName() string {
return "sys_user"
}
type User struct {
Id int `json:"id"`
Name string `json:"name"`
NickName string `json:"nickName"`
Avatar string `json:"avatar"`
Password string `json:"password"`
Email string `json:"email"`
Mobile string `json:"mobile"`
DelStatus int `json:"delStatus"`
CreateTime int64 `json:"createTime"`
}
四、service層建立增刪改查業務邏輯。
在service層建立一個User的service類，命名為UserService.go。
這裡，需要引入兩個依賴，一個是dao層建立的全域性SqlSession，用於操作資料庫；一個是User類，用於接收資料庫對應表結構的資料。
import (
"go-admin/go/dao"
"go-admin/go/entity"
)
接下來，就可以基於SqlSession獲取到的API介面，對資料庫進行簡單的增刪改查操作了。
1.新增User資訊
/**
新建User資訊
*/
func CreateUser(user *entity.User)(err error) {
if err = dao.SqlSession.Create(user).Error;err!=nil{
return err
}
return
}
2.查詢所有的User記錄
/**
獲取user集合
*/
func GetAllUser()(userList []*entity.User,err error) {
if err:=dao.SqlSession.Find(&userList).Error;err!=nil{
return nil,err
}
return
}
3.根據id刪除對應的User資訊
/**
根據id刪除user
*/
func DeleteUserById(id string)(err error){
err = dao.SqlSession.Where("id=?",id).Delete(&entity.User{}).Error
return
}
4.根據id查詢使用者User
/**
根據id查詢使用者User
*/
func GetUserById(id string)(user *entity.User,err error) {
if err = dao.SqlSession.Where("id=?",id).First(user).Error;err!=nil{
return nil,err
}
return
}
5.更新使用者資訊
/**
更新使用者資訊
*/
func UpdateUser(user * entity.User)(err error) {
err = dao.SqlSession.Save(user).Error
return
}
UserService.go的完整程式碼如下：
package service
import (
"go-admin/go/dao"
"go-admin/go/entity"
)
/**
新建User資訊
*/
func CreateUser(user *entity.User)(err error) {
if err = dao.SqlSession.Create(user).Error;err!=nil{
return err
}
return
}
/**
獲取user集合
*/
func GetAllUser()(userList []*entity.User,err error) {
if err:=dao.SqlSession.Find(&userList).Error;err!=nil{
return nil,err
}
return
}
/**
根據id刪除user
*/
func DeleteUserById(id string)(err error){
err = dao.SqlSession.Where("id=?",id).Delete(&entity.User{}).Error
return
}
/**
根據id查詢使用者User
*/
func GetUserById(id string)(user *entity.User,err error) {
if err = dao.SqlSession.Where("id=?",id).First(user).Error;err!=nil{
return nil,err
}
return
}
/**
更新使用者資訊
*/
func UpdateUser(user * entity.User)(err error) {
err = dao.SqlSession.Save(user).Error
return
}
五、controller層建立User的controller類。
在controller層建立一個UserController.go類，類似Java的controller，主要用於根據url跳轉執行到對應路徑的方法。
首先，引入需要用到的依賴包，
import (
//需要用到的結構體
"go-admin/go/entity"
//gin框架的依賴
"github.com/gin-gonic/gin"
//http連線包
"net/http"
//service層方法
"go-admin/go/service"
)
接下來，可以實現增刪改查的controller方法了。
1.實現新增User的方法
func CreateUser(c *gin.Context) {
//定義一個User變數
var user entity.User
//將呼叫後端的request請求中的body資料根據json格式解析到User結構變數中
c.BindJSON(&user)
//將被轉換的user變數傳給service層的CreateUser方法，進行User的新建
err:=service.CreateUser(&user)
//判斷是否異常，無異常則返回包含200和更新資料的資訊
if err!=nil{
c.JSON(http.StatusBadRequest,gin.H{"error":err.Error()})
}else {
c.JSON(http.StatusOK,gin.H{
"code":200,
"msg":"success",
"data":user,
})
}
}
2.查詢User的方法
func GetUserList(c *gin.Context) {
todoList,err :=service.GetAllUser()
if err!=nil{
c.JSON(http.StatusBadRequest,gin.H{"error":err.Error()})
}else {
c.JSON(http.StatusOK,gin.H{
"code":200,
"msg":"success",
"data":todoList,
})
}
}
六、routes層增加路由檔案，用於根據請求url進行轉發。
routes層新建一個Routers.go檔案。
首先，同樣需要引入需要用到的依賴——
import (
"go-admin/go/controller"
"github.com/gin-gonic/gin"
)
然後搭建一個初始化路由的操作，將路由統一存放到資料user的group組裡，這樣可以比較方便區分這些路由資料哪個controller類的。
Routers.go檔案完整程式碼如下：
package routes
import (
"go-admin/go/controller"
"github.com/gin-gonic/gin"
)
func SetRouter() *gin.Engine {
r :=gin.Default()
/**
使用者User路由組
*/
userGroup :=r.Group("user")
{
//增加使用者User
userGroup.POST("/users",controller.CreateUser)
//檢視所有的User
userGroup.GET("/users",controller.GetUserList)
//修改某個User
userGroup.PUT("/users/:id",controller.UpdateUser)
//刪除某個User
userGroup.DELETE("/users/:id",controller.DeleteUserById)
}
return r
}
七、main啟動類。
最後一步，就是建立main的啟動類了，需要注意一點是，go的啟動類，必須命名在package main的包下，否則無法進行啟動。
首先，還是需要先引入依賴,main啟動類需要用到dao、entity、routers以及mysql驅動包。
import (
"go-admin/go/dao"
"go-admin/go/entity"
"go-admin/go/routes"
_ "github.com/jinzhu/gorm/dialects/mysql"
)
啟動方法裡的程式碼主要如下，即前邊搭建的東西，這裡都有用到了——
func main() {
//連線資料庫
err :=dao.InitMySql()
if err !=nil{
panic(err)
}
//程式退出關閉資料庫連線
defer dao.Close()
//繫結模型
dao.SqlSession.AutoMigrate(&entity.User{})
//註冊路由
r :=routes.SetRouter()
//啟動埠為8085的專案
r.Run(":8081")
}
到這一步，就可以啟動專案了，正常情況下，啟動成功會顯示以下日誌資訊——
到這一步，基於Gin+Gorm框架搭建MVC模式的Go後端系統，就初步搭建完成了。
最後，程式碼已經上傳到GitHub：https://github.com/z924931408/go-admin.git
歡迎關注公眾號，關於思考，關於文化，關於成長——
