目录

  • 前言
  • 一、设计思路
  • 二、编写后端请求
    • 1、在Terminal终端输入 go mod
    • 2、下载并安装所需要的包
    • 3、创建路由
    • 4、数据库连接
      • 1）设计数据表
      • 2）数据库连接
  • 三、实现路由方法
    • 1、创建一条记录
    • 2、查询所有记录
    • 3、查找指定id的记录
    • 4、修改指定id记录
    • 5、删除指定id记录
  • 四、结论

前言

感谢开源项目gin-vue-admin，以及1010工作室的视频教程
本人学识尚浅，如有错误，请评论指出，谢谢！
详细可见个人博客：https://linzyblog.netlify.app/

本章会用到的技术，不太熟悉的可以去看看我以前的文章

  1. 快速安装gin框架：https://blog.csdn.net/weixin_46618592/article/details/125540869
  2. HTTP请求：https://blog.csdn.net/weixin_46618592/article/details/125565789
  3. Gorm入门指南：https://blog.csdn.net/weixin_46618592/article/details/125647217
  4. GORM框架进阶之CRUD接口(数据库增删改查操作)：https://blog.csdn.net/weixin_46618592/article/details/125740498

一、设计思路

这章动手把前面学过的Gin框架内容和Gorm框架结合做一个简单的API 微服务

我们需要通过前端来完成对数据库数据的增删改查即可，需要如下这样的 API ：

  1. POST todos/ 添加数据
  2. GET todos/ 获取数据库所有数据
  3. GET todos/{id} 获取指定 id 的数据
  4. PUT todos/{id} 修改指定 id 的数据
  5. DELETE todos/{id} 删除指定 id 的数据

二、编写后端请求

创建一个 todos 文件夹，用VSCode打开当前文件夹

1、在Terminal终端输入 go mod

go mod init todo

创建包管理工具，此命令会在当前目录中初始化和创建一个新的go.mod文件，手动创建go.mod文件再包含一些module声明也等同该命令，而go mod init命令便是帮我们简便操作，可以帮助我们自动创建。

2、下载并安装所需要的包

go get -u github.com/gin-gonic/gingo get -u gorm.io/driver/mysqlgo get -u gorm.io/gorm

3、创建路由

在 todo 文件夹下创建一个名为 main.go 的文件，在 main 文件中创建一个类似下面的路由，将同一个功能模块放到同一个路由分组中，代码更美观易懂

package mainimport ("github.com/gin-gonic/gin")func main() {router := gin.Default()v1 := router.Group("/api/v1/todos"){v1.POST("/", createTodo)v1.GET("/", fetchAllTodo)v1.GET("/:id", fetchSingleTodo)v1.PUT("/:id", updateTodo)v1.DELETE("/:id", deleteTodo)}router.Run()}

4、数据库连接

现在我们要实现数据库连接就要用到GORM框架，GORM框架是go的一个数据库连接及交互框架，主要是把struct类型和数据库记录进行映射，数据库语句复杂的情况下可以直接手写语句，一般用于连接关系型数据库，这里我主要使用MySQL数据库。

1）设计数据表

//数据库字段type todoModel struct {gorm.ModelTitle     string `json:"title"`Completed int    `json:"completed"`}//处理返回字段type transformedTodo struct {ID        int    `json:"id"`Title     string `json:"title"`Completed bool   `json:"completed"`}

2）数据库连接

package mainimport ("gorm.io/driver/mysql""gorm.io/gorm")var db *gorm.DBfunc init() {dsn := "root:123456@tcp(127.0.0.1:3306)/go_test" />
 
  • 数据库
 
 
2、查询所有记录
 
使用到了 Gin 框架中的 GET 请求，没有参数，用 Gorm 框架连接数据库使用Find方法查询所有记录，封装在JSON里返回给前端用户
 
//获取数据库所有todofunc selectAllTodo(c *gin.Context) {var todos []todoModelvar rq_todos []transformedTododb.Find(&todos)if len(todos) <= 0 {c.JSON(http.StatusNotFound, gin.H{"status":  http.StatusNotFound,"message": "No todo found!",})return}for _, item := range todos {completed := falseif item.Completed == 1 {completed = true}rq_todos = append(rq_todos, transformedTodo{ID:        int(item.ID),Title:     item.Title,Completed: completed,})}c.JSON(http.StatusOK, gin.H{"status": http.StatusOK,"data":   rq_todos,})}
  • GET请求
  • 数据库
3、查找指定id的记录
使用到了 Gin 框架中的 Context 上下文来接收 GET 方式存放在URI里传过来的参数，用 Gorm 框架连接数据库使用Find方法或者First方法查询指定记录，封装在JSON里返回给前端用户
//查找指定todofunc selectSingleTodo(c *gin.Context) {var todo todoModeltodoID := c.Param("id")db.First(&todo, todoID)if todo.ID == 0 {c.JSON(http.StatusNotFound, gin.H{"status":  http.StatusNotFound,"message": "No todo found!",})return}completed := falseif todo.Completed == 1 {completed = true}rp_todo := transformedTodo{ID:        int(todo.ID),Title:     todo.Title,Completed: completed,}c.JSON(http.StatusOK, gin.H{"status": http.StatusOK,"data":   rp_todo,})}
  • GET请求
4、修改指定id记录
使用到了 Gin 框架中的 Context 上下文来接收 PUT 方式传过来的参数，用 Gorm 框架连接数据库使用Find方法或者First方法查询指定记录，然后通过Update方法修改记录，返回给前端用户修改成功信息。
//修改指定id todofunc updateTodo(c *gin.Context) {var todo todoModeltodoID := c.Param("id")db.First(&todo, todoID)if todo.ID == 0 {c.JSON(http.StatusNotFound, gin.H{"status":  http.StatusNotFound,"message": "No todo found!",})return}completed, _ := strconv.Atoi(c.PostForm("completed"))db.Model(&todo).Updates(&todoModel{Title:     c.PostForm("title"),Completed: completed,})c.JSON(http.StatusOK, gin.H{"status":  http.StatusOK,"message": "Todo updated successfully",})}
  • PUT请求
  • 数据库
5、删除指定id记录
使用到了 Gin 框架中的 Context 上下文来接收 DELETE 方式存放在URI里传过来的参数，用 Gorm 框架连接数据库使用First方法或者Find查询指定id记录，用Delete删除指定id记录，返回给前端用户删除成功信息。
//删除指定id todofunc deleteTodo(c *gin.Context) {var todo todoModeltodoID := c.Param("id")db.First(&todo, todoID)if todo.ID == 0 {c.JSON(http.StatusNotFound, gin.H{"status":  http.StatusNotFound,"message": "No todo found!",})return}db.Delete(&todo)c.JSON(http.StatusOK, gin.H{"status":  http.StatusOK,"message": "todo Deleted successfully",})}
  • DELETE请求
  • 数据库
四、结论
这章只是把前面的基础的知识Gin框架和Gorm框架结合一起实现，日志、JWT认证和Casbin框架我还没用到，后面我将会学习gva框架把之前所学全部展现并结合出来