游戏开发论坛

 找回密码
 立即注册
搜索
查看: 2062|回复: 0

2013.09.04更新——【Firefly API 新版文档】Package dbentrust

[复制链接]

119

主题

119

帖子

694

积分

版主

Rank: 7Rank: 7Rank: 7

积分
694
发表于 2013-9-23 12:17:13 | 显示全部楼层 |阅读模式
package dbentrust

该包下面主要是数据库的处理与memcached存储。里面封装了,从memcached数据到python对象的映射。可以以操纵python对象的方式进行memcached中存储的数据的操作,只要在不同的进程中实例化相同名称的memobject对象,就能保证对象中的数据是一致的。还包含了将这个对象中的数据同步到数据库的出来方法。这里不需去写一句sql语句。

class DBPool
数据库连接池

InitPool
初始化数据库连接池
  1. type method
  2. //cwd firefly/dbentrust/dbpool.py
  3. Prams initPool(**kw)
复制代码
**kw,关键字参数,是个字典,key:value分别对应为 config.json 这个配置文件中填写的对应值:
  1. "host":"localhost",
  2. "user":"root",
  3. "passwd":"111",
  4. "port":3306,
  5. "db":"test",
  6. "charset":"utf8"
复制代码
用于初始化数据库连接池

connection
获取一条数据库连接
  1. type method
  2. //cwd firefly/dbentrust/dbpool.py
  3. Params connecton(self)
复制代码
class Memclient
memcached 客户端连接类,通过加上前缀的方式类分配不同的命名空间。

connect
连接memcached服务
  1. type method
  2. //cwd firefly/dbentrust/memclient.py
  3. Params connect(urls,hostname)
复制代码
Urls,连接memcached服务所需的ip和端口号
Hostname,所连接的主机名
上面两个参数的值为config.json 这个配置文件中填写的对应值:
  1. "urls":["127.0.0.1:11211"],
  2. "hostname":"anheisg"
复制代码
用于连接memcached服务


produceKey(keyname)
重新生成key
  1. [b]type method
  2. //cwd firefly/dbentrust/memclient.py
  3. Params produceKey(self,keyname)[/b]
复制代码
Key,存取值时的key名,根据key生成统一规则的新key名
Key必须为str型,否则返回 type error

get
获取key对应的值
  1. type method
  2. //cwd firefly/dbentrust/memclient.py
  3. Prams get(key)
复制代码
get_multi
一次获取多个key的值,比for循环调用get方法快       
@param key: list(str) key的列表
  1. type method
  2. //cwd firefly/dbentrust/memclient.py
  3. Params get_multi(keys)
复制代码
keys为list型,keys = [key1,key2,...keyn],key1,key2为str型

set
将keyname的值设置成value
  1. type method
  2. //cwd firefly/dbentrust/memclient.py
  3. Params set(keyname, value)
复制代码
成功返回True,失败返回0

set_multi
设置多个键值对
  1. type method
  2. //cwd firefly/dbentrust/memclient.py
  3. Params set_multi(mapping)
复制代码
mapping 为dic型,mapping = {key1:balue1,key2:value2},成功返回True,失败返回0

incr
自增
  1. type method
  2. //cwd firefly/dbentrust/memclient.py
  3. Params incr(key, delta)
复制代码
key,key名
delta,增加的值
给key的value值增加 delta,返回增加后的value值

delete
删除指定key
  1. type method
  2. //cwd firefly/dbentrust/memclient.py
  3. Params delete(key)
复制代码
key,key名
将key及对应的value值删除,返回值为1

delete_multi
一次删除多个key
  1. type method
  2. //cwd firefly/dbentrust/memclient.py
  3. Params delete_multi(keys)
复制代码
keys为list型,keys = [key1,key2,...keyn],key1,key2为str型

flush_all
清空所有数据,慎用
  1. type method
  2. //cwd firefly/dbentrust/memclient.py
  3. Params flush_all(self)
