TMDOG的Gin学习笔记_01——初识Gin框架
博客地址：[TMDOG的博客](https://blog.tmdog114514.icu)
作者自述：
停更太久了，是因为开学了课太多了，并且我一直在准备上篇文章的内容正在coding，就先搁置了更新博客QAQ，现在终于闲下来了。
说实话挺久没有进行golang的编程了，但以前上课系统学习了golang并且期末项目就是使用beego实现的[CRM管理系统](https://gitee.com/mbjdot/biego-final-project)（可以康康），所以上手gin还是比较快的。
学习目标
使用Gin框架实现一个微服务，并整合到上篇博客的项目中。
预期将会使用的技术栈： Gin、GORM、Postgres、gRPC、Docker
Gin快速入门
1. 安装Gin
首先，确保你已安装Go。然后使用以下命令安装Gin：
go get -u github.com/gin-gonic/gin
2. 创建一个简单的Web应用
在你的项目目录下，创建一个新的Go文件，例如main.go，并添加以下代码：
package main
import (
"github.com/gin-gonic/gin"
)
func main() {
// 创建一个默认的Gin路由
r := gin.Default()
// 设置一个简单的GET路由
r.GET("/", func(c *gin.Context) {
c.JSON(200, gin.H{
"message": "hello gin",
})
})
// 启动服务器，监听在8080端口
r.Run(":8080")
}
3. 运行你的应用
在终端中，运行以下命令启动你的应用：
go run main.go
4. 测试API
打开你的浏览器或使用工具（如Postman或curl），访问 http://localhost:8080/。你应该会看到以下JSON响应：
Gin整合GORM
1. 安装GORM依赖
使用go get命令安装GORM和Postgres驱动的依赖：
go get gorm.io/gorm
go get gorm.io/driver/postgres
2. 初始化数据库连接并构建表模型
以用户表为例进行初始化：
// User模型
type User struct {
ID uint `gorm:"primaryKey;autoIncrement"`
Name string `gorm:"not null"`
Email string `gorm:"not null"`
}
var db *gorm.DB
func init() {
// 数据库连接信息
dsn := "host=localhost user=postgres password=123456 dbname=postgres port=5432 sslmode=disable TimeZone=Asia/Shanghai"
var err error
// 连接数据库
db, err = gorm.Open(postgres.Open(dsn), &gorm.Config{})
if err != nil {
panic("failed to connect to database")
}
// 自动迁移（将在数据库中创建表）
db.AutoMigrate(&User{})
}
3. 编写接口
实现对用户表的增删改查接口：
// 创建用户
r.POST("/users", func(c *gin.Context) {
var user User
if err := c.ShouldBindJSON(&user); err != nil {
c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
return
}
db.Create(&user)
c.JSON(http.StatusCreated, user)
})
// 获取所有用户
r.GET("/users", func(c *gin.Context) {
var users []User
db.Find(&users)
c.JSON(http.StatusOK, users)
})
// 根据ID获取用户
r.GET("/users/:id", func(c *gin.Context) {
var user User
id := c.Param("id")
if err := db.First(&user, id).Error; err != nil {
c.JSON(http.StatusNotFound, gin.H{"error": "User not found"})
return
}
c.JSON(http.StatusOK, user)
})
// 更新用户
r.PUT("/users/:id", func(c *gin.Context) {
var user User
id := c.Param("id")
if err := db.First(&user, id).Error; err != nil {
c.JSON(http.StatusNotFound, gin.H{"error": "User not found"})
return
}
if err := c.ShouldBindJSON(&user); err != nil {
c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
return
}
db.Save(&user)
c.JSON(http.StatusOK, user)
})
// 删除用户
r.DELETE("/users/:id", func(c *gin.Context) {
id := c.Param("id")
if err := db.Delete(&User{}, id).Error; err != nil {
c.JSON(http.StatusNotFound, gin.H{"error": "User not found"})
return
}
c.Status(http.StatusNoContent)
})
4. 测试
使用Postman或curl测试API：
-
创建用户:
curl -X POST http://localhost:8080/users -H "Content-Type: application/json" -d '{"name":"Alice", "email":"alice@example.com"}' -
获取所有用户:
curl -X GET http://localhost:8080/users -
获取单个用户:
curl -X GET http://localhost:8080/users/1 -
更新用户:
curl -X PUT http://localhost:8080/users/1 -H "Content-Type: application/json" -d '{"name":"Alice Updated", "email":"alice.updated@example.com"}' -
删除用户:
curl -X DELETE http://localhost:8080/users/1
5. 测试结果
总结
通过本篇学习笔记，我们初步了解了gin的基本用法，包括如何安装、创建简单的Web应用以及整合gorm进行数据库操作。我们实现了一个用户管理的RESTful API，能够完成基本的增删改查功能。我们发现gin是一个非常简洁的一个框架，几行代码就可以构建一个Web应用，和express.js有着异曲同工之妙。接下来我会继续分享我的学习笔记，尽请期待。
