|
对于最新的稳定版本,请使用 Spring Session 3.5.2! |
春季会话 - 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实现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 Boot 文档的 Spring Session 部分。
配置 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实现Filter. 这springSessionRepositoryFilterbean 负责将HttpSession使用由 Spring Session 支持的自定义实现。
为了我们的Filter为了发挥它的魔力,Spring 需要加载我们的Config类。 最后,我们需要确保我们的 servlet 容器(即 Tomcat)使用springSessionRepositoryFilter对于每个请求。幸运的是,Spring Boot 为我们处理了这两个步骤。
启动示例应用程序
启动示例应用程序演示了如何使用 Spring Session 透明地利用 Redis 来支持 Web 应用程序的HttpSession当您使用 Spring 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 将HttpSession使用由 Redis 支持的实现。
当 Spring Security 的SecurityContextPersistenceFilter保存SecurityContext到HttpSession,然后将其持久化到 Redis 中。
当新的HttpSession创建时,Spring Session 会创建一个名为SESSION在您的浏览器中。
该 cookie 包含您的会话的 ID。
您可以查看 cookie(使用 Chrome 或 Firefox)。
您可以使用 redis-cli 删除会话。 例如,在基于 Linux 的系统上,您可以键入以下内容:
$ redis-cli keys '*' | xargs redis-cli del
| Redis 文档包含安装 redis-cli 的说明。 |
或者,您也可以删除显式键。
为此,请在您的终端中输入以下内容,并确保将7e8383a4-082c-4ffe-a4bc-c40fd3363c5e与您的价值SESSION饼干:
$ redis-cli del spring:session:sessions:7e8383a4-082c-4ffe-a4bc-c40fd3363c5e
现在您可以访问 localhost:8080/ 的应用程序,并观察到我们不再经过身份验证。