Servicestack.redis's iredisclient 03_ turn

In fact, many of the methods in Iredisclient are actually the name of the Redis command. As long as you are familiar with Redis commands, you can understand these methods very quickly, and while you are not particularly knowledgeable about Redis, I am also looking at these methods with commands.

First, the attribute

The properties of the Iredisclient are as follows:

Property	Description
ConnectTimeout	Connection timed out
Db	ID or subscript of the current database
Dbsize	The number of keys in the current database
Hadexceptions
Hashes	Stores complex objects, a value that has several field
Host	Server server host address for Redis
Info	Returns various information and statistics about the Redis server
Lastsave	The last time Redis successfully saved data to disk
Lists	All list collections in the current database
Password	Password
Port	Server ports for Redis
RetryCount	Retry Count
Retrytimeout	Retry timeout
Sendtimeout	Send Timeout
Sets	All hashset<t> collections in the current database
Sortedsets	All sortedset<t> collections in the current database
This[string Key]	Accessing a String type value by means of an index (key)

code example:

　　

Rclient.additemtoset ("Shu", "Liu Bei");        Rclient.additemtoset ("Shu", "Guan Yu");        Rclient.additemtoset ("Shu", "Zhang Fei");        Ihasnamed<iredisset> rr = rclient.sets;        hashset<string> hashsetstring = rr["Shu"]. GetAll ();        foreach (String str in hashsetstring)        {            Response.Write (str);        }

Second, iredisclient data operation

　　1. Icacheclient interface

Iredisclient implements the interface Icacheclient, where icacheclient mainly provides the following functions:

Method	Description
Add	Adds a record based on the incoming Key-value, and returns False when key already exists
Flushall	Invalidates all caches (clears all keys for all Redis databases)
Get	Gets the value of a record based on the key passed in
GetAll	Get values for multiple records based on multiple keys passed in
Remove	Removes a record based on the key passed in
RemoveAll	Remove multiple records based on multiple keys passed in
Replace	Overwrites the value of a record according to the key passed in, and does not add when key does not exist
Set	Modifies the value of a record according to the key passed in, and adds if the key does not exist
SetAll	Overwrite multiple records based on the number of keys passed in
Increment
Decrement

Specifically, for example, the main method of adding includes two overloads, one more datetime type parameter, and one more timespan type parameter. Both are the time the cache expires (equivalent to the absolute expiration time in the cache dependency).

• DateTime failure point: arrives at that point in time , immediately fails;
• TimeSpan failure point: after that time period, the immediate failure;

Simple example:

　　