复制代码
class MemObject
memcached 数据到python对象的映射类。通过继承这个类来实现memcached数据格式的自定义。

produceKey
重新生成key
  1. type method
  2. //cwd firefly/dbentrust/memobject.py
  3. Params produceKey(self,keyname)
复制代码
Key,存取值时的key名,根据key生成统一规则的新key名
Key必须为str型,否则返回 type error

locked
检测对象是否被锁定
  1. type method
  2. //cwd firefly/dbentrust/memobject.py
  3. Params lock(self)
复制代码
返回对象的状态,1表示对象被锁定无法进行修改,0表示可以修改

lock
锁定对象
  1. type method
  2. //cwd firefly/dbentrust/memobject.py
  3. Params lock(self)
复制代码
将对象的锁定状态更改为1

release
释放锁
  1. type method
  2. //cwd firefly/dbentrust/memobject.py
  3. Params release(self)
复制代码
将对象的锁定状态更改为1

get
获取key对应的值
  1. type method
  2. //cwd firefly/dbentrust/memobject.py
  3. Params get(key)
复制代码
get_multi
一次获取多个key的值,比for循环调用get方法快
  1. type method
  2. //cwd firefly/dbentrust/memobject.py
  3. Params get_multi(keys)
复制代码
keys为list型,keys = [key1,key2,...keyn],key1,key2为str型

update

将key的值设置成values
  1. type method
  2. //cwd firefly/dbentrust/memobject.py
  3. Params update(key, values)
复制代码
update_multi
同时修改多个键值对的值
  1. type method
  2. //cwd firefly/dbentrust/memobject.py
  3. Params update_multi(mapping)
复制代码
mapping 为dict型,mapping = {key1:balue1,key2:value2},成功返回True,失败返回0或False

mdelete
删除本类包含的所有的数据
  1. type method
  2. //cwd firefly/dbentrust/memobject.py
  3. Params mdelete(self)
复制代码
incr
自增
  1. type method
  2. //cwd firefly/dbentrust/memobject.py
  3. Params incr(key, delta)
复制代码
key,key名
delta,增加的值
给key的value值增加 delta,返回增加后的value值

insert
插入本类包含的所有的数据
  1. type method
  2. //cwd firefly/dbentrust/memobject.py
  3. Params insert()
复制代码
class Mmode
数据库到memcached直接的映射类。可以实现延迟异步的去修改数据库中的数据,减轻数据库压力。并有自定义的过期时间,过期后memcached中的数据会被自动的清理掉。这里对过期的定义的,这个对象被访问中间的间隔时间。这个类通过继承MemObject实现

update
将key的值设置成values
  1. type method
  2. //cwd firefly/dbentrust/mmode.py
  3. Params update(key, values)
复制代码
update_multi
同时修改多个键值对的值
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params update_multi(mapping)
复制代码
mapping 为dict型,mapping = {key1:balue1,key2:value2},成功返回True,失败返回0或False

get
获取key对应的值
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params get(self, key)
复制代码
get_multi
一次获取多个key的值,比for循环调用get方法快
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params get_multi(self, keys)
复制代码
keys为list型,keys = [key1,key2,...keyn],key1,key2为str型

delete
删除对象,这里只是将数据的状态修改为已经删除的状态
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params delete(self)
复制代码
mdelete
清理对象,先将数据同步到数据库,然后真正的清理掉memcached里的本条数据
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params mdelete(self)
复制代码
IsEffective
检查对象是否有效,有效返回True,无效返回False
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params IsEffective(self)
复制代码
syncDB
将数据同步到数据库
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params syncDB(self)
复制代码
checkSync
将数据同步到数据库并检测数据是否超时,超时则从memcached中删除数据
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params checkSync(self,timeout=TIMEOUT)
复制代码
class MFKMode
外键管理

