Package io.quarkus.redis.datasource.keys
Interface KeyCommands<K>
- Type Parameters:
K
- the type of the keys, oftenString
- All Superinterfaces:
RedisCommands
- All Known Implementing Classes:
BlockingKeyCommandsImpl
Allows executing commands manipulating keys.
See the generic command list for further information about these
commands.
-
Method Summary
Modifier and TypeMethodDescriptionboolean
Execute the command COPY.boolean
Execute the command COPY.int
Execute the command DEL.Execute the command DUMP.boolean
Execute the command EXISTS.int
Execute the command EXISTS.boolean
Execute the command EXPIRE.boolean
expire
(K key, long seconds, ExpireArgs expireArgs) Execute the command EXPIRE.boolean
Execute the command EXPIRE.boolean
expire
(K key, Duration duration, ExpireArgs expireArgs) Execute the command EXPIRE.boolean
Execute the command EXPIREAT.boolean
expireat
(K key, long timestamp, ExpireArgs expireArgs) Execute the command EXPIREAT.boolean
Execute the command EXPIREAT.boolean
expireat
(K key, Instant timestamp, ExpireArgs expireArgs) Execute the command EXPIREAT.long
expiretime
(K key) Execute the command EXPIRETIME.Execute the command KEYS.boolean
Execute the command MOVE.boolean
Execute the command PERSIST.boolean
Execute the command PEXPIRE.boolean
pexpire
(K key, long milliseconds, ExpireArgs expireArgs) Execute the command PEXPIRE.boolean
Execute the command PEXPIRE.boolean
pexpire
(K key, Duration duration, ExpireArgs expireArgs) Execute the command PEXPIRE.boolean
Execute the command PEXPIREAT.boolean
pexpireat
(K key, long timestamp, ExpireArgs expireArgs) Execute the command PEXPIREAT.boolean
Execute the command PEXPIREAT.boolean
pexpireat
(K key, Instant timestamp, ExpireArgs expireArgs) Execute the command PEXPIREAT.long
pexpiretime
(K key) Execute the command PEXPIRETIME.long
Execute the command PTTL.Execute the command RANDOMKEY.void
Execute the command RENAME.boolean
Execute the command RENAMENX.scan()
Execute the command SCAN.scan
(KeyScanArgs args) Execute the command SCAN.int
Execute the command TOUCH.long
Execute the command TTL.Execute the command TYPE.int
Execute the command UNLINK.Methods inherited from interface io.quarkus.redis.datasource.RedisCommands
getDataSource
-
Method Details
-
copy
Execute the command COPY. Summary: Copy a key Group: generic Requires Redis 6.2.0- Parameters:
source
- the keydestination
- the key- Returns:
true
source was copied.false
source was not copied.
-
copy
Execute the command COPY. Summary: Copy a key Group: generic Requires Redis 6.2.0- Parameters:
source
- the keydestination
- the keycopyArgs
- the additional arguments- Returns:
true
source was copied.false
source was not copied.
-
del
Execute the command DEL. Summary: Delete one or multiple keys Group: generic Requires Redis 1.0.0- Parameters:
keys
- the keys.- Returns:
- The number of keys that were removed.
-
dump
Execute the command DUMP. Summary: Return a serialized version of the value stored at the specified key. Group: generic Requires Redis 2.6.0- Parameters:
key
- the key- Returns:
- the serialized value.
-
exists
Execute the command EXISTS. Summary: Determine if a key exists Group: generic Requires Redis 1.0.0- Parameters:
key
- the key to check- Returns:
true
if the key exists,false
otherwise
-
exists
Execute the command EXISTS. Summary: Determine if a key exists Group: generic Requires Redis 1.0.0- Parameters:
keys
- the keys to check- Returns:
- the number of keys that exist from those specified as arguments.
-
expire
Execute the command EXPIRE. Summary: Set a key's time to live in seconds Group: generic Requires Redis 1.0.0- Parameters:
key
- the keyseconds
- the new TTLexpireArgs
- theEXPIRE
command extra-arguments- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist, or operation skipped due to the provided arguments.
-
expire
Execute the command EXPIRE. Summary: Set a key's time to live in seconds Group: generic Requires Redis 1.0.0- Parameters:
key
- the keyduration
- the new TTLexpireArgs
- theEXPIRE
command extra-arguments- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist, or operation skipped due to the provided arguments.
-
expire
Execute the command EXPIRE. Summary: Set a key's time to live in seconds Group: generic Requires Redis 1.0.0- Parameters:
key
- the keyseconds
- the new TTL- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist.
-
expire
Execute the command EXPIRE. Summary: Set a key's time to live in seconds Group: generic Requires Redis 1.0.0- Parameters:
key
- the keyduration
- the new TTL- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist.
-
expireat
Execute the command EXPIREAT. Summary: Set the expiration for a key as a UNIX timestamp Group: generic Requires Redis 1.2.0- Parameters:
key
- the keytimestamp
- the timestamp- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist.
-
expireat
Execute the command EXPIREAT. Summary: Set the expiration for a key as a UNIX timestamp Group: generic Requires Redis 1.2.0- Parameters:
key
- the keytimestamp
- the timestamp- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist.
-
expireat
Execute the command EXPIREAT. Summary: Set the expiration for a key as a UNIX timestamp Group: generic Requires Redis 1.2.0- Parameters:
key
- the keytimestamp
- the timestampexpireArgs
- theEXPIREAT
command extra-arguments- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist, or operation skipped due to the provided arguments.
-
expireat
Execute the command EXPIREAT. Summary: Set the expiration for a key as a UNIX timestamp Group: generic Requires Redis 1.2.0- Parameters:
key
- the keytimestamp
- the timestampexpireArgs
- theEXPIREAT
command extra-arguments- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist, or operation skipped due to the provided arguments.
-
expiretime
Execute the command EXPIRETIME. Summary: Get the expiration Unix timestamp for a key Group: generic Requires Redis 7.0.0- Parameters:
key
- the key- Returns:
- the expiration Unix timestamp in seconds,
-1
if the key exists but has no associated expiration time. - Throws:
RedisKeyNotFoundException
- if the key does not exist
-
keys
Execute the command KEYS. Summary: Find all keys matching the given pattern Group: generic Requires Redis 1.0.0- Parameters:
pattern
- the glob-style pattern- Returns:
- the list of keys matching pattern.
-
move
Execute the command MOVE. Summary: Move a key to another database Group: generic Requires Redis 1.0.0- Parameters:
key
- the key- Returns:
true
key was moved.false
key was not moved.
-
persist
Execute the command PERSIST. Summary: Remove the expiration from a key Group: generic Requires Redis 2.2.0- Parameters:
key
- the key- Returns:
true
the timeout was removed.false
key does not exist or does not have an associated timeout.
-
pexpire
Execute the command PEXPIRE. Summary: Set a key's time to live in milliseconds Group: generic Requires Redis 2.6.0- Parameters:
key
- the keyduration
- the new TTLexpireArgs
- thePEXPIRE
command extra-arguments- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist, or operation skipped due to the provided arguments.
-
pexpire
Execute the command PEXPIRE. Summary: Set a key's time to live in milliseconds Group: generic Requires Redis 2.6.0- Parameters:
key
- the keyms
- the new TTL- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist.
-
pexpire
Execute the command PEXPIRE. Summary: Set a key's time to live in milliseconds Group: generic Requires Redis 2.6.0- Parameters:
key
- the keyduration
- the new TTL- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist.
-
pexpire
Execute the command PEXPIRE. Summary: Set a key's time to live in milliseconds Group: generic Requires Redis 2.6.0- Parameters:
key
- the keymilliseconds
- the new TTLexpireArgs
- thePEXPIRE
command extra-arguments- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist.
-
pexpireat
Execute the command PEXPIREAT. Summary: Set the expiration for a key as a UNIX timestamp Group: generic Requires Redis 2.6.0- Parameters:
key
- the keytimestamp
- the timestamp- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist.
-
pexpireat
Execute the command PEXPIREAT. Summary: Set the expiration for a key as a UNIX timestamp Group: generic Requires Redis 2.6.0- Parameters:
key
- the keytimestamp
- the timestamp- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist.
-
pexpireat
Execute the command PEXPIREAT. Summary: Set the expiration for a key as a UNIX timestamp Group: generic Requires Redis 2.6.0- Parameters:
key
- the keytimestamp
- the timestampexpireArgs
- theEXPIREAT
command extra-arguments- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist, or operation skipped due to the provided arguments.
-
pexpireat
Execute the command PEXPIREAT. Summary: Set the expiration for a key as a UNIX timestamp Group: generic Requires Redis 2.6.0- Parameters:
key
- the keytimestamp
- the timestampexpireArgs
- theEXPIREAT
command extra-arguments- Returns:
true
the timeout was set.false
the timeout was not set. e.g. key doesn't exist, or operation skipped due to the provided arguments.
-
pexpiretime
Execute the command PEXPIRETIME. Summary: Get the expiration Unix timestamp for a key Group: generic Requires Redis 2.6.0- Parameters:
key
- the key- Returns:
- the expiration Unix timestamp in milliseconds;
-1
if the key exists but has no associated expiration time. - Throws:
RedisKeyNotFoundException
- if the key does not exist
-
pttl
Execute the command PTTL. Summary: Get the time to live for a key in milliseconds Group: generic Requires Redis 2.6.0- Parameters:
key
- the key- Returns:
- TTL in milliseconds. The command returns
-1
if the key exists but has no associated expire. - Throws:
RedisKeyNotFoundException
- if the key does not exist
-
randomkey
K randomkey()Execute the command RANDOMKEY. Summary: Return a random key from the keyspace Group: generic Requires Redis 1.0.0- Returns:
- the random key, or
null
when the database is empty.
-
rename
Execute the command RENAME. Summary: Rename a key Group: generic Requires Redis 1.0.0- Parameters:
key
- the keynewkey
- the new key
-
renamenx
Execute the command RENAMENX. Summary: Rename a key, only if the new key does not exist Group: generic Requires Redis 1.0.0- Parameters:
key
- the keynewkey
- the new key- Returns:
true
ifkey
was renamed tonewkey
.false
ifnewkey
already exists.
-
scan
KeyScanCursor<K> scan()Execute the command SCAN. Summary: Incrementally iterate the keys space Group: generic Requires Redis 2.8.0- Returns:
- the cursor.
-
scan
Execute the command SCAN. Summary: Incrementally iterate the keys space Group: generic Requires Redis 2.8.0- Parameters:
args
- the extra arguments- Returns:
- the cursor.
-
touch
Execute the command TOUCH. Summary: Alters the last access time of a key(s). Returns the number of existing keys specified. Group: generic Requires Redis 3.2.1- Parameters:
keys
- the keys- Returns:
- The number of keys that were touched.
-
ttl
Execute the command TTL. Summary: Get the time to live for a key in seconds Group: generic Requires Redis 1.0.0- Parameters:
key
- the key- Returns:
- TTL in seconds,
-1
if the key exists but has no associated expire. - Throws:
RedisKeyNotFoundException
- if the key does not exist
-
type
Execute the command TYPE. Summary: Determine the type stored at key Group: generic Requires Redis 1.0.0- Parameters:
key
- the key- Returns:
- type of key, or
NONE
when key does not exist.
-
unlink
Execute the command UNLINK. Summary: Delete a key asynchronously in another thread. Otherwise, it is just asDEL
, but non-blocking. Group: generic Requires Redis 4.0.0- Parameters:
keys
- the keys- Returns:
- The number of keys that were unlinked.
-