redis.clients.jedis.commands

接口 MultiKeyCommands

所有已知实现类:

Jedis

public interface MultiKeyCommands

方法概要

限定符和类型	方法和说明
java.lang.Long	bitop(BitOP op, java.lang.String destKey, java.lang.String... srcKeys)
java.lang.String	blmove(java.lang.String srcKey, java.lang.String dstKey, ListDirection from, ListDirection to, double timeout)
KeyedListElement	blpop(double timeout, java.lang.String... keys)
java.util.List<java.lang.String>	blpop(int timeout, java.lang.String... keys)
java.util.List<java.lang.String>	blpop(java.lang.String... args)
KeyedListElement	brpop(double timeout, java.lang.String... keys)
java.util.List<java.lang.String>	brpop(int timeout, java.lang.String... keys)
java.util.List<java.lang.String>	brpop(java.lang.String... args)
java.lang.String	brpoplpush(java.lang.String source, java.lang.String destination, int timeout)
KeyedZSetElement	bzpopmax(double timeout, java.lang.String... keys)
KeyedZSetElement	bzpopmin(double timeout, java.lang.String... keys)
java.lang.Boolean	copy(java.lang.String srcKey, java.lang.String dstKey, boolean replace)
java.lang.Boolean	copy(java.lang.String srcKey, java.lang.String dstKey, int db, boolean replace)
java.lang.Long	del(java.lang.String... keys)
java.lang.Long	exists(java.lang.String... keys)
java.lang.Long	georadiusByMemberStore(java.lang.String key, java.lang.String member, double radius, GeoUnit unit, GeoRadiusParam param, GeoRadiusStoreParam storeParam)
java.lang.Long	georadiusStore(java.lang.String key, double longitude, double latitude, double radius, GeoUnit unit, GeoRadiusParam param, GeoRadiusStoreParam storeParam)
java.util.Set<java.lang.String>	keys(java.lang.String pattern) Returns all the keys matching the glob-style pattern.
java.lang.String	lmove(java.lang.String srcKey, java.lang.String dstKey, ListDirection from, ListDirection to)
java.util.List<java.lang.String>	mget(java.lang.String... keys)
java.lang.String	mset(java.lang.String... keysvalues)
java.lang.Long	msetnx(java.lang.String... keysvalues)
long	pfcount(java.lang.String... keys)
java.lang.String	pfmerge(java.lang.String destkey, java.lang.String... sourcekeys)
void	psubscribe(JedisPubSub jedisPubSub, java.lang.String... patterns)
java.lang.Long	publish(java.lang.String channel, java.lang.String message)
java.lang.String	randomKey()
java.lang.String	rename(java.lang.String oldkey, java.lang.String newkey)
java.lang.Long	renamenx(java.lang.String oldkey, java.lang.String newkey)
java.lang.String	rpoplpush(java.lang.String srckey, java.lang.String dstkey)
ScanResult<java.lang.String>	scan(java.lang.String cursor)
ScanResult<java.lang.String>	scan(java.lang.String cursor, ScanParams params) Iterates the set of keys in the currently selected Redis database.
java.util.Set<java.lang.String>	sdiff(java.lang.String... keys)
java.lang.Long	sdiffstore(java.lang.String dstkey, java.lang.String... keys)
java.util.Set<java.lang.String>	sinter(java.lang.String... keys)
java.lang.Long	sinterstore(java.lang.String dstkey, java.lang.String... keys)
java.lang.Long	smove(java.lang.String srckey, java.lang.String dstkey, java.lang.String member)
java.lang.Long	sort(java.lang.String key, SortingParams sortingParameters, java.lang.String dstkey)
java.lang.Long	sort(java.lang.String key, java.lang.String dstkey)
void	subscribe(JedisPubSub jedisPubSub, java.lang.String... channels)
java.util.Set<java.lang.String>	sunion(java.lang.String... keys)
java.lang.Long	sunionstore(java.lang.String dstkey, java.lang.String... keys)
java.lang.Long	touch(java.lang.String... keys)
java.lang.Long	unlink(java.lang.String... keys)
java.lang.String	unwatch()
java.lang.String	watch(java.lang.String... keys)
java.util.List<java.util.Map.Entry<java.lang.String,java.util.List<StreamEntry>>>	xread(int count, long block, java.util.Map.Entry<java.lang.String,StreamEntryID>... streams) 已过时。 This method will be removed due to bug regarding block param. Use xread(redis.clients.jedis.params.XReadParams, java.util.Map).
java.util.List<java.util.Map.Entry<java.lang.String,java.util.List<StreamEntry>>>	xread(XReadParams xReadParams, java.util.Map<java.lang.String,StreamEntryID> streams)
java.util.List<java.util.Map.Entry<java.lang.String,java.util.List<StreamEntry>>>	xreadGroup(java.lang.String groupname, java.lang.String consumer, int count, long block, boolean noAck, java.util.Map.Entry<java.lang.String,StreamEntryID>... streams) 已过时。 This method will be removed due to bug regarding block param. Use xreadGroup(java.lang.String, java.lang.String, redis.clients.jedis.params.XReadGroupParams, java.util.Map).
java.util.List<java.util.Map.Entry<java.lang.String,java.util.List<StreamEntry>>>	xreadGroup(java.lang.String groupname, java.lang.String consumer, XReadGroupParams xReadGroupParams, java.util.Map<java.lang.String,StreamEntryID> streams)
java.util.Set<java.lang.String>	zdiff(java.lang.String... keys)
java.lang.Long	zdiffStore(java.lang.String dstkey, java.lang.String... keys)
java.util.Set<Tuple>	zdiffWithScores(java.lang.String... keys)
java.util.Set<java.lang.String>	zinter(ZParams params, java.lang.String... keys)
java.lang.Long	zinterstore(java.lang.String dstkey, java.lang.String... sets)
java.lang.Long	zinterstore(java.lang.String dstkey, ZParams params, java.lang.String... sets)
java.util.Set<Tuple>	zinterWithScores(ZParams params, java.lang.String... keys)
java.util.Set<java.lang.String>	zunion(ZParams params, java.lang.String... keys)
java.lang.Long	zunionstore(java.lang.String dstkey, java.lang.String... sets)
java.lang.Long	zunionstore(java.lang.String dstkey, ZParams params, java.lang.String... sets)
java.util.Set<Tuple>	zunionWithScores(ZParams params, java.lang.String... keys)

