# GORM 指南
用于Golang的出色的ORM庫旨在對開發人員友好。
## **特性**
* 全功能 ORM
* 關聯 (Has One、Has Many、Belongs To、Many To Many、多態、單表繼承)
* Create、Save、Update、Delete、Find 前/后的勾子
* 基于`Preload`、`Joins`的預加載
* 事務、嵌套事務、保存點、回滾至保存點
* Context、Prepared Statment 模式、DryRun 模式
* 批量插入、FindInBatches、查詢至 Map
* SQL Builder, Upsert, Locking, Optimizer/Index/Comment Hints
* 復合主鍵
* 自動遷移
* 自定義 Logger
* 靈活的可擴展插件 API:Database Resolver(讀寫分離)、Prometheus…
* 所有特性都通過了測試
* 開發者友好
## 安裝
```go
go get -u gorm.io/gorm
go get -u gorm.io/driver/sqlite
```
## 快速入門
```go
package main
import (
"gorm.io/gorm"
"gorm.io/driver/sqlite"
)
type Product struct {
gorm.Model
Code string
Price uint
}
func main() {
db, err := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})
if err != nil {
panic("failed to connect database")
}
// 遷移 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)
}
```