第五小节完稿

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