# shiro-redisson

**Repository Path**: streamone/shiro-redisson

## Basic Information

- **Project Name**: shiro-redisson
- **Description**: 基于 Redis 的 Shiro Cache 和 Session 实现
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://github.com/streamone/shiro-redisson
- **GVP Project**: No

## Statistics

- **Stars**: 56
- **Forks**: 19
- **Created**: 2018-03-13
- **Last Updated**: 2025-02-13

## Categories & Tags

**Categories**: cache-modules

**Tags**: None

## README

# shiro-redisson

[![Travis](https://img.shields.io/travis/streamone/shiro-redisson.svg)](https://travis-ci.org/streamone/shiro-redisson)
[![Coverage Status](https://coveralls.io/repos/github/streamone/shiro-redisson/badge.svg?branch=master)](https://coveralls.io/github/streamone/shiro-redisson?branch=master)
[![license](https://img.shields.io/badge/license-MIT%20License-blue.svg)](https://github.com/streamone/shiro-redisson/blob/master/LICENSE)

### Redis based implementations of Apache Shiro's Cache and Session, using [redisson](https://github.com/redisson/redisson) as rich redis client.

compatible with:
* JDK 1.8 - 14
* shiro 1.5.x
* redisson 3.9.0+
* redis 3+

### [Documentation](https://github.com/streamone/shiro-redisson/wiki)

### Download
Maven dependency:
```xml
<dependency>
    <groupId>com.github.streamone</groupId>
    <artifactId>shiro-redisson</artifactId>
    <version>1.5.0.RELEASE</version>
</dependency>
```

### Features
* Shiro Cache implementation
  * support cache config according to Spring Cache specification

* Shiro Session implementation
  * serialize attributes of session individually as minimum unit
  * package redis commands in lua script for high performance (reduce round-trip time)  and supporting transaction

* Others
  * support several serialization solutions: JDK Serialization, JSON, Smile, MsgPack, FST and so on
  * support common redis servers mode,  including single server, master-salve replication, sentinel, cluster