Go-web开发快速入门——一、gin+gorm完成用户注册登录及用数据库存储用户信息（附源码，超详细）

已于 2022-04-24 10:41:55 修改
阅读量1w 收藏 71
点赞数 21
分类专栏： Go-web开发 文章标签： golang go web
于 2022-04-18 00:52:38 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_50737715/article/details/124240085
版权

本篇博客是Go-web开发快速入门系类的第一篇，本篇博客将介绍如何使用gin和gorm实现用户注册登录及用数据可存储用户信息。

简单来说，gin用于web开发，获取用户信息，而gorm用于连接数据库，将用户数据迁移到我们的数据库中进行存储

参考资料：

gin中文文档

gorm中文文档

一、准备

在开始我们的项目之前，首先确保你已安装了Go语言并配置好其环境并拥有Go语言编辑器，同时也要有数据库相关的工具，其次，为了方便调试，可安装相应的接口测试工具和数据库可视化工具。

本项目所使用的所有工具如下：

  • Visual Studio Code —— 编写并运行Go程序
  • MySql —— 建立数据库
  • Postman —— 接口测试
  • Navicat Premium —— 数据库可视化

在敲代码之前，我们先把项目模块化并引入相关的依赖

1.新建一个项目文件夹

2.使用go mod初始化项目模块

go mod init 项目模块名称

在这里插入图片描述

执行完毕后项目下会出现一个go.mod文件，描述项目使用的模块名称及go的版本
在这里插入图片描述

3.安装gin和gorm

在终端输入以下代码：

go get -u github.com/gin-gonic/gin

go get -u github.com/jinzhu/gorm

安装完成后，可以发现go.mod文件更新了项目所需的依赖

在这里插入图片描述

4.引入mysql

在终端输入以下代码：

go get github.com/go-sql-driver/mysql

5.在mysql中创建一个数据库

在终端输入mysql -u 你的mysql用户名 -p并输入密码即可进入mysql
输入create database 数据库名即可创建数据库

在这里插入图片描述

二、编写Go程序

新建一个main.go文件

首先构建我们的用户结构体，由于要迁移到数据库，必须引入gorm.Model和相关的描述

type User struct {
	gorm.Model
	Name      string `gorm:"varchar(20);not null"`
	Telephone string `gorm:"varchar(20);not null;unique"`
	Password  string `gorm:"size:255;not null"`
}

然后创建路由引擎

func main() {

	//创建一个默认的路由引擎
	r := gin.Default()

	//在9090端口启动服务
	panic(r.Run(":9090"))
}

我们在127.0.0.9090/register和127.0.0.1.9090/login实现用户的注册和登录，将注册和登录的部分下入main函数的两条语句之间

	//注册
	r.POST("/register", func(ctx *gin.Context) {

		//获取参数
		name := ctx.PostForm("name")
		telephone := ctx.PostForm("telephone")
		password := ctx.PostForm("password")

		//数据验证
		if len(name) == 0 {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "用户名不能为空",
			})
			return
		}
		if len(telephone) != 11 {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "手机号必须为11位",
			})
			return
		}
		if len(password) < 6 {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "密码不能少于6位",
			})
			return
		}

		//判断手机号是否存在
		var user User
		db.Where("telephone = ?", telephone).First(&user)
		if user.ID != 0 {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "用户已存在",
			})
			return
		}

		//创建用户
		hasedPassword, err := bcrypt.GenerateFromPassword([]byte(password), bcrypt.DefaultCost)
		if err != nil {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    500,
				"message": "密码加密错误",
			})
			return
		}
		newUser := User{
			Name:      name,
			Telephone: telephone,
			Password:  string(hasedPassword),
		}
		db.Create(&newUser)

		//返回结果
		ctx.JSON(http.StatusOK, gin.H{
			"code":    200,
			"message": "注册成功",
		})
	})

	//登录
	r.POST("/login", func(ctx *gin.Context) {

		//获取参数
		telephone := ctx.PostForm("telephone")
		password := ctx.PostForm("password")

		//数据验证
		if len(telephone) != 11 {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "手机号必须为11位",
			})
			return
		}
		if len(password) < 6 {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "密码不能少于6位",
			})
			return
		}

		//判断手机号是否存在
		var user User
		db.Where("telephone = ?", telephone).First(&user)
		if user.ID == 0 {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "用户不存在",
			})
			return
		}

		//判断密码是否正确
		if err := bcrypt.CompareHashAndPassword([]byte(user.Password), []byte(password)); err != nil {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "密码错误",
			})
		}

		//返回结果
		ctx.JSON(http.StatusOK, gin.H{
			"code":    200,
			"message": "登录成功",
		})
	})

