gin框架学习-Gin框架和Gorm框架搭建一个简单的API微服务

已于 2022-09-07 18:23:07 修改
阅读量2.3k 收藏 18
点赞数 3
分类专栏： gin框架学习 文章标签： 学习 微服务 架构 go 云原生
于 2022-07-14 16:24:57 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_46618592/article/details/125783446
版权

目录

前言

感谢开源项目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/gin
go get -u gorm.io/driver/mysql
go get -u gorm.io/gorm

3、创建路由

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

package main

import (
	"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.Model
	Title     string `json:"title"`
	Completed int    `json:"completed"`
}

//处理返回字段
type transformedTodo struct {
	ID        int    `json:"id"`
	Title     string `json:"title"`
	Completed bool   `json:"completed"`
}

2）数据库连接


package main

import (
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)

var db *gorm.DB

func init() {
	dsn := "root:123456@tcp(127.0.0.1:3306)/go_test?charset=utf8&parseTime=True"
	var err error
	db, err = gorm.Open(mysql.Open(dsn), &gorm.Config{})
	if err != nil {
		panic(err.Error())
	}
	//自动创建数据表
	db.AutoMigrate(&todoModel{})
}

三、实现路由方法

1、创建一条记录

使用到了 Gin 框架中的 Context 上下文来接收 POST 方式传过来的参数，用 Gorm框架 连接数据库使用Save方法或者Create方法都可以来保存相关的数据到数据库，之后会给前端用户返回一个 JSON信息。

//创建一条todo记录
func createTodo(c *gin.Context) {
	completed, err := strconv.Atoi(c.PostForm("completed"))
	if err != nil {
		panic(err.Error())
	}
	todo := todoModel{
		Title:     c.PostForm("title"),
		Completed: completed,
	}
	db.Save(&todo)
	c.JSON(http.StatusCreated, gin.H{
		"status":     http.StatusCreated,
		"message":    "Todo item created successfully",
		"resourceId": todo.ID,
	})
}
  • POST请求

在这里插入图片描述

  • 数据库

在这里插入图片描述

2、查询所有记录

使用到了 Gin 框架中的 GET 请求，没有参数，用 Gorm 框架连接数据库使用Find方法查询所有记录，封装在JSON里返回给前端用户

