ServiceStack.Redis之IRedisClient<第三篇>
来源:互联网 发布:2017年动漫推荐知乎 编辑:程序博客网 时间:2024/05/17 00:18
事实上,IRedisClient里面的很多方法,其实就是Redis的命令名。只要对Redis的命令熟悉一点就能够非常快速地理解和掌握这些方法,趁着现在对Redis不是特别了解,我也对着命令来了解一下这些方法。
一、属性
IRedisClient的属性如下:
属性说明ConnectTimeout 连接超时Db当前数据库的ID或下标DbSize 当前数据库的 key 的数量HadExceptions Hashes 存储复杂对象,一个value中有几个field Host Redis的Server服务器主机地址Info 返回关于 Redis 服务器的各种信息和统计数值LastSave 最近一次 Redis 成功将数据保存到磁盘上的时间Lists 当前数据库中所有的List集合Password 密码Port Redis的Server端口RetryCount 重试次数RetryTimeout 重试超时SendTimeout 发送超时Sets 当前数据库中所有的HashSet<T>集合SortedSets 当前数据库中所有的SortedSet<T>集合this[string key]通过索引的方式(key)访问一个字符串类型值代码示例:
RClient.AddItemToSet("蜀国", "刘备"); RClient.AddItemToSet("蜀国", "关羽"); RClient.AddItemToSet("蜀国", "张飞"); IHasNamed<IRedisSet> rr = RClient.Sets; HashSet<string> HashSetString = rr["蜀国"].GetAll(); foreach (string str in HashSetString) { Response.Write(str); }
二、IRedisClient数据操作
1、ICacheClient接口
IRedisClient实现了接口ICacheClient,其中ICacheClient主要提供的功能如下:
方法说明Add根据传入的key-value添加一条记录,当key已存在返回falseFlushAll使所有缓存失效(清除Redis所有数据库的所有Key)Get根据传入的key获取一条记录的值GetAll根据传入的多个key获取多条记录的值Remove根据传入的key移除一条记录RemoveAll根据传入的多个key移除多条记录Replace根据传入的key覆盖一条记录的值,当key不存在不会添加Set根据传入的key修改一条记录的值,当key不存在则添加SetAll根据传入的多个key覆盖多条记录Increment Decrement特别说明,比如添加的主要方法包括两个重载,一个多了个DateTime类型参数,一个多了TimeSpan类型的参数。这两个都是缓存失效的时间(相当于缓存依赖里的绝对过期时间)。
- DateTime失效点:到达该时间点,立即失效;
- TimeSpan失效点:经过该时间段,立即失效;
简单示例:
public ActionResult Index() { RedisClientManagerConfig RedisConfig = new RedisClientManagerConfig(); RedisConfig.AutoStart = true; RedisConfig.MaxReadPoolSize = 60; RedisConfig.MaxWritePoolSize = 60; PooledRedisClientManager prcm = new PooledRedisClientManager(new List<string>() { "127.0.0.1" }, new List<string>() { "127.0.0.1" }, RedisConfig); using (IRedisClient RClient = prcm.GetClient()) { RClient.Add("c1", "缓存1"); RClient.Set("c1", "缓存2"); RClient.Replace("c1", "缓存3"); Response.Write(RClient.Get<string>("c1")); RClient.Remove("c1"); Response.Write(RClient.Get<string>("c1") == null); } return Content(""); }
2、简单功能
当然,除了实现ICacheClient接口的功能外,对于基本操作,实际上也还有很多功能
方法说明AppendToValue根据Key将参数value追加到原有值的结尾ContainsKey判断Key在本数据库内是否已被使用(包括各种类型、内置集合等等)GetAllKeys获取所有的Keys集合DecrementValue根据指定的Key,将值减1(仅整型有效)DecrementValueBy根据指定的Key,将值减去指定值(仅整型有效)IncrementValue根据指定的Key,将值加1(仅整型有效)IncrementValueBy根据指定的Key,将值加上指定值(仅整型有效)RenameKey重命名一个Key,值不变SearchKeys从数据库中查找名称相等的Keys的集合,特殊模式如h[ae]llo,仅英文有效。GetRandomKey随机获取一个已经被使用的KeyGetValue根据Key获取值,只对string类型有效GetValues根据输入的多个Key获取多个值,支持泛型GetTimeToLive获取指定Key的项距离失效点的TimeSpanGetSortedSetCount获取已排序集合的项的数目,参数支持下标以及score筛选ExpireEntryAt根据指定的key设置一项的到期时间(DateTime)ExpireEntryIn根据指定的key设置一项的到期时间(TimeSpan)FlushDb清除本数据库的所有数据FlushAll清除所有数据库的所有数据Shutdown停止所有客户端,保存,关闭Redis服务Save保存数据DB文件到硬盘SaveAsync异步保存RewriteAppendOnlyFileAsync只在异步情况下将数据追加到服务器文件WriteAll PublishMessage将Message发送到指定的频道StoreObject GetValuesMap以键值对的方式返回值类型相同的多条数据,支持泛型与返回字符串。字符串 SetEntry根据Key修改一个值,存在则覆盖。(只能设置字符串)SetEntryIfNotExists根据Key设置一个值,仅仅当Key不存在时有效,如Key已存在则不修改(只支持字符串)SetEntryIfNotExists根据Key设置一个值,返回旧值。GetEntryType根据Key获取当前存储的值是什么类型:
None = 0
String = 1
List = 2
Set = 3
SortedSet = 4
Hash = 5
3、内置集合
比如,IRedisClient支持在内部维护如下集合类型的数据:
- List<T>
- 排序的List<T>(.Net 4.0后的SortedSet)
- HashSet<T>
关于如下4种类型数据的操作:
方法说明AddItemToList添加一个项到内部的List<T>AddItemToSet添加一个项到内部的HashSet<T>AddItemToSortedSet添加一个项到内部的排序List<T>,其中重载方法多了个score:排序值。优先按照score从小->大排序,否则按值小到大排序AddRangeToList一次过将参数中的List<T>中的多个值添加入内部的List<T>AddRangeToSet一次过将参数中的HashSet<T>中的多个值添加入内部的HashSet<T>AddRangeToSortedSet一次过将参数中的List<T>中的多个值添加到内部List<T>,重载方法的score表示排序值。GetAllItemsFromList获取指定ListId的内部List<T>的所有值GetAllItemsFromSet获取指定SetId的内部HashSet<T>的所有值GetAllItemsFromSortedSet获取指定ListId的内部已排序List<T>的所有值GetAllItemsFromSortedSetDesc获取指定ListId的内部已排序List<T>的所有值,不过获取的值是倒序排列后的。GetRangeFromList获取指定ListId的内部List<T>中指定下标范围的数据GetRangeFromSortedList获取指定ListId的内部已排序List<T>中指定下标范围的数据GetRangeFromSortedSet获取指定SetId的内部HashSet<T>中指定下标范围的数据GetRangeFromSortedSetByHighestScore获取指定SetId的内部HashSet<T>中按照score由高->低排序后的分值范围的数据,并且支持skip、takeGetRangeFromSortedSetByLowestScore同上,只不过是按score分值由低->高取一定范围内的数据GetRangeFromSortedSetDesc按倒序获取内部HashSet<T>的指定下标范围内的数据GetRangeWithScoresFromSortedSet与From相同,只不过获取的是键值对,数据中带分值scoreGetRangeWithScoresFromSortedSetByHighestScore同上GetRangeWithScoresFromSortedSetByLowestScore同上GetRangeWithScoresFromSortedSetDesc同上GetAllWithScoresFromSortedSet获取指定ListId的已排序的内部List<T>与其scoreGetSortedItemsFromList从指定ListId的List<T>中获取按指定排序的集合,支持Skip,TakeGetSortedEntryValues从指定ListId的List<T>中获取经过排序指定开始位置与个数的项RemoveAllFromList移除指定ListId的内部List<T>RemoveItemFromList移除指定ListId的内部List<T>中第二个参数值相等的那一项RemoveItemFromSet从指定SetId的内部HashSet<T>中移除与第二个参数值相等的那一项RemoveItemFromSortedSet从指定ListId中已排序的内部List<T>中移除值相等的那一项RemoveRangeFromSortedSet从指定ListId已排序的List<T>中移除指定下标范围的项RemoveRangeFromSortedSetByScore从指定ListId已排序的List<T>中移除指定score范围的项RemoveStartFromList从指定ListId移除开头那一项RemoveEndFromList从指定ListId移除末尾那项BlockingRemoveStartFromList阻塞地从指定ListId移除开头那一项BlockingRemoveStartFromLists RemoveEntry根据传入的多个ListId,清除多个内部List<T>RemoveAllLuaScripts清除所有的 Lua 脚本缓存RemoveEntryFromHash GetItemFromList根据ListId和下标获取一项GetItemIndexInSortedSet根据List和值,获取内置的排序后的List<T>的下标GetItemIndexInSortedSetDesc同上,不过顺序相反GetItemScoreInSortedSet根据传入的ListId和值获取内置List<T>项的scoreGetListCount根据ListId,获取内置的List<T>的项数GetSetCount根据SetId,获取内置的HashSet<T>的项数GetIntersectFromSets从输入的多个HashSet<T>的Id中获取交集GetUnionFromSets从输入的多个HashSet<T>的Id中获取并集GetRandomItemFromSet从指定ListId的集合中获取随机项StoreUnionFromSets将多个HashSet<T>,合并为第一个参数中的一个大HashSet<T>,第一个参数中的HashSet<T>原本可以不存在StoreUnionFromSortedSets将多个SortedSet<T>,合并为第一个参数中的一个大SortedSet<T>,第一个参数中的SortedSet<T>原本可以不存在StoreIntersectFromSets将交集结果保存在第一个参数的集合中,对HastSet<T>作用StoreIntersectFromSortedSets将交集结果保存在第一个参数的集合中,对SortedSet<T>作用EnqueueItemOnList将一个元素存入指定ListId的List<T>的头部DequeueItemFromList将指定ListId的List<T>末尾的那个元素出列,返回出列元素BlockingDequeueItemFromList将指定ListId的List<T>末尾的那个元素出列,区别是:会阻塞该List<T>,支持超时时间,返回出列元素BlockingDequeueItemFromLists BlockingPopItemFromList阻塞地将指定ListId的List<T>末尾的哪一个元素移除BlockingPopItemFromLists BlockingPopAndPushItemBetweenLists将第一个集合的元素移除并添加到第二个集合的头部,返回该元素,会同时阻塞两个集合PopItemFromList从指定ListId的List<T>末尾移除一项并返回PopItemFromSet从指定SetId的HashSet<T>末尾移除一项并返回PopItemWithHighestScoreFromSortedSet从指定SetId的HashSet<T>移除score最高的那一项PopItemWithLowestScoreFromSortedSet从指定SetId的HashSet<T>移除score最低的那一项PopAndPushItemBetweenLists将第一个集合的元素移除并添加到第二个集合的头部SetContainsItem判断指定SetId的HashSet<T>中是否包含指定的value(仅仅支持字符串)SortedSetContainsItem判断SortedSet是否包含一个键TrimList根据ListId裁剪内置集合,保留下去from->at之间(包含from于at)的元素,其余的裁去IncrementItemInSortedSet为指定ListId的集合中的value的分值score加上指定分值SetItemInList重新设置指定ListId和下标的value为指定值PushItemToList在指定ListId的内置List<T>中入列一个键值对,在末尾PrependItemToList将一个值插入到List<T>的最前面PrependRangeToList一次性添加多个值到指定ListId的内置List<T>中GetDifferencesFromSet返回存在于第一个集合,但是不存在于其他集合的数据。差集StoreDifferencesFromSet将求差集的结果保存在第一个参数的集合中MoveBetweenSets将元素从一个集合移动到另一个集合的开头。(删除与添加)下面仅给出一个List<T>与HashSet<T>的示例:
//内部维护一个List<T>集合 RClient.AddItemToList("蜀国", "刘备"); RClient.AddItemToList("蜀国", "关羽"); RClient.AddItemToList("蜀国", "张飞"); List<string> ListString = RClient.GetAllItemsFromList("蜀国"); foreach (string str in ListString) { Response.Write(str); //输出 刘备 关羽 张飞 } RClient.AddItemToSet("魏国", "曹操"); RClient.AddItemToSet("魏国", "曹操"); RClient.AddItemToSet("魏国", "典韦"); HashSet<string> HashSetString = RClient.GetAllItemsFromSet("魏国"); foreach (string str in HashSetString) { Response.Write(str); //输出 典韦 曹操 }
下面再给一个范围Range操作示例:
//内部维护一个List<T>集合 RClient.AddItemToSortedSet("蜀国", "刘备", 5); RClient.AddItemToSortedSet("蜀国", "关羽", 2); RClient.AddItemToSortedSet("蜀国", "张飞", 3); IDictionary<String,double> DicString = RClient.GetRangeWithScoresFromSortedSet("蜀国", 0, 2); foreach (var r in DicString) { Response.Write(r.Key + ":" + r.Value); //输出 }
3、内置Hash
内部维护一个HashTable
方法说明SetEntryInHash设置一个键值对入Hash表,如果哈希表的key存在则覆盖SetEntryInHashIfNotExists当哈希表的key未被使用时,设置一个键值对如Hash表GetHashValues根据HashId获取多个改HashId下的多个值GetValuesFromHash根据HashId和Hash表的Key获取多个值(支持多个key)GetValueFromHash根据HashId和Hash表的Key获取单个值GetHashKeys获取指定HashId下的所有KeyGetHashValues获取指定HashId下的所有值GetHashCount获取指定HashId下的所有Key数量HashContainsEntry判断指定HashId的哈希表中是否包含指定的KeyIncrementValueInHash将指定HashId的哈希表中的值加上指定值StoreAsHash将一个对象存入Hash(支持泛型)GetFromHash根据Id从Hash表中取出对象(支持泛型)SetRangeInHash通过IEnumerable<KeyValuePair<string, string>>一次性设置多个值,当内部Hash的key不存在则添加,存在则覆盖代码示例:
RClient.SetEntryInHash("xxx","key","123"); List<KeyValuePair<string, string>> keyValuePairs = new List<KeyValuePair<string, string>>(); KeyValuePair<string, string> kvp = new KeyValuePair<string, string>("key", "1"); keyValuePairs.Add(kvp); RClient.SetRangeInHash("xxx", keyValuePairs);
4、Lua Script
从 Redis 2.6.0 版本开始,通过内置的 Lua 解释器,可以执行各种Lua脚本。IRedisClient支持执行Lua脚本,其供用于执行Lua脚本的方法如下:
方法说明LoadLuaScript将一个脚本装入脚本缓存,但并不立即运行它KillRunningLuaScript停止正在运行的指定Id的脚本ExecLuaAsInt ExecLuaAsList ExecLuaAsString ExecLuaShaAsInt ExecLuaShaAsList ExecLuaShaAsString HasLuaScript判断Lua脚本是否在脚本缓存里CalculateSha1 WhichLuaScriptsExists关于Lua脚本可以到这里去了解:http://www.cnblogs.com/ly4cn/archive/2006/08/04/467550.html
5、事务
Redis中的事务
方法说明Watch监视一个(或多个) key ,如果在事务执行之前这个(或这些) key 被其他命令所改动,那么事务将被打断。UnWatch取消 WATCH 命令对所有 key 的监视AcquireLock申请对一个Key加锁(期间其他对象不能访问)CreateTransaction创建一个事务,返回一个IRedisTransaction对象CreateSubscription创建一个订阅事件返回一个IRedisSubscription对象CreatePipeline返回一个IRedisPipeline对象- ServiceStack.Redis之IRedisClient<第三篇>
- ServiceStack.Redis之IRedisClient<第三篇>
- ServiceStack.Redis之IRedisClient常用方法说明<第三篇>
- ServiceStack.Redis之IRedisClient
- Redis : ServiceStack.Redis之IRedisClient
- Redis:ServiceStack.Redis之IRedisClient
- ServiceStack.Redis之IRedisClient(3)
- ServiceStack.Redis 之 IRedisTypedClient<第四篇>
- ServiceStack.Redis 之 IRedisTypedClient<第四篇>
- ServiceStack.Redis之IRedisTypedClient<第四篇>
- C# Redis之ServiceStack
- C# Redis之ServiceStack
- C# Redis之ServiceStack
- C# Redis之ServiceStack
- ServiceStack.Redis 之 RedisClientList.Remove
- Redis:ServiceStack.Redis之IRedisTypedClient<T>
- .Net使用Redis详解之ServiceStack.Redis
- ServiceStack.Redis
- Redis常用命令速查 <第二篇>
- 常见几种存储过程分页
- css如何对齐文本框和旁边的图像按钮
- SSL协议与数字证书原理
- 黑马程序员_OC内存管理
- ServiceStack.Redis之IRedisClient<第三篇>
- schema中simpleType元素和complexType元素的区别
- FZU 2105 Digits Count(线段树区间修改)
- 黑马程序员____反射、正则
- ServiceStack.Redis 之 IRedisTypedClient<第四篇>
- Hive安装与部署
- MapReduce程序打jar要注意的事项
- 黑马程序员—Java集合框架(LinkedList)
- 规范化规范及化工科技化工