API 版本控制

在 Servlet 堆栈中查看等效项spring-doc.cadn.net.cn

这是 API 版本控制的核心策略，它包含所有配置的首选项 与版本控制相关。它执行以下作：spring-doc.cadn.net.cn

ApiVersionStrategy有助于将请求映射到@RequestMapping控制器方法， 并由 WebFlux 配置初始化。通常，应用程序不会交互 直接与它一起使用。spring-doc.cadn.net.cn

在 Servlet 堆栈中查看等效项spring-doc.cadn.net.cn

此策略从请求中解析 API 版本。WebFlux 配置提供内置的 从标头解析的选项、查询参数、媒体类型参数、 或从 URL 路径。您还可以使用自定义ApiVersionResolver.spring-doc.cadn.net.cn

在 Servlet 堆栈中查看等效项spring-doc.cadn.net.cn

此策略有助于将原始版本值解析为Comparable<?>，这有助于 比较、排序和选择版本。默认情况下，内置的SemanticApiVersionParser将版本解析为major,minor和patWebFluxchinteger 值。次要和补丁 如果不存在，则值设置为 0。spring-doc.cadn.net.cn

在 Servlet 堆栈中查看等效项spring-doc.cadn.net.cn

如果不支持请求版本，InvalidApiVersionException被引发，导致 在 400 个回复中。默认情况下，支持的版本列表是从 declared 版本，但您可以通过 WebFlux 配置，并且仅使用配置中显式配置的版本。spring-doc.cadn.net.cn

默认情况下，启用 API 版本控制时需要版本，并且MissingApiVersionException如果不存在，则会引发 400 响应。 您可以将其设为可选，在这种情况下，将使用最新版本。 您还可以指定要使用的默认版本。spring-doc.cadn.net.cn

请参阅响应式堆栈中的等效项spring-doc.cadn.net.cn

可以将此策略配置为将有关已弃用版本的提示和信息发送到 客户端通过响应标头。内置的StandardApiVersionDeprecationHandler可以设置 RFC 9745 和 RFC 8594 中定义的“弃用”、“日落”标头和“链接”标头。您还可以配置自定义 处理程序。spring-doc.cadn.net.cn

在 Servlet 堆栈中查看等效项spring-doc.cadn.net.cn

ApiVersionStrategy支持将请求映射到带注释的控制器方法。 有关更多详细信息，请参阅 API 版本。spring-doc.cadn.net.cn