README

tornado内部化包含了一个很简陋的database.py，最近在这个简单封装了MysqlDb的模块基础上增加增强的功能。
对于Python这种动态语言来说我觉得ORM有点过度封装了，很多时候简单的数据操作不好用，太复杂的操作又不如直接写Sql，所以我放弃了Orm的方式，而是直接抽象了Sql的构建，现在的版本支持单表的sql查询，支持子查询，当然还有一些操作有所遗漏，我会继续向项目里追加。
下载地址：http://files.cnblogs.com/Alexander-Lee/database.py.zip
文档：
Quick start
假设建立表User
create table `user`(
`id` bigint(20) AUTO_INCREMENT,
`name` varchar(20),
`age` int(10),
`birth` datetime,
)
创建连接:
db=Connection(host=’127.0.0.1′,database=’testdb’,user=’root’,password=’xxxxx’)
基本sql操作
————————————————————————–
查询多行
(打印年龄大于18的用户名)
for row in db.query(‘select * from user where age>%s’,18)
print row.name
查询单行
(获取id=5的用户)
user=db.query(‘select * from user where id=%s’,5)
执行sql
(更新生日大于等于8月23日的用户年龄+1)
db.query(‘update user set age=age+1 where DATE_FORMAT(birth,’%%Y-%%m-%%d’)>=%s’,’2010-08-23′)
插入记录
db.insert(‘user’,name=’alex’,age=28,birth=’1981-08-31′)
————————————————————————–
无sql操作
step 1 获取表对象
t = db.user
step 2 创建一个查询
q=t(t.age>18) #用户年龄大于18岁的查询
在这个查询的基础上可以进行下一步的操作，在这个筛选数据条件基础上对筛选出来的数据进行查询、更新、删除的操作
查询条件可以多个组合，比如
(t.age>18)&(t.age<30)|(t.id<500)
组合出来的条件就是 age>18 and age<30 or id<500
1，查询：
for user in q.select.sort(birth="DESC")():
print user.name
根据birth字段取倒序，查询出所有的age>18的用户，打印出用户名
查询分页 q.select.sort(birth=”DESC”)[2:10]() #按页大小20，取第二页的数据
2，更新：
(更新生日大于等于8月23日的用户年龄+1)
t=db.user
q=t(t.birth.DL(‘%%Y-%%m-%%d’,’2010-08-23′))
q.update(t.age==t.age+1)
3.删除
在查询的基础上还可以对查询出的结果直接删除掉，比如
q.delete()
API reference
Connection 对象
构造器参数：
host=’服务器ip/域名’,database=’Schame名’,user=’登录用户’,password=’密码’
例子：db=Connection(host=’127.0.0.1′,database=’testdb’,user=’root’,password=’xxxxx’)
方法(名称后带*的是tornado原有database.py中原有的方法，不带*的是扩展的方法)：
名称：execute *
参数:(sql,[params])
返回值：执行sql影响的数据行数
用途：执行不返回结果集的sql
例子：db.execute(‘update testtable set col1=%s where id=%s’,'haha’,1)
名称：executemany *
参数:(sql,[params])
返回值：执行sql影响的数据行数
用途：同时执行多条不返回结果集的sql
例子：db.execute(‘update testtable set col1=%s where id=%s;update user set age=1 where,id=1′,’haha’,1)
名称:get *
参数:(sql,[params])
返回值：Row对象（见Row对象部分）
用途：返回单行结果
例子：user=db.get(‘select * from user where id=%s’,1)
名称:query *
参数：(sql,[params])
返回值：Row对象列表
用途：返回多行结果
例子：users=db.query(‘select * from user where id<%s',5)
名称：count
参数：(sql,[params])
返回值：count函数返回的结果
用途：通过sql取记录数
例子：c=db.count('select count(1) from user where age>%s’,18)
名称：insert
参数：(tablename,**dict(字段名=值))
用途：插入记录
例子：db.insert(‘user’,name=’alex’,age=28,)
名称：commit *
参数：无
返回值：无
用途：提交事务，由于不是auto commit的连接，所以对数据库的更新都需要手动commit才能生效
例子：db.commit()
名称：rollback *
参数：无
返回值：无
用途：回滚事务
例子：db.rollback()
名称：fromQuery
参数：Select对象
返回值：TableQueryer对象
用途：得到一个基于已有查询的TableQueryer对象
例子：t2=db.fromQuery(q1)
Row对象
查询的结果集都由Row对象进行封装，Row对象是一个字典，Key是数据库字段名，Value是字段的值，可以通过属性访问字典的Key
TableQueryer对象
通过Connection对象创建
有两种方式：
1: db.tablename #获取tablename这个表的TableQueryer对象
2: db.fromQuery(q) #通过已经存在的查询获取一个TableQueryer对象，实现子查询
用途：
1：获取字段条件对象 （conds对象）
例子：t=db.tablename
t.col1
2：获取查询的执行对象 （Operater对象）
例子：t=db.tablename
q=t(t.col1>5) #需要加入查询条件来创建
方法：
名称：get_one
参数：conds对象
返回值：Row对象
用途：获取表中单条记录
例子：user=db.user.get_one(db.user.id==5)
名称：insert
参数：**dict(字段名=值)
返回值：是否成功
用途：插入记录到该表
例子：db.tablename.insert(col1=123,col2=’abc’)
Operater对象
通过调用TableQueryer对象创建
属性：
select:返回Select对象
update:返回Update对象
delete:返回Delete对象
insert:返回Insert对象
Select对象
生成select的sql，收集参数，并执行返回多行结果集
方法：
名称：group_by
参数：*conds对象
返回值：Select对象
用途：加入group by操作的设定
例子：q=db.tablename(db.tablename.col1>5)
q.select.group_by(db.tablename.age)
sql:select * from tablename where col1>5 group by age
名称：having
参数：conds对象
返回值：Select对象
用途：加入having设定
例子：q=db.tablename(db.tablename.col1>5)
q.select.group_by(db.tablename.age).having(db.tablename.col2.count>6)
sql:select * from tablename where col1>5 group by age having count(col2)>6
备注：必须在调用了group_by的前提下才能调用having，否则having条件不生效
名称：collect
参数：*conds
返回值：Select对象
用途：设定要筛选出的字段
例子：q=db.tablename(db.tablename.col1>5)
q.select.collect(db.tablename.col1,db.tablename.col12)
sql:select col1,col2 from tablename where col1>5
名称：limit
参数：start,count
返回值：Select对象
用途：设定limit参数
例子：q=db.tablename(db.tablename.col1>5)
q.select.collect(db.tablename.col1,db.tablename.col12).limit(10,10)
sql:select col1,col2 from tablename where col1>5 limit 10,10
名称：get_sql
参数：无
返回值：生成的sql语句
用途：返回生成的sql语句
分页：
对Select对象切片操作即可设定分页参数
比如：q=db.tablename(db.tablename.col1>5)
q.select.collect(db.tablename.col1,db.tablename.col12)[2:10]
则是设定，页大小是10条记录，取地2页
执行sql：
直接执行Select对象
比如：q=db.tablename(db.tablename.col1>5)
s=q.select.collect(db.tablename.col1,db.tablename.col12)[2:10]
rs=s()
Update对象：
用于生成Update语句更新记录
例子：
q=db.tablename(db.tablename.col1>5)
q.update(db.tablename.col3==db.tablename.col3+5)
sql:update tablename set col3=col3+5 where col1>5
Delete对象
用于生成Delete语句
例子：
q=db.tablename(db.tablename.col1>5)
q.delete()
sql:delete from tablename where col1>5
Insert对象
用于生成insert语句
例子：
q=db.tablename(db.tablename.col1>5)
q.insert(col1=1,col2=’abc’)
conds对象
字段定义以及字段关系条件的定义对象
通过TableQueryer对象的属性获取新的对象
比如： t=db.tablename
t.col1
操作符：
==:赋值或者相等比较，比如 t.col1==5 生成sql col=%s 且在参数列表中加入值5
>：生成sql col>%s
<：生成sql col<%s
>=:生成sql col>=%s
<=:生成sql col<=%s
!=:生成sql col<>%s
&：将两个条件取and关系，比如 (t.col1==5)&(t.col2<20) 生成sql col1=%s and col2<%s
|：将两个条件取or关系
方法：
名称：like
参数：任意对象
返回值：conds对象
用途：生成sql col like %s
名称：In
参数：列表或者Select对象
返回值：conds对象
用途：生成IN 语句
名称：Not_In
参数：列表或者Select对象
返回值：conds对象
用途：生成IN 语句
名称：DL
参数：格式化字符串,时间值
返回值：conds对象
用途：时间字段大于等于给定值
例子：t.col1.DL('%%Y-%%m-%%d','2010-10-20')
SQL: DATE_FORMAT(col1,'%%Y-%%m-%%d')>=%s
名称：DG
参数：格式化字符串,时间值
返回值：conds对象
用途：时间字段小于等于给定值
例子：t.col1.DG(‘%%Y-%%m-%%d’,’2010-10-20′)
SQL: DATE_FORMAT(col1,’%%Y-%%m-%%d’)<=%s
名称：DE
参数：格式化字符串,时间值
返回值：conds对象
用途：时间字段等于给定值
例子：t.col1.DE('%%Y-%%m-%%d','2010-10-20')
SQL: DATE_FORMAT(col1,'%%Y-%%m-%%d')=%s