Spring Session - Spring Boot
更新依赖项
在使用Spring Session与Redis之前,您必须确保已正确添加依赖项。 我们假设您正在处理一个运行中的Spring Boot Web应用程序。
<dependencies>
<!-- ... -->
<dependency>
<groupId>org.springframework.session</groupId>
<artifactId>spring-session-data-redis</artifactId>
</dependency>
</dependencies>
implementation("org.springframework.session:spring-session-data-redis")
Spring Boot 为 Spring Session 模块提供了依赖管理,因此您无需显式声明依赖版本。
Spring Boot 配置
在添加了所需的依赖项后,我们可以创建我们的 Spring Boot 配置。 得益于一等的自动配置支持,只需添加相应的依赖项,Spring Boot 就会为我们设置基于 Redis 的 Spring Session。
在幕后,Spring Boot 应用的配置相当于手动添加了 @EnableRedisHttpSession 注解。
这创建了一个名为 springSessionRepositoryFilter 的 Spring bean,并实现了 Filter 接口。
过滤器负责将 HttpSession 实现替换为由 Spring Session 支持的实现。
进一步自定义可以通过使用application.properties实现,如下例所示:
server.servlet.session.timeout= # Session timeout. If a duration suffix is not specified, seconds is used. spring.session.redis.flush-mode=on_save # Sessions flush mode. spring.session.redis.namespace=spring:session # Namespace for keys used to store sessions.
对于更多信息,请参阅Spring Session部分的Spring Boot 文档。
配置 Redis 连接
Spring Boot 自动创建一个 RedisConnectionFactory,将 Spring Session 连接到本地主机上的端口 6379 的 Redis 服务器(默认端口)。
在生产环境中,您需要更新配置以指向您的 Redis 服务器。例如,您可以将在 application.properties 中包含以下内容:
spring.data.redis.host=localhost # Redis server host. spring.data.redis.password= # Login password of the redis server. spring.data.redis.port=6379 # Redis server port.
对于更多信息,请参阅Spring Boot 文档中的连接 Redis 部分。
Servlet 容器初始化
我们的 Spring Boot 配置 创建了一个名为 springSessionRepositoryFilter 的 Spring bean,它实现了 Filter。
springSessionRepositoryFilter bean 负责用一个由 Spring Session 支撑的自定义实现来替换 HttpSession。
为了使我们的Filter发挥魔力,Spring 需要加载我们的Config类。
最后,我们需要确保我们的 servlet 容器(即 Tomcat)为每个请求使用我们的springSessionRepositoryFilter。
幸运的是,Spring Boot 会为我们处理这两个步骤。
启动示例应用
The Boot 样例应用演示了如何使用 Spring Session 透明地利用 Redis 来支持一个基于 Spring Boot 的 Web 应用程序的 会话(session)。
运行 Boot 示例应用程序
您可以运行示例程序,通过获取源代码并执行以下命令来实现:
$ ./gradlew :spring-session-sample-boot-redis:bootRun
为了使示例正常工作,您必须在本地主机上安装 Redis 2.8+ 并使用默认端口(6379)运行它。
或者,您可以更新 RedisConnectionFactory 指向一个 Redis 服务器。
另一个选项是使用 Docker 在本地主机上运行 Redis。有关详细说明,请参阅 Docker Redis 存储库。 |
您应该能够通过以下地址访问应用:localhost:8080/
探索security示例应用程序
现在您可以尝试使用该应用程序。输入以下内容进行登录:
-
用户名 user
-
密码 密码
现在点击 登录 按钮。
你应该会看到一条消息,表明你已使用之前输入的用户身份进行登录。
用户的个人信息存储在 Redis 而不是 Tomcat 的 HttpSession 实现中。
它是如何工作的?
而不是使用Tomcat的HttpSession,我们将在Redis中持久化这些值。
Spring Session用一个基于Redis的实现替换了HttpSession。
当Spring Security的SecurityContextPersistenceFilter将SecurityContext保存到HttpSession时,它会被持久化到Redis中。
当一个新的HttpSession被创建时,Spring Session会在你的浏览器中创建一个名为SESSION的cookie。
该cookie包含你的会话ID。
你可以通过Chrome或Firefox查看这些cookie。
您可以使用 redis-cli 移除会话。<br/> 例如,在基于 Linux 的系统上,可以输入以下命令:
$ redis-cli keys '*' | xargs redis-cli del
| The Redis 文档有安装 redis-cli 的说明。安装 redis-cli |
也可以删除显式的密钥。
要执行此操作,请在终端中输入以下内容,并确保将7e8383a4-082c-4ffe-a4bc-c40fd3363c5e替换为您的SESSION cookie的值:
$ redis-cli del spring:session:sessions:7e8383a4-082c-4ffe-a4bc-c40fd3363c5e
现在您可以访问应用,地址为 http://localhost:8080/,并观察到我们已经不再进行身份验证。