//获取数据库所有todo
func selectAllTodo(c *gin.Context) {
	var todos []todoModel
	var rq_todos []transformedTodo
	db.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 := false
		if 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里返回给前端用户

//查找指定todo
func selectSingleTodo(c *gin.Context) {
	var todo todoModel
	todoID := 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 := false
	if 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 todo
func updateTodo(c *gin.Context) {
	var todo todoModel
	todoID := 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 todo
func deleteTodo(c *gin.Context) {
	var todo todoModel
	todoID := 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框架把之前所学全部展现并结合出来

lin钟一
关注
  • 3
    点赞
  • 踩
  • 18
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
gorm-gin：具有gin和gorm的简单api
02-06
api变得简单 这是Go的简单RESTful API，使用： 杜松子酒框架 戈姆 安装与运行 # Download this project $ go get github.com/dedidot/gorm-gin # Download Gin Framework $ go get github.com/gin-gonic/gin # Download GORM $ go get github.com/jinzhu/gorm 在main.go中设置数据库 Config . DB , err = gorm . Open ( "mysql" , "DBUSERNAME:DBPASSWORD@t
gin-microservice:使用Go Gin框架的示例微服务
04-27
杜松子酒微服务示例 版本：0.1.0 使用Go 框架的示例微服务 主要图书馆 -API路由器，控制器 包裹管理 -配置 -扩展常见的Go对象，提供更好的替代方法或包装方法 测试库 -测试框架 -模拟基础HTTP请求/响应 创建一个API密钥 转到 ，注册并复制api密钥 在config / development.toml中取消注释以下行 #app_id = "put-your-api-key-here" 删除开头的哈希字符，然后从您的OpenWeatherMap帐户中将api密钥替换为“ put-your-api-key-here” 安装go $ brew install go 准备〜/ .bash_profile或用于Go开发的终端会话 export GOPATH= $HOME /go export GOROOT=/usr/local/opt/go/libexec export G
Golang API框架_go api框架
最新发布
2401_84247760的博客
04-12 522
API框架是一种用于构建API的软件框架，它提供了一系列工具和功能，简化了API的开发过程。API框架通常提供了路由、中间件、参数解析、错误处理等功能，以帮助开发人员快速构建高效的API应用程序。它们还通常提供了易于使用的API文档生成工具，以方便开发人员编写和维护文档。
[golang gin框架] 39.Gin商城项目-微服务实战之微服务架构
zhoupenghui168的博客
07-05 1387
微服务实战之微服务架构,单体架构,微服务架构
Gin微服务框架_golang web框架_完整示例Demo
yinjl123的博客
06-12 1813
Gin是一个golang的微框架，封装比较优雅，API友好，源码注释比较明确，具有快速灵活，容错方便等特点。其实对于golang而言，web框架的依赖要远比Python，Java之类的要小。自身的net/http足够简单，性能也非常不错。框架更像是一些常用函数或者工具的集合。借助框架开发，不仅可以省去很多常用的封装带来的时间，也有助于团队的编码风格和形成规范。
gin-example:使用Gin框架，针对产品微服务的模块化项目布局使用To Todo后端示例
03-13
待办事项后端 使用产品微服务的模块化项目布局转到Todo后端示例。 它适合作为中型到大型项目的起点。 本示例将用于http路由器，将用于数据库访问。 特征： 模块化项目结构。 完整示例，包括测试。 Docker部署。 与兼容。 安装 先决条件 为接口模拟生成安装。 安装以进行数据库迁移。 跑步 准备.env 。 cp .env.sample .env 启动postgresql并创建数据库。 docker-compose up -d 准备数据库架构。 rel migrate 构建和运行make 项目结构 . ├── api │ ├── handler │ │ ├── todos.go │ │ └── [other handler].go │ └── middleware │ └── [other middleware].go ├── bin
gin-admin:基于Gin + Gorm + Casbin + Wire的RBAC脚手架
04-29
Gin Admin 基于 GIN + GORM + CASBIN + WIRE 实现的RBAC权限管理脚手架，目的是提供一套轻量的中后台开发框架，方便、快速的完成业务需求的开发。特性遵循 RESTful API 设计规范 & 基于接口的编程规范基于 GIN 框架...
Gin+Vue+微服务打造秒杀商城-Go课程
06-28
分享课程——Gin+Vue+微服务...本课从Gin基础讲起，涉及模板渲染、中间件、数据绑定及验证、gorm等模块，实战部分更是直接上当今流行、具含金量的微服务+高并发秒杀技术，让你学完后轻松开发出一套扛得住的秒杀系统。
基于gin框架和gorm框架的小清单系统
08-01
该小项目，是用gin和gorm来写的，功能很简单，就是前端发送各种请求，后端来响应。
Gin+Gorm练手小项目-bubble前后端代码合集
09-22
Bubble 是一个使用 Gin 框架和 Gorm ORM 库开发的练手小项目，旨在帮助开发者熟悉 Gin 和 Gorm 的使用，并实践常见的 Web 开发模式和技术栈。Bubble 是一个简单的网页，用户可以发布任务、浏览任务、更新状态等操作...
ginmicro：GIN微服务从MQTT代理读取并在网页上显示数据
02-21
银微 GIN微服务从MQTT代理读取并在网页上显示数据 GIN应用程序的设计 请求->路由器解析器-> [可选中间件]->路由处理程序-> [可选中间件]->响应 路由器配置（此后将更改） 在路由/（HTTP GET请求）处为索引页面提供服务， 在/ u路由下将与用户相关的路由分组，-在/ u / login（HTTP GET请求）服务登录页面，-在/ u / login（HTTP POST请求）处理登录凭证，-在以下位置注销/ u / logout（HTTP GET请求），-在/ u / register（HTTP GET请求）处提供注册页面，-在/ u / register（HTTP POST请求）处处理注册信息， 在/ article路由下将与文章相关的路由分组，-在/ article / create（HTTP GET请求）服务文章创建页面，-在/ article / cre
ginpom:ginpom是一个基于Gin框架开发的个人微服务项目，Gin是一个golang的微框架，封装比较优雅，API友好，源码注释比较清晰，具有快速灵活，容错方便等特点
03-23
金银花 ginpom是一个基于Gin框架开发的个人微服务项目，Gin是一个golang的微框架，封装比较优雅，API友好，源码注释比较清晰，具有快速灵活，容错方便等特点
gin_curd:基于gin gorm快速生成curd代码
03-10
根据模型快速生成基于gin和gorm的嵌入项目 标签： 凝乳 搜索 搜索：喜欢模糊查询 search：true搜索 例子： type TestModel struct { Model Account string `gorm:"account" curd:"search" binding:"required"` Password string `gorm:"password"` RealName string `gorm:"real_name"` } package main import ( "github.com/liujunren93/curl_gin/example/handler/models" "fmt" curd "github.com/liujunren93/curl_gin" ) func main () { //build() } func bu
Gin框架结合gorm使用
热门推荐
qq_42057890的博客
02-02 1万+
Gin框架结合Gorm使用 目录 Gin框架结合Gorm使用 前言 一、介绍 二、使用步骤 1.创建项目 2.开始main.go 3.router的初始化 4.controller的初始化 5.services的初始化 6.models的初始化 7.my.init的初始化 8.开始测试 总结 前言 笔者为golang语言的初学者，之前一直是使用beego框架和框架中自带的orm，使用这一套框架做项目也有大半年了，总的来说对于初学者来讲入门也是可以的。在使用了一段时间当...
gin和gorm更配哦
Go的全部
07-09 241
gin + gorm 待补充
Gin框架API参数
weixin_45919793的博客
03-23 481
占位符 :参数：获取值到不包含/ *参数：获取值到包含/ func main() { // 创建路由 var r = gin.Default() r.GET("/user/:name/*action", func(c *gin.Context) { name := c.Param("name") action := c.Param("action") c.JSON(http.StatusOK, gin.H{ "name": name, "action": action,
Gin框架第二天---关于API
shelgi的博客
11-12 753
文章目录Gin第二天1.RESTful API2. API参数问题 Gin第二天 1.RESTful API 简单来说，REST的含义就是客⼾端与Web服务器之间进⾏交互的时候，使⽤HTTP协议中的4个请求⽅法代表不同的动作。它是一种互联网应用程序的API设计理念：URL定位资源，用HTTP描述操作 GET⽤来获取资源 POST⽤来新建资源 PUT⽤来更新资源 DELETE⽤来删除资源。 只要API程序遵循了REST⻛格，那就可以称其为RESTful API。⽬前在前后端分离的架构中，前后端基本都是通
GoLang搭建gin项目
一个很酷的理科生_v
01-21 967
1.在目录中创建以下三个文件 2.配置环境 GOPROXY=https://goproxy.io,direct 3.下载gin go get -u github.com/gin-gonic/gin 4.初始化mod go mod init example.com/m 5.创建main.go package main import ( "github.com/gin-gonic/gin" "net/http" ) func main() { // ...
使用gin与gorm框架进行后台开发是什么意思
09-06
使用gin与gorm框架进行后台开发是指在构建后台应用程序时，采用了gin和gorm这两个开源框架来帮助实现快速、高效且可靠的开发。 首先，gin是一个轻量级的Web框架，它基于Go语言的net/http包进行封装，并提供了更简洁...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

lin钟一

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值