go语言后端框架之简单探索
文章目录
- 前置教程
- 数据库对象关系映射--gorm
-
- 1. 安装必要库
- 2. 定义orm对象，生成数据表结构
- 路由定义及处理
-
- 1. 集中管理路由
- 2. 编写路由绑定的处理函数
- 3. 删 操作
- 4. 查 （包括分页，模糊搜索，倒序）
- 中间件（middleware）
-
- 1. 自定义响应体
- 2. 鉴权中间件
- 项目热更新启动
- 杂谈--新手探索
前置教程
- 基础语法：https://www.runoob.com/go/go-concurrent.html
- cgo相关：https://www.cntofu.com/book/73/ch6-web/ch6-01-introduction.md
- web开发简单实践-gin框架： https://www.chaindesk.cn/witbook/19/330
- go-gin-admin， 一个star破万的后端管理系统 : https://github.com/flipped-aurora/gin-vue-admin
- 官方英文doc: https://golang.google.cn/doc/
数据库对象关系映射–gorm
1. 安装必要库
go get -u gorm.io/driver/sqlite
go get -u gorm.io/gorm
go get gorm.io/driver/mysql
2. 定义orm对象，生成数据表结构
如下生成article的一张表 （models/articles）
package models
import (
"gorm.io/gorm"
)
// 数据库表结构
type Article struct {
gorm.Model // 会引入4个字段（ID，创建于，修改于，删除于），删除为软删除
Id uint `gorm:"primary_key"`
Title string
Author string
Category string //demo就这么搞了，应该关联另一个类别表
Content string
}
// 数据库访问方法（比如增删改查CRUD）
// ...more
- 初始化数据表
service/init.go
func initDB(){
//1. sqlite
db, err = gorm.Open(sqlite.Open("database/test.db"), &gorm.Config{})
//2. 连接Mysql数据库
//db, err = gorm.Open(mysql.Open(
// "root:pass@tcp(127.0.0.1:3306)/gincms?charset=utf8mb4&parseTime=True&loc=Local"),
// &gorm.Config{})
if err != nil {
panic("failed to connect database")
}
// Migrate the schema
db.AutoMigrate(&Article{})
// 插入内容
// db.Create(&Article{Title: "测试标题1", Author: "作者1", Content: "1000"})
// db.Create(&Article{Title: "测试标题2", Author: "作者2", Content: "3500"})
}
路由定义及处理
1. 集中管理路由
routers/router.go
func InitRouters() *gin.Engine {
router := gin.Default()
router.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))
// 路由分组
r:= router.Group("/api")
r.GET("/", withMain)
// 文章crud
r.GET("/article", handlers.GetArticle)
r.DELETE("/article", handlers.DeleteArticle)
r.POST("/article", handlers.AddArticle)
r.PUT("/article", handlers.EditArticle)
return router
}
2. 编写路由绑定的处理函数
func withMain(c *gin.Context) {
c.JSON(200, gin.H{
"main": "this is a main page"
})
}
...more
3. 删 操作
IN package handles
// @Summary 删除文章
// @Tags 文章
// @Produce json
// @Param id query string true "id"
// @Success 200 {string} json "{"code":200,"data":[],"message":"ok"}"
// @Router /api/article [delete]
func DeleteArticle(context *gin.Context) {
id := context.DefaultQuery("id", "null")
statusOK,_ := models.DeleteArticleById(id)
context.Set("result",If(statusOK,"成功","失败"))
}
IN package models:
func DeleteArticleById(id string) (bool, error) {
err := db.Where("id = ?", id).Delete(&Article{}).Error
if err != nil && err != gorm.ErrRecordNotFound {
return false, err
}
return true, nil
}
4. 查 （包括分页，模糊搜索，倒序）
中间件（middleware）
1. 自定义响应体
2. 鉴权中间件
项目热更新启动
类似于前端webpack保存时的热更新，go也有一大堆热重载工具
- fresh : 速度不错，几秒就ok
- gin run main.go : 有一说一，我改一个文件它就需要15s重新加载，慢。
- 打包：直接 go build main.go
- 交叉编译， 打包一个linux可用的x86_64的二进制包
set GOOS=linux
set GOARCH=amd64
go build main.go
杂谈–新手探索
- 关于go，相同package的不同文件中的方法可以互相直接调用。
- 参考了该项目routers和service的划分：https://github.com/eddycjy/go-gin-example
- .gitkeep可以让git工具追踪一个空文件夹
- git branch --orphan xxx 可以创建一个清空历史提交的分支
- swagger是一个不错的工具， 方便开发阶段-前后端联调， 虽然在路由处理函数前需要写额外的注释，但是这是很值得的。
- 关于函数或者变量的导出：在 Go 中，只要变量或函数的首字母大写就可以了。
- 关于x86_64和amd64，经历长久的磨合期，其实现在基本一致了。
- golang for循环
for key, value := range oldMap {
newMap[key] = value
}
- go全局变量定义
var db *gorm.DB
func xxx(){
db = ........
// 用成db:= ......,,,就gerp了，还是不太熟悉
}
- 含有cgo模块，比如go-sqlite3时，无法在windows上编译linux可执行文件，话说没有go原生实现的文件版小型数据库么。