redisson/README.md

Redis based In-Memory Data Grid for Java. Redisson.

Based on high-performance async and lock-free Java Redis client and Netty framework.
Redis 2.8+ compatible.

Stable Release Version	JDK Version compatibility	Release Date
3.2.3	1.8+	19.01.2017
2.7.3	1.6, 1.7, 1.8 and Android	19.01.2017

NOTE: Both version lines have same features except CompletionStage interface supported by 3.x.x line

Please read documentation for more details.
Redisson releases history
Checkout more code examples
Browse javadocs

Licensed under the Apache License 2.0.

Welcome to support chat

####Try ultra-fast Redisson PRO version.

Features

• Replicated servers mode (also supports AWS ElastiCache and Azure Redis Cache):
  1. automatic master server change discovery
• Cluster servers mode (also supports AWS ElastiCache Cluster and Azure Redis Cache):
  1. automatic master and slave servers discovery
  2. automatic status and topology update
  3. automatic slots change discovery
• Sentinel servers mode:
  1. automatic master, slave and sentinel servers discovery
  2. automatic status and topology update
• Master with Slave servers mode
• Single server mode
• Asynchronous interface for each object
• Asynchronous connection pool
• Thread-safe implementation
• Lua scripting
• Distributed objects
  Object holder, Binary stream holder, Geospatial holder, BitSet, AtomicLong, AtomicDouble, PublishSubscribe, Bloom filter, HyperLogLog
• Distributed collections
  Map, Multimap, Set, List, SortedSet, ScoredSortedSet, LexSortedSet, Queue, Deque, Blocking Queue, Bounded Blocking Queue, Blocking Deque, Delayed Queue
• Distributed locks and synchronizers
  Lock, FairLock, MultiLock, RedLock, ReadWriteLock, Semaphore, PermitExpirableSemaphore, CountDownLatch
• Distributed services
  Remote service, Live Object service, Executor service, Scheduler service
• Spring Cache implementation
• Hibernate Cache implementation
• JCache API (JSR-107) implementation
• Tomcat Session Manager implementation
• Spring Session implementation
• Reactive Streams
• Redis pipelining (command batches)
• Supports Android platform
• Supports auto-reconnect
• Supports failed to send command auto-retry
• Supports OSGi
• Supports many popular codecs (Jackson JSON, Avro, Smile, CBOR, MsgPack, Kryo, FST, LZ4, Snappy and JDK Serialization)
• With over 1000 unit tests

Who uses Redisson

Electronic Arts, Baidu, New Relic Synthetics, National Australia Bank, Brookhaven National Laboratory, Singtel, Infor, Setronica, Monits, [Netflix Dyno client] (https://github.com/Netflix/dyno), 武林Q传, Ocous, Invaluable, Clover , Apache Karaf Decanter, Atmosphere Framework, BrandsEye, Datorama, BrightCloud, Azar, Snapfish, Crimson Hexagon

Articles

Java data structures powered by Redis. Introduction to Redisson (pdf)
A Look at the Java Distributed In-Memory Data Model (Powered by Redis)
Distributed tasks Execution and Scheduling in Java, powered by Redis
Introducing Redisson Live Objects (Object Hash Mapping)
Java Remote Method Invocation with Redisson
Java Multimaps With Redis
Distributed lock with Redis

Success stories

Moving from Hazelcast to Redis

Quick start

Maven

<!-- JDK 1.8+ compatible -->
<dependency>
   <groupId>org.redisson</groupId>
   <artifactId>redisson</artifactId>
   <version>3.2.3</version>
</dependency>  

<!-- JDK 1.6+ compatible -->
<dependency>
   <groupId>org.redisson</groupId>
   <artifactId>redisson</artifactId>
   <version>2.7.3</version>
</dependency>

Gradle

// JDK 1.8+ compatible
compile 'org.redisson:redisson:3.2.3'  

// JDK 1.6+ compatible
compile 'org.redisson:redisson:2.7.3'

Java

// 1. Create config object
Config = ...

// 2. Create Redisson instance
RedissonClient redisson = Redisson.create(config);

// 3. Get object you need
RMap<MyKey, MyValue> map = redisson.getMap("myMap");

RLock lock = redisson.getLock("myLock");

RExecutorService executor = redisson.getExecutorService("myExecutorService");

// over 30 different objects and services ...

Downloads

Redisson 3.2.3, Redisson node 3.2.3

Redisson 2.7.3, Redisson node 2.7.3

Supported by

YourKit is kindly supporting this open source project with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products: YourKit Java Profiler and YourKit .NET Profiler.