From 6ee5426edaf7aba29a8b7c3f918d8bb8bb54b543 Mon Sep 17 00:00:00 2001 From: astaxie Date: Thu, 13 Sep 2012 09:57:47 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E4=B8=80=E4=BA=9B=E8=AF=AD?= =?UTF-8?q?=E5=8F=A5=EF=BC=8C=E6=84=9F=E8=B0=A2=E5=9B=9B=E6=9C=88=E4=BB=BD?= =?UTF-8?q?=E5=B9=B3=E6=B0=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 5.5.md | 49 +++++++++++++++++++++++++------------------------ 1 file changed, 25 insertions(+), 24 deletions(-) diff --git a/5.5.md b/5.5.md index c9e1b1e9..674a4992 100644 --- a/5.5.md +++ b/5.5.md @@ -1,5 +1,5 @@ #5.5使用beedb库进行ORM开发 -beedb是我开发的一个Go进行ORM操作的库，它采用了Go style方式来进行数据库的操作，实现了struct映射到关系型数据表记录。beedb是一个十分轻量级的Go ORM框架，开发这个库的本意旨在降低复杂的ORM学习曲线，尽可能在ORM的运行效率和功能之间做一个平衡点，beedb是目前开源的Go ORM框架中实现比较完整的一个库，而且运行效率相当不错，功能也基本能满足需求。但是目前还不支持关系关联，这个也会是接下来开发的重点。 +beedb是我开发的一个Go进行ORM操作的库，它采用了Go style方式对数据库进行操作，实现了struct到数据表记录的映射。beedb是一个十分轻量级的Go ORM框架，开发这个库的本意降低复杂的ORM学习曲线，尽可能在ORM的运行效率和功能之间寻求一个平衡，beedb是目前开源的Go ORM框架中实现比较完整的一个库，而且运行效率相当不错，功能也基本能满足需求。但是目前还不支持关系关联，这个是接下来版本升级的重点。 beedb是支持database/sql标准接口的ORM库，所以理论上来说，只要数据库驱动支持database/sql接口就可以无缝的接入beedb。目前我测试过的驱动包括下面几个： @@ -17,12 +17,12 @@ ODBC: bitbucket.org/miquella/mgodbc[*] ##安装 -beedb支持go get方式安装，是完全按照Go Style的方式来写的。 +beedb支持go get方式安装，是完全按照Go Style的方式来实现的。 go get github.com/astaxie/beedb ##如何初始化 -beedb的初始化首先你需要import进来相应的数据库驱动包、database/sql标准接口包以及beedb的包，如下所示： +首先你需要import相应的数据库驱动包、database/sql标准接口包以及beedb包，如下所示： import ( "database/sql" @@ -31,7 +31,7 @@ beedb的初始化首先你需要import进来相应的数据库驱动包、databa ) -导入之后我们初始化一个数据链接，然后初始化beedb，如下所示 +导入必须的package之后,我们需要打开到数据库的链接，然后创建一个beedb对象（以MySQL为例)，如下所示 db, err := sql.Open("mymysql", "test/xiemengjun/123456") if err != nil { @@ -39,9 +39,9 @@ beedb的初始化首先你需要import进来相应的数据库驱动包、databa } orm := beedb.New(db) -beedb的New函数实际上应该有两个参数，第一个参数标准接口的db，第二个参数是使用的数据库引擎，默认是mysql/sqlite。 +beedb的New函数实际上应该有两个参数，第一个参数标准接口的db，第二个参数是使用的数据库引擎，如果你使用的数据库引擎是MySQL/Sqlite,那么第二个参数都可以省略。 -如果你使用了mssql，那么初始化需要： +如果你使用的数据库是SQLServer，那么初始化需要： orm = beedb.New(db, "mssql") @@ -65,7 +65,7 @@ beedb的New函数实际上应该有两个参数，第一个参数标准接口的 >注意一点，beedb针对驼峰命名会自动帮你转化成下划线字段，例如你定义了Struct名字为`UserInfo`，那么转化成底层实现的时候是`user_info`，字段命名也遵循该规则。 ##插入数据 -下面的代码演示了如何插入一个数据，我们看到我们操作的是strcut，而不是数据库的sql，最后通过save接口保存了数据到数据库。 +下面的代码演示了如何插入一条记录，可以看到我们操作的是strcut对象，而不是原生的sql语句，最后通过调用Save接口将数据保存到数据库。 var saveone Userinfo saveone.Username = "Test Add User" @@ -97,12 +97,12 @@ beedb接口提供了另外一种插入的方式，map数据插入。 addslice =append(addslice, add, add2) orm.SetTable("userinfo").Insert(addslice) -上面我们调用了的方式有点类似链式查询，如果熟悉jquery的同学一定知道这种查询方式，这里其实就是每次的调用method都会返回orm对象，这样就可以继续操作下一个method。 +上面的操作方式有点类似链式查询，熟悉jquery的同学应该会觉得很亲切，每次调用的method都会返回原orm对象，以便可以继续调用该对象上的其他method。 上面我们调用的SetTable函数是显式的告诉ORM，我要执行的这个map对应的数据库表是`userinfo`。 ##更新数据 -我们更新数据继续上面的例子代码，现在saveone的主键已经有值了，那么现在调用save接口，接口里面会自动调用update进行数据的更新操作 +继续上面的例子来演示更新操作，现在saveone的主键已经有值了，此时调用save接口，beedb内部会自动调用update以进行数据的更新而非插入操作。 saveone.Username = "Update Username" saveone.Departname = "Update Departname" @@ -119,8 +119,7 @@ beedb接口提供了另外一种插入的方式，map数据插入。 SetPK：显式的告诉ORM，数据库表`userinfo`的主键是`uid`。 -Where:用来设置条件，支持多个参数，第一个参数如果为整数，默认就是主键=值。 - +Where:用来设置条件，支持多个参数，第一个参数如果为整数，相当于调用了Where("主键=?",值)。 Updata函数接收map类型的数据，执行更新数据。 ##查询数据 @@ -150,7 +149,7 @@ beedb的查询接口比较灵活，具体使用请看下面的例子 orm.Where("name = ? and age < ?", "john", 88).Find(&user4) -获取多条数据的话通过如下接口获取，请看下面的例子 +可以通过如下接口获取多条数据，请看示例 例子1，根据条件id>3，获取20位置开始的10条数据的数据 @@ -171,26 +170,26 @@ beedb的查询接口比较灵活，具体使用请看下面的例子 Limit:支持两个参数，第一个参数表示查询的条数，第二个参数表示读取数据的起始位置，默认为0。 -上面这些例子都是获取的的数据直接映射到struct里面，但是有些时候我们只是想获取一些数据到map，那么也可以通过如下接口获取 +上面这些例子都是将获取的的数据直接映射成struct对象，如果我们只是想获取一些数据到map，以下方式可以实现： a, _ := orm.SetTable("userinfo").SetPK("uid").Where(2).Select("uid,username").FindMap() 上面和这个例子里面又出现了一个新的接口函数Select，这个函数用来指定需要查询多少个字段。默认为全部字段`*`。 -FindMap()函数返回的是`[]map[string][]byte`类型，所以在处理的时候需要注意。 +FindMap()函数返回的是`[]map[string][]byte`类型，所以你需要自己作类型转换。 ##删除数据 beedb提供了丰富的删除数据接口，请看下面的例子 例子1，删除单条数据 - //saveone就是上面定义的struct + //saveone就是上面示例中的那个saveone orm.Delete(&saveone) 例子2，删除多条数据 //alluser就是上面定义的获取多条数据的slice - orm.DeleteAll(&everyone) + orm.DeleteAll(&alluser) 例子3，根据sql删除数据 @@ -198,7 +197,7 @@ beedb提供了丰富的删除数据接口，请看下面的例子 ##关联查询 -目前beedb还不支持struct的关联关系，但是我们有些应用里面确实需要用到连接查询，那么现在提供了一个简陋的方式来实现 +目前beedb还不支持struct的关联关系，但是有些应用却需要用到连接查询，所以现在beedb提供了一个简陋的实现方案： a, _ := orm.SetTable("userinfo").Join("LEFT", "userdeatail", "userinfo.uid=userdeatail.uid").Where("userinfo.uid=?", 1).Select("userinfo.uid,userinfo.username,userdeatail.profile").FindMap() @@ -206,7 +205,7 @@ beedb提供了丰富的删除数据接口，请看下面的例子 - 第一个参数可以是：INNER, LEFT, OUTER, CROSS等 - 第二个参数表示连接的表 -- 第三个参数表示链接的条件 +- 第三个参数表示连接的条件 ##Group By和Having @@ -221,11 +220,17 @@ GroupBy:用来指定进行groupby的字段 Having:用来指定having执行的时候的条件 ##进一步的发展 -目前beedb已经获得了很多国内外用户的很多反馈，我目前也正在考虑重构，接下来会在几个方面进行改进 +目前beedb已经获得了很多来自国内外用户的反馈，我目前也正在考虑重构，接下来会在几个方面进行改进 - 实现interface设计，类似databse/sql/driver的设计，设计beedb的接口，然后去实现相应数据库的CRUD操作 - 实现关联数据库设计，支持一对一，一对多，多对多的实现，示例代码如下： + + type Profile struct{ + Nickname string + Mobile string + } + type Userinfo struct { Uid int `PK` Username string @@ -233,11 +238,7 @@ Having:用来指定having执行的时候的条件 Created time.Time Profile `HasOne` } - - type Profile struct{ - Nickname string - Mobile string - } + - 自动建库建表建索引 - 实现连接池的实现，采用goroutine