使用 Shiro 和 Redis 实现会话续期

在现代应用中，很多时候需要管理用户的会话。Apache Shiro 是一个强大的安全框架，它的会话管理可以与 Redis 集成，从而实现会话的续期。下面我们将通过流程图、代码示例以及详细步骤，指导你完成 Shiro Redis 会话续期的实现。

流程概览

在实现会话续期之前，我们需要确保了解整个流程。以下是简化流程图：

步骤 描述
1. 配置 Redis 设置 Redis 连接信息
2. 配置 Shiro 配置 Shiro 以使用 Redis 作为会话存储
3. 创建 Session 在用户登录时创建 Session
4. 续期机制 每次请求时检查并续期 Session
5. 注销 Session 用户主动注销或 Session 超时清除

流程图（序列图）

sequenceDiagram
    participant U as 用户
    participant B as 后端接口
    participant R as Redis服务器
    participant S as Shiro

    U->>B: 发起请求（包括登录）
    B->>S: 验证用户身份
    S->>R: 创建Session
    R-->>S: Session ID
    S-->>B: 返回登录结果
    B-->>U: 返回响应

    U->>B: 发起新请求
    B->>S: 查询Session
    S->>R: 续期 Session
    R-->>S: 续期确认
    S-->>B: 返回请求结果
    B-->>U: 返回响应

实现步骤

1. 配置 Redis

首先，你需要添加 Redis 的依赖。在 pom.xml 中添加如下代码：

<dependency>
    <groupId>org.apache.shiro</groupId>
    <artifactId>shiro-spring</artifactId>
    <version>1.9.0</version>
</dependency>
<dependency>
    <groupId>org.redis</groupId>
    <artifactId>jedis</artifactId>
    <version>3.6.0</version>
</dependency>
<dependency>
    <groupId>org.apache.shiro</groupId>
    <artifactId>shiro-redis</artifactId>
    <version>1.3.0</version>
</dependency>

2. 配置 Shiro

接下来在你的 Shiro 配置类中配置 Redis。你可以使用如下代码：

import org.apache.shiro.cache.CacheManager;
import org.apache.shiro.session.mgt.SessionFactory;
import org.apache.shiro.session.mgt.DefaultWebSessionManager;
import org.apache.shiro.spring.web.ShiroFilterFactoryBean;
import org.apache.shiro.web.mgt.DefaultWebSecurityManager;
import org.apache.shiro.web.mgt.WebSecurityManager;

@Bean
public ShiroFilterFactoryBean shiroFilterFactoryBean(WebSecurityManager securityManager) {
    ShiroFilterFactoryBean shiroFilterFactoryBean = new ShiroFilterFactoryBean();
    shiroFilterFactoryBean.setSecurityManager(securityManager);
    return shiroFilterFactoryBean;
}

@Bean
public WebSecurityManager securityManager(CacheManager cacheManager, SessionFactory sessionFactory) {
    DefaultWebSecurityManager securityManager = new DefaultWebSecurityManager();
    securityManager.setCacheManager(cacheManager);
    securityManager.setSessionFactory(sessionFactory);
    return securityManager;
}

@Bean
public CacheManager cacheManager() {
    RedisCacheManager cacheManager = new RedisCacheManager();
    cacheManager.setRedisTemplate(redisTemplate());
    return cacheManager;
}

3. 创建 Session

在用户登录时，你需要创建会话。可以通过如下代码实现：

import org.apache.shiro.SecurityUtils;
import org.apache.shiro.subject.Subject;

// 用户身份验证
Subject currentUser = SecurityUtils.getSubject();
if (!currentUser.isAuthenticated()) {
    // 验证用户
    currentUser.login(token);
    // 会话创建后这里可以设置一些属性
    currentUser.getSession().setAttribute("user", user);
}

4. 续期机制

为了续期 Session，你可以在每次请求的处理逻辑中加入续期的代码：

// 续期 Session
if (SecurityUtils.getSubject().isAuthenticated()) {
    // 访问 Session 并更新
    Session session = SecurityUtils.getSubject().getSession();
    session.setTimeout(30 * 60 * 1000); // 设置 30 分钟续期
}

5. 注销 Session

最后，当用户主动注销时，你需要清理 Session：

Subject currentUser = SecurityUtils.getSubject();
if (currentUser.isAuthenticated()) {
    currentUser.logout(); // 注销会话
}

总结

通过以上步骤，你已经了解了如何使用 Shiro 和 Redis 实现会话续期。确保在每次用户请求时续期 Session，从而提高用户体验和安全性。注意保持代码的整洁和注释的完整，这样可以让未来的维护和扩展变得更加简单。希望这篇文章能帮助你顺利完成 Session 续期的实现！