|
此版本仍在开发中，尚不被认为是稳定的。对于最新的稳定版本，请使用 Spring Framework 6.2.10！ |
HTTP 缓存
HTTP 缓存可以显着提高 Web 应用程序的性能。HTTP 缓存
围绕着Cache-Control响应标头和后续条件请求
标头，例如Last-Modified和ETag.Cache-Control建议私有（例如浏览器）
public （例如，proxy） 缓存如何缓存和重用响应。一ETagheader 被使用
要提出可能导致没有正文的 304 （NOT_MODIFIED） 的条件请求，
如果内容没有改变。ETag可以看作是更复杂的继任者
这Last-Modified页眉。
本节介绍 Spring WebFlux 中可用的 HTTP 缓存相关选项。
CacheControl
CacheControl提供支持
配置与Cache-Control标头，并被接受为参数
在许多地方：
虽然 RFC 7234 描述了所有可能的
指令Cache-Controlresponse 标头，CacheControl类型采用
面向用例的方法，专注于常见场景，如以下示例所示：
-
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 缓存的显式支持。我们建议这样做，因为lastModified或ETag需要先计算资源的值，然后才能进行比较
针对条件请求标头。控制器可以添加ETag和Cache-Controlsettings 设置为ResponseEntity，如以下示例所示：
-
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)
}前面的示例发送一个 304 （NOT_MODIFIED） 响应，如果比较
到条件请求标头表示内容未更改。否则，ETag和Cache-Control标头将添加到响应中。
您还可以对控制器中的条件请求标头进行检查， 如以下示例所示：
-
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值lastModified值，或两者。对于有条件的GET和HEAD请求，您可以将响应设置为
304 （NOT_MODIFIED）。对于有条件的POST,PUT和DELETE，您可以改为设置响应
设置为 412 （PRECONDITION_FAILED） 以防止并发修改。
静态资源
您应该使用Cache-Control和条件响应标头以获得最佳性能。请参阅有关配置静态资源的部分。