All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.redisson.api.RStreamAsync Maven / Gradle / Ivy

Go to download

Easy Redis Java client and Real-Time Data Platform. Valkey compatible. Sync/Async/RxJava3/Reactive API. Client side caching. Over 50 Redis based Java objects and services: JCache API, Apache Tomcat, Hibernate, Spring, Set, Multimap, SortedSet, Map, List, Queue, Deque, Semaphore, Lock, AtomicLong, Map Reduce, Bloom filter, Scheduler, RPC

There is a newer version: 3.40.2
Show newest version
/**
 * Copyright (c) 2013-2024 Nikita Koksharov
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.redisson.api;

import org.redisson.api.stream.*;

import java.util.List;
import java.util.Map;
import java.util.concurrent.TimeUnit;

/**
 * Async interface for Redis Stream object.
 * 

* Requires Redis 5.0.0 and higher. * * @author Nikita Koksharov * * @param key type * @param value type */ public interface RStreamAsync extends RExpirableAsync { /** * Creates consumer group. *

* Usage examples: *

     * StreamMessageId id = stream.createGroup(StreamCreateGroupArgs.name("test").id(id).makeStream());
     * 
* * @param args method arguments object */ RFuture createGroupAsync(StreamCreateGroupArgs args); /** * Removes group by name. * * @param groupName - name of group * @return void */ RFuture removeGroupAsync(String groupName); /** * Creates consumer of the group by name. *

* Requires Redis 6.2.0 and higher. * * @param groupName - name of group * @param consumerName - name of consumer */ RFuture createConsumerAsync(String groupName, String consumerName); /** * Removes consumer of the group by name. * * @param groupName - name of group * @param consumerName - name of consumer * @return number of pending messages owned by consumer */ RFuture removeConsumerAsync(String groupName, String consumerName); /** * Updates next message id delivered to consumers. * * @param groupName - name of group * @param id - Stream Message ID * @return void */ RFuture updateGroupMessageIdAsync(String groupName, StreamMessageId id); /** * Marks pending messages by group name and stream ids as correctly processed. * * @param groupName - name of group * @param ids - stream ids * @return marked messages amount */ RFuture ackAsync(String groupName, StreamMessageId... ids); /** * Returns common info about pending messages by group name. * * @param groupName - name of group * @return result object */ RFuture getPendingInfoAsync(String groupName); /** * Returns list of common info about pending messages by group name. * Limited by minimum idle time, messages count, start and end Stream Message IDs. *

* {@link StreamMessageId#MAX} is used as max Stream Message ID * {@link StreamMessageId#MIN} is used as min Stream Message ID *

* Requires Redis 6.2.0 and higher. * * @see #pendingRangeAsync * * @param groupName - name of group * @param startId - start Stream Message ID * @param idleTime - minimum idle time of messages * @param idleTimeUnit - idle time unit * @param endId - end Stream Message ID * @param count - amount of messages * @return list */ RFuture> listPendingAsync(String groupName, StreamMessageId startId, StreamMessageId endId, long idleTime, TimeUnit idleTimeUnit, int count); /** * Returns list of common info about pending messages by group and consumer name. * Limited by minimum idle time, messages count, start and end Stream Message IDs. *

* {@link StreamMessageId#MAX} is used as max Stream Message ID * {@link StreamMessageId#MIN} is used as min Stream Message ID *

* Requires Redis 6.2.0 and higher. * * @see #pendingRangeAsync * * @param consumerName - name of consumer * @param groupName - name of group * @param startId - start Stream Message ID * @param endId - end Stream Message ID * @param idleTime - minimum idle time of messages * @param idleTimeUnit - idle time unit * @param count - amount of messages * @return list */ RFuture> listPendingAsync(String groupName, String consumerName, StreamMessageId startId, StreamMessageId endId, long idleTime, TimeUnit idleTimeUnit, int count); /** * Returns list of common info about pending messages by group name. * Limited by start Stream Message ID and end Stream Message ID and count. *

* {@link StreamMessageId#MAX} is used as max Stream Message ID * {@link StreamMessageId#MIN} is used as min Stream Message ID * * @see #pendingRangeAsync * * @param groupName - name of group * @param startId - start Stream Message ID * @param endId - end Stream Message ID * @param count - amount of messages * @return list */ RFuture> listPendingAsync(String groupName, StreamMessageId startId, StreamMessageId endId, int count); /** * Returns list of common info about pending messages by group and consumer name. * Limited by start Stream Message ID and end Stream Message ID and count. *

* {@link StreamMessageId#MAX} is used as max Stream Message ID * {@link StreamMessageId#MIN} is used as min Stream Message ID * * @see #pendingRangeAsync * * @param consumerName - name of consumer * @param groupName - name of group * @param startId - start Stream Message ID * @param endId - end Stream Message ID * @param count - amount of messages * @return list */ RFuture> listPendingAsync(String groupName, String consumerName, StreamMessageId startId, StreamMessageId endId, int count); /** * Returns stream data of pending messages by group name. * Limited by start Stream Message ID and end Stream Message ID and count. *

* {@link StreamMessageId#MAX} is used as max Stream Message ID * {@link StreamMessageId#MIN} is used as min Stream Message ID * * @see #listPendingAsync * * @param groupName - name of group * @param startId - start Stream Message ID * @param endId - end Stream Message ID * @param count - amount of messages * @return map */ RFuture>> pendingRangeAsync(String groupName, StreamMessageId startId, StreamMessageId endId, int count); /** * Returns stream data of pending messages by group and customer name. * Limited by start Stream Message ID and end Stream Message ID and count. *

* {@link StreamMessageId#MAX} is used as max Stream Message ID * {@link StreamMessageId#MIN} is used as min Stream Message ID * * @see #listPendingAsync * * @param consumerName - name of consumer * @param groupName - name of group * @param startId - start Stream Message ID * @param endId - end Stream Message ID * @param count - amount of messages * @return map */ RFuture>> pendingRangeAsync(String groupName, String consumerName, StreamMessageId startId, StreamMessageId endId, int count); /** * Returns stream data of pending messages by group name. * Limited by minimum idle time, messages count, start and end Stream Message IDs. *

* {@link StreamMessageId#MAX} is used as max Stream Message ID * {@link StreamMessageId#MIN} is used as min Stream Message ID *

* Requires Redis 6.2.0 and higher. * * @see #listPendingAsync * * @param groupName - name of group * @param startId - start Stream Message ID * @param endId - end Stream Message ID * @param idleTime - minimum idle time of messages * @param idleTimeUnit - idle time unit * @param count - amount of messages * @return map */ RFuture>> pendingRangeAsync(String groupName, StreamMessageId startId, StreamMessageId endId, long idleTime, TimeUnit idleTimeUnit, int count); /** * Returns stream data of pending messages by group and customer name. * Limited by minimum idle time, messages count, start and end Stream Message IDs. *

* {@link StreamMessageId#MAX} is used as max Stream Message ID * {@link StreamMessageId#MIN} is used as min Stream Message ID *

* Requires Redis 6.2.0 and higher. * * @see #listPendingAsync * * @param consumerName - name of consumer * @param groupName - name of group * @param startId - start Stream Message ID * @param endId - end Stream Message ID * @param idleTime - minimum idle time of messages * @param idleTimeUnit - idle time unit * @param count - amount of messages * @return map */ RFuture>> pendingRangeAsync(String groupName, String consumerName, StreamMessageId startId, StreamMessageId endId, long idleTime, TimeUnit idleTimeUnit, int count); /** * Transfers ownership of pending messages by id to a new consumer * by name if idle time of messages and startId are greater than defined value. * * @param groupName - name of group * @param consumerName - name of consumer * @param idleTime - minimum idle time of messages * @param idleTimeUnit - idle time unit * @param startId - start Stream Message ID * @return stream data mapped by Stream ID */ RFuture> autoClaimAsync(String groupName, String consumerName, long idleTime, TimeUnit idleTimeUnit, StreamMessageId startId, int count); /** * Transfers ownership of pending messages by id to a new consumer * by name if idle time of messages and startId are greater than defined value. * * @param groupName - name of group * @param consumerName - name of consumer * @param idleTime - minimum idle time of messages * @param idleTimeUnit - idle time unit * @param startId - start Stream Message ID * @return list of Stream Message IDs */ RFuture fastAutoClaimAsync(String groupName, String consumerName, long idleTime, TimeUnit idleTimeUnit, StreamMessageId startId, int count); /** * Transfers ownership of pending messages by id to a new consumer * by name if idle time of messages is greater than defined value. * * @param groupName - name of group * @param consumerName - name of consumer * @param idleTime - minimum idle time of messages * @param idleTimeUnit - idle time unit * @param ids - Stream Message IDs * @return stream data mapped by Stream ID */ RFuture>> claimAsync(String groupName, String consumerName, long idleTime, TimeUnit idleTimeUnit, StreamMessageId... ids); /** * Transfers ownership of pending messages by id to a new consumer * by name if idle time of messages is greater than defined value. * * @param groupName - name of group * @param consumerName - name of consumer * @param idleTime - minimum idle time of messages * @param idleTimeUnit - idle time unit * @param ids - Stream Message IDs * @return list of Stream Message IDs */ RFuture> fastClaimAsync(String groupName, String consumerName, long idleTime, TimeUnit idleTimeUnit, StreamMessageId... ids); /** * Read stream data from consumer group and multiple streams including current. * * @param args - method arguments object * @return stream data mapped by stream name and Stream Message ID */ RFuture>>> readGroupAsync(String groupName, String consumerName, StreamMultiReadGroupArgs args); /** * Read stream data from consumer group and current stream only. * * @param args - method arguments object * @return stream data mapped by Stream Message ID */ RFuture>> readGroupAsync(String groupName, String consumerName, StreamReadGroupArgs args); /** * Returns number of entries in stream * * @return size of stream */ RFuture sizeAsync(); /** * Appends a new entry/entries and returns generated Stream Message ID * * @param args - method arguments object * @return Stream Message ID */ RFuture addAsync(StreamAddArgs args); /** * Appends a new entry/entries by specified Stream Message ID * * @param id - Stream Message ID * @param args - method arguments object */ RFuture addAsync(StreamMessageId id, StreamAddArgs args); /** * Read stream data from multiple streams including current. * * @param args - method arguments object * @return stream data mapped by stream name and Stream Message ID */ RFuture>>> readAsync(StreamMultiReadArgs args); /** * Read stream data from current stream only. * * @param args - method arguments object * @return stream data mapped by Stream Message ID */ RFuture>> readAsync(StreamReadArgs args); /** * Returns stream data in range by specified start Stream ID (included) and end Stream ID (included). * * @param startId - start Stream ID * @param endId - end Stream ID * @return stream data mapped by Stream ID */ RFuture>> rangeAsync(StreamMessageId startId, StreamMessageId endId); /** * Returns stream data in range by specified start Stream ID (included) and end Stream ID (included). * * @param count - stream data size limit * @param startId - start Stream ID * @param endId - end Stream ID * @return stream data mapped by Stream ID */ RFuture>> rangeAsync(int count, StreamMessageId startId, StreamMessageId endId); /** * Returns stream data in reverse order in range by specified start Stream ID (included) and end Stream ID (included). * * @param startId - start Stream ID * @param endId - end Stream ID * @return stream data mapped by Stream ID */ RFuture>> rangeReversedAsync(StreamMessageId startId, StreamMessageId endId); /** * Returns stream data in reverse order in range by specified start Stream ID (included) and end Stream ID (included). * * @param count - stream data size limit * @param startId - start Stream ID * @param endId - end Stream ID * @return stream data mapped by Stream ID */ RFuture>> rangeReversedAsync(int count, StreamMessageId startId, StreamMessageId endId); /** * Removes messages by id. * * @param ids - id of messages to remove * @return deleted messages amount */ RFuture removeAsync(StreamMessageId... ids); RFuture trimAsync(StreamTrimArgs args); RFuture trimNonStrictAsync(StreamTrimArgs args); /** * Returns information about this stream. * * @return info object */ RFuture> getInfoAsync(); /** * Returns list of objects with information about groups belonging to this stream. * * @return list of info objects */ RFuture> listGroupsAsync(); /** * Returns list of objects with information about group customers for specified groupName. * * @param groupName - name of group * @return list of info objects */ RFuture> listConsumersAsync(String groupName); /** * Adds object event listener * * @see org.redisson.api.listener.TrackingListener * @see org.redisson.api.listener.StreamAddListener * @see org.redisson.api.listener.StreamRemoveListener * @see org.redisson.api.listener.StreamCreateGroupListener * @see org.redisson.api.listener.StreamRemoveGroupListener * @see org.redisson.api.listener.StreamCreateConsumerListener * @see org.redisson.api.listener.StreamRemoveConsumerListener * @see org.redisson.api.listener.StreamTrimListener * @see org.redisson.api.ExpiredObjectListener * @see org.redisson.api.DeletedObjectListener * * @param listener object event listener * @return listener id */ RFuture addListenerAsync(ObjectListener listener); }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy