io.lettuce.core.api.reactive

Interface RedisStreamReactiveCommands<K,V>

Type Parameters:

K - Key type.

V - Value type.

All Known Subinterfaces:

RedisAdvancedClusterReactiveCommands<K,V>, RedisClusterPubSubReactiveCommands<K,V>, RedisClusterReactiveCommands<K,V>, RedisPubSubReactiveCommands<K,V>, RedisReactiveCommands<K,V>

All Known Implementing Classes:

AbstractRedisReactiveCommands, RedisAdvancedClusterReactiveCommandsImpl, RedisClusterPubSubReactiveCommandsImpl, RedisPubSubReactiveCommandsImpl, RedisReactiveCommandsImpl, RedisSentinelReactiveCommandsImpl

public interface RedisStreamReactiveCommands<K,V>

Reactive executed commands for Streams.

Since:

5.1

Author:

Mark Paluch

Generated class:

by io.lettuce.apigenerator.CreateReactiveApi

Method Summary

Modifier and Type	Method and Description
Mono<Long>	xack(K key, K group, String... messageIds) Acknowledge one or more messages as processed.
Mono<String>	xadd(K key, Map<K,V> body) Append a message to the stream key.
Mono<String>	xadd(K key, Object... keysAndValues) Append a message to the stream key.
Mono<String>	xadd(K key, XAddArgs args, Map<K,V> body) Append a message to the stream key.
Mono<String>	xadd(K key, XAddArgs args, Object... keysAndValues) Append a message to the stream key.
Flux<StreamMessage<K,V>>	xclaim(K key, Consumer<K> consumer, long minIdleTime, String... messageIds) Gets ownership of one or multiple messages in the Pending Entries List of a given stream consumer group.
Flux<StreamMessage<K,V>>	xclaim(K key, Consumer<K> consumer, XClaimArgs args, String... messageIds) Gets ownership of one or multiple messages in the Pending Entries List of a given stream consumer group.
Mono<Long>	xdel(K key, String... messageIds) Removes the specified entries from the stream.
Mono<String>	xgroupCreate(XReadArgs.StreamOffset<K> streamOffset, K group) Create a consumer group.
Mono<String>	xgroupCreate(XReadArgs.StreamOffset<K> streamOffset, K group, XGroupCreateArgs args) Create a consumer group.
Mono<Boolean>	xgroupDelconsumer(K key, Consumer<K> consumer) Delete a consumer from a consumer group.
Mono<Boolean>	xgroupDestroy(K key, K group) Destroy a consumer group.
Mono<String>	xgroupSetid(XReadArgs.StreamOffset<K> streamOffset, K group) Set the current group id.
Flux<Object>	xinfoConsumers(K key, K group) Retrieve information about consumer groups of group group and stream at key.
Flux<Object>	xinfoGroups(K key) Retrieve information about the stream consumer groups at key.
Flux<Object>	xinfoStream(K key) Retrieve information about the stream at key.
Mono<Long>	xlen(K key) Get the length of a steam.
Flux<Object>	xpending(K key, Consumer<K> consumer, Range<String> range, Limit limit) Read pending messages from a stream within a specific Range.
Flux<Object>	xpending(K key, K group) Read pending messages from a stream for a group.
Flux<Object>	xpending(K key, K group, Range<String> range, Limit limit) Read pending messages from a stream within a specific Range.
Flux<StreamMessage<K,V>>	xrange(K key, Range<String> range) Read messages from a stream within a specific Range.
Flux<StreamMessage<K,V>>	xrange(K key, Range<String> range, Limit limit) Read messages from a stream within a specific Range applying a Limit.
Flux<StreamMessage<K,V>>	xread(XReadArgs.StreamOffset<K>... streams) Read messages from one or more XReadArgs.StreamOffsets.
Flux<StreamMessage<K,V>>	xread(XReadArgs args, XReadArgs.StreamOffset<K>... streams) Read messages from one or more XReadArgs.StreamOffsets.
Flux<StreamMessage<K,V>>	xreadgroup(Consumer<K> consumer, XReadArgs.StreamOffset<K>... streams) Read messages from one or more XReadArgs.StreamOffsets using a consumer group.
Flux<StreamMessage<K,V>>	xreadgroup(Consumer<K> consumer, XReadArgs args, XReadArgs.StreamOffset<K>... streams) Read messages from one or more XReadArgs.StreamOffsets using a consumer group.
Flux<StreamMessage<K,V>>	xrevrange(K key, Range<String> range) Read messages from a stream within a specific Range in reverse order.
Flux<StreamMessage<K,V>>	xrevrange(K key, Range<String> range, Limit limit) Read messages from a stream within a specific Range applying a Limit in reverse order.
Mono<Long>	xtrim(K key, boolean approximateTrimming, long count) Trims the stream to count elements.
Mono<Long>	xtrim(K key, long count) Trims the stream to count elements.

