Spring Session

Rob Winch; Vedran Pavić; Jay Bryant; Eleftheria Stein-Kousathana

Spring Session 提供 API 和實現來管理使用者的會話資訊。

Spring Session 提供 API 和實現來管理使用者的會話資訊，同時可以輕鬆支援叢集會話，且不受特定應用容器解決方案的限制。它還提供與以下各項的透明整合：

  • HttpSession：允許以應用容器無關的方式替換 HttpSession，支援在頭部提供會話 ID，以便與 RESTful API 協作。

  • WebSocket：提供在接收 WebSocket 訊息時保持 HttpSession 活躍的能力

  • WebSession：允許以應用容器無關的方式替換 Spring WebFlux 的 WebSession。

理解 Spring Session 解決的問題

當用戶與 Web 應用互動時，伺服器會建立一個會話來跟蹤使用者的活動。此會話可能儲存使用者資訊，例如使用者偏好、登入狀態和購物車內容。然而，會話在分散式環境中可能會出現問題，因為它們通常儲存在伺服器的記憶體中。

為了更好地理解 Spring Session 解決的問題，讓我們首先看下面的圖表

In-Memory Sessions
圖 1. 記憶體會話

在上圖中，每個 Spring 應用將其會話儲存在一個只有自身可以訪問的地方，通常在伺服器的記憶體中，但這在分散式環境中可能會成為問題。想象一下，如果 Spring 應用 #2 收到一個帶有會話 #3 的請求，該應用將無法讀取會話資料，因為它儲存在 Spring 應用 #1 的記憶體中。為了解決這個問題，我們需要實現某種共享會話儲存，如下圖所示

Shared Session Storage
圖 2. 共享會話儲存

透過上述設定，擁有會話儲存訪問許可權的每個應用都可以訪問會話。

Spring Session 在應用和會話管理之間提供了一個抽象層。它允許將會話資料儲存在各種持久化儲存中，例如關係型資料庫、NoSQL 資料庫等。

使用 Spring Session，無論使用何種持久化儲存，您都可以使用相同的 API 來管理會話。這使得在不同儲存之間切換變得更容易，而無需更改應用程式碼。Spring Session 還提供會話過期和不同 Web 應用之間的跨上下文通訊等功能。

總而言之，Spring Session 簡化了 Web 應用中的使用者會話管理，讓您可以更輕鬆地專注於構建應用的核心功能。

以下是一些 Spring Session 的常見用例

  • 分散式 Web 應用：如果您有一個分散式部署在多臺伺服器上的 Web 應用，管理使用者會話可能會很困難。Spring Session 可以透過將會話資料儲存在共享資料庫或 Redis 中來提供幫助，從而允許所有伺服器訪問和更新會話資料。

  • 會話可伸縮性：在擁有大量併發使用者的大型 Web 應用中，將會話儲存在伺服器記憶體中可能會導致可伸縮性問題。Spring Session 允許您將會話資料儲存在持久化儲存中，從而提高可伸縮性並降低記憶體溢位錯誤的風險。

  • 會話備份與恢復：將會話資料儲存在持久化儲存中還可以提供一種機制，用於在伺服器故障或停機時備份和恢復會話資料。

Spring Session 社群

我們很高興將您視為我們社群的一份子。以下部分提供了關於如何與 Spring Session 社群互動的額外資訊。

支援

您可以在 在 Stack Overflow 上使用 spring-session 標籤提問 來獲得幫助。同樣，我們也鼓勵您透過回答 Stack Overflow 上的問題來幫助他人。

原始碼

您可以在 GitHub 上找到原始碼：github.com/spring-projects/spring-session/

問題追蹤

我們在 GitHub issues 上追蹤問題：github.com/spring-projects/spring-session/issues

貢獻

我們歡迎 拉取請求 (pull requests)。

許可證

Spring Session 是根據 Apache 2.0 許可證釋出的開源軟體。

社群擴充套件

名稱 位置

Spring Session Infinispan

infinispan.org/docs/stable/titles/spring/spring.html

Spring Session Caffeine

github.com/gotson/spring-session-caffeine

最低要求

Spring Session 的最低要求是：

  • Java 17+。

  • 如果您在 Servlet 容器中執行（非必需），需要 Servlet 3.1+。

  • 如果您使用其他 Spring 庫（非必需），最低版本要求是 Spring 6.0.x。

  • @EnableRedisHttpSession 需要 Redis 2.8+。這是支援會話過期所必需的

  • @EnableHazelcastHttpSession 需要 Hazelcast 3.6+。這是支援 FindByIndexNameSessionRepository 所必需的

核心而言，Spring Session 僅強制依賴於 spring-jcl。有關在不依賴任何其他 Spring 依賴項的情況下使用 Spring Session 的示例，請參閱 hazelcast 示例應用。