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