调试模式

为便于开发阶段调试,gdb支持调试模式,可以使用以下方式开启调试模式:

  1. // 是否开启调试服务
  2. func (db DB) SetDebug(debug bool)

随后在ORM的操作过程中,所有的执行语句将会打印到终端进行展示。
同时,我们可以通过以下方法获得调试过程中执行的所有SQL语句:

  1. // 获取已经执行的SQL列表
  2. func (db DB) GetQueriedSqls() []*Sql

使用示例:

  1. package main
  2. import (
  3. "fmt"
  4. "github.com/gogf/gf/database/gdb"
  5. )
  6. var db gdb.DB
  7. // 初始化配置及创建数据库
  8. func init () {
  9. gdb.AddDefaultConfigNode(gdb.ConfigNode {
  10. Host : "127.0.0.1",
  11. Port : "3306",
  12. User : "root",
  13. Pass : "123456",
  14. Name : "test",
  15. Type : "mysql",
  16. Role : "master",
  17. Charset : "utf8",
  18. })
  19. db, _ = gdb.New()
  20. }
  21. func main() {
  22. db.SetDebug(true)
  23. // 执行3条SQL查询
  24. for i := 1; i <= 3; i++ {
  25. db.Table("user").Where("uid=?", i).One()
  26. }
  27. // 构造一条错误查询
  28. db.Table("user").Where("no_such_field=?", "just_test").One()
  29. }

执行后,输出结果如下:

  1. 2018-08-31 13:54:32.913 [DEBU] SELECT * FROM user WHERE uid=1 LIMIT 1
  2. 2018-08-31 13:54:32.915 [DEBU] SELECT * FROM user WHERE uid=2 LIMIT 1
  3. 2018-08-31 13:54:32.915 [DEBU] SELECT * FROM user WHERE uid=3 LIMIT 1
  4. 2018-08-31 13:54:32.915 [ERRO] SELECT * FROM user WHERE no_such_field='just_test' LIMIT 1
  5. Error: Error 1054: Unknown column 'no_such_field' in 'where clause'
  6. 1. /home/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/database/gdb/gdb_base.go:120
  7. 2. /home/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/database/gdb/gdb_base.go:174
  8. 3. /home/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/database/gdb/gdb_model.go:378
  9. 4. /home/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/database/gdb/gdb_model.go:301
  10. 5. /home/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/database/gdb/gdb_model.go:306
  11. 6. /home/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/database/gdb/gdb_model.go:311
  12. 7. /home/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/geg/database/gdb/mysql/gdb_debug.go:30

日志输出

日志输出请查看ORM的使用配置章节。

类型识别

使用gdb查询数据时,返回的数据类型将会被自动识别映射到Go变量类型。例如: 当字段类型为int(xx)时,查询到的字段值类型将会被识别会int类型;当字段类型为varchar(xxx)/char(xxx)/text等类型时将会被自动识别为string类型。以下以mysql类型为例,介绍数据库类型与Go变量类型的自动识别映射关系:

数据库类型 Go变量类型
*char string
*text string
*binary bytes
*blob bytes
*int int
bit int
big_int int64
float float64
double float64
decimal float64
bool bool
其他 string

这一特性对于需要将查询结果进行编码,并通过例如JSON方式直接返回给客户端来说将会非常友好。

类型转换

gdb的数据记录结果(Value)支持非常灵活的类型转换,并内置支持常用的数十种数据类型的转换。Result/Record的类型转换请查看后续【ORM高级特性】章节。

Value类型是*gvar.Var类型的别名,因此可以使用gvar.Var数据类型的所有转换方法,具体请查看【通用动态变量】章节

使用示例:

首先,数据表定义如下:

  1. # 商品表
  2. CREATE TABLE `goods` (
  3. `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
  4. `title` varchar(300) NOT NULL COMMENT '商品名称',
  5. `price` decimal(10,2) NOT NULL COMMENT '商品价格',
  6. ...
  7. PRIMARY KEY (`id`)
  8. ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;

其次,数据表中的数据如下:

  1. id title price
  2. 1 IPhoneX 5999.99

最后,完整的示例程序如下:

  1. package main
  2. import (
  3. "fmt"
  4. "github.com/gogf/gf/frame/g"
  5. "github.com/gogf/gf/os/glog"
  6. )
  7. func main() {
  8. g.Config().SetPath("/home/john/Workspace/github.com/gogf/gf/geg/frame")
  9. db := g.Database()
  10. if r, err := db.Table("goods").Where("id=?", 1).One(); err == nil {
  11. fmt.Printf("goods id: %d\n", r["id"].Int())
  12. fmt.Printf("goods title: %s\n", r["title"].String())
  13. fmt.Printf("goods proce: %.2f\n", r["price"].Float32())
  14. } else {
  15. glog.Error(err)
  16. }
  17. }

执行后,输出结果为:

  1. goods id: 1
  2. goods title: IPhoneX
  3. goods proce: 5999.99

继承支持

gdb模块针对于struct继承提供了良好的支持,包括参数传递、结果处理。例如:

  1. type Base struct {
  2. Uid int `orm:"uid"`
  3. CreateTime string `orm:"create_time"`
  4. }
  5. type User struct {
  6. Base
  7. Passport string `orm:"passport"`
  8. Password string `orm:"password"`
  9. Nickname string `orm:"nickname"`
  10. }

并且,无论多少层级的struct继承,gdb的参数传递和结果处理都支持。