##About

一个数据库ORM.

How to use?

Insert

go get github.com/ablegao/orm

例子

//引用模块
import "github.com/ablegao/orm"

//MysqL 驱动
import _ "github.com/go-sql-driver/MysqL"

//建立连接 
// 参数分别为 名称 ， 驱动， 连接字符串
// 注：必须包含一个default 连接， 作为默认连接。
orm.NewDatabase("default","MysqL","user:passwd@ip/database?charset=utf8")


//建立一个数据模型。 
type UserInfo struct {
	orm.Object
	Id int64 `field:"id" auto:"true" index:"pk"`
	Name string `field:"username"`
	Passwd string `field:"password"`
}

//数据库表名称
func(self *UserInfo) GetTableName()string{

	return "database.user_info"
}

//查询一个用户名为 "test1"的账户  
user:=new(UserInfo)
err:=user.Objects(user).Filter("Name","test1").One()
fmt.Println(user.Id,user.Passwd,user.Name)

//Update 
user.Name="test2"
user.Objects(user).Save()
// or 
user.Objects(user).Filter("Id",1).Change("Name","test2").Save()


//查询id小于10的所有数据

users,err:=user.Objects(user).Filter("Id__lt",10).All()
if err == nil {
    for _,userinfo:= range users{
    	u:=userinfo.(*UserInfo)
        fmt.Println(u.Id,u.Passwd,u.Name)
    }
}

//Create 
user:=new(UserInfo)
user.Name ="test1"
user.Passwd ="123456"
id,err:=user.Objects(user).Save()



//delete
user.Objects(user).Delete()

// User other Database connect 
orm.NewDatabase("other","user:passwd@ip/database?charset=utf8")
user.Objects(user).Db("other").Filter(x,x).Delete()
// or 
user.Objects(user).Filter().Db("other").XXX()

Filter or FilterOr

.Filter(fieldname,val )

Filter 作为orm 的主要作用是过滤查询条件， 最终将会转换为sql 语句中的where 条件语句。 可以填写多次， 多次数据为and 关系

FilterOr 作为Orm 的主要过滤查询条件， 最终将妆化为sql 语句的where 条件语句,可以填写多次， 多次数据以 or 连接

user.Objects(user).Filter("Name","test1").FilterOr("Name","test2").All() //select id,username,passwd from database.user_info where username='test1' or username='test2'

##关于Filter字段的魔法参数

###目前支持: __exact 精确等于 like 'aaa' __iexact 精确等于 忽略大小写 ilike 'aaa' __contains 包含 like '%aaa%' __icontains 包含 忽略大小写 ilike '%aaa%'，但是对于sqlite来说，contains的作用效果等同于icontains。 __gt 大于 __gte 大于等于 __ne 不等于 __lt 小于 __lte 小于等于 __startswith 以...开头 __istartswith 以...开头 忽略大小写 __endswith 以...结尾 __iendswith 以...结尾，忽略大小写

###尚未支持: __in 存在于一个list范围内 __range 在...范围内 __year 日期字段的年份 __month 日期字段的月份 __day 日期字段的日 __isnull=True/False

##Change

修改数据， 执行时，相当于 sql 语句中的set

传入一个结构字段 和值 .Change("Field",1)

update from xxx set field=1

可以添加魔法参数：

.Change("Field__add",1 ) update from xxx set field=field+1

__add 累加 field=field+1 __sub 累减 field=field-1 __mult 累乘 field=field*1 __div 累计出发 field=field/1