redis.clients.jedis

Interface MultiKeyCommands

All Known Implementing Classes:

Jedis

public interface MultiKeyCommands

Method Summary

Modifier and Type	Method and Description
Long	bitop(BitOP op, String destKey, String... srcKeys)
List<String>	blpop(int timeout, String... keys)
List<String>	blpop(String... args)
List<String>	brpop(int timeout, String... keys)
List<String>	brpop(String... args)
String	brpoplpush(String source, String destination, int timeout)
Long	del(String... keys)
Long	exists(String... keys)
Set<String>	keys(String pattern) Returns all the keys matching the glob-style pattern.
List<String>	mget(String... keys)
String	mset(String... keysvalues)
Long	msetnx(String... keysvalues)
long	pfcount(String... keys)
String	pfmerge(String destkey, String... sourcekeys)
void	psubscribe(JedisPubSub jedisPubSub, String... patterns)
Long	publish(String channel, String message)
String	randomKey()
String	rename(String oldkey, String newkey)
Long	renamenx(String oldkey, String newkey)
String	rpoplpush(String srckey, String dstkey)
ScanResult<String>	scan(int cursor) Deprecated.
ScanResult<String>	scan(String cursor)
ScanResult<String>	scan(String cursor, ScanParams params) Iterates the set of keys in the currently selected Redis database.
Set<String>	sdiff(String... keys)
Long	sdiffstore(String dstkey, String... keys)
Set<String>	sinter(String... keys)
Long	sinterstore(String dstkey, String... keys)
Long	smove(String srckey, String dstkey, String member)
Long	sort(String key, SortingParams sortingParameters, String dstkey)
Long	sort(String key, String dstkey)
void	subscribe(JedisPubSub jedisPubSub, String... channels)
Set<String>	sunion(String... keys)
Long	sunionstore(String dstkey, String... keys)
Long	touch(String... keys)
Long	unlink(String... keys)
String	unwatch()
String	watch(String... keys)
Long	zinterstore(String dstkey, String... sets)
Long	zinterstore(String dstkey, ZParams params, String... sets)
Long	zunionstore(String dstkey, String... sets)
Long	zunionstore(String dstkey, ZParams params, String... sets)

Method Detail

del

Long del(String... keys)

unlink

Long unlink(String... keys)

exists

Long exists(String... keys)

blpop

List<String> blpop(int timeout,
                   String... keys)

brpop

List<String> brpop(int timeout,
                   String... keys)

blpop

List<String> blpop(String... args)

brpop

List<String> brpop(String... args)

keys

Set<String> keys(String pattern)

Returns all the keys matching the glob-style pattern. For example if you have in the database the keys "foo" and "foobar" the command "KEYS foo*" will return "foo foobar".
Warning: consider this as a command that should be used in production environments with extreme care. It may ruin performance when it is executed against large databases. This command is intended for debugging and special operations, such as changing your keyspace layout. Don't use it in your regular application code. If you're looking for a way to find keys in a subset of your keyspace, consider using scan(String, ScanParams) or sets.

While the time complexity for this operation is O(N), the constant times are fairly low. For example, Redis running on an entry level laptop can scan a 1 million key database in 40 milliseconds.

Glob style patterns examples:

• h?llo will match hello hallo hhllo
• h*llo will match hllo heeeello
• h[ae]llo will match hello and hallo, but not hillo

Use \ to escape special chars if you want to match them verbatim.

Time complexity: O(n) (with n being the number of keys in the DB, and assuming keys and pattern of limited length)

Parameters:

pattern -

Returns:

Multi bulk reply

See Also:

Redis KEYS documentation

mget

List<String> mget(String... keys)

mset

String mset(String... keysvalues)

msetnx

Long msetnx(String... keysvalues)

rename

String rename(String oldkey,
              String newkey)

renamenx

Long renamenx(String oldkey,
              String newkey)

rpoplpush

String rpoplpush(String srckey,
                 String dstkey)

sdiff

Set<String> sdiff(String... keys)

sdiffstore

Long sdiffstore(String dstkey,
                String... keys)

sinter

Set<String> sinter(String... keys)

sinterstore

Long sinterstore(String dstkey,
                 String... keys)

smove

Long smove(String srckey,
           String dstkey,
           String member)

sort

Long sort(String key,
          SortingParams sortingParameters,
          String dstkey)

sort

Long sort(String key,
          String dstkey)

sunion

Set<String> sunion(String... keys)

sunionstore

Long sunionstore(String dstkey,
                 String... keys)

watch

String watch(String... keys)

unwatch

String unwatch()

zinterstore

Long zinterstore(String dstkey,
                 String... sets)

zinterstore

Long zinterstore(String dstkey,
                 ZParams params,
                 String... sets)

zunionstore

Long zunionstore(String dstkey,
                 String... sets)

zunionstore

Long zunionstore(String dstkey,
                 ZParams params,
                 String... sets)

brpoplpush

String brpoplpush(String source,
                  String destination,
                  int timeout)

publish

Long publish(String channel,
             String message)

subscribe

void subscribe(JedisPubSub jedisPubSub,
               String... channels)

psubscribe

void psubscribe(JedisPubSub jedisPubSub,
                String... patterns)

randomKey

String randomKey()

bitop

Long bitop(BitOP op,
           String destKey,
           String... srcKeys)

scan

@Deprecated
ScanResult<String> scan(int cursor)

Deprecated.

scan

ScanResult<String> scan(String cursor)

scan

ScanResult<String> scan(String cursor,
                        ScanParams params)

Iterates the set of keys in the currently selected Redis database.

Since this command allows for incremental iteration, returning only a small number of elements per call, it can be used in production without the downside of commands like keys(String) or JedisCommands.smembers(String) )} that may block the server for a long time (even several seconds) when called against big collections of keys or elements.

SCAN basic usage
SCAN is a cursor based iterator. This means that at every call of the command, the server returns an updated cursor that the user needs to use as the cursor argument in the next call. An iteration starts when the cursor is set to 0, and terminates when the cursor returned by the server is 0.

Scan guarantees
The SCAN command, and the other commands in the SCAN family, are able to provide to the user a set of guarantees associated to full iterations.

• A full iteration always retrieves all the elements that were present in the collection from the start to the end of a full iteration. This means that if a given element is inside the collection when an iteration is started, and is still there when an iteration terminates, then at some point SCAN returned it to the user.
• A full iteration never returns any element that was NOT present in the collection from the start to the end of a full iteration. So if an element was removed before the start of an iteration, and is never added back to the collection for all the time an iteration lasts, SCAN ensures that this element will never be returned.

However because SCAN has very little state associated (just the cursor) it has the following drawbacks:

• A given element may be returned multiple times. It is up to the application to handle the case of duplicated elements, for example only using the returned elements in order to perform operations that are safe when re-applied multiple times.
• Elements that were not constantly present in the collection during a full iteration, may be returned or not: it is undefined.

Time complexity: O(1) for every call. O(N) for a complete iteration, including enough command calls for the cursor to return back to 0. N is the number of elements inside the DB.

Parameters:

cursor - The cursor.

params - the scan parameters. For example a glob-style match pattern

Returns:

the scan result with the results of this iteration and the new position of the cursor

See Also:

Redis SCAN documentation

pfmerge

String pfmerge(String destkey,
               String... sourcekeys)

pfcount

long pfcount(String... keys)

touch

Long touch(String... keys)