接着构建我们的数据库，编写InitDB()函数

func InitDB() *gorm.DB {
	driverName := "mysql"
	host := "127.0.0.1"
	port := "3306"
	database := "你的数据库名"
	username := "你的mysql用户名"
	password := "你的mysql密码"
	charset := "utf8"
	args := fmt.Sprintf("%s:%s@(%s:%s)/%s?charset=%s&parseTime=true",
		username,
		password,
		host,
		port,
		database,
		charset)

	db, err := gorm.Open(driverName, args)
	if err != nil {
		panic("failed to connect database, err:" + err.Error())
	}

	//迁移
	db.AutoMigrate(&User{})

	return db

}

最后在main函数开头引入InitDB()函数，并延迟关闭数据库，在main函数开头写入：

	//获取初始化的数据库
	db := InitDB()
	//延迟关闭数据库
	defer db.Close()

完整代码如下：

package main

import (
	"fmt"
	"net/http"
	"github.com/gin-gonic/gin"
	_ "github.com/go-sql-driver/mysql"
	"github.com/jinzhu/gorm"
	"golang.org/x/crypto/bcrypt"
)

type User struct {
	gorm.Model
	Name      string `gorm:"varchar(20);not null"`
	Telephone string `gorm:"varchar(20);not null;unique"`
	Password  string `gorm:"size:255;not null"`
}

func main() {

	//获取初始化的数据库
	db := InitDB()
	//延迟关闭数据库
	defer db.Close()

	//创建一个默认的路由引擎
	r := gin.Default()

	//注册
	r.POST("/register", func(ctx *gin.Context) {

		//获取参数
		name := ctx.PostForm("name")
		telephone := ctx.PostForm("telephone")
		password := ctx.PostForm("password")

		//数据验证
		if len(name) == 0 {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "用户名不能为空",
			})
			return
		}
		if len(telephone) != 11 {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "手机号必须为11位",
			})
			return
		}
		if len(password) < 6 {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "密码不能少于6位",
			})
			return
		}

		//判断手机号是否存在
		var user User
		db.Where("telephone = ?", telephone).First(&user)
		if user.ID != 0 {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "用户已存在",
			})
			return
		}

		//创建用户
		hasedPassword, err := bcrypt.GenerateFromPassword([]byte(password), bcrypt.DefaultCost)
		if err != nil {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    500,
				"message": "密码加密错误",
			})
			return
		}
		newUser := User{
			Name:      name,
			Telephone: telephone,
			Password:  string(hasedPassword),
		}
		db.Create(&newUser)

		//返回结果
		ctx.JSON(http.StatusOK, gin.H{
			"code":    200,
			"message": "注册成功",
		})
	})

	//登录
	r.POST("/login", func(ctx *gin.Context) {

		//获取参数
		telephone := ctx.PostForm("telephone")
		password := ctx.PostForm("password")

		//数据验证
		if len(telephone) != 11 {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "手机号必须为11位",
			})
			return
		}
		if len(password) < 6 {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "密码不能少于6位",
			})
			return
		}

		//判断手机号是否存在
		var user User
		db.Where("telephone = ?", telephone).First(&user)
		if user.ID == 0 {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "用户不存在",
			})
			return
		}

		//判断密码是否正确
		if err := bcrypt.CompareHashAndPassword([]byte(user.Password), []byte(password)); err != nil {
			ctx.JSON(http.StatusUnprocessableEntity, gin.H{
				"code":    422,
				"message": "密码错误",
			})
		}

		//返回结果
		ctx.JSON(http.StatusOK, gin.H{
			"code":    200,
			"message": "登录成功",
		})
	})

	//在9090端口启动服务
	panic(r.Run(":9090"))
}

func InitDB() *gorm.DB {
	driverName := "mysql"
	host := "127.0.0.1"
	port := "3306"
	database := "你的数据库名"
	username := "你的mysql用户名"
	password := "你的mysql密码"
	charset := "utf8"
	args := fmt.Sprintf("%s:%s@(%s:%s)/%s?charset=%s&parseTime=true",
		username,
		password,
		host,
		port,
		database,
		charset)

	db, err := gorm.Open(driverName, args)
	if err != nil {
		panic("failed to connect database, err:" + err.Error())
	}

	//迁移
	db.AutoMigrate(&User{})

	return db

}

三、测试

用postman进行接口测试

点击"+"新建用于测试的request

在这里插入图片描述

