对于最新稳定版本,请使用Spring Boot 4.0.0spring-doc.cadn.net.cn

缓存(缓存)

缓存端点提供对应用程序缓存的访问。spring-doc.cadn.net.cn

检索所有缓存

要检索应用程序缓存,请获取请求/执行器/缓存如以下基于卷度的示例所示:spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/caches' -i -X GET

最终的响应类似于以下内容:spring-doc.cadn.net.cn

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

{
  "cacheManagers" : {
    "anotherCacheManager" : {
      "caches" : {
        "countries" : {
          "target" : "java.util.concurrent.ConcurrentHashMap"
        }
      }
    },
    "cacheManager" : {
      "caches" : {
        "cities" : {
          "target" : "java.util.concurrent.ConcurrentHashMap"
        },
        "countries" : {
          "target" : "java.util.concurrent.ConcurrentHashMap"
        }
      }
    }
  }
}

响应结构

响应包含应用程序缓存的详细信息。 下表描述了该反应的结构:spring-doc.cadn.net.cn

路径 类型 描述

缓存管理器spring-doc.cadn.net.cn

对象spring-doc.cadn.net.cn

缓存管理器由ID键入。spring-doc.cadn.net.cn

cacheManagers.*.cachesspring-doc.cadn.net.cn

对象spring-doc.cadn.net.cn

应用程序上下文中的缓存按名称键入。spring-doc.cadn.net.cn

cacheManagers.*.caches.*.targetspring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

本地缓存的完全限定名称。spring-doc.cadn.net.cn

按名称检索缓存

要按名称检索缓存,请设置获取请求/执行器/缓存/{name}如以下基于卷度的示例所示:spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/caches/cities' -i -X GET

前面的例子检索了关于名为城市. 最终的响应类似于以下内容:spring-doc.cadn.net.cn

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

{
  "target" : "java.util.concurrent.ConcurrentHashMap",
  "name" : "cities",
  "cacheManager" : "cacheManager"
}

查询参数

如果请求的名称足够具体以识别单个缓存,则无需额外参数。 否则,缓存管理器必须说明。 下表显示了支持的查询参数:spring-doc.cadn.net.cn

参数 描述

缓存管理器spring-doc.cadn.net.cn

用来限定缓存的 cacheManager 名称。如果缓存名称是唯一的,可以省略。spring-doc.cadn.net.cn

响应结构

响应包含请求缓存的详细信息。 下表描述了该反应的结构:spring-doc.cadn.net.cn

路径 类型 描述

名称spring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

缓存名称。spring-doc.cadn.net.cn

缓存管理器spring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

缓存管理器名称。spring-doc.cadn.net.cn

目标spring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

本地缓存的完全限定名称。spring-doc.cadn.net.cn

驱逐所有缓存

要清除所有可用缓存,请设置删除请求/执行器/缓存如下基于卷度的示例所示:spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/caches' -i -X DELETE

按名称驱逐缓存

要驱逐某个缓存,请设置删除请求/执行器/缓存/{name}如下基于卷度的示例所示:spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/caches/countries?cacheManager=anotherCacheManager' -i -X DELETE \
    -H 'Content-Type: application/x-www-form-urlencoded'
因为有两个名为状态缓存管理器必须提供以指定哪种情况缓存应该已经清理干净了。

请求结构

如果请求的名称足够具体以识别单个缓存,则无需额外参数。 否则,缓存管理器必须说明。 下表显示了支持的查询参数:spring-doc.cadn.net.cn

参数 描述

缓存管理器spring-doc.cadn.net.cn

用来限定缓存的 cacheManager 名称。如果缓存名称是唯一的,可以省略。spring-doc.cadn.net.cn