GORM介绍及入门指南

最新推荐文章于 2024-09-20 14:27:31 发布
最新推荐文章于 2024-09-20 14:27:31 发布
阅读量1.8k 收藏 40
点赞数 29
分类专栏： gorm 文章标签： go mysql
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/mpy_3/article/details/140471450
版权

GORM

本文后半部分来源于GORM官方文档。

GORM的介绍

什么是GORM？

GORM 是一个适用于 Go 语言的 ORM（对象关系映射）库。ORM 的目的是让开发者能够通过面向对象的方式与数据库交互，而不是直接编写 SQL 语句。GORM 使得操作数据库更加高效和便捷，同时保留了 Go 语言的简洁性和灵活性。

GORM 的特点

  1. 简单易用的 API：GORM 提供了简单且直观的 API，开发者可以通过链式调用来完成数据库操作。无论是插入、查询、更新还是删除操作，GORM 都提供了统一且易于理解的方法。
  2. 自动迁移：自动迁移功能允许开发者定义数据模型，然后 GORM 会根据这些模型自动创建或更新数据库表结构。这大大简化了数据库的管理和维护工作。
  3. 多数据库支持：GORM 支持多种常见的数据库系统，包括 MySQL、PostgreSQL、SQLite 和 SQL Server 等。开发者可以根据需要选择合适的数据库，而无需担心 ORM 的兼容性问题。
  4. 关系映射：GORM 支持定义和处理数据库表之间的关系，包括一对一、一对多和多对多关系。通过简单的配置，开发者可以轻松管理复杂的数据关系。
  5. 灵活的查询功能：GORM 提供了强大的查询功能，支持条件查询、链式查询和原生 SQL 查询。开发者可以根据需求灵活构建复杂的查询语句。
  6. 事务支持：事务是一种确保数据库操作一致性的机制。GORM 提供了对事务的完整支持，开发者可以在需要时使用事务来保证数据操作的原子性。
  7. 钩子函数：GORM 支持钩子函数（Hooks），允许开发者在特定操作前后执行自定义逻辑。例如，可以在插入数据前进行数据验证，或者在删除数据后进行日志记录。

GORM 的使用场景

GORM 适用于各种类型的 Go 语言项目，特别是在需要频繁与数据库交互的应用中，例如：

  • Web 应用程序
  • 微服务架构
  • 数据分析系统
  • 内容管理系统（CMS）
  • 电子商务平台

GORM官方文档：

官方文档：GORM官方文档

GORM入门指南

1. 简单使用

1. GORM的安装
go get -u gorm.io/gorm
go get -u gorm.io/driver/mysql
2.数据库连接

GORM 官方支持的数据库类型有：MySQL, PostgreSQL, SQLite, SQL Server 和 TiDB

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

func main() {
  // 参考 https://github.com/go-sql-driver/mysql#dsn-data-source-name 获取详情
  dsn := "user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local"
  db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
}
3. 快速入门
package main

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

type Product struct {
  gorm.Model
  Code  string
  Price uint
}

func main() {
  dsn := "root:123456@tcp(127.0.0.1:3309)/try_gorm?charset=utf8mb4&parseTime=True&loc=Local"
  db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
	if err != nil {
		panic(err)
	}

  // 迁移 schema
  db.AutoMigrate(&Product{})

  // Create
  db.Create(&Product{Code: "D42", Price: 100})

  // Read
  var product Product
  db.First(&product, 1) // 根据整型主键查找
  db.First(&product, "code = ?", "D42") // 查找 code 字段值为 D42 的记录

  // Update - 将 product 的 price 更新为 200
  db.Model(&product).Update("Price", 200)
  // Update - 更新多个字段
  db.Model(&product).Updates(Product{Price: 200, Code: "F42"}) // 仅更新非零值字段
  db.Model(&product).Updates(map[string]interface{}{"Price": 200, "Code": "F42"})

  // Delete - 删除 product
  db.Delete(&product, 1)
}

2. 声明模型

GORM 通过将 Go 结构体（Go structs） 映射到数据库表来简化数据库交互。 了解如何在GORM中定义模型，是充分利用GORM全部功能的基础。

模型定义

模型是使用普通结构体定义的。 这些结构体可以包含具有基本Go类型、指针或这些类型的别名，甚至是自定义类型（只需要实现 database/sql 包中的Scanner和Valuer接口）。

考虑以下 user 模型的示例：

type User struct {
  ID           uint           // Standard field for the primary key
  Name         string         // 一个常规字符串字段
  Email        *string        // 一个指向字符串的指针, allowing for null values
  Age          uint8          // 一个未签名的8位整数
  Birthday     *time.Time     // A pointer to time.Time, can be null
  MemberNumber sql.NullString // Uses sql.NullString to handle nullable strings
  ActivatedAt  sql.NullTime   // Uses sql.NullTime for nullable time fields
  CreatedAt    time.Time      // 创建时间（由GORM自动管理）
  UpdatedAt    time.Time      // 最后一次更新时间（由GORM自动管理）
}

