# gorm-cn-doc

**Repository Path**: Ranger313/gorm-cn-doc

## Basic Information

- **Project Name**: gorm-cn-doc
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-06-08
- **Last Updated**: 2021-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GORM 中文文档

[https://jasperxu.com/#/Programming/Golang/GORM/](https://jasperxu.com/#/Programming/Golang/GORM/)

Golang写的，开发人员友好的ORM库。本文档是基于 GORM v1.x 版本的文档翻译的。

目前已迁移到上面的新地址。

## 概述

* 全功能ORM（几乎）
* 关联（包含一个，包含多个，属于，多对多，多种包含）
* Callbacks（创建/保存/更新/删除/查找之前/之后）
* 预加载（急加载）
* 事务
* 复合主键
* SQL Builder
* 自动迁移
* 日志
* 可扩展，编写基于GORM回调的插件
* 每个功能都有测试
* 开发人员友好

## 安装

```
go get -u github.com/jinzhu/gorm
```

## 升级到V1.0

* [更新日志](changelog.md)

## 快速开始

```go
package main

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

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

func main() {
  db, err := gorm.Open("sqlite3", "test.db")
  if err != nil {
    panic("连接数据库失败")
  }
  defer db.Close()

  // 自动迁移模式
  db.AutoMigrate(&Product{})

  // 创建
  db.Create(&Product{Code: "L1212", Price: 1000})

  // 读取
  var product Product
  db.First(&product, 1) // 查询id为1的product
  db.First(&product, "code = ?", "L1212") // 查询code为l1212的product

  // 更新 - 更新product的price为2000
  db.Model(&product).Update("Price", 2000)

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