此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Boot 3.3.1！

此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Boot 3.3.1！

端点提供有关由 Spring Session 管理的应用程序的 HTTP 会话的信息。sessions

检索会话

若要检索会话，请向 发出请求，如以下基于 curl 的示例所示：GET/actuator/sessions

$ curl 'http://localhost:8080/actuator/sessions?username=alice' -i -X GET

前面的示例检索用户名为 的用户的所有会话。 生成的响应类似于以下内容：alice

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 789

{
  "sessions" : [ {
    "id" : "e21306ba-9388-42e5-946e-077804e5d781",
    "attributeNames" : [ ],
    "creationTime" : "2024-06-20T16:36:51.283935115Z",
    "lastAccessedTime" : "2024-06-20T18:36:39.283935817Z",
    "maxInactiveInterval" : 1800,
    "expired" : false
  }, {
    "id" : "4db5efcc-99cb-4d05-a52c-b49acfbb7ea9",
    "attributeNames" : [ ],
    "creationTime" : "2024-06-20T13:36:51.283929475Z",
    "lastAccessedTime" : "2024-06-20T18:36:14.283931950Z",
    "maxInactiveInterval" : 1800,
    "expired" : false
  }, {
    "id" : "dc223bcf-1ded-476f-a294-10ebd17c3b47",
    "attributeNames" : [ ],
    "creationTime" : "2024-06-20T06:36:51.283022836Z",
    "lastAccessedTime" : "2024-06-20T18:36:06.283029479Z",
    "maxInactiveInterval" : 1800,
    "expired" : false
  } ]
}

查询参数

终结点使用查询参数来限制它返回的会话。 下表显示了单个必需的查询参数：

参数 描述

username

用户的名称。

响应结构

响应包含匹配会话的详细信息。 下表描述了响应的结构：

路径 类型 描述

sessions

Array

给定用户名的会话。

sessions.[].id

String

会话的 ID。

sessions.[].attributeNames

Array

会话中存储的属性的名称。

sessions.[].creationTime

String

创建会话的时间戳。

sessions.[].lastAccessedTime

String

上次访问会话的时间戳。

sessions.[].maxInactiveInterval

Number

会话过期前允许的最长非活动时间（以秒为单位）。

sessions.[].expired

Boolean

会话是否已过期。
参数 描述

username

用户的名称。
路径 类型 描述

sessions

Array

给定用户名的会话。

sessions.[].id

String

会话的 ID。

sessions.[].attributeNames

Array

会话中存储的属性的名称。

sessions.[].creationTime

String

创建会话的时间戳。

sessions.[].lastAccessedTime

String

上次访问会话的时间戳。

sessions.[].maxInactiveInterval

Number

会话过期前允许的最长非活动时间（以秒为单位）。

sessions.[].expired

Boolean

会话是否已过期。

检索单个会话

若要检索单个会话，请向 发出请求，如以下基于 curl 的示例所示：GET/actuator/sessions/{id}

$ curl 'http://localhost:8080/actuator/sessions/4db5efcc-99cb-4d05-a52c-b49acfbb7ea9' -i -X GET

前面的示例检索具有 of 的会话。 生成的响应类似于以下内容：id4db5efcc-99cb-4d05-a52c-b49acfbb7ea9

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 208

{"id":"4db5efcc-99cb-4d05-a52c-b49acfbb7ea9","attributeNames":[],"creationTime":"2024-06-20T13:36:51.283929475Z","lastAccessedTime":"2024-06-20T18:36:14.283931950Z","maxInactiveInterval":1800,"expired":false}

响应结构

响应包含所请求会话的详细信息。 下表描述了响应的结构：

路径 类型 描述

id

String

会话的 ID。

attributeNames

Array

会话中存储的属性的名称。

creationTime

String

创建会话的时间戳。

lastAccessedTime

String

上次访问会话的时间戳。

maxInactiveInterval

Number

会话过期前允许的最长非活动时间（以秒为单位）。

expired

Boolean

会话是否已过期。
路径 类型 描述

id

String

会话的 ID。

attributeNames

Array

会话中存储的属性的名称。

creationTime

String

创建会话的时间戳。

lastAccessedTime

String

上次访问会话的时间戳。

maxInactiveInterval

Number

会话过期前允许的最长非活动时间（以秒为单位）。

expired

Boolean

会话是否已过期。

删除会话

要删除会话，请向 发出请求，如以下基于 curl 的示例所示：DELETE/actuator/sessions/{id}

$ curl 'http://localhost:8080/actuator/sessions/4db5efcc-99cb-4d05-a52c-b49acfbb7ea9' -i -X DELETE

前面的示例删除了 的会话。id4db5efcc-99cb-4d05-a52c-b49acfbb7ea9