• 模型（Models）－ beego ORM
    • 修改日志
    • 快速入门
      • 简单示例
      • 关联查询
      • SQL 查询
      • 事务处理
      • 调试查询日志
    • 文档索引

    模型（Models）－ beego ORM

    beego ORM 是一个强大的 Go 语言 ORM 框架。她的灵感主要来自 Django ORM 和 SQLAlchemy。

    目前该框架仍处于开发阶段，可能发生任何导致不兼容的改动。

    已支持数据库驱动：

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

    以上数据库驱动均通过基本测试，但我们仍需要您的反馈。

    ORM 特性：

    • 支持 Go 的所有类型存储
    • 轻松上手，采用简单的 CRUD 风格
    • 自动 Join 关联表
    • 跨数据库兼容查询
    • 允许直接使用 SQL 查询／映射
    • 严格完整的测试保证 ORM 的稳定与健壮

    更多特性请在文档中自行品读。

    安装 ORM：

    1. go get github.com/astaxie/beego/orm

    修改日志

    • 2016-01-18: 规范了数据库驱动的命名
    • 2014-03-10: GetDB 从注册的数据库中返回 *sql.DB. ResetModelCache 重置已注册的模型struct

    • 2014-02-10: 随着 beego1.1.0 的发布提交的改进

      • 关于 时区设置

      • 新增的 api:
        Ormer.InsertMulti
        Ormer.ReadOrCreate
        RawSeter.RowsToMap
        RawSeter.RowsToStruct
        orm.NewOrmWithDB

      • 改进的 api:
        RawSeter.Values 支持设置 columns
        RawSeter.ValuesList 支持设置 columns
        RawSeter.ValuesFlat 支持设置 column
        RawSeter.QueryRow/QueryRows 从对应每个strcut field位置的赋值，改为对应名称取值（不需要对应好字段数量与位置）

    • 2013-10-14: 自动载入关系字段，多对多关系操作，完善关系查询

    • 2013-10-09: 原子操作更新值
    • 2013-09-22: RegisterDataBase maxIdle / maxConn 设置为可选参数, MySQL 自定义引擎
    • 2013-09-16: 支持设置 空闲链接数 和 最大链接数 SetMaxIdleConns / SetMaxOpenConns
    • 2013-09-12: Read 支持设定条件字段 Update / All / One 支持设定返回字段
    • 2013-09-09: Raw SQL QueryRow/QueryRows 功能完成
    • 2013-08-27: 自动建表继续改进
    • 2013-08-19: 自动建表功能完成
    • 2013-08-13: 更新数据库类型测试
    • 2013-08-13: 增加 Go 类型支持，包括 int8、uint8、byte、rune 等
    • 2013-08-13: 增强 date／datetime 的时区支持

    快速入门

    简单示例

    1. package main
    3. import (
    4.     "fmt"
    5.     "github.com/astaxie/beego/orm"
    6.     _ "github.com/go-sql-driver/mysql" // import your used driver
    7. )
    9. // Model Struct
    10. type User struct {
    11.     Id   int
    12.     Name string `orm:"size(100)"`
    13. }
    15. func init() {
    16.     // set default database
    17.     orm.RegisterDataBase("default", "mysql", "username:password@tcp(127.0.0.1:3306)/db_name?charset=utf8", 30)
    19.     // register model
    20.     orm.RegisterModel(new(User))
    22.     // create table
    23.     orm.RunSyncdb("default", false, true)
    24. }
    26. func main() {
    27.     o := orm.NewOrm()
    29.     user := User{Name: "slene"}
    31.     // insert
    32.     id, err := o.Insert(&user)
    33.     fmt.Printf("ID: %d, ERR: %v\n", id, err)
    35.     // update
    36.     user.Name = "astaxie"
    37.     num, err := o.Update(&user)
    38.     fmt.Printf("NUM: %d, ERR: %v\n", num, err)
    40.     // read one
    41.     u := User{Id: user.Id}
    42.     err := o.Read(&u)
    43.     fmt.Printf("ERR: %v\n", err)
    45.     // delete
    46.     num, err = o.Delete(&u)
    47.     fmt.Printf("NUM: %d, ERR: %v\n", num, err)
    48. }

    关联查询

    1. type Post struct {
    2.     Id    int    `orm:"auto"`
    3.     Title string `orm:"size(100)"`
    4.     User  *User  `orm:"rel(fk)"`
    5. }
    7. var posts []*Post
    8. qs := o.QueryTable("post")
    9. num, err := qs.Filter("User__Name", "slene").All(&posts)

    SQL 查询

    当您无法使用 ORM 来达到您的需求时，也可以直接使用 SQL 来完成查询／映射操作。

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

    事务处理

    1. o.Begin()
    2. ...
    3. user := User{Name: "slene"}
    4. id, err := o.Insert(&user)
    5. if err == nil {
    6.     o.Commit()
    7. } else {
    8.     o.Rollback()
    9. }

    调试查询日志

    在开发环境下，您可以使用以下指令来开启查询调试模式：

    1. func main() {
    2.     orm.Debug = true
    3. ...

    开启后将会输出所有查询语句，包括执行、准备、事务等。

    例如：

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

    注意：我们不建议您在部署产品后这样做。

    文档索引

    1. Orm 使用方法
      • 数据库的设置
        • 驱动类型设置
        • 参数设置
        • 时区设置
      • 注册模型
      • ORM 接口使用
      • 调试模式打印查询语句
    2. 对象的CRUD操作
    3. 高级查询
      • 使用的表达式语法
      • 支持的操作符号
      • 高级查询接口使用
      • 关系查询
      • 载入关系字段
      • 多对多关系操作
    4. 使用SQL语句进行查询
    5. 事务处理
    6. 模型定义
      • 自定义表名
      • 自定义引擎
      • 设置参数
      • 表关系设置
      • 模型字段与数据库类型的对应
    7. 命令模式
      • 自动建表
      • 打印建表SQL
    8. Test ORM
    9. 自定义字段
    10. FAQ