在此模型中：

  • 具体数字类型如 uint、string和 uint8 直接使用。
  • 指向 *string 和 *time.Time 类型的指针表示可空字段。
  • 来自 database/sql 包的 sql.NullString 和 sql.NullTime 用于具有更多控制的可空字段。
  • CreatedAt 和 UpdatedAt 是特殊字段，当记录被创建或更新时，GORM 会自动向内填充当前时间。

除了 GORM 中模型声明的基本特性外，强调下通过 serializer 标签支持序列化也很重要。 此功能增强了数据存储和检索的灵活性，特别是对于需要自定义序列化逻辑的字段。详细说明请参见 Serializer。

约定
  1. 主键：GORM 使用一个名为ID 的字段作为每个模型的默认主键。
  2. 表名：默认情况下，GORM 将结构体名称转换为 snake_case 并为表名加上复数形式。 例如，一个 User 结构体在数据库中的表名变为 users 。
  3. 列名：GORM 自动将结构体字段名称转换为 snake_case 作为数据库中的列名。
  4. 时间戳字段：GORM使用字段 CreatedAt 和 UpdatedAt 来自动跟踪记录的创建和更新时间。

遵循这些约定可以大大减少您需要编写的配置或代码量。 但是，GORM也具有灵活性，允许您根据自己的需求自定义这些设置。 您可以在GORM的约定文档中了解更多关于自定义这些约定的信息。

gorm.Model

GORM提供了一个预定义的结构体，名为gorm.Model，其中包含常用字段：

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

  • 将其嵌入在您的结构体中: 您可以直接在您的结构体中嵌入 gorm.Model ，以便自动包含这些字段。 这对于在不同模型之间保持一致性并利用GORM内置的约定非常有用，请参考嵌入结构。

  • 包含的字段：

    • ID ：每个记录的唯一标识符（主键）。
    • CreatedAt ：在创建记录时自动设置为当前时间。
    • UpdatedAt：每当记录更新时，自动更新为当前时间。
    • DeletedAt：用于软删除（将记录标记为已删除，而实际上并未从数据库中删除）。
高级选项
字段级权限控制

可导出的字段在使用 GORM 进行 CRUD 时拥有全部的权限，此外，GORM 允许您用标签控制字段级别的权限。这样您就可以让一个字段的权限是只读、只写、只创建、只更新或者被忽略

注意： 使用 GORM Migrator 创建表时，不会创建被忽略的字段

type User struct {
  Name string `gorm:"<-:create"` // 允许读和创建
  Name string `gorm:"<-:update"` // 允许读和更新
  Name string `gorm:"<-"`        // 允许读和写（创建和更新）
  Name string `gorm:"<-:false"`  // 允许读，禁止写
  Name string `gorm:"->"`        // 只读（除非有自定义配置，否则禁止写）
  Name string `gorm:"->;<-:create"` // 允许读和写
  Name string `gorm:"->:false;<-:create"` // 仅创建（禁止从 db 读）
  Name string `gorm:"-"`  // 通过 struct 读写会忽略该字段
  Name string `gorm:"-:all"`        // 通过 struct 读写、迁移会忽略该字段
  Name string `gorm:"-:migration"`  // 通过 struct 迁移会忽略该字段
}
创建/更新时间追踪（纳秒、毫秒、秒、Time）

GORM 约定使用 CreatedAt、UpdatedAt 追踪创建/更新时间。如果您定义了这种字段，GORM 在创建、更新时会自动填充 当前时间

要使用不同名称的字段，您可以配置 autoCreateTime、autoUpdateTime 标签。

如果您想要保存 UNIX（毫/纳）秒时间戳，而不是 time，您只需简单地将 time.Time 修改为 int 即可

type User struct {
  CreatedAt time.Time // 在创建时，如果该字段值为零值，则使用当前时间填充
  UpdatedAt int       // 在创建时该字段值为零值或者在更新时，使用当前时间戳秒数填充
  Updated   int64 `gorm:"autoUpdateTime:nano"` // 使用时间戳纳秒数填充更新时间
  Updated   int64 `gorm:"autoUpdateTime:milli"` // 使用时间戳毫秒数填充更新时间
  Created   int64 `gorm:"autoCreateTime"`      // 使用时间戳秒数填充创建时间
}
嵌入结构体

对于匿名字段，GORM 会将其字段包含在父结构体中，例如：

type User struct {
  gorm.Model
  Name string
}
// 等效于
type User struct {
  ID        uint           `gorm:"primaryKey"`
  CreatedAt time.Time
  UpdatedAt time.Time
  DeletedAt gorm.DeletedAt `gorm:"index"`
  Name string
}