Method Detail

xack

Mono<Long> xack(K key,
                K group,
                String... messageIds)

Acknowledge one or more messages as processed.

Parameters:

key - the stream key.

group - name of the consumer group.

messageIds - message Id's to acknowledge.

Returns:

simple-reply the lenght of acknowledged messages.

xadd

Mono<String> xadd(K key,
                  Map<K,V> body)

Append a message to the stream key.

Parameters:

key - the stream key.

body - message body.

Returns:

simple-reply the message Id.

xadd

Mono<String> xadd(K key,
                  XAddArgs args,
                  Map<K,V> body)

Append a message to the stream key.

Parameters:

key - the stream key.

args -

body - message body.

Returns:

simple-reply the message Id.

xadd

Mono<String> xadd(K key,
                  Object... keysAndValues)

Append a message to the stream key.

Parameters:

key - the stream key.

keysAndValues - message body.

Returns:

simple-reply the message Id.

xadd

Mono<String> xadd(K key,
                  XAddArgs args,
                  Object... keysAndValues)

Append a message to the stream key.

Parameters:

key - the stream key.

args -

keysAndValues - message body.

Returns:

simple-reply the message Id.

xclaim

Flux<StreamMessage<K,V>> xclaim(K key,
                                Consumer<K> consumer,
                                long minIdleTime,
                                String... messageIds)

Gets ownership of one or multiple messages in the Pending Entries List of a given stream consumer group.

Parameters:

key - the stream key.

consumer - consumer identified by group name and consumer key.

minIdleTime -

messageIds - message Id's to claim.

Returns:

simple-reply the StreamMessage.

xclaim

Flux<StreamMessage<K,V>> xclaim(K key,
                                Consumer<K> consumer,
                                XClaimArgs args,
                                String... messageIds)

Gets ownership of one or multiple messages in the Pending Entries List of a given stream consumer group.

Note that setting the JUSTID flag (calling this method with XClaimArgs.justid()) suppresses the message bode and StreamMessage.getBody() is null.

Parameters:

key - the stream key.

consumer - consumer identified by group name and consumer key.

args -

messageIds - message Id's to claim.

Returns:

simple-reply the StreamMessage.

xdel

Mono<Long> xdel(K key,
                String... messageIds)

Removes the specified entries from the stream. Returns the number of items deleted, that may be different from the number of IDs passed in case certain IDs do not exist.

Parameters:

key - the stream key.

messageIds - stream message Id's.

Returns:

simple-reply number of removed entries.

xgroupCreate

Mono<String> xgroupCreate(XReadArgs.StreamOffset<K> streamOffset,
                          K group)

Create a consumer group.

Parameters:

streamOffset - name of the stream containing the offset to set.

group - name of the consumer group.

Returns:

simple-reply true if successful.

xgroupCreate

Mono<String> xgroupCreate(XReadArgs.StreamOffset<K> streamOffset,
                          K group,
                          XGroupCreateArgs args)

Create a consumer group.

Parameters:

streamOffset - name of the stream containing the offset to set.

group - name of the consumer group.

args -

Returns:

simple-reply true if successful.

Since:

5.2

xgroupDelconsumer

Mono<Boolean> xgroupDelconsumer(K key,
                                Consumer<K> consumer)

Delete a consumer from a consumer group.

Parameters:

key - the stream key.

consumer - consumer identified by group name and consumer key.

Returns:

simple-reply true if successful.

xgroupDestroy

Mono<Boolean> xgroupDestroy(K key,
                            K group)

Destroy a consumer group.

Parameters:

key - the stream key.

group - name of the consumer group.

Returns:

simple-reply true if successful.

xgroupSetid

Mono<String> xgroupSetid(XReadArgs.StreamOffset<K> streamOffset,
                         K group)

Set the current group id.

Parameters:

streamOffset - name of the stream containing the offset to set.

group - name of the consumer group.

Returns:

simple-reply OK.

xinfoStream

Flux<Object> xinfoStream(K key)

Retrieve information about the stream at key.

Parameters:

key - the stream key.

Returns:

Object array-reply.

Since:

5.2

xinfoGroups

Flux<Object> xinfoGroups(K key)

Retrieve information about the stream consumer groups at key.

