模型（Models）－ beego ORM

beego ORM 是一個(gè)強(qiáng)大的 Go 語言 ORM 框架。她的靈感主要來自 Django ORM 和 SQLAlchemy。

目前該框架仍處于開發(fā)階段，可能發(fā)生任何導(dǎo)致不兼容的改動(dòng)。

已支持?jǐn)?shù)據(jù)庫驅(qū)動(dòng)：

• MySQL：github.com/go-sql-driver/mysql
• PostgreSQL：github.com/lib/pq
• Sqlite3：github.com/mattn/go-sqlite3

以上數(shù)據(jù)庫驅(qū)動(dòng)均通過基本測試，但我們?nèi)孕枰姆答仭?/p>

ORM 特性：

• 支持 Go 的所有類型存儲(chǔ)
• 輕松上手，采用簡單的 CRUD 風(fēng)格
• 自動(dòng) Join 關(guān)聯(lián)表
• 跨數(shù)據(jù)庫兼容查詢
• 允許直接使用 SQL 查詢／映射
• 嚴(yán)格完整的測試保證 ORM 的穩(wěn)定與健壯

更多特性請(qǐng)?jiān)谖臋n中自行品讀。

安裝 ORM：

go get github.com/astaxie/beego/orm

修改日志

• 2016-01-18: 規(guī)范了數(shù)據(jù)庫驅(qū)動(dòng)的命名
• 2014-03-10: GetDB 從注冊(cè)的數(shù)據(jù)庫中返回 *sql.DB. ResetModelCache 重置已注冊(cè)的模型struct
• 2014-02-10: 隨著 beego1.1.0 的發(fā)布提交的改進(jìn)關(guān)于 時(shí)區(qū)設(shè)置新增的 api: Ormer.InsertMulti Ormer.ReadOrCreate RawSeter.RowsToMap RawSeter.RowsToStruct orm.NewOrmWithDB改進(jìn)的 api: RawSeter.Values 支持設(shè)置 columns RawSeter.ValuesList 支持設(shè)置 columns RawSeter.ValuesFlat 支持設(shè)置 column RawSeter.QueryRow/QueryRows 從對(duì)應(yīng)每個(gè)strcut field位置的賦值，改為對(duì)應(yīng)名稱取值（不需要對(duì)應(yīng)好字段數(shù)量與位置）
• 2013-10-14: 自動(dòng)載入關(guān)系字段，多對(duì)多關(guān)系操作，完善關(guān)系查詢
• 2013-10-09: 原子操作更新值
• 2013-09-22: RegisterDataBase maxIdle / maxConn 設(shè)置為可選參數(shù), MySQL 自定義引擎
• 2013-09-16: 支持設(shè)置 空閑鏈接數(shù) 和 最大鏈接數(shù) SetMaxIdleConns / SetMaxOpenConns
• 2013-09-12: Read 支持設(shè)定條件字段 Update / All / One 支持設(shè)定返回字段
• 2013-09-09: Raw SQL QueryRow/QueryRows 功能完成
• 2013-08-27: 自動(dòng)建表繼續(xù)改進(jìn)
• 2013-08-19: 自動(dòng)建表功能完成
• 2013-08-13: 更新數(shù)據(jù)庫類型測試
• 2013-08-13: 增加 Go 類型支持，包括 int8、uint8、byte、rune 等
• 2013-08-13: 增強(qiáng) date／datetime 的時(shí)區(qū)支持

快速入門

 簡單示例

package main

import (
    "fmt"
    "github.com/astaxie/beego/orm"
    _ "github.com/go-sql-driver/mysql" // import your used driver
)

// Model Struct
type User struct {
    Id   int
    Name string `orm:"size(100)"`
}

func init() {
    // set default database
    orm.RegisterDataBase("default", "mysql", "username:password@tcp(127.0.0.1:3306)/db_name?charset=utf8", 30)

    // register model
    orm.RegisterModel(new(User))

    // create table
    orm.RunSyncdb("default", false, true)
}

func main() {
    o := orm.NewOrm()

    user := User{Name: "slene"}

    // insert
    id, err := o.Insert(&user)
    fmt.Printf("ID: %d, ERR: %v\n", id, err)

    // update
    user.Name = "astaxie"
    num, err := o.Update(&user)
    fmt.Printf("NUM: %d, ERR: %v\n", num, err)

    // read one
    u := User{Id: user.Id}
    err = o.Read(&u)
    fmt.Printf("ERR: %v\n", err)

    // delete
    num, err = o.Delete(&u)
    fmt.Printf("NUM: %d, ERR: %v\n", num, err)
}

關(guān)聯(lián)查詢

type Post struct {
    Id    int    `orm:"auto"`
    Title string `orm:"size(100)"`
    User  *User  `orm:"rel(fk)"`
}

var posts []*Post
qs := o.QueryTable("post")
num, err := qs.Filter("User__Name", "slene").All(&posts)

SQL 查詢

當(dāng)您無法使用 ORM 來達(dá)到您的需求時(shí)，也可以直接使用 SQL 來完成查詢／映射操作。

var maps []orm.Params
num, err := o.Raw("SELECT * FROM user").Values(&maps)
for _,term := range maps{
    fmt.Println(term["id"],":",term["name"])
}

事務(wù)處理

o.Begin()
...
user := User{Name: "slene"}
id, err := o.Insert(&user)
if err == nil {
    o.Commit()
} else {
    o.Rollback()
}

調(diào)試查詢?nèi)罩?/h3>

在開發(fā)環(huán)境下，您可以使用以下指令來開啟查詢調(diào)試模式：

func main() {
    orm.Debug = true
...

開啟后將會(huì)輸出所有查詢語句，包括執(zhí)行、準(zhǔn)備、事務(wù)等。

例如：

[ORM] - 2013-08-09 13:18:16 - [Queries/default] - [    db.Exec /     0.4ms] -     [INSERT INTO `user` (`name`) VALUES (?)] - `slene`
...

注意：我們不建議您在部署產(chǎn)品后這樣做。