这是我参与「第三届青训营 -后端场」笔记创作活动的的第2篇笔记。
概述
The fantastic ORM library for Golang aims to be developer friendly.
一个致力于开发者友好、极好的Golang ORM类库。
特性
-
全功能 ORM
-
关联 (Has One,Has Many,Belongs To,Many To Many,多态,单表继承)
-
Create,Save,Update,Delete,Find 中钩子方法
-
支持 Preload、Joins 的预加载
-
事务,嵌套事务,Save Point,回滚到 Saved Point
-
Context、预编译模式、DryRun 模式
-
批量插入,FindInBatches,Find/Create with Map,使用 SQL 表达式、Context Valuer 进行 CRUD SQL 构建器,Upsert,数据库锁,Optimizer/Index/Comment Hint,命名参数,子查询
-
复合主键,索引,约束
-
Auto Migration
-
自定义 Logger
-
灵活的可扩展插件 API:Database Resolver(多数据库,读写分离)、Prometheus…
-
每个特性都经过了测试的重重考验
-
开发者友好
一、使用形式
1、引入gorm包
import "github.com/jinzhu/gorm"
2、导入数据库驱动
import (
"github.com/jinzhu/gorm"
_ "github.com/go-sql-driver/mysql"
)
3、连接数据库
//最简单形式
func main() {
db, err := gorm.Open("mysql", "user:password@/dbnamecharset=utf8&parseTime=True&loc=Local")
defer db.Close()
}
二、查询操作
1、模型
表名默认是模型的复数形式,列名默认是字段名的驼峰形式
type User struct {// 默认表名是`users`
ID uint // 列名为 `id`
Name string // 列名为 `name`
Birthday time.Time // 列名为 `birthday`
CreatedAt time.Time // 列名为 `created_at`
}
基本模型定义如下,表中需要这些字段的,可以直接引入模型即可
// 基本模型的定义
type Model struct {
ID uint `gorm:"primary_key"`
CreatedAt time.Time
UpdatedAt time.Time
DeletedAt *time.Time
}
//引入模型:
type User struct {
gorm.Model
Name string
}
//默认id为主键
type User struct {
ID uint // 字段`ID`为默认主键
Name string
}
// 使用tag`primary_key`用来设置主键
type Animal struct {
AnimalId int64 `gorm:"primary_key"` // 设置AnimalId为主键
Name string
Age int64
}
2、简单查询
// 获取第一条记录,按主键排序
db.First(&user);
select * from users order by id limit 1;
// 获取最后一条记录,按主键排序
db.Last(&user);
select * from users order by id desc limit 1;
// 获取所有记录
db.Find(&user);
select * from users;
// 使用主键获取记录
db.First(&user,10);
select * from users where id =10;
3、Select查询
指定要从数据库检索的字段,默认情况下,将选择所有字段;
//简单select
db.Select("name","age").Find(&user);
select name,age from users;
db.Select([]string{"name","age"}).Find(&user);
db.Table("users").Select("COALESCE(age,?)", 42).Rows()
SELECT COALESCE(age,'42') FROM users;
4、where查询(简单sql)
// 获取第一个匹配记录
db.Where("name=?","jinzhu").First(&user);
select * from users where name='jinzhu' limit 1
// 获取所有匹配记录
db.Where("name=?","jinzhu").Find(&user);
select * from users where name='jinzhu';
//不等于
db.Where("name<>?","jinzhu").Find(&user);
//in
db.Where("name in (?) ",[]string{"jinzhu1","jinzhu2"}).Find(&user)
//like
db.Where("name like ?","%jinzhu%").Find(&user);
//and
db.Where("name =? and age=?","jinzhu",16).Find(&user);
// Time
db.Where("create_at >= ?",lastWeek).Find(&user);
db.Where("create_at between ? and ?",lastWeek,today).Find(&user);