Introduction
目前,memlink支持的客户端库,有c,python,php,java这四种。python,php,java客户端实际上是利用c客户端来做成不同语言的模块。因此c以外语言的客户端同样可以达到很高的性能。
Details
C/C++
-
MemLink* memlink_create(char *host, int readport, int writeport, int timeout);
创建MemLink数据结构
host为memlink server的ip,readport为server端的读端口,writeport为server端的写端口,timeout为网络操作的超时时间。单位为秒。
错误返回NULL,否则为成功
-
void memlink_destroy(MemLink *m);
销毁MemLink数据结构,释放资源
-
void memlink_close(MemLink *m);
关闭MemLink中的网络连接
-
int memlink_cmd_dump(MemLink *m);
发送DUMP命令。memlink服务器端执行dump操作。
返回MEMLINK_OK表示执行成功,否则出错
-
int memlink_cmd_clean(MemLink *m, char *key);
发送CLEAN命令。memlink会对该key下的列表进行重新排列,以去除已真实删除的数据空洞。
-
int memlink_cmd_stat(MemLink *m, char *key, MemLinkStat *stat);
发送STAT命令。获取对应key的一些统计信息,结果存储到传入的参数stat中。 MemLinkStat的结构如下:
typedef struct _memlink_stat { unsigned char valuesize; unsigned char masksize; unsigned int blocks; // all blocks unsigned int data; // all alloc data item unsigned int data_used; // all data item used unsigned int mem; // all alloc mem unsigned int mem_used; // all used mem }MemLinkStat;
其中valuesize为value长度的字节数,masksize为mask长度的字节数。blocks为该key下有多少个大的数据块(这里称为block),data为这些所有block中可以容纳的value数,data_used为实际存储了多少个value值。mem为所有block一共占用的内存字节数,mem_used对应data_used所占用的内存字节数。
-
int memlink_cmd_create(MemLink *m, char *key, int valuelen, char *maskstr);
发送CREATE命令,创建一个key。参数valuelen表示该key下的value的长度,maskstr为value的属性格式。该属性格式由问号分隔的数字组成。这些数字表示对应属性项所占用的空间的bit数。比如4:3:1表示有三个属性,这三个属性分别占用4bit,3bit,1bit。
-
int memlink_cmd_del(MemLink *m, char *key, char *value, int valuelen);
发送DEL命令。删除一个指定key下的对应value。
-
int memlink_cmd_insert(MemLink *m, char *key, char *value, int valuelen,char *maskstr, unsigned int pos);
发送insert命令,在指定的key下插入一个value,且此value要插入到一个指定位置。maskstr为该value的熟悉信息。格式和创建key时指定的属性格式对应。比如创建时属性格式为4:3:1,那么这里的maskstr也只能设置三项,比如maskstr可以为8:3:1。pos表示value要插入到列表中的哪个位置,0是列表头部,-1是列表尾部。注意,如果pos超出了列表的范围,也会被插入到尾部。
-
int memlink_cmd_update(MemLink *m, char *key, char *value, int valuelen, unsigned int pos);
发送UPDATE命令,更新一个value的位置。pos为此value的新位置。
-
int memlink_cmd_mask(MemLink *m, char *key, char *value, int valuelen, char *maskstr);
发送MASK命令,修改一个value的属性值。这里的maskstr的格式和INSERT命令的格式一样。
-
int memlink_cmd_tag(MemLink *m, char *key, char *value, int valuelen, int tag);
发送TAG命令,对一个value进行标记删除或者恢复。标记删除的value不会被真实删除,只是该数据不再显示。tag值为MEMLINK_TAG_DEL表示标记删除,为MEMLINK_TAG_RESTOR表示恢复。
-
int memlink_cmd_range(MemLink *m, char *key, char *maskstr,unsigned int frompos, unsigned int len,MemLinkResult *result);
发送RANGE命令,获取指定key下的某个范围的value。frompos是获取的开始位置,从0开始,len为要获取的长度。结果将写入到result中。 MemLinkResult的结构定义如下:typedef struct _memlink_result { int count; int valuesize; int masksize; MemLinkItem *root; }MemLinkResult;其中count为返回的结果的条数,valuesize为value的长度(字节数),masksize为mask的长度(字节数)。root为返回结果的链表。 MemLinkItem的结构定义如下:typedef struct _memlink_item { struct _memlink_item *next; char value[256]; char mask[256]; }MemLinkItem;其中的next是链表的下一个节点指针,value和mask就是对应的结果值。
-
int memlink_cmd_rmkey(MemLink *m, char *key);
发送RMKEY命令,删除一个key,以及该key下的所有value。
-
int memlink_cmd_count(MemLink *m, char *key, char *maskstr, MemLinkCount *count);
发送COUNT命令,以maskstr为条件,统计一个key下所有可见的value,以及被标记删除的value的数量。结果写入到count中。MemLinkCount结构定义如下:typedef struct _memlink_count { unsigned int visible_count; unsigned int tagdel_count; }MemLinkCount;visible_count为可见value的数量。tagdel_count为标记删除的value的数量。
-
void memlink_result_free(MemLinkResult *result);
释放MemLinkResult结构中的root项的内存。
PHP
- class MemLinkClient
memlink客户端类。
- construct($host, $readport, $writeport, $timeout)
同c版memlink_create。
- close()
同c版memlink_close
- destroy()
同c版memlink_destroy
- create($key, $valuesize, $maskformat)
同c版memlink_cmd_create。返回值为整型,正常返回MEMLNK_OK。
- dump()
同c版memlink_dump。返回值为整型,正常返回MEMLNK_OK。
- clean($key)
同c版memlink_cmd_clean。返回值为整型,正常返回MEMLNK_OK。
- stat($key)
同c版memlink_cmd_stat。返回MemLinkStat对象,失败返回null。
- stat2($key, $mstat)
同c版memlink_cmd_stat。和上一个stat方法的区别是,需要传一个MemLinkStat对象作为第二个参数,返回值为整型,正常返回MEMLNK_OK。
- delete($key, $value, $valuelen)
同c版memlink_cmd_del。返回值为整型,正常返回MEMLNK_OK。
- insert($key, $value, $valuelen, $maskstr, $pos)
同c版memlink_cmd_insert。返回值为整型,正常返回MEMLNK_OK。
- update($key, $value, $valuelen, $pos)
同c版memlink_cmd_update。返回值为整型,正常返回MEMLNK_OK。
- mask($key, $value, $valulen, $maskstr)
同c版memlink_cmd_mask。返回值为整型,正常返回MEMLNK_OK。
- tag($key, $value, $valuelen, $tag)
同c版memlink_cmd_tag。返回值为整型,正常返回MEMLNK_OK。
- range($key, $maskstr, $frompos, $len)
同c版memlink_cmd_range。返回MemLinkResult对象,失败返回null。
- range2($key, $maskstr, $frompos, $len, $result)
同c版memlink_cmd_range。和上一个range方法的区别是,需要传一个MemLinkResult对象作为第二个参数,返回值为整型,正常返回MEMLNK_OK。
- rmkey($key)
同c版memlink_cmd_rmkey。返回值为整型,正常返回MEMLNK_OK。
- count($key, $maskstr)
同c版memlink_cmd_count。返回MemLinkCount对象,失败返回null。
- count2($key, $maskstr, $count)
同c版memlink_cmd_count2。和上一个count方法的区别是,需要传一个MemLinkCount对象作为第二个参数,返回值为整型,正常返回MEMLNK_OK。
PYTHON
- class MemLinkClient
memlink客户端类
- init(self, host, readport, writeport, timeout)
同c版memlink_create。
- close(self)
同c版memlink_close
- destroy(self)
同c版memlink_destroy
- dump(self)
同c版memlink_dump。返回值为整型,正常返回MEMLNK_OK。
- clean(self, key)
同c版memlink_cmd_clean。返回值为整型,正常返回MEMLNK_OK。
- create(self, key, valuesize, maskstr)
同c版memlink_cmd_create。返回值为整型,正常返回MEMLNK_OK。
- stat(self, key)
同c版memlink_cmd_stat。返回值为tuple,共两个成员。其中第一项为整形返回值,为MEMLINK_OK表示正常。第二项为MemLinkStat对象。
- delete(self, key, value)
同c版memlink_cmd_delete。返回值为整型,正常返回MEMLNK_OK。
- insert(self, key, value, maskstr, pos)
同c版memlink_cmd_insert。返回值为整型,正常返回MEMLNK_OK。
- update(self, key, value, pos)
同c版memlink_cmd_update。返回值为整型,正常返回MEMLNK_OK。
- mask(self, key, value, maskstr)
同c版memlink_cmd_mask。返回值为整型,正常返回MEMLNK_OK。
- tag(self, key, value, tag)
同c版memlink_cmd_tag。返回值为整型,正常返回MEMLNK_OK。
- range(self, key, maskstr, frompos, len)
同c版memlink_cmd_range。返回值为tuple,共两个成员。其中第一项为整形返回值,为MEMLINK_OK表示正常。第二项为MemLinkResult对象。
- rmkey(self, key)
同c版memlink_cmd_rmkey。返回值为整型,正常返回MEMLNK_OK。
- count(self, key, maskstr)
同c版memlink_cmd_count。返回值为tuple,共两个成员。其中第一项为整形返回值,为MEMLINK_OK表示正常。第二项为MemLinkCount对象。
Java
- public class MemLinkClient
memlink客户端类。说明和php版本类似。
- public MemLinkClient (String host, int readport, int writeport, int timeout)
- public void close()
- public void destroy()
- public int create(String key, int valuesize, String maskstr)
- public int dump()
- public int clean(String key)
- public MemLinkStat stat(String key)
- public int stat2(String key, MemLinkStat stat)
- public int delete(String key, String value)
- public int insert(String key, String value, String maskstr, int pos)
- public int update(String key, String value, int pos)
- public int mask(String key, String value, String maskstr)
- public int tag(String key, String value, int tag)
- public MemLinkResult range(String key, String maskstr, int frompos, int len)
- public int range2(String key, String maskstr, int frompos, int len, MemLinkResult mresult)
- public int rmkey(String key)
- public MemLinkCount count(String key, String maskstr)
- public int count2(String key, String maskstr, MemLinkCount mcount)
发表评论
-
淘宝开源Key/Value结构数据存储系统Tair技术剖析
2010-12-20 00:16 809Tair是由淘宝网 ... -
NoSQL数据库笔谈
2010-12-20 00:15 1147NoSQL数据库笔谈 颜开v0.220 ... -
对SQL说不!NoSQL的数据库技术革命
2010-12-20 00:14 688【51CTO.com快译自7月6日 ... -
又一个key/value数据库 Memlink
2010-12-20 00:13 747为什么会有Memlink? 对于大型论坛服务,比如百度贴吧、 ... -
MemLink详细设计文档
2010-12-20 00:12 985DesignDocument MemLink ... -
MemLink 性能测试
2010-12-20 00:08 1133Introduction Memlink用于持久化存储论坛中 ... -
HandlerSocket client for java——MySql as NoSQL
2010-12-20 00:06 790转:http://rdc.taobao.com ... -
NoSQL数据库探讨 -- 非关系型数据库
2010-12-19 23:57 718随着互联网web ...
相关推荐
#### 四、C/C++ API介绍 为了更好地理解Memlink的核心功能,下面详细介绍其部分C/C++ API接口: - **创建连接**:`MemLink*memlink_create(char*host,intreadport,intwriteport,inttimeout);` - 创建一个MemLink...
Memlink是天涯社区开发的一个高性能、持久化、分布式的Key-list/queue数据引擎。正如名称中的memlink所示,所有数据都 建构在内存中,保证了系统的高性能 (大约是redis几倍),同时使用了redo-log技术保证数据的持久...
Memlink是天涯社区开发的一个高性能、持久化、分布式的Key-list/queue数据引擎。正如名称中的memlink所示,所有数据都建构在内存中,保证了系统的高性能 (大约是redis几倍),同时使用了redo-log技术保证数据的持久化...
在本文中,我们将深入探讨如何使用232+MemoryLink协议来实现在Proface触摸屏上显示255个数据点。Proface是一家知名的工业触摸屏制造商,其产品广泛应用于自动化控制领域。MemoryLink协议是一种专为Proface屏幕设计的...
在这个过程中,天涯社区开源了一系列项目,包括LVS管理系统、Varnish缓存推送平台以及高性能数据引擎memlink等。这些项目的开源极大地促进了业界的技术交流和发展,降低了整个行业的成本,同时也增强了团队成员的...