|
对于最新稳定版本，请使用Spring Framework 7.0.1！ |
HTTP 缓存
HTTP 缓存可以显著提升网页应用的性能。HTTP 缓存
围绕缓存控制响应头及后续条件请求
头部，例如最后修改版和ETag.缓存控制建议私人（例如浏览器）
以及公共（例如代理）缓存，如何缓存和重用响应。一ETag使用 头部
如果提出一个可能导致304（NOT_MODIFIED）但没有正体的条件请求，
前提是内容没有变化。ETag可以看作是 的更高级继任者
这最后修改版页眉。
本节介绍了 Spring WebFlux 中可用的 HTTP 缓存相关选项。
缓存控制
缓存控制提供支持
配置与缓存控制标头和被接受为参数
在多个地方：
而RFC 7234描述了所有可能的情况
关于缓存控制响应头，该缓存控制类型取 a
采用以案例为导向的方法，聚焦于常见场景，如下示例所示：
-
Java
-
Kotlin
// Cache for an hour - "Cache-Control: max-age=3600"
CacheControl ccCacheOneHour = CacheControl.maxAge(1, TimeUnit.HOURS);
// Prevent caching - "Cache-Control: no-store"
CacheControl ccNoStore = CacheControl.noStore();
// Cache for ten days in public and private caches,
// public caches should not transform the response
// "Cache-Control: max-age=864000, public, no-transform"
CacheControl ccCustom = CacheControl.maxAge(10, TimeUnit.DAYS).noTransform().cachePublic();// Cache for an hour - "Cache-Control: max-age=3600"
val ccCacheOneHour = CacheControl.maxAge(1, TimeUnit.HOURS)
// Prevent caching - "Cache-Control: no-store"
val ccNoStore = CacheControl.noStore()
// Cache for ten days in public and private caches,
// public caches should not transform the response
// "Cache-Control: max-age=864000, public, no-transform"
val ccCustom = CacheControl.maxAge(10, TimeUnit.DAYS).noTransform().cachePublic()控制器
控制器可以添加对HTTP缓存的明确支持。我们建议这样做，因为最后修改或ETag资源的价值需要先计算，才能进行比较
与条件请求头对抗。控制器可以添加ETag和缓存控制设置到响应实体，如下示例所示：
-
Java
-
Kotlin
@GetMapping("/book/{id}")
public ResponseEntity<Book> showBook(@PathVariable Long id) {
Book book = findBook(id);
String version = book.getVersion();
return ResponseEntity
.ok()
.cacheControl(CacheControl.maxAge(30, TimeUnit.DAYS))
.eTag(version) // lastModified is also available
.body(book);
}@GetMapping("/book/{id}")
fun showBook(@PathVariable id: Long): ResponseEntity<Book> {
val book = findBook(id)
val version = book.getVersion()
return ResponseEntity
.ok()
.cacheControl(CacheControl.maxAge(30, TimeUnit.DAYS))
.eTag(version) // lastModified is also available
.body(book)
}前NOT_MODIFIED例如果比较
条件请求头表示内容未变。否则，ETag和缓存控制响应中会添加报头。
你也可以在控制器中对条件请求头进行检查， 如下示例所示：
-
Java
-
Kotlin
@RequestMapping
public String myHandleMethod(ServerWebExchange exchange, Model model) {
long eTag = ... (1)
if (exchange.checkNotModified(eTag)) {
return null; (2)
}
model.addAttribute(...); (3)
return "myViewName";
}| 1 | 应用特定计算。 |
| 2 | 响应已设置为304（NOT_MODIFIED）。没有进一步处理。 |
| 3 | 继续处理请求。 |
@RequestMapping
fun myHandleMethod(exchange: ServerWebExchange, model: Model): String? {
val eTag: Long = ... (1)
if (exchange.checkNotModified(eTag)) {
return null(2)
}
model.addAttribute(...) (3)
return "myViewName"
}| 1 | 应用特定计算。 |
| 2 | 响应已设置为304（NOT_MODIFIED）。没有进一步处理。 |
| 3 | 继续处理请求。 |
有三种变体用于对条件请求进行检查eTag值最后修改价值观，或者两者兼有。对于条件式获取和头请求时，你可以将响应设置为
304（NOT_MODIFIED）。对于条件式发布,放和删除，你可以设置响应
为防止同时修改，定为412（PRECONDITION_FAILED）。
静态资源
你应该用缓存控制以及条件响应头
为了最佳性能。参见配置静态资源的部分。