[TOC]
# 對象的CRUD操作
如果已知主鍵的值,那么可以使用這些方法進行CRUD操作
對 object 操作的四個方法 Read / Insert / Update / Delete
```go
o := orm.NewOrm()
user := new(User)
user.Name = "slene"
fmt.Println(o.Insert(user))
user.Name = "Your"
fmt.Println(o.Update(user))
fmt.Println(o.Read(user))
fmt.Println(o.Delete(user))
```
如果需要通過條件查詢獲取對象,請參見[高級查詢](query.md#all)
## Read
```go
o := orm.NewOrm()
user := User{Id: 1}
err = o.Read(&user)
if err == orm.ErrNoRows {
fmt.Println("查詢不到")
} else if err == orm.ErrMissPK {
fmt.Println("找不到主鍵")
} else {
fmt.Println(user.Id, user.Name)
}
```
Read 默認通過查詢主鍵賦值,可以使用指定的字段進行查詢:
```go
user := User{Name: "slene"}
err = o.Read(&user, "Name")
...
```
對象的其他字段值將會是對應類型的默認值
復雜的單個對象查詢參見 [One](query.md#one)
## ReadOrCreate
嘗試從數據庫讀取,不存在的話就創建一個
默認必須傳入一個參數作為條件字段,同時也支持多個參數多個條件字段
```go
o := orm.NewOrm()
user := User{Name: "slene"}
// 三個返回參數依次為:是否新創建的,對象Id值,錯誤
if created, id, err := o.ReadOrCreate(&user, "Name"); err == nil {
if created {
fmt.Println("New Insert an object. Id:", id)
} else {
fmt.Println("Get an object. Id:", id)
}
}
```
## Insert
第一個返回值為自增健 Id 的值
```go
o := orm.NewOrm()
var user User
user.Name = "slene"
user.IsActive = true
id, err := o.Insert(&user)
if err == nil {
fmt.Println(id)
}
```
創建后會自動對 auto 的 field 賦值
## InsertMulti
同時插入多個對象
類似sql語句
```
insert into table (name, age) values("slene", 28),("astaxie", 30),("unknown", 20)
```
第一個參數 bulk 為并列插入的數量,第二個為對象的slice
返回值為成功插入的數量
```go
users := []User{
{Name: "slene"},
{Name: "astaxie"},
{Name: "unknown"},
...
}
successNums, err := o.InsertMulti(100, users)
```
bulk 為 1 時,將會順序插入 slice 中的數據
## Update
第一個返回值為影響的行數
```go
o := orm.NewOrm()
user := User{Id: 1}
if o.Read(&user) == nil {
user.Name = "MyName"
if num, err := o.Update(&user); err == nil {
fmt.Println(num)
}
}
```
Update 默認更新所有的字段,可以更新指定的字段:
```go
// 只更新 Name
o.Update(&user, "Name")
// 指定多個字段
// o.Update(&user, "Field1", "Field2", ...)
...
```
根據復雜條件更新字段值參見 [Update](query.md#update)
## Delete
第一個返回值為影響的行數
```go
o := orm.NewOrm()
if num, err := o.Delete(&User{Id: 1}); err == nil {
fmt.Println(num)
}
```
Delete 操作會對反向關系進行操作,此例中 Post 擁有一個到 User 的外鍵。刪除 User 的時候。如果 on_delete 設置為默認的級聯操作,將刪除對應的 Post
**Changed in 1.0.3** 刪除以后不會刪除 auto field 的值
- 寫在前面的話
- 第0章 beego 簡介
- 0.1 為beego貢獻
- 0.2 發布版本
- 0.3 升級指南
- 第1章 安裝升級
- 1.1 bee工具的使用
- 第2章 快速入門
- 2.1 新建項目
- 2.2 路由設置
- 2.3 Controller運行機制
- 2.4 Model邏輯
- 2.5 View編寫
- 2.6 靜態文件處理
- 第3章 beego的MVC架構
- 3.1 Model設計
- 3.1.1 概述
- 3.1.2 ORM使用
- 3.1.3 CRUD操作
- 3.1.4 高級查詢
- 3.1.5 原生SQL查詢
- 3.1.6 構造查詢
- 3.1.7 事物處理
- 3.1.8 模型定義
- 3.1.9 命令模式
- 3.1.10 測試用例
- 3.1.11 自定義字段
- 3.1.12 FAQ
- 3.2 View設計
- 3.2.1 模板語法指南
- 3.2.2 模板處理
- 3.2.3 模板函數
- 3.2.4 靜態文件處理
- 3.2.5 模板分頁處理
- 3.3 Controller設計
- 3.3.1 參數配置
- 3.3.2 路由設置
- 3.3.3 控制器函數
- 3.3.4 XSRF過濾
- 3.3.5 請求數據處理
- 3.3.6 session 控制
- 3.3.7 過濾器
- 3.3.8 flash 數據
- 3.3.9 URL構建
- 3.3.10 多種格式數據輸出
- 3.3.11 表單數據驗證
- 3.3.12 錯誤處理
- 3.3.13 日志處理
- 第4章 beego的模塊設計
- 4.1 session 模塊
- 4.2 grace 模塊
- 4.3 cache 模塊
- 4.4 logs 模塊
- 4.5 httplib 模塊
- 4.6 context 模塊
- 4.7 toolbox 模塊
- 4.8 config 模塊
- 4.9 i18n 模塊
- 第5章 beego高級編程
- 5.1 進程內監控
- 5.2 API自動化文檔
- 第6章 應用部署
- 6.1 獨立部署
- 6.2 Supervisor部署
- 6.3 Nginx 部署
- 6.4 Apache 部署
- 第7章 第三方庫
- 第8章 應用例子
- 8.1 在線聊天室
- 8.2 短域名服務
- 8.3 Todo列表
- 第9章 FAQ