GORM入门

于 2024-09-25 19:02:15 发布
阅读量572 收藏 16
点赞数 12
分类专栏： Gin框架 文章标签： gin golang
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_79890350/article/details/142464230
版权

ORM框架

什么是ORM

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

ORM优缺点

在这里插入图片描述

GORM介绍

Github GORM

中文官方网站

安装

go get -u github.com/jinzhu/gorm

连接数据库

连接不同的数据库都需要导入对应数据的驱动程序，GORM已经包装了一些驱动程序，只需要按如下方式导入需要的数据库驱动即可：

import _ "github.com/jinzhu/gorm/dialects/mysql"
// import _ "github.com/jinzhu/gorm/dialects/postgres"
// import _ "github.com/jinzhu/gorm/dialects/sqlite"
// import _ "github.com/jinzhu/gorm/dialects/mssql"

连接MySQL

import (
  "github.com/jinzhu/gorm"
  _ "github.com/jinzhu/gorm/dialects/mysql"
)

func main() {
  db, err := gorm.Open("mysql", "user:password@(localhost)/dbname?charset=utf8mb4&parseTime=True&loc=Local")
  defer db.Close()
}

连接PostgreSQL

基本代码同上，注意引入对应 postgres 驱动并正确指定 gorm.Open() 参数。

import (
  "github.com/jinzhu/gorm"
  _ "github.com/jinzhu/gorm/dialects/postgres"
)

func main() {
  db, err := gorm.Open("postgres", "host=myhost port=myport user=gorm dbname=gorm password=mypassword")
  defer db.Close()
}

连接Sqlite3

基本代码同上，注意引入对应 sqlite 驱动并正确指定 gorm.Open() 参数。

import (
  "github.com/jinzhu/gorm"
  _ "github.com/jinzhu/gorm/dialects/sqlite"
)

func main() {
  db, err := gorm.Open("sqlite3", "/tmp/gorm.db")
  defer db.Close()
}

连接SQL Server

基本代码同上，注意引入对应 mssql 驱动并正确指定 gorm.Open() 参数。

import (
  "github.com/jinzhu/gorm"
  _ "github.com/jinzhu/gorm/dialects/mssql"
)

func main() {
  db, err := gorm.Open("mssql", "sqlserver://username:password@localhost:1433?database=dbname")
  defer db.Close()
}

GORM基本示例

以MySQL数据库为例，讲解GORM各项功能的主要使用方法。

Docker快速创建MySQL实例

如果没有安装MySQL，可以使用一下命令快速运行一个MySQL8.0.19实例，当然前提是要有docker环境…

在本地的 13306 端口运行一个名为 mysql8019 ，root用户名密码为 root1234 的MySQL容器环境:

docker run --name mysql8019 -p 13306:3306 -e MYSQL_ROOT_PASSWORD=root1234 -d mysql:8.0.19

在另外启动一个 MySQL Client 连接上面的MySQL环境，密码为上一步指定的密码 root1234:

docker run -it --network host --rm mysql mysql -h127.0.0.1 -P13306 --default-character-set=utf8mb4 -uroot -p

创建数据库

在使用GORM前手动创建数据库 db1：

CREATE DATABASE db1;

GORM操作MySQL

使用GORM连接上面的 db1 进行创建、查询、更新、删除操作。

package main

import (
	"fmt"
	"github.com/jinzhu/gorm"
	_ "github.com/jinzhu/gorm/dialects/mysql"
)

// UserInfo --> 数据表
type UserInfo struct {
	ID     uint
	Name   string
	Gender string
	Hobby  string
}

func main() {
	// 连接MySQL数据库
	db, err := gorm.Open("mysql", "root:SHANG6688@(127.0.0.1:3306)/db1?charset=utf8mb4&parseTime=True&loc=Local")
	if err != nil {
		panic(err)
	}
	defer db.Close()

	// 创建表 自动迁移（把结构体和数据表进行对应）
	db.AutoMigrate(&UserInfo{})

	// 创建数据行
	//u1 := UserInfo{1, "七米", "男", "蛙泳"}
	//db.Create(&u1)

	// 查询
	var u UserInfo
	db.First(&u) // 查询表中第一条数据保存到u中
	fmt.Printf("u:%#v\n", u)

	// 更新
	db.Model(&u).Update("hobby", "双色球")

	// 删除
	db.Delete(&u)
}

GORM Model定义

在使用ORM工具时，通常需要在代码中定义模型（Models）与数据库中的数据表进行映射，在GORM中模型（Models）通常是正常定义的结构体、基本的go类型或它们的指针。 同时也支持 sql.Scanner 及 driver.Valuer 接口（interfaces）。

