You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
144 lines
7.5 KiB
Markdown
144 lines
7.5 KiB
Markdown
Redis based In-Memory Data Grid for Java. Redisson.
|
|
====
|
|
|
|
Based on high-performance async and lock-free Java Redis client and [Netty](http://netty.io) framework.
|
|
Redis 2.8+ compatible.
|
|
|
|
| Stable Release Version | JDK Version compatibility | Release Date |
|
|
| ------------- | ------------- | ------------|
|
|
| 3.1.0 | 1.8+ | 07.11.2016 |
|
|
| 2.6.0 | 1.6+ | 07.11.2016 |
|
|
|
|
Please read [documentation](https://github.com/redisson/redisson/wiki) for more details.
|
|
Redisson [releases history](https://github.com/redisson/redisson/blob/master/CHANGELOG.md).
|
|
|
|
Licensed under the Apache License 2.0.
|
|
|
|
Welcome to support chat [](https://gitter.im/mrniko/redisson?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
|
|
####Try [Redisson PRO](http://redisson.pro) version.
|
|
####Redisson team offers commercial support. Please contact sales@redisson.pro for details.
|
|
|
|
Features
|
|
================================
|
|
* [AWS ElastiCache](http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/Replication.html) mode:
|
|
1. automatic master server change discovery
|
|
* [AWS ElastiCache Cluster](http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/Clusters.html) mode:
|
|
1. automatic master and slave servers discovery
|
|
2. automatic new master server discovery
|
|
3. automatic new slave servers discovery
|
|
4. automatic slave servers offline/online discovery
|
|
5. automatic slots change discovery
|
|
* Cluster servers mode:
|
|
1. automatic master and slave servers discovery
|
|
2. automatic new master server discovery
|
|
3. automatic new slave servers discovery
|
|
4. automatic slave servers offline/online discovery
|
|
5. automatic slots change discovery
|
|
* Sentinel servers mode:
|
|
1. automatic master and slave servers discovery
|
|
2. automatic new master server discovery
|
|
3. automatic new slave servers discovery
|
|
4. automatic slave servers offline/online discovery
|
|
5. automatic sentinel servers discovery
|
|
* Master with Slave servers mode
|
|
* Single server mode
|
|
* Asynchronous interface for each object
|
|
* Asynchronous connection pool
|
|
* Thread-safe implementation
|
|
* Lua scripting
|
|
* [Distributed objects](https://github.com/redisson/redisson/wiki/6.-Distributed-objects)
|
|
* [Distributed collections](https://github.com/redisson/redisson/wiki/7.-Distributed-collections)
|
|
* [Distributed locks and synchronizers](https://github.com/redisson/redisson/wiki/8.-Distributed-locks-and-synchronizers)
|
|
* [Distributed services](https://github.com/redisson/redisson/wiki/9.-distributed-services)
|
|
* [Spring cache](https://github.com/redisson/redisson/wiki/14.-Integration%20with%20frameworks/#141-spring-cache) integration
|
|
* [Hibernate](https://github.com/redisson/redisson/wiki/14.-Integration%20with%20frameworks/#142-hibernate) integration
|
|
* [Tomcat Session Manager](https://github.com/redisson/redisson/wiki/14.-Integration%20with%20frameworks#144-tomcat-redis-session-manager)
|
|
* [JCache API (JSR-107)](https://github.com/redisson/redisson/wiki/14.-Integration%20with%20frameworks/#143-jcache-api-jsr-107-implementation) implementation
|
|
* [Reactive Streams](https://github.com/redisson/redisson/wiki/3.-operations-execution#32-reactive-way)
|
|
* [Redis pipelining](https://github.com/redisson/redisson/wiki/10.-additional-features#102-execution-batches-of-commands) (command batches)
|
|
* Supports Android platform
|
|
* Supports auto-reconnect
|
|
* Supports failed to send command auto-retry
|
|
* Supports OSGi
|
|
* Supports many popular codecs ([Jackson JSON](https://github.com/FasterXML/jackson), [Avro](http://avro.apache.org/), [Smile](http://wiki.fasterxml.com/SmileFormatSpec), [CBOR](http://cbor.io/), [MsgPack](http://msgpack.org/), [Kryo](https://github.com/EsotericSoftware/kryo), [FST](https://github.com/RuedigerMoeller/fast-serialization), [LZ4](https://github.com/jpountz/lz4-java), [Snappy](https://github.com/xerial/snappy-java) and JDK Serialization)
|
|
* With over 1000 unit tests
|
|
|
|
Projects using Redisson
|
|
================================
|
|
[Infor](http://www.infor.com/), [New Relic Synthetics](https://newrelic.com/synthetics), [Singtel](http://singtel.com), [Setronica](http://setronica.com/), [Monits](http://monits.com/), [Brookhaven National Laboratory](http://bnl.gov/), [Netflix Dyno client] (https://github.com/Netflix/dyno), [武林Q传](http://www.nbrpg.com/), [Ocous](http://www.ocous.com/), [Invaluable](http://www.invaluable.com/), [Clover](https://www.clover.com/) , [Apache Karaf Decanter](https://karaf.apache.org/projects.html#decanter), [Atmosphere Framework](http://async-io.org/), [BrandsEye](http://brandseye.com), [Datorama](http://datorama.com/), [BrightCloud](http://brightcloud.com/)
|
|
|
|
Articles
|
|
================================
|
|
|
|
[Java data structures powered by Redis. Introduction to Redisson (pdf)](http://redisson.org/Redisson.pdf)
|
|
[A Look at the Java Distributed In-Memory Data Model (Powered by Redis)](https://dzone.com/articles/java-distributed-in-memory-data-model-powered-by-r)
|
|
[Distributed tasks Execution and Scheduling in Java, powered by Redis](https://dzone.com/articles/distributed-tasks-execution-and-scheduling-in-java)
|
|
[Introducing Redisson Live Objects (Object Hash Mapping)](https://dzone.com/articles/introducing-redisson-live-object-object-hash-mappi)
|
|
[Java Remote Method Invocation with Redisson](https://dzone.com/articles/java-remote-method-invocation-with-redisson)
|
|
[Java Multimaps With Redis](https://dzone.com/articles/multimaps-with-redis)
|
|
[Distributed lock with Redis](https://evuvatech.com/2016/02/05/distributed-lock-with-redis/)
|
|
|
|
Quick start
|
|
===============================
|
|
|
|
#### Maven
|
|
<!-- JDK 1.8+ compatible -->
|
|
<dependency>
|
|
<groupId>org.redisson</groupId>
|
|
<artifactId>redisson</artifactId>
|
|
<version>3.1.0</version>
|
|
</dependency>
|
|
|
|
<!-- JDK 1.6+ compatible -->
|
|
<dependency>
|
|
<groupId>org.redisson</groupId>
|
|
<artifactId>redisson</artifactId>
|
|
<version>2.6.0</version>
|
|
</dependency>
|
|
|
|
|
|
#### Gradle
|
|
// JDK 1.8+ compatible
|
|
compile 'org.redisson:redisson:3.1.0'
|
|
|
|
// JDK 1.6+ compatible
|
|
compile 'org.redisson:redisson:2.6.0'
|
|
|
|
#### Java
|
|
|
|
```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.1.0](https://repository.sonatype.org/service/local/artifact/maven/redirect?r=central-proxy&g=org.redisson&a=redisson&v=3.1.0&e=jar),
|
|
[Redisson node 3.1.0](https://repository.sonatype.org/service/local/artifact/maven/redirect?r=central-proxy&g=org.redisson&a=redisson-all&v=3.1.0&e=jar)
|
|
|
|
[Redisson 2.6.0](https://repository.sonatype.org/service/local/artifact/maven/redirect?r=central-proxy&g=org.redisson&a=redisson&v=2.6.0&e=jar),
|
|
[Redisson node 2.6.0](https://repository.sonatype.org/service/local/artifact/maven/redirect?r=central-proxy&g=org.redisson&a=redisson-all&v=2.6.0&e=jar)
|
|
|
|
### 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:
|
|
<a href="http://www.yourkit.com/java/profiler/index.jsp">YourKit Java Profiler</a> and
|
|
<a href="http://www.yourkit.com/.net/profiler/index.jsp">YourKit .NET Profiler</a>.
|