输入相应的url发送请求，得到如下结果：

在这里插入图片描述

在这里插入图片描述

用navicat连接数据库可视化显示

填写相关信息连接数据库，用户名为MySql的用户名，密码为MySql的密码
在这里插入图片描述

连接后可看到数据库的内容如下：

在这里插入图片描述

在vs code终端有如下显示

在这里插入图片描述

四、重构与代码优化

为了使代码更好的复用，我们对代码进行重构，重构的结构如下：

在这里插入图片描述

model/user.go，用于定义我们的用户

package model

import "github.com/jinzhu/gorm"

type User struct {
	gorm.Model
	Name      string `gorm:"varchar(20);not null"`
	Telephone string `gorm:"varchar(20);not null;unique"`
	Password  string `gorm:"size:255;not null"`
}

common/database 用于数据库的构建与连接

package common

import (
	"demo/model"
	"fmt"

	"github.com/jinzhu/gorm"
)

var DB *gorm.DB

func InitDB() *gorm.DB {
	driverName := "mysql"
	host := "127.0.0.1"
	port := "3306"
	database := "你的数据库名称"
	username := "你的mysql用户名"
	password := "你的mysql密码"
	charset := "utf8"
	args := fmt.Sprintf("%s:%s@(%s:%s)/%s?charset=%s&parseTime=true",
		username,
		password,
		host,
		port,
		database,
		charset)

	db, err := gorm.Open(driverName, args)
	if err != nil {
		panic("failed to connect database, err:" + err.Error())
	}

	//迁移
	db.AutoMigrate(&model.User{})

	DB = db

	return db

}

func GetDB() *gorm.DB{
	return DB
}

controller/userController 用于编写用户相关的函数，如注册、登录

package controller

import (
	"demo/common"
	"demo/model"
	"net/http"

	"github.com/gin-gonic/gin"
	"golang.org/x/crypto/bcrypt"
)

func Register(ctx *gin.Context) {

	db := common.GetDB()

	//获取参数
	//此处使用Bind()函数，可以处理不同格式的前端数据
	var requestUser model.User
	ctx.Bind(&requestUser)
	name := requestUser.Name
	telephone := requestUser.Telephone
	password := requestUser.Password

	//数据验证
	if len(name) == 0 {
		ctx.JSON(http.StatusUnprocessableEntity, gin.H{
			"code":    422,
			"message": "用户名不能为空",
		})
		return
	}
	if len(telephone) != 11 {
		ctx.JSON(http.StatusUnprocessableEntity, gin.H{
			"code":    422,
			"message": "手机号必须为11位",
		})
		return
	}
	if len(password) < 6 {
		ctx.JSON(http.StatusUnprocessableEntity, gin.H{
			"code":    422,
			"message": "密码不能少于6位",
		})
		return
	}

	//判断手机号是否存在
	var user model.User
	db.Where("telephone = ?", telephone).First(&user)
	if user.ID != 0 {
		ctx.JSON(http.StatusUnprocessableEntity, gin.H{
			"code":    422,
			"message": "用户已存在",
		})
		return
	}

	//创建用户
	hasedPassword, err := bcrypt.GenerateFromPassword([]byte(password), bcrypt.DefaultCost)
	if err != nil {
		ctx.JSON(http.StatusUnprocessableEntity, gin.H{
			"code":    500,
			"message": "密码加密错误",
		})
		return
	}
	newUser :=model.User{
		Name:      name,
		Telephone: telephone,
		Password:  string(hasedPassword),
	}
	db.Create(&newUser)

	//返回结果
	ctx.JSON(http.StatusOK, gin.H{
		"code":    200,
		"message": "注册成功",
	})
}


func Login(ctx *gin.Context) {

	db := common.GetDB()

	//获取参数
	//此处使用Bind()函数，可以处理不同格式的前端数据
	var requestUser model.User
	ctx.Bind(&requestUser)
	telephone := requestUser.Telephone
	password := requestUser.Password
	
	//数据验证
	if len(telephone) != 11 {
		ctx.JSON(http.StatusUnprocessableEntity, gin.H{
			"code":    422,
			"message": "手机号必须为11位",
		})
		return
	}
	if len(password) < 6 {
		ctx.JSON(http.StatusUnprocessableEntity, gin.H{
			"code":    422,
			"message": "密码不能少于6位",
		})
		return
	}
	
	//判断手机号是否存在
	var user model.User
	db.Where("telephone = ?", telephone).First(&user)
	if user.ID == 0 {
		ctx.JSON(http.StatusUnprocessableEntity, gin.H{
			"code":    422,
			"message": "用户不存在",
		})
		return
	}
	
	//判断密码是否正确
	if err := bcrypt.CompareHashAndPassword([]byte(user.Password), []byte(password)); err != nil {
		ctx.JSON(http.StatusUnprocessableEntity, gin.H{
			"code":    422,
			"message": "密码错误",
		})
	}
	
	//返回结果
	ctx.JSON(http.StatusOK, gin.H{
		"code":    200,
		"message": "登录成功",
	})
}

