调试模式

为便于开发阶段调试,gdb支持调试模式,可以通过Debug配置文件项或者SetDebug配置方式开启调试模式, 随后任何的数据库SQL操作语句都将会由内置的日志对象中输出到终端或者日志文件中。

日志输出

日志输出往往是打印一些调试或者SQL语句,日志对象可以通过SetLogger方法来设置,也可以通过配置文件来做简单配置,日志的配置请查看ORM的配置管理章节。

空跑特性

ORM空跑可以通过DryRun配置项来启用,默认关闭。当ORM的空跑特性开启时,读取操作将会提交,而写入、更新、删除操作将会被忽略。该特性往往结合调试模式和日志输出一起使用,用于校验当前的程序(特别是脚本)执行的SQL是否符合预期。

类型识别

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

数据库类型 Go变量类型
*char string
*text string
*binary bytes
*blob bytes
*int int
*money float64
bit int
big_int int64
float float64
double float64
decimal float64
bool bool
date time.Time
datetime time.Time
timestamp time.Time
其他 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. if r, err := db.Table("goods").FindOne(1); err == nil {
  2. fmt.Printf("goods id: %d\n", r["id"].Int())
  3. fmt.Printf("goods title: %s\n", r["title"].String())
  4. fmt.Printf("goods proce: %.2f\n", r["price"].Float32())
  5. } else {
  6. glog.Error(err)
  7. }

执行后,输出结果为:

  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. CreateAt *gtime.Time `orm:"create_at"`
  4. UpdateAt *gtime.Time `orm:"update_at"`
  5. DeleteAt *gtime.Time `orm:"delete_at"`
  6. }
  7. type User struct {
  8. Base
  9. Passport string `orm:"passport"`
  10. Password string `orm:"password"`
  11. Nickname string `orm:"nickname"`
  12. }

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