方法详细资料

copy

java.lang.Boolean copy(java.lang.String srcKey,
                       java.lang.String dstKey,
                       int db,
                       boolean replace)

copy

java.lang.Boolean copy(java.lang.String srcKey,
                       java.lang.String dstKey,
                       boolean replace)

del

java.lang.Long del(java.lang.String... keys)

unlink

java.lang.Long unlink(java.lang.String... keys)

exists

java.lang.Long exists(java.lang.String... keys)

lmove

java.lang.String lmove(java.lang.String srcKey,
                       java.lang.String dstKey,
                       ListDirection from,
                       ListDirection to)

blmove

java.lang.String blmove(java.lang.String srcKey,
                        java.lang.String dstKey,
                        ListDirection from,
                        ListDirection to,
                        double timeout)

blpop

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

blpop

KeyedListElement blpop(double timeout,
                       java.lang.String... keys)

brpop

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

brpop

KeyedListElement brpop(double timeout,
                       java.lang.String... keys)

blpop

java.util.List<java.lang.String> blpop(java.lang.String... args)

brpop

java.util.List<java.lang.String> brpop(java.lang.String... args)

bzpopmax

KeyedZSetElement bzpopmax(double timeout,
                          java.lang.String... keys)

bzpopmin

KeyedZSetElement bzpopmin(double timeout,
                          java.lang.String... keys)

keys

java.util.Set<java.lang.String> keys(java.lang.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)

参数:

pattern -

返回:

Multi bulk reply

另请参阅:

Redis KEYS documentation

mget

java.util.List<java.lang.String> mget(java.lang.String... keys)

mset

java.lang.String mset(java.lang.String... keysvalues)

msetnx

java.lang.Long msetnx(java.lang.String... keysvalues)

rename

java.lang.String rename(java.lang.String oldkey,
                        java.lang.String newkey)

renamenx

java.lang.Long renamenx(java.lang.String oldkey,
                        java.lang.String newkey)

rpoplpush

java.lang.String rpoplpush(java.lang.String srckey,
                           java.lang.String dstkey)

sdiff

java.util.Set<java.lang.String> sdiff(java.lang.String... keys)

sdiffstore

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

sinter

java.util.Set<java.lang.String> sinter(java.lang.String... keys)

sinterstore

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

smove

java.lang.Long smove(java.lang.String srckey,
                     java.lang.String dstkey,
                     java.lang.String member)

sort