routes.go 用于存放我们的路由

package main

import (
	"demo/controller"

	"github.com/gin-gonic/gin"
)

func CollectRoutes(r *gin.Engine) *gin.Engine {

	//注册
	r.POST("/register", controller.Register)
	//登录
	r.POST("/login", controller.Login)

	return r

}

main.go 用于数据库初始化、路由与服务的启动

package main

import (
	"demo/common"
	"github.com/gin-gonic/gin"
)

func main() {

	//获取初始化的数据库
	db := common.InitDB()
	//延迟关闭数据库
	defer db.Close()

	//创建一个默认的路由引擎
	r := gin.Default()

	//启动路由
	CollectRoutes(r)

	//在9090端口启动服务
	panic(r.Run(":9090"))
}

注意在重构之后，运行时需要同时运行main.go和routes.go

go run main.go routes.go

或同时编译main.go和routes.go再运行main.exe

go build main.go routes.go

main.exe

测试一下，重构后的代码正常运行~

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

下一篇博客将介绍如何使用jwt配合中间件进行用户认证~
Go-web开发快速入门——二、使用jwt配合中间件进行用户认证

Golang GORM系列：GORM无缝集成web框架
neweastsun的专栏
02-19 996
在models/解耦：将数据库连接、数据访问逻辑和业务逻辑分离，降低模块之间的耦合性。依赖注入：通过构造函数将数据库连接传递给 Repository 和 Service，避免全局变量的使用。可扩展性：每个模块（用户、产品等）可以独立开发和测试，便于扩展和维护。这种设计模式非常适合中大型项目，能够有效提升代码的可维护性和可测试性。如果有更多问题，欢迎继续讨论！在import (// 初始化数据库连接// 提供 UserRepository// 提供 ProductRepository。
Gin(十一):集成 gorm
代码猎奇站
08-02 1563
点击蓝色字关注我们！一个努力中的公众号长的好看的人都关注了随着项目的不断扩大，总有一天，项目中的表和表中的字段多的数不胜数，如果此时仍旧使用 SQL 语言来执行增删改查，...
基于gin框架和gorm的web开发实战
最新发布
2301_79819426的博客
02-19 1115
学习框架——Gin、GORM框架——搭建好的一个舞台，不需要重复造轮子我们在舞台上表演，只需要关注表演的内容，不需要关注舞台怎么搭建的Gin 是一个用 Go (Golang) 编写的 Web 框架。它具有类似 martini 的 API，性能要好得多，多亏了httprouter，速度提高了 40 倍。如果您需要性能和良好的生产力，您一定会喜欢 Gin。在本节中，我们将介绍 Gin 是什么，它解决了哪些问题，以及它如何帮助你的项目。"Gin 是一个用 Go (Golang) 编写的 Web 框架。
Go语言项目使用gin框架和gorm框架实现后端的注册和登录功能
pyscl01的博客
04-19 3099
Go语言项目使用gin框架和gorm框架实现后端的注册和登录功能的详细步骤
Go Web 编程 (一) - 快速入门
"代码"的日常搬运
04-18 3580
1.应用场景 基于go, 编写web项目, 替换PHP的实现方案. 2.学习/操作 1 介绍 基于 Golang 进行 Web 编程，包含 Web 服务器、路由、请求、响应、视图、数据库交互、Web 服务、测试、部署等模块。 2.快速入门 https://xueyuanjun.com/post/21298 //快速入门：创建第一...
使用Gin框架和Gorm（GoLand）
weixin_62372981的博客
11-23 519
使用Gin框架和Gorm（GoLand）
go语言web开发系列之一:gin+gorm开发一个简单的热榜接口站
刘老师的技术森林
11-20 2055
一，热榜的例子： 以抽屉新热榜为例，只存储资讯的链接和提示， 用户点击时会跳转到外部的网站阅读 我们在这里只实现了显示单条内容和多条内容的功能， 主要是把它做为后续功能集成演示的一个基础 后续的集成包括: 统一报错信息 统一rest输出 validator 日志功能 安全 接口文档 统一读取配置文件 ... 其他想到再补充吧 说明：刘宏缔的go森林是一个专注golang的博客， 地址：https://blog.csdn.net/weixin_43881...
深入浅出：Gin框架中的数据库集与GORM操作
软件架构师笔记
12-06 1277
通过本文的学习，你应该掌握了如何在Gin应用中集成数据库，并实现基本的CRUD操作。无论是构建RESTful API还是微服务架构，掌握这些技能都将为你提供坚实的技术基础。此外，我们还探讨了一些进阶话题，如事务处理、分页查询和关联查询，进一步增强了你处理复杂业务逻辑的能力。
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，使用这一套框架做项目也有大半年了，总的来说对于初学者来讲入门也是可以的。在使用了一段时间当...
5. gin集成Gorm
YouMing_Li的博客
03-06 879
本节主要介绍如何使用gin集成gorm，并完成用户的创建、修改、删除、查询等功能。
用户注册——注册信息保存到数据库
chuquanxi4884的博客
11-17 646
一、所需知识要点 q ASP.NET的网页代码模型。 q Web窗体基本控件。 q 数据库基础。 q ADO.NET常用对象。 q Web窗体数据控件。 基本了解了以上章节的知识点后，就能够熟练学习和开发此模块。 二、首先用户需要访问网站，访问网站后就会选择是否进...
gin+gorm
abb4018的博客
04-29 191
在【环境变量】中添加如下【用户变量】/【系统变量】：GO111MODULE，值为on go mod init目录 在项目中新建文件main.go，并添加测试代码 package main import "github.com/gin-gonic/gin" func main() { r := gin.Default() r.GET("/ping"...
gin+gorm 集成环境搭建
scola001的专栏
10-28 889
如果报错：'swag' 不是内部或外部命令。安装 gorm的mysql驱动。安装 gin-swagger。安装 热启动 fresh。再执行 swag init。创建目录 online。
Gin+Gorm+sessions 搭建 golang web项目
悟世君子的博客
10-17 2879
Gin是用Go（Golang）编写的HTTP web框架。它具有类似Martini的API，但性能比Martini快40倍Gorm，Golang 出色的ORM库sessions，具有多后端支持的用于会话管理的Gin中间件使用 Gin + Gorm + sessions 搭建 golang web 项目，步骤如下。
使用Go语言进行Web开发入门指南
spiker_的博客
08-20 1349
Go语言（Golang）是一门强大的编程语言，特别适合Web开发。本文将带你从基础开始，逐步构建一个简单的Go Web应用程序。
golang web 开发 —— gin 框架 （gorm 链接 mysql）
原来45的博客
04-07 4276
go gin gorm mysql
【搞定Go语言】第3天12：gin框架路由拆分与注册
就叫一片白纸的博客
02-06 974
本文总结了我平时在项目中积累的关于gin框架路由拆分与注册的若干方法。 gin框架路由拆分与注册 基本的路由注册 下面最基础的gin路由注册方式，适用于路由条目比较少的简单项目或者项目demo。 package main import ( "net/http" "github.com/gin-gonic/gin" ) func helloHandler(c *gin.Context) { c.JSON(http.StatusOK, gin.H{ "message": "Hello q1mi!
[golang gin框架] 29.Gin 商城项目-用户登录,注册操作
zhoupenghui168的博客
05-10 2357
用户登录，注册步骤，以及发送短信验证码，校验图形验证码等功能
基于gin框架的登录注册
m0_49049914的博客
02-05 3491
包含前端vue,后端gin框架的登录注册以及mysql数据库的连接使用，主要是练习后端框架的使用，前端简陋见谅。 一.前端vue部分 首先搭建vue框架，可以参考我的这篇博客https://blog.csdn.net/m0_49049914/article/details/112527510 前端登录页面展示如下 代码如下：主要是使用的vant组件库 <template> <div> <van-form @submit="onSubmit"> &
用go+gin+gorm开发项目的文件夹目录结构是什么样子
04-21
我可以回答您的第一个问题。 通常，用go gin gorm开发的项目的文件夹目录结构如下： - main.go：应用程序的入口点 - config：应用程序的配置文件 - controllers：处理HTTP请求的控制器 - models：数据库模型，即数据库表的映射 - repositories：用于handle数据库操作的repositories - routers：路由配置文件 - utils：用于存放帮助函数或复用代码的文件 这是一种常见的目录结构，但它可能因项目而异，具体目录结构可以根据您的项目的要求进行调整和改变。
评论 5
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值