Public ActionResult Index ()        {            Redisclientmanagerconfig redisconfig = new Redisclientmanagerconfig ();            Redisconfig.autostart = true;            Redisconfig.maxreadpoolsize =;            Redisconfig.maxwritepoolsize =;            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", "Cache 1");                Rclient.set ("C1", "Cache 2");                Rclient.replace ("C1", "Cache 3");                Response.Write (rclient.get<string> ("C1"));                Rclient.remove ("C1");                Response.Write (rclient.get<string> ("c1") = = null);            }            Return Content ("");        }

　　2. Simple function

Of course, in addition to the function of implementing the Icacheclient interface, there are actually many functions for basic operation.

Method	Description
Appendtovalue	Appends the parameter value to the end of the original value according to key
ContainsKey	Determine if key has been used within this database (including various types, built-in collections, etc.)
Getallkeys	Get all the Keys collection
Decrementvalue	The value is reduced by 1 according to the specified key (only integer valid)
Decrementvalueby	Subtracts a value from a specified value, based on the specified key (only integer valid)
Incrementvalue	Adds a value of 1 to the specified key (only integer valid)
Incrementvalueby	Adds a value to the specified value, based on the specified key (only integer valid)
Renamekey	Rename a key, the value does not change
Searchkeys	Find the collection of keys of equal name from the database, special mode such as H[ae]llo, only valid in English.
Getrandomkey	Randomly get a key that has already been used
GetValue	Gets a value based on key, only valid for string type
GetValues	Gets multiple values based on multiple keys entered, supports generics
Gettimetolive	Gets the timespan of the item of the specified key distance from the failure point
Getsortedsetcount	Gets the number of items in the sorted collection, with parameters that support subscript and score filtering
Expireentryat	Sets the expiry time (DateTime) of an item according to the specified key
Expireentryin	Sets the expiry time (TimeSpan) of an item based on the specified key
Flushdb	Erase all data from this database
Flushall	Clears all data for all databases
Shutdown	Stop all clients, save, and close the Redis service
Save	Save data DB file to hard disk
Saveasync	Asynchronous Save
Rewriteappendonlyfileasync	Append data to server files only in asynchronous situations
Writeall
PublishMessage	Sends a message to the specified channel
Storeobject
Getvaluesmap	Returns multiple data of the same value type in key-value pairs, supporting generics and return strings.
String
Setentry	Modifies a value according to key, which is overwritten by the presence. (Only strings can be set)
Setentryifnotexists	Set a value based on key, which is valid only if key does not exist, as the key already exists and does not modify (only strings are supported)
Setentryifnotexists	Sets a value based on key to return the old value.
Getentrytype	Gets the current stored value according to the key type: None = 0 String = 1 List = 2 Set = 3 SortedSet = 4 Hash = 5

　　

　　

　　3. Built-in collection

For example, Iredisclient supports the maintenance of data of the following collection types internally:

• List<t>
• Sorted list<t> (SortedSet after. Net 4.0)
• Hashset<t>

Operations on the following 4 types of data:

Method	Description
Additemtolist	Add an item to the internal list<t>
Additemtoset	Add an item to the internal hashset<t>
Additemtosortedset	Adds an item to the internal sort list<t>, where the overloaded method has more than one score: the sorted value. Prioritize according to score from small to large, otherwise by value to big sort
Addrangetolist	Add more than one value from a list<t> in a parameter to an internal list<t>
Addrangetoset	Add more than one value from a hashset<t> in a parameter to an internal hashset<t>
Addrangetosortedset	Adds more than one value from a list<t> in an argument to an internal list<t> at a time, and the score of an overloaded method represents a sorted value.
Getallitemsfromlist	Gets all values for the internal list<t> of the specified Listid
Getallitemsfromset	Gets all values for the internal hashset<t> of the specified SetID
Getallitemsfromsortedset	Gets all values for the internally sorted list<t> of the specified Listid
Getallitemsfromsortedsetdesc	Gets all values for the internally sorted list<t> of the specified Listid, but the obtained values are in reverse order.
Getrangefromlist	Gets the data for the specified subscript range in the internal list<t> of the specified Listid
Getrangefromsortedlist	Gets the data for the specified subscript range in the internally sorted list<t> of the specified Listid
Getrangefromsortedset	Gets the data for the specified subscript range in the internal hashset<t> of the specified SetID
Getrangefromsortedsetbyhighestscore	Gets the data in the internal hashset<t> of the specified SetID in accordance with the score of the high-and low-order values, and supports the skip, take
Getrangefromsortedsetbylowestscore	Ibid., except that the data in a certain range is determined by the score score from low to high
Getrangefromsortedsetdesc	Gets the data within the specified subscript range of the internal hashset<t> in reverse order
Getrangewithscoresfromsortedset	Same as from, except for key-value pairs, with a score in the data score
Getrangewithscoresfromsortedsetbyhighestscore	Ditto
Getrangewithscoresfromsortedsetbylowestscore	Ditto
Getrangewithscoresfromsortedsetdesc	Ditto
Getallwithscoresfromsortedset	Gets the ordered internal list<t> of the specified Listid and its score
Getsorteditemsfromlist	Gets a collection of the specified sort from the list<t> of the specified Listid, supporting Skip,take
Getsortedentryvalues	Gets the item sorted by the specified starting position and number from the list<t> of the specified Listid
Removeallfromlist	Removes the internal list<t> of the specified Listid
Removeitemfromlist	Removes the equivalent of the second parameter value in the internal list<t> of a specified Listid
Removeitemfromset	Removes the item equal to the second parameter value from the internal hashset<t> of the specified SetID
Removeitemfromsortedset	Removes the item of equal value from the sorted internal list<t> in the specified Listid
Removerangefromsortedset	Removes an item of the specified subscript range from the specified Listid sorted list<t>
Removerangefromsortedsetbyscore	Removes an item of the specified score range from the specified Listid sorted list<t>
Removestartfromlist	Removes the beginning item from the specified Listid
Removeendfromlist	Removes the end item from the specified Listid
Blockingremovestartfromlist	To remove from the specified listid the beginning of the block
Blockingremovestartfromlists
RemoveEntry	Clears multiple internal list<t> based on multiple Listid passed in
Removeallluascripts	Clear all Lua script caches
Removeentryfromhash
Getitemfromlist	Get an item based on Listid and subscript
Getitemindexinsortedset	Gets the subscript of the built-in sorted list<t> based on list and value
Getitemindexinsortedsetdesc	Ditto, but in the opposite order
Getitemscoreinsortedset	Gets the score of the built-in list<t> items based on the incoming Listid and values
GetListCount	Gets the number of entries for the built-in list<t> according to Listid
Getsetcount	Gets the number of entries for the built-in hashset<t> according to SetID
Getintersectfromsets	Get the intersection from the IDs of multiple hashset<t> entered
Getunionfromsets	Get the hashset<t> from the IDs of multiple inputs
Getrandomitemfromset	Gets the random item from the collection of the specified Listid
Storeunionfromsets	Combine multiple hashset<t>, and merge as a large hashset<t> in the first argument; the hashset<t> in the first argument may not exist
Storeunionfromsortedsets	Combine multiple sortedset<t>, and merge as a large sortedset<t> in the first argument; the sortedset<t> in the first argument may not exist
Storeintersectfromsets	The intersection result is saved in the first parameter's collection, and the hastset<t> effect
Storeintersectfromsortedsets	The intersection result is saved in the first parameter's collection, and the sortedset<t> effect
Enqueueitemonlist	Stores an element in the head of the list<t> of the specified Listid
Dequeueitemfromlist	List<t> the element at the end of the specified Listid to return the dequeue element
Blockingdequeueitemfromlist	Dequeue the element at the end of the list<t> that specifies Listid, except that it blocks the LIST<T>, supports a timeout, and returns a DEQUEUE element
Blockingdequeueitemfromlists
Blockingpopitemfromlist	Blocks which element at the end of the list<t> of the specified Listid is removed
Blockingpopitemfromlists
Blockingpopandpushitembetweenlists	Removes the element from the first collection and adds it to the head of the second collection, returning the element, blocking two sets at a time
Popitemfromlist	Removes an item from the end of list<t> of the specified Listid and returns
Popitemfromset	Removes an item from the end of hashset<t> of the specified SetID and returns
Popitemwithhighestscorefromsortedset	Removes the score highest item from the hashset<t> of the specified SetID
Popitemwithlowestscorefromsortedset	Removes the lowest score from the hashset<t> of the specified SetID
Popandpushitembetweenlists	Removes the elements from the first collection and adds the header to the second collection
Setcontainsitem	Determines whether the specified value is included in the hashset<t> for the specified SetID (string only)
Sortedsetcontainsitem	Determine if SortedSet contains a key
Trimlist	Trim the built-in collection according to Listid, preserving the elements between the from->at (containing the From
Incrementiteminsortedset	The value score plus the specified score for the values in the specified Listid collection
Setiteminlist	Re-sets the value of the specified Listid and subscript to the specified values
Pushitemtolist	Into row a key-value pair in the built-in list<t> of the specified Listid, at the end
Prependitemtolist	Inserts a value to the front of the list<t>
Prependrangetolist	Add multiple values at once to the built-in list<t> of the specified Listid
Getdifferencesfromset	Returns data that exists in the first collection, but does not exist in the other collection. Subtraction
Storedifferencesfromset	Saves the result of the differential set in the collection of the first parameter
Movebetweensets	Moves an element from one collection to the beginning of another collection. (Delete and add)

Here is an example of list<t> and hashset<t>:

Internal maintenance of a list<t> set        rclient.additemtolist ("Shu", "Liu Bei");        Rclient.additemtolist ("Shu", "Guan Yu");        Rclient.additemtolist ("Shu", "Zhang Fei");        list<string> liststring = rclient.getallitemsfromlist ("Shu");        foreach (String str in liststring)        {            Response.Write (str);    Output Liu Bei Guan yu Zhang                       rclient.additemtoset ("Wei", "Cao");        Rclient.additemtoset ("Wei", "Cao");        Rclient.additemtoset ("Wei", "Dian Wei");        hashset<string> hashsetstring = Rclient.getallitemsfromset ("Wei");        foreach (String str in hashsetstring)        {            Response.Write (str);    Output Code Vecao        }

Here is another example of the scope range operation:

        Internal maintenance of a list<t> set        rclient.additemtosortedset ("Shu", "Liu Bei", 5);        Rclient.additemtosortedset ("Shu", "Guan Yu", 2);        Rclient.additemtosortedset ("Shu", "Zhang Fei", 3);        idictionary<string,double> dicstring = Rclient.getrangewithscoresfromsortedset ("Shu", 0, 2);        foreach (Var r in dicstring)        {            Response.Write (R.key + ":" + r.value);    Output         }

3. Built-in hash

Internal maintenance a Hashtable

Method	Description
Setentryinhash	Sets a key-value pair into the hash table, overwriting if the key of the Hashtable is present
Setentryinhashifnotexists	When a hash table key is not used, set a key value pair such as hash
Gethashvalues	Get multiple values under Hashid based on the Hashid
Getvaluesfromhash	Get multiple values based on the key of the Hashid and hash table (multiple keys supported)
Getvaluefromhash	Get a single value based on the key of the Hashid and hash table
Gethashkeys	Gets all keys under the specified Hashid
Gethashvalues	Gets all values under the specified Hashid
Gethashcount	Gets the number of all keys under the specified Hashid
Hashcontainsentry	Determines whether the specified Hashid contains the specified key in the hash table
Incrementvalueinhash	Adds the value from the hash table of the specified Hashid to the specified value
Storeashash	Hash an object (supports generics)
Getfromhash	Extract objects from the hash table by ID (supports generics)
Setrangeinhash	by ienumerable<keyvaluepair<string, string>> sets multiple values at once, and when the internal hash key does not exist, it is added, and the presence is overwritten

code example:

        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

Starting with the Redis 2.6.0 release, a variety of LUA scripts can be executed with the built-in LUA interpreter. Iredisclient supports the execution of LUA scripts, which are used to execute LUA scripts in the following ways:

Method	Description
Loadluascript	Loads a script into the script cache, but does not run it immediately
Killrunningluascript	To stop a script that is running a specified ID
Execluaasint
Execluaaslist
Execluaasstring
Execluashaasint
Execluashaaslist
Execluashaasstring
Hasluascript	Determine if the Lua script is in the script cache
CalculateSha1
Whichluascriptsexists

About the Lua script can be here to understand: http://www.cnblogs.com/ly4cn/archive/2006/08/04/467550.html

　　5. Business

Transactions in Redis

Method	Description
Watch	Monitor one (or more) key, and if this (or these) key is changed by another command before the transaction executes, the transaction will be interrupted.
Unwatch	Suppress watch command for all key monitoring
Acquirelock	Apply to a key locking (during which other objects cannot be accessed)
CreateTransaction	Creates a transaction that returns a Iredistransaction object
Createsubscription	Creating a subscription event returns a Iredissubscription object
Createpipeline	Returns a Iredispipeline object

Servicestack.redis's iredisclient 03_ turn