com.github.lontime.shaded.org.redisson.api.RedissonClient Maven / Gradle / Ivy
/**
* Copyright (c) 2013-2021 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 com.github.lontime.shaded.org.redisson.api;
import com.github.lontime.shaded.org.redisson.api.redisnode.BaseRedisNodes;
import com.github.lontime.shaded.org.redisson.api.redisnode.RedisNodes;
import com.github.lontime.shaded.org.redisson.client.codec.Codec;
import com.github.lontime.shaded.org.redisson.codec.JsonCodec;
import com.github.lontime.shaded.org.redisson.config.Config;
import java.util.concurrent.TimeUnit;
/**
* Main Redisson interface for access
* to all redisson objects with sync/async interface.
*
* @see RedissonReactiveClient
* @see RedissonRxClient
*
* @author Nikita Koksharov
*
*/
public interface RedissonClient {
/**
* Returns time-series instance by name
*
* @param type of value
* @param name - name of instance
* @return RTimeSeries object
*/
RTimeSeries getTimeSeries(String name);
/**
* Returns time-series instance by name
* using provided codec for values.
*
* @param type of value
* @param name - name of instance
* @param codec - codec for values
* @return RTimeSeries object
*/
RTimeSeries getTimeSeries(String name, Codec codec);
/**
* Returns stream instance by name
*
* Requires Redis 5.0.0 and higher.
*
* @param type of key
* @param type of value
* @param name of stream
* @return RStream object
*/
RStream getStream(String name);
/**
* Returns stream instance by name
* using provided codec for entries.
*
* Requires Redis 5.0.0 and higher.
*
* @param type of key
* @param type of value
* @param name - name of stream
* @param codec - codec for entry
* @return RStream object
*/
RStream getStream(String name, Codec codec);
/**
* Returns rate limiter instance by name
*
* @param name of rate limiter
* @return RateLimiter object
*/
RRateLimiter getRateLimiter(String name);
/**
* Returns binary stream holder instance by name
*
* @param name of binary stream
* @return BinaryStream object
*/
RBinaryStream getBinaryStream(String name);
/**
* Returns geospatial items holder instance by name.
*
* @param type of value
* @param name - name of object
* @return Geo object
*/
RGeo getGeo(String name);
/**
* Returns geospatial items holder instance by name
* using provided codec for geospatial members.
*
* @param type of value
* @param name - name of object
* @param codec - codec for value
* @return Geo object
*/
RGeo getGeo(String name, Codec codec);
/**
* Returns set-based cache instance by name.
* Supports value eviction with a given TTL value.
*
* If eviction is not required then it's better to use regular map {@link #getSet(String, Codec)}.
*
* @param type of value
* @param name - name of object
* @return SetCache object
*/
RSetCache getSetCache(String name);
/**
* Returns set-based cache instance by name.
* Supports value eviction with a given TTL value.
*
* If eviction is not required then it's better to use regular map {@link #getSet(String, Codec)}.
*
* @param type of value
* @param name - name of object
* @param codec - codec for values
* @return SetCache object
*/
RSetCache getSetCache(String name, Codec codec);
/**
* Returns map-based cache instance by name
* using provided codec for both cache keys and values.
* Supports entry eviction with a given MaxIdleTime and TTL settings.
*
* If eviction is not required then it's better to use regular map {@link #getMap(String, Codec)}.
*
* @param type of key
* @param type of value
* @param name - object name
* @param codec - codec for keys and values
* @return MapCache object
*/
RMapCache getMapCache(String name, Codec codec);
/**
* Returns map-based cache instance by name
* using provided codec for both cache keys and values.
* Supports entry eviction with a given MaxIdleTime and TTL settings.
*
* If eviction is not required then it's better to use regular map {@link #getMap(String, Codec)}.
*
* @param type of key
* @param type of value
* @param name - object name
* @param codec - codec for keys and values
* @param options - map options
* @return MapCache object
*/
RMapCache getMapCache(String name, Codec codec, MapOptions options);
/**
* Returns map-based cache instance by name.
* Supports entry eviction with a given MaxIdleTime and TTL settings.
*
* If eviction is not required then it's better to use regular map {@link #getMap(String)}.
*
* @param type of key
* @param type of value
* @param name - name of object
* @return MapCache object
*/
RMapCache getMapCache(String name);
/**
* Returns map-based cache instance by name.
* Supports entry eviction with a given MaxIdleTime and TTL settings.
*
* If eviction is not required then it's better to use regular map {@link #getMap(String)}.
*
* @param type of key
* @param type of value
* @param name - name of object
* @param options - map options
* @return MapCache object
*/
RMapCache getMapCache(String name, MapOptions options);
/**
* Returns object holder instance by name.
*
* @param type of value
* @param name - name of object
* @return Bucket object
*/
RBucket getBucket(String name);
/**
* Returns object holder instance by name
* using provided codec for object.
*
* @param type of value
* @param name - name of object
* @param codec - codec for values
* @return Bucket object
*/
RBucket getBucket(String name, Codec codec);
/**
* Returns interface for mass operations with Bucket objects.
*
* @return Buckets
*/
RBuckets getBuckets();
/**
* Returns interface for mass operations with Bucket objects
* using provided codec for object.
*
* @param codec - codec for bucket objects
* @return Buckets
*/
RBuckets getBuckets(Codec codec);
/**
* Returns JSON data holder instance by name using provided codec.
*
* @param type of value
* @param name name of object
* @param codec codec for values
* @return JsonBucket object
*/
RJsonBucket getJsonBucket(String name, JsonCodec codec);
/**
* Returns HyperLogLog instance by name.
*
* @param type of value
* @param name - name of object
* @return HyperLogLog object
*/
RHyperLogLog getHyperLogLog(String name);
/**
* Returns HyperLogLog instance by name
* using provided codec for hll objects.
*
* @param type of value
* @param name - name of object
* @param codec - codec for values
* @return HyperLogLog object
*/
RHyperLogLog getHyperLogLog(String name, Codec codec);
/**
* Returns list instance by name.
*
* @param type of value
* @param name - name of object
* @return List object
*/
RList getList(String name);
/**
* Returns list instance by name
* using provided codec for list objects.
*
* @param type of value
* @param name - name of object
* @param codec - codec for values
* @return List object
*/
RList getList(String name, Codec codec);
/**
* Returns List based Multimap instance by name.
*
* @param type of key
* @param type of value
* @param name - name of object
* @return ListMultimap object
*/
RListMultimap getListMultimap(String name);
/**
* Returns List based Multimap instance by name
* using provided codec for both map keys and values.
*
* @param type of key
* @param type of value
* @param name - name of object
* @param codec - codec for keys and values
* @return ListMultimap object
*/
RListMultimap getListMultimap(String name, Codec codec);
/**
* Returns List based Multimap instance by name.
* Supports key-entry eviction with a given TTL value.
*
* If eviction is not required then it's better to use regular map {@link #getSetMultimap(String)}.
*
* @param type of key
* @param type of value
* @param name - name of object
* @return ListMultimapCache object
*/
RListMultimapCache getListMultimapCache(String name);
/**
* Returns List based Multimap instance by name
* using provided codec for both map keys and values.
* Supports key-entry eviction with a given TTL value.
*
* If eviction is not required then it's better to use regular map {@link #getSetMultimap(String, Codec)}.
*
* @param type of key
* @param type of value
* @param name - name of object
* @param codec - codec for keys and values
* @return ListMultimapCache object
*/
RListMultimapCache getListMultimapCache(String name, Codec codec);
/**
* Returns local cached map instance by name.
* Configured by parameters of options-object.
*
* @param type of key
* @param type of value
* @param name - name of object
* @param options - local map options
* @return LocalCachedMap object
*/
RLocalCachedMap getLocalCachedMap(String name, LocalCachedMapOptions options);
/**
* Returns local cached map instance by name
* using provided codec. Configured by parameters of options-object.
*
* @param type of key
* @param type of value
* @param name - name of object
* @param codec - codec for keys and values
* @param options - local map options
* @return LocalCachedMap object
*/
RLocalCachedMap getLocalCachedMap(String name, Codec codec, LocalCachedMapOptions options);
/**
* Returns map instance by name.
*
* @param type of key
* @param type of value
* @param name - name of object
* @return Map object
*/
RMap getMap(String name);
/**
* Returns map instance by name.
*
* @param type of key
* @param type of value
* @param name - name of object
* @param options - map options
* @return Map object
*/
RMap getMap(String name, MapOptions options);
/**
* Returns map instance by name
* using provided codec for both map keys and values.
*
* @param type of key
* @param type of value
* @param name - name of object
* @param codec - codec for keys and values
* @return Map object
*/
RMap getMap(String name, Codec codec);
/**
* Returns map instance by name
* using provided codec for both map keys and values.
*
* @param type of key
* @param type of value
* @param name - name of object
* @param codec - codec for keys and values
* @param options - map options
* @return Map object
*/
RMap getMap(String name, Codec codec, MapOptions options);
/**
* Returns Set based Multimap instance by name.
*
* @param type of key
* @param type of value
* @param name - name of object
* @return SetMultimap object
*/
RSetMultimap getSetMultimap(String name);
/**
* Returns Set based Multimap instance by name
* using provided codec for both map keys and values.
*
* @param type of key
* @param type of value
* @param name - name of object
* @param codec - codec for keys and values
* @return SetMultimap object
*/
RSetMultimap getSetMultimap(String name, Codec codec);
/**
* Returns Set based Multimap instance by name.
* Supports key-entry eviction with a given TTL value.
*
* If eviction is not required then it's better to use regular map {@link #getSetMultimap(String)}.
*
* @param type of key
* @param type of value
* @param name - name of object
* @return SetMultimapCache object
*/
RSetMultimapCache getSetMultimapCache(String name);
/**
* Returns Set based Multimap instance by name
* using provided codec for both map keys and values.
* Supports key-entry eviction with a given TTL value.
*
* If eviction is not required then it's better to use regular map {@link #getSetMultimap(String, Codec)}.
*
* @param type of key
* @param type of value
* @param name - name of object
* @param codec - codec for keys and values
* @return SetMultimapCache object
*/
RSetMultimapCache getSetMultimapCache(String name, Codec codec);
/**
* Returns semaphore instance by name
*
* @param name - name of object
* @return Semaphore object
*/
RSemaphore getSemaphore(String name);
/**
* Returns semaphore instance by name.
* Supports lease time parameter for each acquired permit.
*
* @param name - name of object
* @return PermitExpirableSemaphore object
*/
RPermitExpirableSemaphore getPermitExpirableSemaphore(String name);
/**
* Returns Lock instance by name.
*
* Implements a non-fair locking so doesn't guarantees an acquire order by threads.
*
* To increase reliability during failover, all operations wait for propagation to all Redis slaves.
*
* @param name - name of object
* @return Lock object
*/
RLock getLock(String name);
/**
* Returns Spin lock instance by name.
*
* Implements a non-fair locking so doesn't guarantees an acquire order by threads.
*
* Lock doesn't use a pub/sub mechanism
*
* @param name - name of object
* @return Lock object
*/
RLock getSpinLock(String name);
/**
* Returns Spin lock instance by name with specified back off options.
*
* Implements a non-fair locking so doesn't guarantees an acquire order by threads.
*
* Lock doesn't use a pub/sub mechanism
*
* @param name - name of object
* @return Lock object
*/
RLock getSpinLock(String name, LockOptions.BackOff backOff);
/**
* Returns MultiLock instance associated with specified locks
*
* @param locks - collection of locks
* @return MultiLock object
*/
RLock getMultiLock(RLock... locks);
/*
* Use getLock method instead. Returned instance uses Redis Slave synchronization
*/
@Deprecated
RLock getRedLock(RLock... locks);
/**
* Returns Lock instance by name.
*
* Implements a fair locking so it guarantees an acquire order by threads.
*
* To increase reliability during failover, all operations wait for propagation to all Redis slaves.
*
* @param name - name of object
* @return Lock object
*/
RLock getFairLock(String name);
/**
* Returns ReadWriteLock instance by name.
*
* To increase reliability during failover, all operations wait for propagation to all Redis slaves.
*
* @param name - name of object
* @return Lock object
*/
RReadWriteLock getReadWriteLock(String name);
/**
* Returns set instance by name.
*
* @param type of value
* @param name - name of object
* @return Set object
*/
RSet getSet(String name);
/**
* Returns set instance by name
* using provided codec for set objects.
*
* @param type of value
* @param name - name of object
* @param codec - codec for values
* @return Set object
*/
RSet getSet(String name, Codec codec);
/**
* Returns sorted set instance by name.
* This sorted set uses comparator to sort objects.
*
* @param type of value
* @param name - name of object
* @return SortedSet object
*/
RSortedSet getSortedSet(String name);
/**
* Returns sorted set instance by name
* using provided codec for sorted set objects.
* This sorted set sorts objects using comparator.
*
* @param type of value
* @param name - name of object
* @param codec - codec for values
* @return SortedSet object
*/
RSortedSet getSortedSet(String name, Codec codec);
/**
* Returns Redis Sorted Set instance by name.
* This sorted set sorts objects by object score.
*
* @param type of value
* @param name - name of object
* @return ScoredSortedSet object
*/
RScoredSortedSet getScoredSortedSet(String name);
/**
* Returns Redis Sorted Set instance by name
* using provided codec for sorted set objects.
* This sorted set sorts objects by object score.
*
* @param type of value
* @param name - name of object
* @param codec - codec for values
* @return ScoredSortedSet object
*/
RScoredSortedSet getScoredSortedSet(String name, Codec codec);
/**
* Returns String based Redis Sorted Set instance by name
* All elements are inserted with the same score during addition,
* in order to force lexicographical ordering
*
* @param name - name of object
* @return LexSortedSet object
*/
RLexSortedSet getLexSortedSet(String name);
/**
* Returns Sharded Topic instance by name.
*
* Messages are delivered to message listeners connected to the same Topic.
*
*
* @param name - name of object
* @return Topic object
*/
RShardedTopic getShardedTopic(String name);
/**
* Returns Sharded Topic instance by name using provided codec for messages.
*
* Messages are delivered to message listeners connected to the same Topic.
*
*
* @param name - name of object
* @param codec - codec for message
* @return Topic object
*/
RShardedTopic getShardedTopic(String name, Codec codec);
/**
* Returns topic instance by name.
*
* Messages are delivered to message listeners connected to the same Topic.
*
*
* @param name - name of object
* @return Topic object
*/
RTopic getTopic(String name);
/**
* Returns topic instance by name
* using provided codec for messages.
*
* Messages are delivered to message listeners connected to the same Topic.
*
*
* @param name - name of object
* @param codec - codec for message
* @return Topic object
*/
RTopic getTopic(String name, Codec codec);
/**
* Returns reliable topic instance by name.
*
* Dedicated Redis connection is allocated per instance (subscriber) of this object.
* Messages are delivered to all listeners attached to the same Redis setup.
*
* Requires Redis 5.0.0 and higher.
*
* @param name - name of object
* @return ReliableTopic object
*/
RReliableTopic getReliableTopic(String name);
/**
* Returns reliable topic instance by name
* using provided codec for messages.
*
* Dedicated Redis connection is allocated per instance (subscriber) of this object.
* Messages are delivered to all listeners attached to the same Redis setup.
*
* Requires Redis 5.0.0 and higher.
*
* @param name - name of object
* @param codec - codec for message
* @return ReliableTopic object
*/
RReliableTopic getReliableTopic(String name, Codec codec);
/**
* Returns topic instance satisfies by pattern name.
*
* Supported glob-style patterns:
* h?llo subscribes to hello, hallo and hxllo
* h*llo subscribes to hllo and heeeello
* h[ae]llo subscribes to hello and hallo, but not hillo
*
* @param pattern of the topic
* @return PatterTopic object
*/
RPatternTopic getPatternTopic(String pattern);
/**
* Returns topic instance satisfies by pattern name
* using provided codec for messages.
*
* Supported glob-style patterns:
* h?llo subscribes to hello, hallo and hxllo
* h*llo subscribes to hllo and heeeello
* h[ae]llo subscribes to hello and hallo, but not hillo
*
* @param pattern of the topic
* @param codec - codec for message
* @return PatterTopic object
*/
RPatternTopic getPatternTopic(String pattern, Codec codec);
/**
* Returns unbounded queue instance by name.
*
* @param type of value
* @param name of object
* @return queue object
*/
RQueue getQueue(String name);
/**
* Returns transfer queue instance by name.
*
* @param type of values
* @param name - name of object
* @return TransferQueue object
*/
RTransferQueue getTransferQueue(String name);
/**
* Returns transfer queue instance by name
* using provided codec for queue objects.
*
* @param type of values
* @param name - name of object
* @param codec - code for values
* @return TransferQueue object
*/
RTransferQueue getTransferQueue(String name, Codec codec);
/**
* Returns unbounded delayed queue instance by name.
*
* Could be attached to destination queue only.
* All elements are inserted with transfer delay to destination queue.
*
* @param type of value
* @param destinationQueue - destination queue
* @return Delayed queue object
*/
RDelayedQueue getDelayedQueue(RQueue destinationQueue);
/**
* Returns unbounded queue instance by name
* using provided codec for queue objects.
*
* @param type of value
* @param name - name of object
* @param codec - codec for message
* @return Queue object
*/
RQueue getQueue(String name, Codec codec);
/**
* Returns RingBuffer based queue.
*
* @param value type
* @param name - name of object
* @return RingBuffer object
*/
RRingBuffer getRingBuffer(String name);
/**
* Returns RingBuffer based queue.
*
* @param value type
* @param name - name of object
* @param codec - codec for values
* @return RingBuffer object
*/
RRingBuffer getRingBuffer(String name, Codec codec);
/**
* Returns priority unbounded queue instance by name.
* It uses comparator to sort objects.
*
* @param type of value
* @param name of object
* @return Queue object
*/
RPriorityQueue getPriorityQueue(String name);
/**
* Returns priority unbounded queue instance by name
* using provided codec for queue objects.
* It uses comparator to sort objects.
*
* @param type of value
* @param name - name of object
* @param codec - codec for message
* @return Queue object
*/
RPriorityQueue getPriorityQueue(String name, Codec codec);
/**
* Returns unbounded priority blocking queue instance by name.
* It uses comparator to sort objects.
*
* @param type of value
* @param name of object
* @return Queue object
*/
RPriorityBlockingQueue getPriorityBlockingQueue(String name);
/**
* Returns unbounded priority blocking queue instance by name
* using provided codec for queue objects.
* It uses comparator to sort objects.
*
* @param type of value
* @param name - name of object
* @param codec - codec for message
* @return Queue object
*/
RPriorityBlockingQueue getPriorityBlockingQueue(String name, Codec codec);
/**
* Returns unbounded priority blocking deque instance by name.
* It uses comparator to sort objects.
*
* @param type of value
* @param name of object
* @return Queue object
*/
RPriorityBlockingDeque getPriorityBlockingDeque(String name);
/**
* Returns unbounded priority blocking deque instance by name
* using provided codec for queue objects.
* It uses comparator to sort objects.
*
* @param type of value
* @param name - name of object
* @param codec - codec for message
* @return Queue object
*/
RPriorityBlockingDeque getPriorityBlockingDeque(String name, Codec codec);
/**
* Returns priority unbounded deque instance by name.
* It uses comparator to sort objects.
*
* @param type of value
* @param name of object
* @return Queue object
*/
RPriorityDeque getPriorityDeque(String name);
/**
* Returns priority unbounded deque instance by name
* using provided codec for queue objects.
* It uses comparator to sort objects.
*
* @param type of value
* @param name - name of object
* @param codec - codec for message
* @return Queue object
*/
RPriorityDeque getPriorityDeque(String name, Codec codec);
/**
* Returns unbounded blocking queue instance by name.
*
* @param type of value
* @param name - name of object
* @return BlockingQueue object
*/
RBlockingQueue getBlockingQueue(String name);
/**
* Returns unbounded blocking queue instance by name
* using provided codec for queue objects.
*
* @param type of value
* @param name - name of queue
* @param codec - queue objects codec
* @return BlockingQueue object
*/
RBlockingQueue getBlockingQueue(String name, Codec codec);
/**
* Returns bounded blocking queue instance by name.
*
* @param type of value
* @param name of queue
* @return BoundedBlockingQueue object
*/
RBoundedBlockingQueue getBoundedBlockingQueue(String name);
/**
* Returns bounded blocking queue instance by name
* using provided codec for queue objects.
*
* @param type of value
* @param name - name of queue
* @param codec - codec for values
* @return BoundedBlockingQueue object
*/
RBoundedBlockingQueue getBoundedBlockingQueue(String name, Codec codec);
/**
* Returns unbounded deque instance by name.
*
* @param type of value
* @param name - name of object
* @return Deque object
*/
RDeque getDeque(String name);
/**
* Returns unbounded deque instance by name
* using provided codec for deque objects.
*
* @param type of value
* @param name - name of object
* @param codec - codec for values
* @return Deque object
*/
RDeque getDeque(String name, Codec codec);
/**
* Returns unbounded blocking deque instance by name.
*
* @param type of value
* @param name - name of object
* @return BlockingDeque object
*/
RBlockingDeque getBlockingDeque(String name);
/**
* Returns unbounded blocking deque instance by name
* using provided codec for deque objects.
*
* @param type of value
* @param name - name of object
* @param codec - deque objects codec
* @return BlockingDeque object
*/
RBlockingDeque getBlockingDeque(String name, Codec codec);
/**
* Returns atomicLong instance by name.
*
* @param name - name of object
* @return AtomicLong object
*/
RAtomicLong getAtomicLong(String name);
/**
* Returns atomicDouble instance by name.
*
* @param name - name of object
* @return AtomicDouble object
*/
RAtomicDouble getAtomicDouble(String name);
/**
* Returns LongAdder instances by name.
*
* @param name - name of object
* @return LongAdder object
*/
RLongAdder getLongAdder(String name);
/**
* Returns DoubleAdder instances by name.
*
* @param name - name of object
* @return LongAdder object
*/
RDoubleAdder getDoubleAdder(String name);
/**
* Returns countDownLatch instance by name.
*
* @param name - name of object
* @return CountDownLatch object
*/
RCountDownLatch getCountDownLatch(String name);
/**
* Returns bitSet instance by name.
*
* @param name - name of object
* @return BitSet object
*/
RBitSet getBitSet(String name);
/**
* Returns bloom filter instance by name.
*
* @param type of value
* @param name - name of object
* @return BloomFilter object
*/
RBloomFilter getBloomFilter(String name);
/**
* Returns bloom filter instance by name
* using provided codec for objects.
*
* @param type of value
* @param name - name of object
* @param codec - codec for values
* @return BloomFilter object
*/
RBloomFilter getBloomFilter(String name, Codec codec);
/**
* Returns id generator by name.
*
* @param name - name of object
* @return IdGenerator object
*/
RIdGenerator getIdGenerator(String name);
/**
* Returns interface for Redis Function feature
*
* @return function object
*/
RFunction getFunction();
/**
* Returns interface for Redis Function feature using provided codec
*
* @param codec - codec for params and result
* @return function interface
*/
RFunction getFunction(Codec codec);
/**
* Returns script operations object
*
* @return Script object
*/
RScript getScript();
/**
* Returns script operations object using provided codec.
*
* @param codec - codec for params and result
* @return Script object
*/
RScript getScript(Codec codec);
/**
* Returns ScheduledExecutorService by name
*
* @param name - name of object
* @return ScheduledExecutorService object
*/
RScheduledExecutorService getExecutorService(String name);
/**
* Returns ScheduledExecutorService by name
*
* @param name - name of object
* @param options - options for executor
* @return ScheduledExecutorService object
*/
RScheduledExecutorService getExecutorService(String name, ExecutorOptions options);
/**
* Returns ScheduledExecutorService by name
* using provided codec for task, response and request serialization
*
* @param name - name of object
* @param codec - codec for task, response and request
* @return ScheduledExecutorService object
* @since 2.8.2
*/
RScheduledExecutorService getExecutorService(String name, Codec codec);
/**
* Returns ScheduledExecutorService by name
* using provided codec for task, response and request serialization
*
* @param name - name of object
* @param codec - codec for task, response and request
* @param options - options for executor
* @return ScheduledExecutorService object
*/
RScheduledExecutorService getExecutorService(String name, Codec codec, ExecutorOptions options);
/**
* Returns object for remote operations prefixed with the default name (redisson_remote_service)
*
* @return RemoteService object
*/
RRemoteService getRemoteService();
/**
* Returns object for remote operations prefixed with the default name (redisson_remote_service)
* and uses provided codec for method arguments and result.
*
* @param codec - codec for response and request
* @return RemoteService object
*/
RRemoteService getRemoteService(Codec codec);
/**
* Returns object for remote operations prefixed with the specified name
*
* @param name - the name used as the Redis key prefix for the services
* @return RemoteService object
*/
RRemoteService getRemoteService(String name);
/**
* Returns object for remote operations prefixed with the specified name
* and uses provided codec for method arguments and result.
*
* @param name - the name used as the Redis key prefix for the services
* @param codec - codec for response and request
* @return RemoteService object
*/
RRemoteService getRemoteService(String name, Codec codec);
/**
* Creates transaction with READ_COMMITTED isolation level.
*
* @param options - transaction configuration
* @return Transaction object
*/
RTransaction createTransaction(TransactionOptions options);
/**
* Creates batch object which could be executed later
* with collected group of commands in pipeline mode.
*
* See http://redis.io/topics/pipelining
*
* @param options - batch configuration
* @return Batch object
*/
RBatch createBatch(BatchOptions options);
/**
* Creates batch object which could be executed later
* with collected group of commands in pipeline mode.
*
* See http://redis.io/topics/pipelining
*
* @return Batch object
*/
RBatch createBatch();
/**
* Returns interface with methods for Redis keys.
* Each of Redis/Redisson object associated with own key
*
* @return Keys object
*/
RKeys getKeys();
/**
* Returns RedissonAttachedLiveObjectService which can be used to
* retrieve live REntity(s)
*
* @return LiveObjectService object
*/
RLiveObjectService getLiveObjectService();
/**
* Returns RxJava Redisson instance
*
* @return redisson instance
*/
RedissonRxClient rxJava();
/**
* Returns Reactive Redisson instance
*
* @return redisson instance
*/
RedissonReactiveClient reactive();
/**
* Shutdown Redisson instance but NOT Redis server
*
* This equates to invoke shutdown(0, 2, TimeUnit.SECONDS);
*/
void shutdown();
/**
* Shuts down Redisson instance but NOT Redis server
*
* Shutdown ensures that no tasks are submitted for 'the quiet period'
* (usually a couple seconds) before it shuts itself down. If a task is submitted during the quiet period,
* it is guaranteed to be accepted and the quiet period will start over.
*
* @param quietPeriod the quiet period as described in the documentation
* @param timeout the maximum amount of time to wait until the executor is {@linkplain #shutdown()}
* regardless if a task was submitted during the quiet period
* @param unit the unit of {@code quietPeriod} and {@code timeout}
*/
void shutdown(long quietPeriod, long timeout, TimeUnit unit);
/**
* Allows to get configuration provided
* during Redisson instance creation. Further changes on
* this object not affect Redisson instance.
*
* @return Config object
*/
Config getConfig();
/**
* Returns API to manage Redis nodes
*
* @see RedisNodes#CLUSTER
* @see RedisNodes#MASTER_SLAVE
* @see RedisNodes#SENTINEL_MASTER_SLAVE
* @see RedisNodes#SINGLE
*
* @param nodes Redis nodes API class
* @param type of Redis nodes API
* @return Redis nodes API object
*/
T getRedisNodes(RedisNodes nodes);
/*
* Use getRedisNodes() method instead
*/
@Deprecated
NodesGroup getNodesGroup();
/*
* Use getRedisNodes() method instead
*/
@Deprecated
ClusterNodesGroup getClusterNodesGroup();
/**
* Returns {@code true} if this Redisson instance has been shut down.
*
* @return {@code true} if this Redisson instance has been shut down overwise false
*/
boolean isShutdown();
/**
* Returns {@code true} if this Redisson instance was started to be shutdown
* or was shutdown {@link #isShutdown()} already.
*
* @return {@code true} if this Redisson instance was started to be shutdown
* or was shutdown {@link #isShutdown()} already.
*/
boolean isShuttingDown();
/**
* Returns id of this Redisson instance
*
* @return id
*/
String getId();
}