对于正常的结构体字段，你也可以通过标签 embedded 将其嵌入，例如：

type Author struct {
    Name  string
    Email string
}

type Blog struct {
  ID      int
  Author  Author `gorm:"embedded"`
  Upvotes int32
}
// 等效于
type Blog struct {
  ID    int64
  Name  string
  Email string
  Upvotes  int32
}

并且，您可以使用标签 embeddedPrefix 来为 db 中的字段名添加前缀，例如：

type Blog struct {
  ID      int
  Author  Author `gorm:"embedded;embeddedPrefix:author_"`
  Upvotes int32
}
// 等效于
type Blog struct {
  ID          int64
  AuthorName string
  AuthorEmail string
  Upvotes     int32
}
字段标签

声明模型时可以选择使用标签，GORM 支持以下标签： 标签不区分大小写，但首选 camelCase 。如果使用多个标签，则应使用分号 ( ; ) 分隔它们。对解析器具有特殊含义的字符可以使用反斜杠 ( \ ) 进行转义，从而将它们用作参数值。

标签名说明
column指定 db 列名
type列数据类型，推荐使用兼容性好的通用类型，例如：所有数据库都支持 bool、int、uint、float、string、time、bytes 并且可以和其他标签一起使用，例如：not null、size, autoIncrement… 像 varbinary(8) 这样指定数据库数据类型也是支持的。在使用指定数据库数据类型时，它需要是完整的数据库数据类型，如：MEDIUMINT UNSIGNED not NULL AUTO_INCREMENT
serializer指定将数据序列化或反序列化到数据库中的序列化器, 例如: serializer:json/gob/unixtime
size定义列数据类型的大小或长度，例如 size: 256
primaryKey将列定义为主键
unique将列定义为唯一键
default定义列的默认值
precision指定列的精度
scale指定列大小
not null指定列为 NOT NULL
autoIncrement指定列为自动增长
autoIncrementIncrement自动步长，控制连续记录之间的间隔
embedded嵌套字段
embeddedPrefix嵌入字段的列名前缀
autoCreateTime创建时追踪当前时间，对于 int 字段，它会追踪时间戳秒数，您可以使用 nano/milli 来追踪纳秒、毫秒时间戳，例如：autoCreateTime:nano
autoUpdateTime创建/更新时追踪当前时间，对于 int 字段，它会追踪时间戳秒数，您可以使用 nano/milli 来追踪纳秒、毫秒时间戳，例如：autoUpdateTime:milli
index根据参数创建索引，多个字段使用相同的名称则创建复合索引，查看 索引 获取详情
uniqueIndex与 index 相同，但创建的是唯一索引
check创建检查约束，例如 check:age > 13，查看 约束 获取详情
<-设置字段写入的权限， <-:create 只创建、<-:update 只更新、<-:false 无写入权限、<- 创建和更新权限
->设置字段读的权限，->:false 无读权限
-忽略该字段，- 表示无读写，-:migration 表示无迁移权限，-:all 表示无读写迁移权限
comment迁移时为字段添加注释
关联标签

GORM 允许通过标签为关联配置外键、约束、many2many 表，详情请参考 关联部分