Parameters:

key - the stream key.

Returns:

Object array-reply.

Since:

5.2

xinfoConsumers

Flux<Object> xinfoConsumers(K key,
                            K group)

Retrieve information about consumer groups of group group and stream at key.

Parameters:

key - the stream key.

group - name of the consumer group.

Returns:

Object array-reply.

Since:

5.2

xlen

Mono<Long> xlen(K key)

Get the length of a steam.

Parameters:

key - the stream key.

Returns:

simple-reply the lenght of the stream.

xpending

Flux<Object> xpending(K key,
                      K group)

Read pending messages from a stream for a group.

Parameters:

key - the stream key.

group - name of the consumer group.

Returns:

Object array-reply list pending entries.

xpending

Flux<Object> xpending(K key,
                      K group,
                      Range<String> range,
                      Limit limit)

Read pending messages from a stream within a specific Range.

Parameters:

key - the stream key.

group - name of the consumer group.

range - must not be null.

limit - must not be null.

Returns:

Object array-reply list with members of the resulting stream.

xpending

Flux<Object> xpending(K key,
                      Consumer<K> consumer,
                      Range<String> range,
                      Limit limit)

Read pending messages from a stream within a specific Range.

Parameters:

key - the stream key.

consumer - consumer identified by group name and consumer key.

range - must not be null.

limit - must not be null.

Returns:

Object array-reply list with members of the resulting stream.

xrange

Flux<StreamMessage<K,V>> xrange(K key,
                                Range<String> range)

Read messages from a stream within a specific Range.

Parameters:

key - the stream key.

range - must not be null.

Returns:

StreamMessage array-reply list with members of the resulting stream.

xrange

Flux<StreamMessage<K,V>> xrange(K key,
                                Range<String> range,
                                Limit limit)

Read messages from a stream within a specific Range applying a Limit.

Parameters:

key - the stream key.

range - must not be null.

limit - must not be null.

Returns:

StreamMessage array-reply list with members of the resulting stream.

xread

Flux<StreamMessage<K,V>> xread(XReadArgs.StreamOffset<K>... streams)

Read messages from one or more XReadArgs.StreamOffsets.

Parameters:

streams - the streams to read from.

Returns:

StreamMessage array-reply list with members of the resulting stream.

xread

Flux<StreamMessage<K,V>> xread(XReadArgs args,
                               XReadArgs.StreamOffset<K>... streams)

Read messages from one or more XReadArgs.StreamOffsets.

Parameters:

args - read arguments.

streams - the streams to read from.

Returns:

StreamMessage array-reply list with members of the resulting stream.

xreadgroup

Flux<StreamMessage<K,V>> xreadgroup(Consumer<K> consumer,
                                    XReadArgs.StreamOffset<K>... streams)

Read messages from one or more XReadArgs.StreamOffsets using a consumer group.

Parameters:

consumer - consumer/group.

streams - the streams to read from.

Returns:

StreamMessage array-reply list with members of the resulting stream.

xreadgroup

Flux<StreamMessage<K,V>> xreadgroup(Consumer<K> consumer,
                                    XReadArgs args,
                                    XReadArgs.StreamOffset<K>... streams)

Read messages from one or more XReadArgs.StreamOffsets using a consumer group.

Parameters:

consumer - consumer/group.

args - read arguments.

streams - the streams to read from.

Returns:

StreamMessage array-reply list with members of the resulting stream.

xrevrange

Flux<StreamMessage<K,V>> xrevrange(K key,
                                   Range<String> range)

Read messages from a stream within a specific Range in reverse order.

Parameters:

key - the stream key.

range - must not be null.

Returns:

StreamMessage array-reply list with members of the resulting stream.

xrevrange

Flux<StreamMessage<K,V>> xrevrange(K key,
                                   Range<String> range,
                                   Limit limit)

Read messages from a stream within a specific Range applying a Limit in reverse order.

Parameters:

key - the stream key.

range - must not be null.

limit - must not be null.

Returns:

StreamMessage array-reply list with members of the resulting stream.

xtrim

Mono<Long> xtrim(K key,
                 long count)

Trims the stream to count elements.

Parameters:

key - the stream key.

count - length of the stream.

Returns:

simple-reply number of removed entries.

xtrim

Mono<Long> xtrim(K key,
                 boolean approximateTrimming,
                 long count)

Trims the stream to count elements.

Parameters:

key - the stream key.

approximateTrimming - true to trim approximately using the ~ flag.

count - length of the stream.

Returns:

simple-reply number of removed entries.