class MAdmin                       
mmode管理器,可以根据主键获取一个mmode的实例。一个MAdmin管理器对应到的是数据库的某张表,继承与MemObject类。它的实例化方式如下
  1. ma = MAdmin("tb_user",'id',fk = 'group',incrkey='id')
  2. user2 = ma.getObj(2)
  3. user2.update('name','test')
复制代码
表示对应的是数据库tb_user这张表,通过ma.getObj(2),可以获取id为2的这条记录的对应的mmode对象。user2.update('name','test')修改这条记录对应的name字段为‘test’。

insert
将所有数据写入到memcached。
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params insert(self)
复制代码
load
将本管理器对应的数据库中的表的所有信息,写入到memcached中
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params load(self)
复制代码
madmininfo
获取Madmin的相关信息
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params madmininfo(self)
复制代码
mfilter
查找符合的对象(效率低下,不推荐使用)
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params mfilter(self,kw)
复制代码
getAllPkByFk
根据外键获取主键列表
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params getAllPkByFk(self,fk)
复制代码
fk,外键的值
根据外键的值查找本表中所有符合条件的数据,返回这些数据的主键的值的列表。

getObj
根据主键获取对应的记录的mmode对象。
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params getObj(pk)
复制代码
pk,主键的值,返回该主键对应的数据的mmode对象实例,类型为instance

getObjData
根据主键获取对应的记录的mmode对象的字段数据。
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params getObjData(self,pk)
复制代码
pk,主键的值,返回该主键对应的数据,类型为dict

getObjList
根据主键列表获取对应的记录的mmode对象的列表。
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params getObjList(self,pklist)
复制代码
Pklist主键列表,根据列表里面的主键,返回由主键对应的数据的mmode对象实例的列表([instance,instance,instance])

deleteMode
根据主键删除对应的mmode信息。
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params deleteMode(self,pk)
复制代码
pk,主键的值
这里只是将数据的状态修改为已经删除的状态


checkAll
检测同步管理的对象信息到数据库。并处理过期的对象
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. check()
复制代码
deleteAllFk
删除所有的外键
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params deleteAllFk(self)
复制代码
真正将数据从memcached中删除

new
创建一个新的对象,对应的是在数据库中创建新的记录,但不是同步实时的。需要在checkAll执行后才能真正的同步到数据库中。
  1. type method
  2. //cwd firefly/dbentrust/ mmode.py
  3. Params new(self,data)
复制代码
class MadminManager
Madmin对象的管理器,实际上就是对整个库中的表的记录进行管理,但这个表对应的Madmin必须在这里被注册。

registe
注册Madmin管理器。
  1. type method
  2. //cwd firefly/dbentrust/ madminanager.py
  3. Params registe(self,admin)
复制代码
admin,数据模型对象实例
将数据对象Madmin的实例添加到Madmin单例管理器MadminManager中

dropAdmin
取消对madmin对象的管理
  1. type method
  2. //cwd firefly/dbentrust/ madminanager.py
  3. Params dropAdmin(self,adminname)
复制代码
adminname,数据模型对象实例的名字
根据实例adminname,将数据对象Madmin的实例从Madmin单例管理器MadminManager中删除

getAdmin
根据表名称获取注册过的madmin对象。
  1. type method
  2. //cwd firefly/dbentrust/ madminanager.py
  3. Params getAdmin(self,adminname)
复制代码
adminname,数据模型对象实例的名字
根据实例adminname,从Madmin单例管理器MadminManager中获取数据对象Madmin的实例

checkAdmins
同步MadminManager中所有的注册的了madmin对应的记录到数据库中,并处理过期的对象
  1. type method
  2. //cwd firefly/dbentrust/ madminanager.py
  3. Params checkAdmins(self)
复制代码


您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

作品发布|文章投稿|广告合作|关于本站|游戏开发论坛 ( 闽ICP备17032699号-3 )

GMT+8, 2024-3-29 17:32

Powered by Discuz! X3.4

Copyright © 2001-2021, Tencent Cloud.

快速回复 返回顶部 返回列表