模型（Models）－ beego ORM

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

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

已支持数据库驱动：

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

ORM 特性：

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

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

安装 ORM：

  1. go get github.com/beego/beego/v2/client/orm

快速入门

简单示例

  1. package main
  3. import (
  4.     "fmt"
  5.     "github.com/beego/beego/v2/client/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&loc=Local", 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. ...

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