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

检索会话

若要检索会话,请向 发出请求,如以下基于 curl 的示例所示:GET/actuator/sessionsSpring中文文档

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

前面的示例检索用户名为 的用户的所有会话。 生成的响应类似于以下内容:aliceSpring中文文档

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

{
  "sessions" : [ {
    "id" : "9265cb2f-f745-4cbe-8ab2-989db205b6c9",
    "attributeNames" : [ ],
    "creationTime" : "2024-06-20T07:58:12.571690121Z",
    "lastAccessedTime" : "2024-06-20T09:58:00.571690942Z",
    "maxInactiveInterval" : 1800,
    "expired" : false
  }, {
    "id" : "4db5efcc-99cb-4d05-a52c-b49acfbb7ea9",
    "attributeNames" : [ ],
    "creationTime" : "2024-06-20T04:58:12.571685051Z",
    "lastAccessedTime" : "2024-06-20T09:57:35.571687325Z",
    "maxInactiveInterval" : 1800,
    "expired" : false
  }, {
    "id" : "a2aecd64-d9e9-4102-a42b-0db8836a13bd",
    "attributeNames" : [ ],
    "creationTime" : "2024-06-19T21:58:12.570931001Z",
    "lastAccessedTime" : "2024-06-20T09:57:27.570937924Z",
    "maxInactiveInterval" : 1800,
    "expired" : false
  } ]
}

查询参数

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

参数 描述

usernameSpring中文文档

用户的名称。Spring中文文档

响应结构

响应包含匹配会话的详细信息。 下表描述了响应的结构:Spring中文文档

路径 类型 描述

sessionsSpring中文文档

ArraySpring中文文档

给定用户名的会话。Spring中文文档

sessions.[].idSpring中文文档

StringSpring中文文档

会话的 ID。Spring中文文档

sessions.[].attributeNamesSpring中文文档

ArraySpring中文文档

会话中存储的属性的名称。Spring中文文档

sessions.[].creationTimeSpring中文文档

StringSpring中文文档

创建会话的时间戳。Spring中文文档

sessions.[].lastAccessedTimeSpring中文文档

StringSpring中文文档

上次访问会话的时间戳。Spring中文文档

sessions.[].maxInactiveIntervalSpring中文文档

NumberSpring中文文档

会话过期前允许的最长非活动时间(以秒为单位)。Spring中文文档

sessions.[].expiredSpring中文文档

BooleanSpring中文文档

会话是否已过期。Spring中文文档

参数 描述

usernameSpring中文文档

用户的名称。Spring中文文档

路径 类型 描述

sessionsSpring中文文档

ArraySpring中文文档

给定用户名的会话。Spring中文文档

sessions.[].idSpring中文文档

StringSpring中文文档

会话的 ID。Spring中文文档

sessions.[].attributeNamesSpring中文文档

ArraySpring中文文档

会话中存储的属性的名称。Spring中文文档

sessions.[].creationTimeSpring中文文档

StringSpring中文文档

创建会话的时间戳。Spring中文文档

sessions.[].lastAccessedTimeSpring中文文档

StringSpring中文文档

上次访问会话的时间戳。Spring中文文档

sessions.[].maxInactiveIntervalSpring中文文档

NumberSpring中文文档

会话过期前允许的最长非活动时间(以秒为单位)。Spring中文文档

sessions.[].expiredSpring中文文档

BooleanSpring中文文档

会话是否已过期。Spring中文文档

检索单个会话

若要检索单个会话,请向 发出请求,如以下基于 curl 的示例所示:GET/actuator/sessions/{id}Spring中文文档

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

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

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-20T04:58:12.571685051Z","lastAccessedTime":"2024-06-20T09:57:35.571687325Z","maxInactiveInterval":1800,"expired":false}

响应结构

响应包含所请求会话的详细信息。 下表描述了响应的结构:Spring中文文档

路径 类型 描述

idSpring中文文档

StringSpring中文文档

会话的 ID。Spring中文文档

attributeNamesSpring中文文档

ArraySpring中文文档

会话中存储的属性的名称。Spring中文文档

creationTimeSpring中文文档

StringSpring中文文档

创建会话的时间戳。Spring中文文档

lastAccessedTimeSpring中文文档

StringSpring中文文档

上次访问会话的时间戳。Spring中文文档

maxInactiveIntervalSpring中文文档

NumberSpring中文文档

会话过期前允许的最长非活动时间(以秒为单位)。Spring中文文档

expiredSpring中文文档

BooleanSpring中文文档

会话是否已过期。Spring中文文档

路径 类型 描述

idSpring中文文档

StringSpring中文文档

会话的 ID。Spring中文文档

attributeNamesSpring中文文档

ArraySpring中文文档

会话中存储的属性的名称。Spring中文文档

creationTimeSpring中文文档

StringSpring中文文档

创建会话的时间戳。Spring中文文档

lastAccessedTimeSpring中文文档

StringSpring中文文档

上次访问会话的时间戳。Spring中文文档

maxInactiveIntervalSpring中文文档

NumberSpring中文文档

会话过期前允许的最长非活动时间(以秒为单位)。Spring中文文档

expiredSpring中文文档

BooleanSpring中文文档

会话是否已过期。Spring中文文档

删除会话

要删除会话,请向 发出请求,如以下基于 curl 的示例所示:DELETE/actuator/sessions/{id}Spring中文文档

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

前面的示例删除了 的会话。id4db5efcc-99cb-4d05-a52c-b49acfbb7ea9Spring中文文档