diff --git a/5.5.md b/5.5.md index 2880f06c..c9e1b1e9 100644 --- a/5.5.md +++ b/5.5.md @@ -17,19 +17,232 @@ ODBC: bitbucket.org/miquella/mgodbc[*] ##安装 +beedb支持go get方式安装,是完全按照Go Style的方式来写的。 + + go get github.com/astaxie/beedb + ##如何初始化 +beedb的初始化首先你需要import进来相应的数据库驱动包、database/sql标准接口包以及beedb的包,如下所示: + + import ( + "database/sql" + "github.com/astaxie/beedb" + _ "github.com/ziutek/mymysql/godrv" + + ) + +导入之后我们初始化一个数据链接,然后初始化beedb,如下所示 + + db, err := sql.Open("mymysql", "test/xiemengjun/123456") + if err != nil { + panic(err) + } + orm := beedb.New(db) + +beedb的New函数实际上应该有两个参数,第一个参数标准接口的db,第二个参数是使用的数据库引擎,默认是mysql/sqlite。 + +如果你使用了mssql,那么初始化需要: + + orm = beedb.New(db, "mssql") + +如果你使用了PostgreSQL,那么初始化需要: + + orm = beedb.New(db, "pg") + +目前beedb支持打印调试,你可以通过如下的代码实现调试 + + beedb.OnDebug=true + +接下来我们的例子采用前面的数据库表Userinfo,现在我们建立相应的struct + + type Userinfo struct { + Uid int `PK` //如果表的主键不是id,那么需要加上pk注释,显式的说这个字段是主键 + Username string + Departname string + Created time.Time + } + +>注意一点,beedb针对驼峰命名会自动帮你转化成下划线字段,例如你定义了Struct名字为`UserInfo`,那么转化成底层实现的时候是`user_info`,字段命名也遵循该规则。 ##插入数据 +下面的代码演示了如何插入一个数据,我们看到我们操作的是strcut,而不是数据库的sql,最后通过save接口保存了数据到数据库。 -##查询数据 + var saveone Userinfo + saveone.Username = "Test Add User" + saveone.Departname = "Test Add Departname" + saveone.Created = time.Now() + orm.Save(&saveone) + +我们看到插入之后`saveone.Uid`就是插入成功之后的自增ID。Save接口会自动帮你存进去。 + +beedb接口提供了另外一种插入的方式,map数据插入。 + + add := make(map[string]interface{}) + add["username"] = "astaxie" + add["departname"] = "cloud develop" + add["created"] = "2012-12-02" + orm.SetTable("userinfo").Insert(add) + +插入多条数据 + + addslice := make([]map[string]interface{}) + add:=make(map[string]interface{}) + add2:=make(map[string]interface{}) + add["username"] = "astaxie" + add["departname"] = "cloud develop" + add["created"] = "2012-12-02" + add2["username"] = "astaxie2" + add2["departname"] = "cloud develop2" + add2["created"] = "2012-12-02" + addslice =append(addslice, add, add2) + orm.SetTable("userinfo").Insert(addslice) + +上面我们调用了的方式有点类似链式查询,如果熟悉jquery的同学一定知道这种查询方式,这里其实就是每次的调用method都会返回orm对象,这样就可以继续操作下一个method。 + +上面我们调用的SetTable函数是显式的告诉ORM,我要执行的这个map对应的数据库表是`userinfo`。 ##更新数据 +我们更新数据继续上面的例子代码,现在saveone的主键已经有值了,那么现在调用save接口,接口里面会自动调用update进行数据的更新操作 + + saveone.Username = "Update Username" + saveone.Departname = "Update Departname" + saveone.Created = time.Now() + orm.Save(&saveone) //现在saveone有了主键值,就执行更新操作 + +更新数据也支持直接使用map操作 + + t := make(map[string]interface{}) + t["username"] = "astaxie" + orm.SetTable("userinfo").SetPK("uid").Where(2).Update(t) + +这里我们调用了几个beedb的函数 + +SetPK:显式的告诉ORM,数据库表`userinfo`的主键是`uid`。 + +Where:用来设置条件,支持多个参数,第一个参数如果为整数,默认就是主键=值。 + +Updata函数接收map类型的数据,执行更新数据。 + +##查询数据 +beedb的查询接口比较灵活,具体使用请看下面的例子 + +例子1,根据主键获取数据: + + var user Userinfo + //Where接受两个参数,支持整形参数 + orm.Where("uid=?", 27).Find(&user) + + +例子2: + + var user2 Userinfo + orm.Where(3).Find(&user2) // 这是上面版本的缩写版,可以省略主键 + +例子3,不是主键类型的的条件: + + var user3 Userinfo + //Where接受两个参数,支持字符型的参数 + orm.Where("name = ?", "john").Find(&user3) +例子4,更加复杂的条件: + + var user4 Userinfo + //Where支持三个参数 + orm.Where("name = ? and age < ?", "john", 88).Find(&user4) + + +获取多条数据的话通过如下接口获取,请看下面的例子 + +例子1,根据条件id>3,获取20位置开始的10条数据的数据 + + var allusers []Userinfo + err := orm.Where("id > ?", "3").Limit(10,20).FindAll(&allusers) + +例子2,省略limit第二个参数,默认从0开始,获取10条数据 + + var tenusers []Userinfo + err := orm.Where("id > ?", "3").Limit(10).FindAll(&tenusers) + +例子3,获取全部数据 + + var everyone []Userinfo + err := orm.FindAll(&everyone) + +上面这些里面里面我们看到一个函数Limit,他是用来控制查询结构条数的。 + +Limit:支持两个参数,第一个参数表示查询的条数,第二个参数表示读取数据的起始位置,默认为0。 + +上面这些例子都是获取的的数据直接映射到struct里面,但是有些时候我们只是想获取一些数据到map,那么也可以通过如下接口获取 + + a, _ := orm.SetTable("userinfo").SetPK("uid").Where(2).Select("uid,username").FindMap() + +上面和这个例子里面又出现了一个新的接口函数Select,这个函数用来指定需要查询多少个字段。默认为全部字段`*`。 + +FindMap()函数返回的是`[]map[string][]byte`类型,所以在处理的时候需要注意。 ##删除数据 +beedb提供了丰富的删除数据接口,请看下面的例子 + +例子1,删除单条数据 + + //saveone就是上面定义的struct + orm.Delete(&saveone) + +例子2,删除多条数据 + + //alluser就是上面定义的获取多条数据的slice + orm.DeleteAll(&everyone) + +例子3,根据sql删除数据 + + orm.SetTable("userinfo").Where("uid>?", 3).DeleteRow() + ##关联查询 +目前beedb还不支持struct的关联关系,但是我们有些应用里面确实需要用到连接查询,那么现在提供了一个简陋的方式来实现 + a, _ := orm.SetTable("userinfo").Join("LEFT", "userdeatail", "userinfo.uid=userdeatail.uid").Where("userinfo.uid=?", 1).Select("userinfo.uid,userinfo.username,userdeatail.profile").FindMap() + +上面代码中我们看到了一个新的接口Join函数,这个函数带有三个参数 + +- 第一个参数可以是:INNER, LEFT, OUTER, CROSS等 +- 第二个参数表示连接的表 +- 第三个参数表示链接的条件 + + ##Group By和Having +针对有些应用需要用到group by和having的功能,beedb也提供了一个简陋的实现 + + a, _ := orm.SetTable("userinfo").GroupBy("username").Having("username='astaxie'").FindMap() + +上面的代码中出现了两个新接口函数 + +GroupBy:用来指定进行groupby的字段 + +Having:用来指定having执行的时候的条件 + +##进一步的发展 +目前beedb已经获得了很多国内外用户的很多反馈,我目前也正在考虑重构,接下来会在几个方面进行改进 + +- 实现interface设计,类似databse/sql/driver的设计,设计beedb的接口,然后去实现相应数据库的CRUD操作 +- 实现关联数据库设计,支持一对一,一对多,多对多的实现,示例代码如下: + + type Userinfo struct { + Uid int `PK` + Username string + Departname string + Created time.Time + Profile `HasOne` + } + + type Profile struct{ + Nickname string + Mobile string + } + +- 自动建库建表建索引 +- 实现连接池的实现,采用goroutine + + ## links