java.lang.Long sort(java.lang.String key,
                    SortingParams sortingParameters,
                    java.lang.String dstkey)

sort

java.lang.Long sort(java.lang.String key,
                    java.lang.String dstkey)

sunion

java.util.Set<java.lang.String> sunion(java.lang.String... keys)

sunionstore

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

watch

java.lang.String watch(java.lang.String... keys)

unwatch

java.lang.String unwatch()

zdiff

java.util.Set<java.lang.String> zdiff(java.lang.String... keys)

zdiffWithScores

java.util.Set<Tuple> zdiffWithScores(java.lang.String... keys)

zdiffStore

java.lang.Long zdiffStore(java.lang.String dstkey,
                          java.lang.String... keys)

zinterstore

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

zinterstore

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

zinter

java.util.Set<java.lang.String> zinter(ZParams params,
                                       java.lang.String... keys)

zinterWithScores

java.util.Set<Tuple> zinterWithScores(ZParams params,
                                      java.lang.String... keys)

zunion

java.util.Set<java.lang.String> zunion(ZParams params,
                                       java.lang.String... keys)

zunionWithScores

java.util.Set<Tuple> zunionWithScores(ZParams params,
                                      java.lang.String... keys)

zunionstore

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

zunionstore

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

brpoplpush

java.lang.String brpoplpush(java.lang.String source,
                            java.lang.String destination,
                            int timeout)

publish

java.lang.Long publish(java.lang.String channel,
                       java.lang.String message)

subscribe

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

psubscribe

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

randomKey

java.lang.String randomKey()

bitop

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

scan

ScanResult<java.lang.String> scan(java.lang.String cursor)

参数:

cursor -

返回:

另请参阅:

scan(String, ScanParams)

scan

ScanResult<java.lang.String> scan(java.lang.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.

参数:

cursor - The cursor.

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

返回:

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

另请参阅:

Redis SCAN documentation

pfmerge

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

pfcount

long pfcount(java.lang.String... keys)

touch

java.lang.Long touch(java.lang.String... keys)

xread

@Deprecated
java.util.List<java.util.Map.Entry<java.lang.String,java.util.List<StreamEntry>>> xread(int count,
                                                                                                     long block,
                                                                                                     java.util.Map.Entry<java.lang.String,StreamEntryID>... streams)

已过时。 This method will be removed due to bug regarding block param. Use xread(redis.clients.jedis.params.XReadParams, java.util.Map).

XREAD [COUNT count] [BLOCK milliseconds] STREAMS key [key ...] ID [ID ...]

参数:

count -

block -

streams -

返回:

xread

java.util.List<java.util.Map.Entry<java.lang.String,java.util.List<StreamEntry>>> xread(XReadParams xReadParams,
                                                                                        java.util.Map<java.lang.String,StreamEntryID> streams)

xreadGroup

@Deprecated
java.util.List<java.util.Map.Entry<java.lang.String,java.util.List<StreamEntry>>> xreadGroup(java.lang.String groupname,
                                                                                                          java.lang.String consumer,
                                                                                                          int count,
                                                                                                          long block,
                                                                                                          boolean noAck,
                                                                                                          java.util.Map.Entry<java.lang.String,StreamEntryID>... streams)

已过时。 This method will be removed due to bug regarding block param. Use xreadGroup(java.lang.String, java.lang.String, redis.clients.jedis.params.XReadGroupParams, java.util.Map).

XREAD [COUNT count] [BLOCK milliseconds] STREAMS key [key ...] ID [ID ...]

参数:

groupname -

consumer -

count -

block -

noAck -

streams -

返回:

xreadGroup

java.util.List<java.util.Map.Entry<java.lang.String,java.util.List<StreamEntry>>> xreadGroup(java.lang.String groupname,
                                                                                             java.lang.String consumer,
                                                                                             XReadGroupParams xReadGroupParams,
                                                                                             java.util.Map<java.lang.String,StreamEntryID> streams)

georadiusStore

java.lang.Long georadiusStore(java.lang.String key,
                              double longitude,
                              double latitude,
                              double radius,
                              GeoUnit unit,
                              GeoRadiusParam param,
                              GeoRadiusStoreParam storeParam)

georadiusByMemberStore

java.lang.Long georadiusByMemberStore(java.lang.String key,
                                      java.lang.String member,
                                      double radius,
                                      GeoUnit unit,
                                      GeoRadiusParam param,
                                      GeoRadiusStoreParam storeParam)