golang orm 框架之 gorm
最近在想给这个小站增加点赞和评论功能,第三方系统又有各种限制,就想自己弄个后端,实现类似的功能,对于个人来说,数据量不是很大,单机的 mysql 足够存下所有数据,mysql 作为底层存储是个不错的选择
之前在公司是直接用的 github.com/go-sql-driver/mysql
访问数据库都是直接用写 sql,取出结果然后自己拼成对象,使用上面不是很方便,可读性也不好。想起之前研究 php laravel 框架的时候,直接把数据库层屏蔽了,用户看到的只有对象,使用非常方便,java 里面这种操作方式基本上已经成了标准做法,就去 github 上找了一下 golang 里面有没有类似的东西,果然已经有非常成熟的框架了,github.com/jinzhu/gorm
已经有 7k+ 的 star 了
ORM(Object Relation Mapping),对象关系映射,实际上就是对数据库的操作进行封装,对上层开发人员屏蔽数据操作的细节,开发人员看到的就是一个个对象,大大简化了开发工作,提高了生产效率
好了,下面我以这个点赞评论系统为例,介绍一下 gorm 的简单用法,以下使用的完整代码:https://github.com/hatlonely/microservices/blob/master/internal/comment_like/comment_like.go
gorm 用法介绍
库安装
go get -u github.com/jinzhu/gorm
数据库连接
import ("github.com/jinzhu/gorm"_ "github.com/jinzhu/gorm/dialects/mysql"
)var db *gorm.DBfunc init() {var err errordb, err = gorm.Open("mysql", "<user>:<password>/<database>?charset=utf8&parseTime=True&loc=Local")if err != nil {panic(err)}
}
连接比较简单,直接调用 gorm.Open
传入数据库地址即可
github.com/jinzhu/gorm/dialects/mysql
是 golang 的 mysql 驱动,实际上就是 github.com/go-sql-driver/mysql
作者这里为了好记,重新弄了个名字
这里我用的 mysql,实际上支持基本上所有主流的关系数据库,连接方式上略有不同
db.DB().SetMaxIdleConns(10)
db.DB().SetMaxOpenConns(100)
还可以使用 db.DB()
对象设置连接池信息
表定义
先来定义一个点赞表,这里面一条记录表示某个用户在某个时刻对某篇文章点了一个赞,用 ip + ua 来标识用户,title 标识文章标题
type Like struct {ID int `gorm:"primary_key"`Ip string `gorm:"type:varchar(20);not null;index:ip_idx"`Ua string `gorm:"type:varchar(256);not null;"`Title string `gorm:"type:varchar(128);not null;index:title_idx"`Hash uint64 `gorm:"unique_index:hash_idx;"`CreatedAt time.Time
}
gorm 用 tag 的方式来标识 mysql 里面的约束
创建索引只需要直接指定列即可,这里创建了两个索引,ip_idx
和 title_idx
;如果需要多列组合索引,直接让索引的名字相同即可;如果需要创建唯一索引,指定为 unique_index
即可
支持时间类型,直接使用 time.Time
即可
创建表
if !db.HasTable(&Like{}) {if err := db.Set("gorm:table_options", "ENGINE=InnoDB DEFAULT CHARSET=utf8").CreateTable(&Like{}).Error; err != nil {panic(err)}
}
直接通过 db.CreateTable
就可以创建表了,非常方便,还可以通过 db.Set
设置一些额外的表属性
插入
like := &Like{Ip: ip,Ua: ua,Title: title,Hash: murmur3.Sum64([]byte(strings.Join([]string{ip, ua, title}, "-"))) >> 1,CreatedAt: time.Now(),
}if err := db.Create(like).Error; err != nil {return err
}
先构造已给对象,直接调用 db.Create()
就可以插入一条记录了
删除
if err := db.Where(&Like{Hash: hash}).Delete(Like{}).Error; err != nil {return err
}
先用 db.Where()
构造查询条件,再调用 db.Delete()
就可以删除
查询
var count int
err := db.Model(&Like{}).Where(&Like{Ip: ip, Ua: ua, Title: title}).Count(&count).Error
if err != nil {return false, err
}
先用 db.Model()
选择一个表,再用 db.Where()
构造查询条件,后面可以使用 db.Count()
计算数量,如果要获取对象,可以使用 db.Find(&Likes)
或者只需要查一条记录 db.First(&Like)
修改
db.Model(&user).Update("name", "hello")
db.Model(&user).Updates(User{Name: "hello", Age: 18})
db.Model(&user).Updates(User{Name: "", Age: 0, Actived: false}) // nothing update
我这个系统里面没有更新需求,这几个例子来自于官网,第一个是更新单条记录;第二个是更新整条记录,注意只有非空字段才会更新;第三个例子是不会更新的,在系统设计的时候要尽量避免这些空值有特殊的含义,如果一定要更新,可以使用第一种方式,设置单个值
错误处理
其实你已经看到了,这里基本上所有的函数都是链式的,全部都返回 db
对象,任何时候调用 db.Error
就能获取到错误信息,非常方便
事务
func CreateAnimals(db *gorm.DB) err {tx := db.Begin()if err := tx.Create(&Animal{Name: "Giraffe"}).Error; err != nil {tx.Rollback()return err}if err := tx.Create(&Animal{Name: "Lion"}).Error; err != nil {tx.Rollback()return err}tx.Commit()return nil
}
事务的处理也很简单,用 db.Begin()
声明开启事务,结束的时候调用 tx.Commit()
,异常的时候调用 tx.Rollback()
其他
还可以使用如下方式设置日志输出级别以及改变日志输出地方
db.LogMode(true)
db.SetLogger(gorm.Logger{revel.TRACE})
db.SetLogger(log.New(os.Stdout, "\r\n", 0))
也支持普通的 sql,但是建议尽量不要使用
参考链接
- gorm 官方文档: http://gorm.io/
- gorm github: https://github.com/jinzhu/gorm
golang orm 框架之 gorm相关推荐
- 自己动手写一个Golang ORM框架
作者:smallyang,腾讯 IEG 运营开发工程师 当我深入的学习和了解了 GORM,XORM 后,我还是觉得它们不够简洁和优雅,有些笨重,有很大的学习成本.本着学习和探索的目的,于是我自己实现了 ...
- gin框架学习-Gorm入门指南
目录 前言 一.GORM介绍 1.GORM概述 2.为什么选择GORM? 二.安装 三.快速入门 四.模型定义 1.模型定义介绍 2.约定 3.gorm.Model 4.高级选项 1)字段级权限控制 ...
- 【ORM框架】go语言ORM框架 - gorm快速入门
文章目录 前言 一.正确看待orm 1.什么是orm 2.常用的orm 3.orm的优缺点 4.如何正确看待orm和sql之间的关系 二.gorm入门 前言 Gorm 是 Golang 的一个 orm ...
- [golang gin框架] 6.Gin GORM简介以及安装
介绍 GORM 是 Golang 的一个 orm 框架,简单说,ORM 就是通过实例对象的语法,完成关系型 数据库的操作的技术,是"对象-关系映射"(Object/Relation ...
- 【GORM框架】ORM介绍、GORM简单连接和高级配置详解
博主简介:努力学习的大一在校计算机专业学生,热爱学习和创作.目前在学习和分享:数据结构.Go,Java等相关知识. 博主主页: @是瑶瑶子啦 所属专栏: GORM框架学习 近期目标:写好专栏的每一篇文 ...
- golang orm对比
golang orm对比 golang https://segmentfault.com/a/1190000015606291 各主流的golang orm介绍 当前较为主流/活跃的orm有gorm. ...
- Golang学习笔记之GORM基础使用(一)
本文章主要学习了GORM的基础知识,数据库的连接以及数据库表的建立的多种方法.本文为学习笔记,通过GORM官方中文文档和李文周的博客学习整理而成. gorm是一个使用Go语言编写的ORM框架.它文档齐 ...
- Golang gin框架
gin框架学习 一.Gin 介绍 二.Gin 环境搭建 三.golang 程序的热加载 安装fresh 库 四.Gin 框架中的路由 4.1 路由概述 4.2 简单的路由配置 4.3 动态路由 4.4 ...
- Golang学习笔记之GORM基础使用(二)
本文章主要学习GORM的增删查改.若还没有完成数据库和数据表的创建.定义模型以及数据库的连接请先学习本本专栏文章Golang学习笔记之GORM基础使用(一).本文为学习笔记,通过GORM官方中文文档和 ...
最新文章
- Python实训day08pm【面试和职场的经验分享】
- MSSQL 标量函数
- 代码编辑器揭露性格,你是哪一种?
- 蓝桥杯 试题 基础练习 十六进制转十进制——5行代码AC
- .NET Core/.NET 5.0 析构函数依然有效?
- 计算机通信辞典登录,数字化
- 找出100以内内被7整除的数,每行显示7个,然后换行显示
- 论述计算机科学与技术专业的狭义与广义,2013年秋季学期计算机科学与技术专业《高等代数》复习提纲与补充题...
- 目标检测算法 2020_One-stage目标检测算法综述
- Google 的隐私噩梦来了......
- JAVA 读取shp数据,shp导入,导出工具
- 硬件知识:网线的分类知识笔记,看完你就懂了!
- pandas用in筛选数据
- Android连接逍遥模拟器
- python自动评论_selenium+python 的微博自动转赞评功能实现
- 集合的运算(C++单链表实现)
- keil (v5.24.2.0)、protues8.9、STM32F103R6,点灯试验仿真protues报错unclocked peripheral at 0x40010800
- 淘宝店铺层级划分规则是什么?如何去玩转?
- 数字信号处理_第1个编程实例
- php公众号获取code,微信开发系列——公众号内嵌H5页面获取code,拿到openID
热门文章
- 组策略 之 文件夹重定向
- 浅谈依赖注入与控制反转
- 实用ExtJS教程100例-006:ExtJS中Window的用法示例
- Codeforces Round #351 (VK Cup 2016 Round 3, Div. 2 Edition) A. Bear and Game 水题
- 为安装有系统及应用的服务器更换硬盘方法一例
- 最优化问题的求解分类
- 方程AX=b的解的讨论(特解、通解、零空间向量等概念)及其MATLAB实现
- 简单剖析C语言中的位扩展问题
- c++构建工具之xmake使用实例
- python dlib学习(二):人脸特征点标定