gorm 中文文档(pdf)
08-07
参照 https://github.com/jasperxu/gorm-cn-doc.git 生成的pdf文档。
Go语言入门指南：从基础到实践.zip
04-21
Go语言，也被称为Golang，是由Google开发的一种静态类型的、编译型的、...实践是检验理论的最好方式，因此，阅读并实践《Go语言入门指南：从基础到实践》中的案例，将有助于你更好地掌握Go语言并将其应用于实际项目中。
gorm 介绍
feiyan35488的专栏
04-06 202
grails 中的gorm框架是基于 hibernage，就是在hibernate基础上进行了一层薄薄的封装。 下面主要讲讲 几种关系  1，1对1     在 class A { B b       }     class B{}     默认会级联  插入和更新     当B 指定 static belongsTo 时，表示指定owner， 这样在删除A时 会将B级联删除 ...
GORM 全面解析：从基础到高级
最新发布
m0_57836225的博客
09-20 570
GORM 也提供了执行原生 SQL 语句的方法，可以使用 GORM 的 Raw 函数来执行原生 SQL 语句，并将结果映射到 Go 结构体中。预加载是一种优化关联查询性能的方法。在进行关联查询时，如果不使用预加载，GORM 会在查询主表数据后，再分别查询关联表的数据，这样会导致多次数据库查询。- 连接池管理：GORM 可以使用数据库连接池来管理数据库连接，提高连接的复用率，减少连接创建和销毁的开销。- 模型定义：首先，定义 Go 结构体来表示数据库表的结构，并使用 GORM 的标签来指定字段的数据库属性。
Gorm简介
qq_41891425的博客
12-26 801
简介 gorm主要是把struct类型和数据库表记录进行映射，操作数据库的时候不需要直接手写SQL代码 导入依赖包：github.com/jinzhu/gorm 数据库定义的users表s 字段 属性 id 自增id username 账号 password 密码 createtime 创建时间 Gorm的定义 对应关系 数据库中的username 结构体中 Username password Password createtime CreateTim
gorm简介
all_about_WZY的博客
06-17 1354
gorm是一个功能强大的Go编程语言中的ORM库，具有简单易用、多数据库支持、自动迁移、事务支持和强大的查询功能等特点。在复杂的业务逻辑中，事务可以确保一系列操作要么全部成功，要么全部回滚，避免了数据不一致的问题。ORM是一种技术，它将数据库表中的数据映射到面向对象的模型中，从而简化了数据库操作。gorm具有强大的自动迁移功能，可以根据定义的模型自动创建、修改数据库表结构。这简化了数据库结构的管理，减少了手动处理数据库迁移的工作量。接下来，你可以定义你的数据模型，并使用gorm提供的API进行数据库操作。
Grails入门指南
05-26
**Grails入门指南** Grails是一种基于Groovy语言的开源Web应用框架，它极大地简化了Java平台上的开发工作。Grails的设计理念是“代码胜于配置”，它通过元编程和约定优于配置的原则，使得开发效率得到了显著提升。...
gorm文档_英文.pdf
09-14
gorm文档_英文.pdf gorm文档是Golang语言中一个功能强大的ORM（Object-Relational ...gorm文档提供了一个完整的gorm库使用指南，涵盖了从基本使用到高级用法的所有方面，对于想要使用gorm库的开发者来说非常有帮助。
Grails从入门指南(第二版)
12-16
《Grails从入门指南(第二版)》是一本专为初学者设计的全面教程，旨在帮助读者快速掌握Grails框架的基础知识和高级特性。Grails是一个基于Groovy语言的开源Web应用开发框架，它简化了Java平台上的开发过程，提供了...
golang学习之gorm(一):Gorm介绍
热门推荐
浅弋、璃鱼的博客
11-15 3万+
文章目录一、gorm介绍:1. 什么是orm？2. gorm3.安装4.官方文档： 一、gorm介绍: 1. 什么是orm？ Object-Relationl Mapping，即对象关系映射，这里的Relationl指的是关系型数据库 它的作用是在关系型数据库和对象之间作一个映射，这样，我们在具体的操作数据库的时候，就不需要再去和复杂的SQL语句打交道，只要像平时操作对象一样操作它就可以了 。 2. gorm 1.Golang写的，GitHub上活跃度很高的orm库 2.特点： 全功能ORM; 关联(包含
01-gorm介绍和基本用法
w7635122886的博客
01-17 329
gorm介绍和基本用法
Gorm—Go语言数据库框架
追求幸福，探索未知的博客
07-30 6490
Go语言最流行的数据库ORM【对象关系映射】框架。
gorm
bob422720735的博客
06-29 132
func UpdateArticleDetails(title, content, cover, desc, tags, keyword string, menuId, categoryId int, isTop, hot, recommend, prod, markdown bool, id int) error { // 0 草稿箱 1发布 2垃圾箱 var save int if prod { save = 1 } else { save = 0 } a := &m..
go-gorm
qq_40530622的博客
11-22 286
package main import ( "encoding/json" "fmt" "time" "github.com/jinzhu/gorm" _ "github.com/jinzhu/gorm/dialects/mysql" ) var MainDB *gorm.DB func main() { url := "test:123456@tcp(127.0.0.1:3306)/blogger?charset=utf8mb4&parseTime=True&loc=L
Gorm(简介)
屈帅波的技术博客
06-26 5958
ORM Object Relation Mapping（关系对象映射） 把对象模型表示的对象映射到基于S Q L 的关系模型数据库结构中 在具体的操作实体对象的时候，不需要直接与复杂的 SQL语句打交道，只需简单的操作实体对象的属性和方法 Gorm是使用go语言开发的ORM库 地址: github.com/jinzhu/gorm 驱动：github.com/go-sql-driver/mysql 导入：github.com/jinzhu/gorm/dialects/mysql 连接设置 username
GORM(推荐)
右见小栈
01-24 3261
Golang操控MySQL的小李飞刀。
GORM 文档
peng_lixuan的博客
11-30 429
GORM 中文文档
Grails入门指南：快速掌握Groovy框架
"Grails入门指南中文版，由Scott Davis和Jason Rudolph撰写，胡键翻译，旨在帮助读者快速掌握Grails基础开发。本书由InfoQ中文站免费提供，并强调Grails作为Java社区中的创新框架，提供了丰富的功能如MVC、ORM、插件...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值