gorm.Model

为了方便模型定义，GORM内置了一个 gorm.Model 结构体。gorm.Model 是一个包含了ID, CreatedAt , UpdatedAt , DeletedAt 四个字段的Golang结构体。

// gorm.Model 定义
type Model struct {
  ID        uint `gorm:"primary_key"`
  CreatedAt time.Time
  UpdatedAt time.Time
  DeletedAt *time.Time
}

可以将它嵌入到自己的模型中：

// 将 `ID`, `CreatedAt`, `UpdatedAt`, `DeletedAt`字段注入到`User`模型中
type User struct {
  gorm.Model
  Name string
}

当然也可以完全自己定义模型：

// 不使用gorm.Model，自行定义模型
type User struct {
  ID   int
  Name string
}

模型定义示例

// 定义模型
type User struct {
	gorm.Model   // 内嵌gorm.Model
	Name         string
	Age          sql.NullInt64 // 零值类型
	Birthday     *time.Time
	Email        string  `gorm:"type:varchar(100);unique_index"`
	Role         string  `gorm:"size:255"`        // 设置字段大小为255
	MemberNumber *string `gorm:"unique;not null"` // 设置会员号（member number）唯一并且不为空
	Num          int     `gorm:"AUTO_INCREMENT"`  // 设置 num 为自增类型
	Address      string  `gorm:"index:addr"`      // 给address字段创建名为addr的索引
	IgnoreMe     int     `gorm:"-"`               // 忽略本字段

结构体标记（tags）

使用结构体声明模型时，标记（tags）是可选项。gorm支持以下标记:

支持的结构体标记（Struct tags）

在这里插入图片描述

关联相关标记（tags）

在这里插入图片描述

主键、表名、列名的约定

主键（Primary Key）

GORM 默认会使用名为ID的字段作为表的主键。

type User struct {
  ID   string // 名为`ID`的字段会默认作为表的主键
  Name string
}

// 使用`AnimalID`作为主键
type Animal struct {
  AnimalID int64 `gorm:"primary_key"`
  Name     string
  Age      int64
}

表名（Table Name）

表名默认就是结构体名称的复数，例如：

type User struct {} // 默认表名是 `users`

// 将 User 的表名设置为 `profiles`
func (User) TableName() string {
  return "profiles"
}

func (u User) TableName() string {
  if u.Role == "admin" {
    return "admin_users"
  } else {
    return "users"
  }
}

// 禁用默认表名的复数形式，如果置为 true，则 `User` 的默认表名是 `user`
db.SingularTable(true)

也可以通过 Table() 指定表名：

// 使用User结构体创建名为`deleted_users`的表
db.Table("deleted_users").CreateTable(&User{})

var deleted_users []User
db.Table("deleted_users").Find(&deleted_users)
 SELECT * FROM deleted_users;

db.Table("deleted_users").Where("name = ?", "jinzhu").Delete()
 DELETE FROM deleted_users WHERE name = 'jinzhu';
GORM还支持更改默认表名称规则：

gorm.DefaultTableNameHandler = func (db *gorm.DB, defaultTableName string) string  {
  return "prefix_" + defaultTableName;
}

列名（Column Name）

列名由字段名称进行下划线分割来生成

type User struct {
  ID        uint      // column name is `id`
  Name      string    // column name is `name`
  Birthday  time.Time // column name is `birthday`
  CreatedAt time.Time // column name is `created_at`
}

可以使用结构体tag指定列名：

type Animal struct {
  AnimalId    int64     `gorm:"column:beast_id"`         // set column name to `beast_id`
  Birthday    time.Time `gorm:"column:day_of_the_beast"` // set column name to `day_of_the_beast`
  Age         int64     `gorm:"column:age_of_the_beast"` // set column name to `age_of_the_beast`
}

时间戳跟踪

CreatedAt

如果模型有 CreatedAt 字段，该字段的值将会是初次创建记录的时间。

db.Create(&user) // `CreatedAt`将会是当前时间

// 可以使用`Update`方法来改变`CreateAt`的值
db.Model(&user).Update("CreatedAt", time.Now())

UpdatedAt

如果模型有 UpdatedAt 字段，该字段的值将会是每次更新记录的时间。

db.Save(&user) // `UpdatedAt`将会是当前时间

db.Model(&user).Update("name", "jinzhu") // `UpdatedAt`将会是当前时间

DeletedAt

如果模型有 DeletedAt 字段，调用 Delete 删除该记录时，将会设置 DeletedAt 字段为当前时间，而不是直接将记录从数据库中删除。

示例

package main

import (
	"database/sql"
	"github.com/jinzhu/gorm"
	_ "github.com/jinzhu/gorm/dialects/mysql"
	"time"
)

// UserInfo --> 数据表
type UserInfo struct {
	ID     uint
	Name   string
	Gender string
	Hobby  string
}

// 定义模型
type User struct {
	gorm.Model   // 内嵌gorm.Model
	Name         string
	Age          sql.NullInt64 `gorm:"column:user_age"` // 零值类型
	Birthday     *time.Time
	Email        string  `gorm:"type:varchar(100);unique_index"`
	Role         string  `gorm:"size:255"`        // 设置字段大小为255
	MemberNumber *string `gorm:"unique;not null"` // 设置会员号（member number）唯一并且不为空
	Num          int     `gorm:"AUTO_INCREMENT"`  // 设置 num 为自增类型
	Address      string  `gorm:"index:addr"`      // 给address字段创建名为addr的索引
	IgnoreMe     int     `gorm:"-"`               // 忽略本字段
}

type Animal struct {
	AnimalID int64 `gorm:"primary_key"`
	Name     string
	Age      int64
}

func (Animal) TableName() string {
	return "qimi"
}

func main() {
	// 修改默认的表名规则
	gorm.DefaultTableNameHandler = func(db *gorm.DB, defaultTableName string) string {
		return "SMS_" + defaultTableName
	}

	// 连接MySQL数据库
	db, err := gorm.Open("mysql", "root:SHANG6688@(127.0.0.1:3306)/db1?charset=utf8mb4&parseTime=True&loc=Local")
	if err != nil {
		panic(err)
	}
	defer db.Close()
	db.SingularTable(true) // 禁用复数

	db.AutoMigrate(&User{})
	db.AutoMigrate(&Animal{})

	// 使用User结构体创建名叫 xiaowangzi 的表
	db.Table("xiaowangzi").CreateTable(&User{})
}
SHtop11
关注
专栏目录
Gin+Gorm练手小项目-bubble前后端代码合集
09-22
Bubble 是一个使用 Gin 框架和 Gorm ORM 库开发的练手小项目，旨在帮助开发者熟悉 Gin 和 Gorm 的使用，并实践常见的 Web 开发模式和技术栈。Bubble 是一个简单的网页，用户可以发布任务、浏览任务、更新状态等操作...
Gin+Gorm开发Golang API快速开发脚手架-Golang开发
05-26
Gin+Gorm开发Golang API快速开发脚手架 Singo Singo: Simple Single Golang Web Service go-crud正式改名为Singo! 使用Singo开发Web服务: 用最简单的架构，实现够用的框架，服务海量用户 ... Singo文档 ...
Gorm入门
好兄弟起把大狙
06-03 842
李文周大佬gorm入门视频笔记
Gorm 入门介绍与基本使用
淘小欣的博客
01-10 1260
ORM（Object-Relational Mapping）是一种编程技术，它将对象和关系数据库之间的映射抽象出来，使得开发者可以通过面向对象的方式操作数据库，而不用直接处理SQL语句，相当于在业务逻辑层和数据库层之间一座桥梁。在Golang中，有一款优秀的ORM框架叫做Gorm，它提供了强大的功能，使得数据库操作变得更加简单和灵活。开发者需要定义数据模型，通常是一个结构体，表示数据库中的表结构。Gorm是一款用于Golang的ORM框架，它提供了丰富的功能，包括模型定义、数据验证、关联查询等。
GO进阶之旅（一）GORM入门
m0_58466443的博客
07-08 1355
模型一般基于 Go 的基本数据类型、实现了 Scanner 和 Valuer 接口的自定义类型以及它们的指针/别名Scanner 接口：这是一个接口，定义了从数据库读取数据时如何将其扫描到 Go 类型的方法**（数据库–>实体类）**。它通常与自定义类型一起使用，用于将数据库中的原始数据转换为 Go 的特定类型。Valuer 接口：这是一个接口，定义了将Go 类型转换为数据库可以存储的值的方法**（实体类型–>数据库）**。ORM 库会在将结构体保存到数据库之前调用这个方法。
GORM快速入门
EGXXM的博客
05-12 701
crud 指的creat retrieve update delete增加，查询，更新，删除四种操作 ORM,对象关系映射，是一种框架格式，显示了映射关系 迁移 创建表，查看表，重命名表，删除表 type User struct { ID int Name string } func main() { db, err := gorm.Open(mysql.New(mysql.Config{ DSN: "root:123456@tcp(127.0.0.1:3306)/db1?charset=
gorm入门——更新对象
小诸葛的博客
08-08 284
在 GORM 中，你可以通过多种方式更新数据库中的记录。
gorm入门——删除对象
小诸葛的博客
08-08 359
在 GORM 中，你可以根据任何字段删除记录。要根据其他字段删除记录，你可以使用Delete方法，并传入一个包含要删除条件的结构体或使用Where方法指定条件。
GO的 ORM框架 GORM 入门
qq_21047625的博客
03-16 931
GORM 是一种流行的 Go 语言 ORM（对象关系映射）库，可以将结构体映射到数据库。它提供了一个简单易用的 API，可以无缝地连接并操作多种数据库，如 MySQL、PostgreSQL、SQLite 和 SQL Server。在这篇文章中，我将简要介绍如何使用 GORM 连接到数据库并进行基本的 CRUD（增加，读取，更新，删除）操作。
gorm的入门
ZN175623的博客
11-20 294
在使用ORM工具时，通常我们需要在代码中定义模型（Models）与数据库中的数据表进行映射，在GORM中模型（Models）通常是正常定义的结构体、基本的go类型或它们的指针。如果模型有DeletedAt字段，调用Delete删除该记录时，将会设置DeletedAt字段为当前时间，而不是直接将记录从数据库中删除。如果模型有 CreatedAt字段，该字段的值将会是初次创建记录的时间。使用结构体声明模型时，标记（tags）是可选项。如果模型有UpdatedAt字段，该字段的值将会是每次更新记录的时间。
Gorm入门-删除
umgsai的专栏
03-27 2707
参考 删除 | GORM - The fantastic ORM library for Golang, aims to be developer friendly. // 删除数据 https://gorm.io/zh_CN/docs/delete.html // 如果模型包含了一个 gorm.deletedat 字段（gorm.Model 已经包含了该字段)，它将自动获得软删除的能力！ // 拥有软删除能力的模型调用 Delete 时，记录不会被数据库。但 GORM 会将 DeletedAt
gorm文档_英文.pdf
09-14
gorm文档的开始部分讲解了如何使用gorm库，包括安装、升级到V1.0、快速入门等内容。同时，也提到了gorm库的特点，如 Associations、Callbacks、Preloading、Transactions、Composite Primary Key、SQL Builder、Auto...
GORM mysql驱动程序-Golang开发
05-26
GORM mysql驱动程序GORM MySQL驱动程序快速入门import（“ gorm.io/driver/mysql”“ gorm.io/gorm”）// https://github.com/go-sql-driver/mysql dsn：=“ gorm： gorm @ tcp（localhost：9910）/ gorm？...
文件上传、重定向、Gin路由
2301_79890350的博客
09-22 306
文件上传 + 重定向 + Gin路由
将 Go 作为脚本语言用及一些好用的包
编程点滴
09-23 867
创建一个新的命令对象。可以设置命令的名称、简短描述、详细描述、执行函数等。cmd.Use：设置命令的名称和用法。cmd.Short：设置命令的简短描述。cmd.Long：设置命令的详细描述。cmd.Run：设置命令的执行函数。：将多个子命令添加到根命令中。：添加一个字符串类型的命令行参数，带有短名称（-p）和长名称（–paramName）。可以指定默认值和参数描述。：添加一个整数类型的命令行参数。：添加一个布尔类型的命令行参数。：执行命令。如果命令执行过程中出现错误，会返回一个错误对象。
优化 Go 语言数据打包：性能基准测试与分析
dsgdauigfs的博客
09-24 1141
对于序列化和反序列化在复用内存后，速度的提升非常明显，在同步的操作下，能做到 0 字节分配。异步场景下，使用 sync.Pool 内存固定字节分配（两个返回值在堆上分配）- encode_to：性能最优，几乎没有内存分配，适用于高性能要求的场景。- encode_with_pool：使用内存池优化，显著减少了时间和内存开销，适用于大多数场景。- encode：标准方法，时间和内存开销较高。
GO语言中make与new的区别
最新发布
lisus2007的专栏
09-25 245
new 可以为任何类型的值开辟内存并返回此值的指针new申请的值均为零值，对创建映射和切处没有意义实际工作中通常使用字面量来创建数组而很少使用new。
golang学习笔记12-函数（一）：定义与使用
技术卷的博客
09-24 405
函数的定义与使用，定义的语法有多种，使用时传递函数的引用，另外也可自定义函数别名
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值