构造查询条件

worm支持链式API，可使用Where, And, Or, ID, In, Limit, GroupBy, OrderBy, Having等函数构造查询条件。

通过ID来查询数据

若数据库表存在id字段，则可以通过ID函数来查询一条数据据记录：

func DemoGetById() {
	var user model.User
	_, err := worm.Model(&user).ID(1).Get()
	if err != nil {
		log.Error(err)
		return
	}
	log.Debug(user)
}

执行该函数后的sql日志为：

[S] select id,name,age,passwd,created from user where id=1 limit 1
[S] DB: time=18.816ms

通过Where函数来查询数据

Where函数的使用类似Sprintf函数，函数的第一个参数是sql语句(where语句)模板，后面的参数是模板变量的值。

func DemoWhere() {
	var users []model.User
	err := worm.Model(&model.User{}).Where("id>? and age>?", 1, 10).Find(&users)
	if err != nil {
		log.Error(err)
		return
	}
}
//对应的sql语句为：
//select id,name,age,passwd,created from user where id>? and age>?

说明：

• worm占位符统一使用?，worm会根据数据库类型,自动替换占位符，例如postgresql数据库把?替换成$1,$2...
• 可以在Where函数使用多个变量进行查询，这种方式比较直观，与数据库查询中的sql语句的写法比较类似。但是当查询条件比较多时，建议使用And、Or函数进行适当的分割，防止将查询变量与变量的值对应错误。例如：

func DemoWhere() {
	var users []model.User
	err := worm.Model(&model.User{}).Where("id>?", 1).And("age>?", 10).Find(&users)
	if err != nil {
		log.Error(err)
		return
	}
}
//对应的sql语句为：
//select id,name,age,passwd,created from user where id>? and age>?

• like查询的写法

  例如查询用户的姓名中包含：demo的数据库记录：

func DemoWhereLike() {
	var users []model.User
	err := worm.Model(&model.User{}).Where("name like ?", "%demo%").Find(&users)
	if err != nil {
		log.Error(err)
		return
	}
}
//对应的sql语句为：
//select id,name,age,passwd,created from user where name like '%demo%'

XXXIf查询

有些情况加我们会根据变量的值来判断使用使用一个变量来作为查询条件来查询书库，例如，若用户的姓名不为空时通过用户姓名来查询数据库。常规的写法如下：

func DemoWhereIf(name string) {
	var users []model.User
	var err error
	if name == "" {
		err = worm.Model(&model.User{}).Find(&users)
	} else {
		err = worm.Model(&model.User{}).Where("name=?", name).Find(&users)
	}
	if err != nil {
		log.Error(err)
		return
	}
}

worm提供了更为简单的方法（提供了WhereIf、AndIf、OrIf函数）来支持这种查询需求：

func DemoWhereIf(name string) {
	var users []model.User
	err := worm.Model(&model.User{}).WhereIf(name != "", "name=?", name).Find(&users)
	if err != nil {
		log.Error(err)
		return
	}
}

说明：

• WhereIf函数的第一个参数时一个bool变量，若该变量为true，则会添加查询条件，否则忽略该查询条件。

in、not in查询

worm提供了AndIn、AndNotIn、OrIn、OrNotIn函数来支持sql语句中的in、not in查询。例如：

func DemoWhereIn() {
	var users []model.User
	err := worm.Model(&model.User{}).Where("").AndIn("id", 11, 12, 13, 14).Find(&users)
	if err != nil {
		log.Error(err)
		return
	}
}
//对应的sql语句为：
select id,name,age,passwd,created from user where id in (?,?,?,?)

XXXIn、XXXNotIn的第二个参数时一个变长参数，您可以将需要查询的值作为变长参数传入，也可以将查询的值放到一个数组中进行查询：

func DemoWhereIn() {
	var users []model.User
	arr_id := []int64{11, 12, 13, 14}
	err := worm.Model(&model.User{}).Where("").AndIn("id", arr_id).Find(&users)
	if err != nil {
		log.Error(err)
		return
	}
}

说明：

• 若使用数组方式，则可变长参数智能时一个参数，并且该参数为数组类型。

嵌套查询语句

worm支持嵌套查询语句，例如查询为：age>10 and (name='demo1' or name='demo2')， 则使用worm的方式如下：

func DemoWhereExp() {
	var users []model.User
	sqlw := worm.SQLW("name=?", "demo1").Or("name=?", "demo2")
	err := worm.Model(&model.User{}).Where("age>?", 10).AndExp(sqlw).Find(&users)
	if err != nil {
		log.Error(err)
		return
	}
}
//对应的sql语句为：
//select id,name,age,passwd,created from user where age>? and (name=? or name=?)

Limit与Offset

在MySQL语句中可以使用Limit与Offset来查询数据库，这种查询通常用于WEB的分页查询中。worm也支持mysql的Limit与Offset语句：

func DemoQueryPage(plen int64, pcur int64) {
	var users []model.User
	err := worm.Model(&model.User{}).Where("age>?", 10).Limit(plen).Offset(plen * pcur).Find(&users)
	if err != nil {
		log.Error(err)
		return
	}
}
//对应的sql语句为：
//select id,name,age,passwd,created from user where age>? limit ?, ? 

orderby查询

OrderBy函数对应sql语句中的order by语句：

func DemoQueryOrderBy(orderby string) {
	var users []model.User
	err := worm.Model(&model.User{}).Where("age>?", 10).OrderBy(orderby).Find(&users)
	if err != nil {
		log.Error(err)
		return
	}
}
//对应的sql语句为：
//select id,name,age,passwd,created from user where age>? order by created desc