Go语言ORM框架：快捷查询函数的使用

快捷查询函数

大多数情况下您都是在使用worm支提供的Model方式（持结构体字段映射）来访问数据库，但有些时候使用Model方式显然有些笨重。例如您可能只需要查询一个记录的一个字段的值，这种情况下若使用Model方式则比较繁琐。worm提供了一些快捷查询函数来应对这种需求，例如DbTable的GetString()函数，该函数克用于查询一个记录的一个字符串类型的字段。这些快捷查询函数可以用于原生SQL以及SQLBuilder模式，这些快捷函数的用法以上两种模式下的用法基本上是一致的，本文中使用SQLBuilder模式来说明这些快捷函数的使用方法。

main函数

package main
import (
	"database/sql"
	_ "github.com/go-sql-driver/mysql"
	log "github.com/haming123/wego/dlog"
	"github.com/haming123/wego/worm"
)
func mysql_open(cnnstr string) (*sql.DB, error) {
	db, err := sql.Open("mysql", cnnstr)
	if err != nil {
		return nil, err
	}
	err = db.Ping()
	if err != nil {
		return nil, err
	}
	return db, nil
}
func main() {
	//创建数据连接池
	cnnstr := "user:passwd@tcp(127.0.0.1:3306)/dbname?charset=utf8&parseTime=True"
	db_cnn, err := mysql_open(cnnstr)
	if err != nil {
		log.Error(err)
		return
	}
	//初始化ORM
	worm.InitMysql(db_cnn)
	//显示SQL语句log
	worm.ShowSqlLog(true)
}

说明：

• worm代码的下载
  go get github.com/haming123/wego
• worm.ShowSqlLog
  worm.ShowSqlLog用于控制sql日志的显示，建议测试环境下打开sql日志的显示的开关，这样可以看到每个数据库操作的sql语句以及执行时间，方便快速定位问题。
• 数据库的支持
  目前worm支持的数据库有：mysql、postgres、sqlite、sqlserver， 本文的例子中采用了mysql数据库。

数据库表

//建表语句
CREATE TABLE `user` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `name` varchar(30) DEFAULT NULL,
  `age` int(11) DEFAULT NULL,
  `passwd` varchar(32) DEFAULT NULL,
  `created` datetime DEFAULT NULL,
  PRIMARY KEY (`id`)
);

查询某个记录是否存在

有些情况下您不需要获取一个记录的数据，而是只需要查询数据库中是否存在某个记录，这种情况下可以使用Exist()函数：

func SQLBuilderExist() {
	has, err := worm.Table("user").ID(1).Exist()
	if err != nil {
		log.Error(err)
		return
	}
	//select * from user where id=? limit 1
}

查询一个记录的指定字段

有些情况下您可能只需要获取一条记录的某几个字段，这种情况在没必要定义一个struct，然后通过Model方式来获取字段的数据。您可以使用DbTable的Get函数：

func SQLBuilderGetValue() {
	name := ""; age := 0
	_, err := worm.Table("user").Select("name,age").ID(1).Get(&name, &age)
	if err != nil {
		log.Error(err)
		return
	}
	//select name,age from user where id=? limit 1
}

说明：

• Get函数的参数是可变长参数，参数的数量与类型必须与Select()中的字段一一对应。
• Get函数的第一个返回值是一个bool类型，用于表示是否存在该记录。

查询一个记录的一个字符串字段

GetString()函数用于查询一个记录的一个字符串字段

func SQLBuilderGetValue() {
	val, err := worm.Table("user").Select("name").ID(1).GetString()
	if err != nil {
		log.Error(err)
		return
	}
	//select name from user where id=? limit 1
}

说明：

• Select()中必须只有一个字段，并且字段的类型为字符串。
• GetString()的第一个返回值为sql.NullString类型，其中的Valid变量用于说明是否是一个有效的值。

查询一个记录的一个整形字段

GetInt()函数用于查询一个记录的一个整形字段

func SQLBuilderGetInt() {
	val, err := worm.Table("user").Select("age").ID(1).GetInt()
	if err != nil {
		log.Error(err)
		return
	}
	//select age from user where id=? limit 1
}

说明：

• Select()中必须只有一个字段，并且字段的类型为整形。
• GetInt()的第一个返回值为sql.NullInt64类型，其中的Valid变量用于说明是否是一个有效的值。

查询一个记录的一个浮点型字段

GetFloat()函数用于查询一个记录的一个浮点型字段

func SQLBuilderGetFloat() {
	val, err := worm.Table("user").Select("weight").ID(1).GetFloat()
	if err != nil {
		log.Error(err)
		return
	}
	//select weight from user where id=? limit 1
}

说明：

• Select()中必须只有一个字段，并且字段的类型为浮点型。
• GetFloat()的第一个返回值为sql.NullFloat64类型，其中的Valid变量用于说明是否是一个有效的值。

查询一个记录

GetFloat()函数用于查询一个记录的一个浮点型字段

func SQLBuilderGetFloat() {
	val, err := worm.Table("user").Select("weight").ID(1).GetFloat()
	if err != nil {
		log.Error(err)
		return
	}
	//select weight from user where id=? limit 1
}

说明：

• Select()中必须只有一个字段，并且字段的类型为浮点型。
• GetFloat()的第一个返回值为sql.NullFloat64类型，其中的Valid变量用于说明是否是一个有效的值。

查询满足条件的记录数

Count()函数用于查询查询满足条件的记录数

func SQLBuilderCount() {
	val, err := worm.Table("user").Where("id>?", 0).Count()
	if err != nil {
		log.Error(err)
		return
	}
	//select count(1) from user where id>?
}

说明：

• Count()若没有参数，则使用count(1)的计数， 若需要您也可以指定字段名称来计数：

func SQLBuilderCount() {
	val, err := worm.Table("user").Where("id>?", 0).Count("name")
	if err != nil {
		log.Error(err)
		return
	}
	//select count(name) from user where id>?
}

count_distinct查询

DistinctCount()函数用于统计满足条件的字段的排重后的数量：

func SQLBuilderDistinctCount() {
	val, err := worm.Table("user").Where("id>?", 0).DistinctCount("name")
	if err != nil {
		log.Error(err)
		return
	}
	//select count(distinct name) from user where id>?
}

查询字符串字段到数组

FindString()函数用于查询满足条件的记录，并将字符串字段的值添加到字符串数组：

func SQLBuilderFindString() {
	val, err := worm.Table("user").Select("name").Where("id>?", 0).FindString()
	if err != nil {
		log.Error(err)
		return
	}
	// select name from user where id>?
}

说明：

• Select()中必须只有一个字段，并且字段的类型为字符串。

查询整形字段到数组

FindInt()函数用于查询满足条件的记录，并将整形字段的值添加到整形数组：

func SQLBuilderFindInt() {
	val, err := worm.Table("user").Select("age").Where("id>?", 0).FindInt()
	if err != nil {
		log.Error(err)
		return
	}
	log.Debug(val)
	// select age from user where id>?
}

说明：

• Select()中必须只有一个字段，并且字段的类型为整形。

查询浮点型字段到数组

FindInt()函数用于查询满足条件的记录，并将浮点型字段的值添加到浮点型数组：

func SQLBuilderFindFloat() {
	val, err := worm.Table("user").Select("weight").Where("id>?", 0).FindFloat()
	if err != nil {
		log.Error(err)
		return
	}
	// select weight from user where id>?
}

说明：

• Select()中必须只有一个字段，并且字段的类型为浮点型。