Web on Servlet Stack

您可以通过在您的Spring配置中声明多个HandlerExceptionResolverBean并根据需要设置它们的顺序属性来形成异常解析器链。Order属性越高，异常解决程序的定位就越晚。

HandlerExceptionResolver的约定指定它可以返回：

MVC配置自动为默认的Spring MVC异常、@ResponseStatus注释的异常以及对@ExceptionHandler方法的支持声明内置的解析器。您可以自定义或替换该列表。

如果任何HandlerExceptionResolver仍未解决异常，并因此将其留给传播，或者如果响应状态设置为错误状态(即4xx、5xx)，则Servlet容器可以在HTML中呈现默认错误页面。要定制容器的默认错误页，可以在web.xml中声明错误页映射。以下示例显示了如何执行此操作：

在前面的示例中，当出现异常或响应具有错误状态时，Servlet容器会在容器内将错误分派到配置的URL(例如，/error)。然后由DispatcherServlet进行处理，可能会将其映射到@Controller，可以实现该方法来返回带有模型的错误视图名或呈现JSON响应，如下面的示例所示：

WebFlux

您可以通过声明多个解析器Bean来链接视图解析器，如果需要，还可以通过设置order属性来指定排序。请记住，Order属性越高，视图解析器在链中的位置就越晚。

ViewResolver的约定指定它可以返回NULL以指示找不到该视图。然而，对于JSP和InternalResourceViewResolver，确定是否存在JSP的唯一方法是通过RequestDispatcher执行分派。因此，您必须始终将InternalResourceViewResolver配置为在视图解析器的总体顺序中最后。

配置视图解析非常简单，只需将ViewResolverBean添加到您的Spring配置中。MVC配置为视图解析器和添加无逻辑的视图控制器提供了专用的配置API，这对于在没有控制器逻辑的情况下呈现HTML模板非常有用。

WebFlux

视图名称中的特殊reDirect：前缀允许您执行重定向。UrlBasedViewResolver(及其子类)将此识别为需要重定向的指令。视图名称的其余部分是重定向URL。

实际效果与控制器返回RedirectView相同，但现在控制器本身可以根据逻辑视图名称进行操作。逻辑视图名称(如reDirect：/myapp/ome/resource)相对于当前Servlet上下文进行重定向，而诸如redirect:https://myhost.com/some/arbitrary/path之类的名称则重定向到绝对URL。

请注意，如果控制器方法使用@ResponseStatus进行注释，则该注释值优先于RedirectView设置的响应状态。

您还可以为最终由UrlBasedViewResolver和子类解析的视图名称使用特殊的Forward：前缀。这将创建一个InternalResourceView，它执行RequestDispatcher.ward()。因此，这个前缀对于InternalResourceViewResolver和InternalResourceView(对于JSP)没有用处，但如果您使用另一种视图技术，但仍然希望强制由Servlet/JSP引擎处理资源的转发，则它可能会很有帮助。请注意，您也可以改为链接多个视图解析器。

WebFlux

ContentNegotiatingViewResolver本身并不解析视图，而是委托给其他视图解析器，并选择与客户端请求的表示类似的视图。表示形式可以从Accept头或查询参数(例如，“/Path？Format=pdf”)确定。

通过将请求的媒体类型与与其每个ViewResolver相关联的View所支持的媒体类型(也称为Content-Type)进行比较，Content NeatheratingViewResolver选择适当的View来处理请求。列表中具有兼容Content-Type的第一个View将表示形式返回给客户端。如果ViewResolver链无法提供兼容的视图，则会参考通过DefaultViews属性指定的视图列表。后一种选项适用于单独的视图，它可以呈现当前资源的适当表示形式，而不考虑逻辑视图名称。Accept标头可以包括通配符(例如，Text/*)，在这种情况下，其Content-Type为Text/XML视图是兼容匹配。

有关配置详情，请参阅MVC配置下的查看解析程序。

除了获取客户的区域设置外，了解其时区通常也很有用。LocaleContextResolver接口提供了LocaleResolver的扩展，使解析程序可以提供更丰富的LocaleContext，其中可能包括时区信息。

如果可用，则可以使用RequestContext.getTimeZone()方法获取用户的时区。时区信息由向Spring的ConversionService注册的任何日期/时间Converter和Formatter对象自动使用。

此区域设置解析器检查客户端(例如，Web浏览器)发送的请求中的Accept-Language头。通常，此标头字段包含客户端操作系统的区域设置。请注意，此解析程序不支持时区信息。

此区域设置解析器检查客户端上可能存在的Cookie，以确定是否指定了区域设置或时区。如果是，则使用指定的详细信息。通过使用此区域设置解析器的属性，您可以指定Cookie的名称以及最长期限。下面的示例定义CookieLocaleResolver：

下表介绍了CookieLocaleResolver属性：

SessionLocaleResolver允许您从可能与用户请求相关联的会话中检索区域设置和时区。与CookieLocaleResolver不同，该策略将本地选择的区域设置存储在Servlet容器的HttpSession中。因此，这些设置对于每个会话都是临时的，因此在每个会话结束时会丢失。

请注意，这与外部会话管理机制(如Spring Session项目)没有直接关系。此SessionLocaleResolver针对当前HttpServletRequest计算和修改相应的HttpSession属性。

您可以通过将LocaleChangeInterceptor添加到一个HandlerMapping定义来启用区域设置更改。它检测请求中的参数并相应地更改区域设置，在Dispatcher的应用程序上下文中对LocaleResolver调用setLocale方法。下一个示例显示，对包含名为siteLanguage的参数的所有*.view资源的调用现在更改了区域设置。例如，对 https://www.sf.net/home.view?siteLanguage=nl，>

要在Web应用程序中使用主题，必须设置org.springframework.ui.context.ThemeSource接口的实现。WebApplicationContext接口扩展ThemeSource，但将其职责委托给专用实现。默认情况下，委托是一个org.springframework.ui.context.support.ResourceBundleThemeSource实现，它从类路径的根目录加载属性文件。若要使用自定义ThemeSource实现或配置ResourceBundleThemeSource的基本名称前缀，您可以在应用程序上下文中使用保留名称ThemeSource注册一个Bean。Web应用程序上下文自动检测具有该名称的Bean并使用它。

当您使用ResourceBundleThemeSource时，主题是在一个简单的属性文件中定义的。属性文件列出了构成主题的资源，如下例所示：

属性的键是引用视图代码中的主题元素的名称。对于一个JSP，您通常使用Spring：Theme定制标记来实现这一点，这与Spring：Message标记非常相似。下面的JSP片段使用上一个示例中定义的主题来自定义外观：

默认情况下，ResourceBundleThemeSource使用空基名称前缀。因此，将从类路径的根目录加载属性文件。因此，您应该将Cool.Properties主题定义放在类路径根目录下的一个目录中(例如，/WEB-INF/CLASSES)。ResourceBundleThemeSource使用标准的Java资源包加载机制，允许主题完全国际化。例如，我们可以有一个引用带有荷兰语文本的特殊背景图像的/WEB-INF/classes/cool_nl.properties。

定义主题后，如上一节所述，您将决定使用哪个主题。DispatcherServlet查找名为hemeResolver的Bean，以找出要使用哪个ThemeResolver实现。主题解析器的工作方式与LocaleResolver基本相同。它检测用于特定请求的主题，还可以更改请求的主题。下表介绍了Spring提供的主题解析器：

Spring还提供了一个ThemeChangeInterceptor，它允许通过一个简单的请求参数对每个请求进行主题更改。

要使用Apache CommonsFileUpload，可以将CommonsMultipartResolver类型的Bean配置为MultipartResolver。您还需要将Commons-FileuploadJAR作为类路径的依赖项。

这个解析器变体委托给应用程序中的一个本地库，从而提供最大限度的跨Servlet容器的可移植性。作为替代方案，可以考虑通过容器自己的解析器进行标准的Servlet多部分解析，如下所述。

Servlet多部分解析需要通过Servlet容器配置来启用。要执行此操作，请执行以下操作：

以下示例显示如何在Servlet注册上设置MultipartConfigElement：

一旦Servlet多部分配置就绪，您就可以添加名为MultipartResolver的类型为StandardServletMultipartResolver的Bean。

WebFlux

调试和跟踪日志记录可能会记录敏感信息。这就是为什么默认情况下会屏蔽请求参数和标头，并且必须通过DispatcherServlet上的enableLoggingRequestDetails属性显式启用它们的完整日志记录。

以下示例显示如何使用Java配置执行此操作：

WebFlux

在某些情况下，您可能需要在运行时使用AOP代理来装饰控制器。一个例子是，如果您选择在控制器上直接使用@Transaction注释。在这种情况下，特别是对于控制器，我们建议使用基于类的代理。直接在控制器上使用此类注释时会自动出现这种情况。

如果控制器实现了一个接口，并且需要AOP代理，您可能需要显式地配置基于类的代理。例如，使用<代码>@EnableTransactionManagement 可以更改为@EnableTransactionManagement(proxyTargetClass=TRUE) ，使用<代码><；tx：批注驱动/>； 可以更改为<代码><；tx：批注驱动的代理-目标类=“True”/>； 。

WebFlux

@Requestmap方法可以使用URL模式进行映射。有两种选择：

PathPattern是推荐的Web应用解决方案，也是Spring WebFlux的唯一选择。它是从5.3版开始在Spring MVC中启用的，从6.0版开始默认启用。有关路径匹配选项的自定义，请参阅MVC配置。

PathPattern支持与AntPathMatcher相同的模式语法。此外，它还支持捕获模式，例如{*Spring}，匹配路径末尾的0个或多个路径段。PathPattern还限制使用**匹配多个路径段，以便只允许在模式的末尾使用。这消除了在为给定请求选择最佳匹配模式时的许多模糊情况。有关完整的模式语法，请参考PathPattern和AntPathMatcher。

以下是一些模式示例：

捕获的URI变量可以通过@PathVariable访问。例如：

您可以在类和方法级别声明URI变量，如下面的示例所示：

URI变量将自动转换为适当的类型，否则将引发TypeMismatchException。默认支持简单类型(int、long、Date等)，您可以注册对任何其他数据类型的支持。请参阅类型转换和数据活页夹。

您可以显式命名URI变量(例如，@PathVariable(“CustomID”))，但如果名称相同，并且您的代码是使用调试信息或使用Java 8上的-参数编译器标志编译的，则可以省略该细节。

语法{varName：regex}使用语法为{varName：regex}的正则表达式声明URI变量。例如，给定URL“/Spring-web-3.0.5.jar”，以下方法提取名称、版本和文件扩展名：

URI路径模式还可以嵌入${…通过对本地、系统、环境和其他属性源使用PropertySourcesPlaceholderConfigurer在启动时解析的​}占位符。例如，您可以使用它来基于某些外部配置对基本URL进行参数化。

WebFlux

当多个模式与一个URL匹配时，必须选择最佳匹配。这是通过以下方法之一完成的，具体取决于是否启用了已解析的PathPattern：

两者都有助于对模式进行排序，更具体的模式位于顶部。如果模式具有较少的URI变量(计数为1)、单通配符(计数为1)和双通配符(计数为2)，则该模式不太具体。如果得分相等，则选择较长的模式。在给定相同分数和长度的情况下，选择URI变量多于通配符的模式。

默认映射模式(/**)从评分中排除，始终排在最后。此外，前缀模式(如/public/**)被认为没有其他没有双通配符的模式那么具体。

有关完整的详细信息，请访问上面的模式比较器链接。

从5.3开始，默认情况下，Spring MVC不再执行.*后缀模式匹配，其中映射到/Person的控制器也隐式映射到/Person.*。因此，不再使用路径扩展来解释响应 - 所请求的内容类型，例如，<代码>/Pers.pdf 、<代码>/Pers.xml 等等。

当浏览器发送难以一致解释的接受头时，必须以这种方式使用文件扩展名。目前，这不再是必需的，使用Accept头应该是首选。

随着时间的推移，文件扩展名的使用在各种方面都被证明是有问题的。当使用URI变量、路径参数和URI编码进行覆盖时，可能会导致歧义。关于基于URL的授权和安全性(有关更多详细信息，请参阅下一节)的推理也变得更加困难。

要在5.3之前的版本中完全禁用路径扩展，请设置以下设置：

除了通过“Accept”头请求内容类型之外，还有一种方法仍然很有用，例如在浏览器中键入URL时。路径扩展的安全替代方案是使用查询参数策略。如果您必须使用文件扩展名，则可以考虑通过Content NeatherationConfigurer的mediaTypes属性将它们限制为显式注册的扩展名列表。

反射文件下载(RFD)攻击类似于XSS，因为它依赖于响应中反映的请求输入(例如，查询参数和URI变量)。然而，RFD攻击不是将JavaScript插入到HTML中，而是依靠浏览器切换来执行下载，并在以后双击时将响应视为可执行脚本。

在Spring MVC中，@ResponseBody和ResponseEntity方法面临风险，因为它们可以呈现不同的内容类型，客户端可以通过URL路径扩展请求这些内容类型。禁用后缀模式匹配并使用路径扩展进行内容协商可以降低风险，但不足以防止RFD攻击。

为了防止RFD攻击，在呈现响应正文之前，Spring MVC添加了一个Content-Disposition:inline；filename=f.txt头来建议一个固定且安全的下载文件。仅当URL路径包含既不允许作为安全的文件扩展名，也不显式注册用于内容协商的文件扩展名时，才会执行此操作。然而，当URL直接输入到浏览器中时，它可能会产生副作用。

默认情况下，许多常见路径扩展都是安全的。具有自定义HttpMessageConverter实现的应用程序可以显式注册用于内容协商的文件扩展名，以避免为这些扩展名添加Content-Disposal头。参见内容类型。

有关RFD的其他建议，请参阅CVE-2015-5211。

WebFlux

您可以根据请求的Content-Type缩小请求映射范围，如下例所示：

<代码>消耗 属性还支持否定表达式 - 例如，<代码>！文本/普通 表示除<代码>文本/普通 以外的任何内容类型。

您可以在类级别声明共享的消耗属性。然而，与大多数其他请求映射属性不同，当在类级别使用时，方法级别的使用属性覆盖，而不是扩展类级别声明。

WebFlux

您可以根据Accept请求头和控制器方法生成的内容类型列表来缩小请求映射范围，如下例所示：

媒体类型可以指定一个字符集。 - 支持否定表达式例如，<代码>！文本/纯文本 表示除“文本/纯文本”之外的任何内容类型。

您可以在类级别声明共享的Products属性。然而，与大多数其他请求映射属性不同，当在类级别使用时，方法级别的会生成属性覆盖，而不是扩展类级别声明。

WebFlux

您可以根据请求参数条件缩小请求映射范围。您可以测试请求参数(myParam)是否存在(！myParam)或特定值(myParam=myValue)。以下示例显示如何测试特定值：

您还可以对请求标头条件使用相同的方法，如下例所示：

WebFlux

@Getmap(和@RequestMapping(method=HttpMethod.GET))透明支持HTTPHead进行请求映射。控制器方法不需要更改。在jakarta.servlet.http.HttpServlet，中应用的响应包装器确保将Content-Length头设置为写入的字节数(而不实际写入响应)。

@Getmap(和@RequestMapping(method=HttpMethod.GET))隐式映射到HTTPHead，支持HTTPHead。HTTP Head请求被当作HTTP GET进行处理，不同之处在于，不是写入正文，而是计算字节数并设置Content-Length头。

默认情况下，通过将Allow响应标头设置为具有匹配URL模式的所有@Requestmap方法中列出的HTTP方法列表来处理HTTP选项。

对于没有HTTP方法声明的@Requestmap，Allow标头设置为GET、Head、POST、PUT、Patch、Delete、Options。控制器方法应该始终声明受支持的HTTP方法(例如，使用特定于HTTP方法的变量：@Getmap、@Postmap等)。

您可以显式地将@Requestmap方法映射到HTTPHead和HTTP选项，但在常见情况下这不是必需的。

WebFlux

Spring MVC支持使用组合注释进行请求映射。这些批注本身使用@RequestMapping进行了元批注，并被组合以使用更窄、更具体的目的重新声明@Requestmap属性的一个子集(或全部)。

@Getmap、@Postmap、@Putmap、@Deletemap和@Patchmap是合成批注的示例。之所以提供它们，是因为可以说，大多数控制器方法都应该映射到特定的HTTP方法，而不是使用@Requestmap，后者在默认情况下与所有HTTP方法匹配。如果您需要组合注释的示例，请看一下这些注释是如何声明的。

Spring MVC还支持使用定制请求匹配逻辑的定制请求映射属性。这是一个更高级的选项，它需要将RequestMappingHandlerMapping子类化并覆盖getCustomMethodCondition方法，在该方法中您可以检查自定义属性并返回您自己的RequestCondition。

WebFlux

您可以通过编程方式注册处理程序方法，这些方法可用于动态注册或高级情况，例如同一处理程序在不同URL下的不同实例。下面的示例注册一个处理程序方法：

WebFlux

下表描述了支持的控制器方法参数。任何参数都不支持反应类型。

支持将JDK 8的java.util.Optional作为方法参数，并将其与具有RequestParam属性(例如，@RequestParam、@RequestHeader等)的批注结合使用，并等同于RequestHeader=False。

WebFlux

下表描述了支持的控制器方法返回值。所有返回值都支持反应类型。

WebFlux

一些表示基于字符串的请求输入的带注释的控制器方法参数(如@RequestParam、@RequestHeader、@PathVariable、@MatrixVariable和@CookieValue)如果声明为字符串以外的内容，可能需要类型转换。

对于此类情况，将根据配置的转换器自动应用类型转换。默认支持简单类型(int、long、Date等)。您可以通过WebDataBinder(请参阅DataBinder)或通过向FormattingConversionService注册FormattingConversionService来自定义类型转换。请参阅Spring字段格式。

类型转换中的一个实际问题是空字符串源值的处理。如果此类值由于类型转换而变为NULL，则将其视为缺少。long、uuid和其他目标类型可能是这种情况。如果要允许注入Null，请在参数批注上使用Required标志，或者将参数声明为@Nullable。

WebFlux

RFC 3986讨论路径段中的名称-值对。在Spring MVC中，我们将基于Tim Berners-Lee的“old post”的那些称为“矩阵变量”，但它们也可以称为URI路径参数。

矩阵变量可以出现在任何路径段中，每个变量用分号分隔，多个值用逗号分隔(例如，/car；COLOR=红、绿；Year=2012)。还可以通过重复的变量名(例如，color=red；color=green；color=blue).)指定多个值

如果URL预期包含矩阵变量，则控制器方法的请求映射必须使用URI变量来屏蔽该变量的内容，并确保请求可以成功匹配，而与矩阵变量的顺序和存在无关。下面的示例使用矩阵变量：

考虑到所有路径段都可能包含矩阵变量，有时可能需要明确矩阵变量应该在哪个路径变量中。以下示例显示了如何执行此操作：

可以将矩阵变量定义为可选并指定默认值，如下例所示：

要获取所有矩阵变量，可以使用MultiValueMap，如下例所示：

注意，您需要启用矩阵变量的使用。在MVC Java配置中，需要通过路径匹配设置一个UrlPath Helper，emoveSemicolonContent=FALSE。在MVC XML命名空间中，您可以设置<；mvc：注解驱动的启用矩阵变量=“true”/>；。

WebFlux

您可以使用@RequestParam注释将Servlet请求参数(即查询参数或表单数据)绑定到控制器中的方法参数。

以下示例显示了如何执行此操作：

默认情况下，使用该批注的方法参数是必需的，但您可以通过将@RequestParam批注的Required标志设置为FALSE，或通过使用java.util.Optional包装器声明参数，来指定方法参数是可选的。

如果目标方法参数类型不是字符串，则自动应用类型转换。请参阅类型转换。

将参数类型声明为数组或列表允许为同一参数名称解析多个参数值。

当@RequestParam批注声明为Map<；字符串或MultiValueMap<；字符串，而没有在批注中指定参数名称时，则使用每个给定参数名称的请求参数值填充映射。

注意，@RequestParam的使用是可选的(例如，设置其属性)。默认情况下，任何简单值类型的参数(由BeanUtils#isSimpleProperty确定)并且不被任何其他参数解析器解析，将被视为使用@RequestParam注释。

WebFlux

您可以使用@RequestHeader注释将请求头绑定到控制器中的方法参数。

请考虑以下带有标头的请求：

下面的示例获取Accept-Ending和Keep-Alive标头的值：

如果目标方法参数类型不是字符串，则自动应用类型转换。请参阅类型转换。

当@RequestHeader批注用于Map<；字符串、字符串>；、MultiValueMap<；字符串、字符串>；或HttpHeaders参数时，映射将填充所有标头值。

WebFlux

您可以使用@CookieValue注释将HTTP cookie的值绑定到控制器中的方法参数。

考虑具有以下Cookie的请求：

以下示例显示如何获取Cookie值：

如果目标方法参数类型不是字符串，则自动应用类型转换。请参阅类型转换。

WebFlux

您可以在方法参数上使用@ModelAttribute注释来访问模型中的属性，如果该属性不存在，则将其实例化。模型属性还覆盖了来自HTTP Servlet请求参数的值，这些参数的名称与字段名称匹配。这称为数据绑定，它使您不必解析和转换单个查询参数和表单域。以下示例显示了如何执行此操作：

上面的Pet实例的来源如下：

使用@ModelAttribute方法提供它或依赖框架创建模型属性的一种替代方法是使用Converter<；字符串来提供实例。当模型属性名称与请求值的名称(如路径变量或请求参数)匹配，并且存在字符串到模型属性类型的转换器时，将应用此方法。在下面的示例中，模型属性名称为Account，它与URI路径变量Account匹配，并且有一个注册的Converter<；字符串Account&>可以从数据存储加载Account：

获取模型属性实例后，应用数据绑定。WebDataBinder类将Servlet请求参数名称(查询参数和表单字段)与目标对象上的字段名称匹配。必要时，在应用类型转换后填充匹配的字段。有关数据绑定(和验证)的更多信息，请参阅验证。有关定制数据绑定的更多信息，请参阅DataBinder。

数据绑定可能会导致错误。默认情况下，会引发绑定异常。但是，要检查控制器方法中的此类错误，可以在@ModelAttribute旁边添加BindingResult参数，如下面的示例所示：

在某些情况下，您可能希望在没有数据绑定的情况下访问模型属性。对于这种情况，您可以将Model注入控制器并直接访问它，或者设置@ModelAttribute(Binding=False)，如下例所示：

您可以通过添加jakarta.validation.Valid注释或Spring的@valated注释(Bean验证和Spring验证)，在数据绑定后自动应用验证。以下示例显示了如何执行此操作：

注意，使用@ModelAttribute是可选的(例如，设置其属性)。默认情况下，任何不是简单值类型(由BeanUtils#isSimpleProperty确定)且不能由任何其他参数解析器解析的参数都被视为使用@ModelAttribute进行了注释。

WebFlux

@SessionAttributes用于在请求之间的HTTP Servlet会话中存储模型属性。它是一个类型级别的注释，用于声明特定控制器使用的会话属性。这通常会列出模型属性的名称或模型属性的类型，它们应该透明地存储在会话中，以供后续请求访问。

下面的示例使用@SessionAttributes批注：

在第一次请求时，当名为pet的模型属性添加到模型中时，它会自动提升到HTTP Servlet会话中并保存在其中。它一直保留在那里，直到另一个控制器方法使用SessionStatus方法参数清除存储空间，如下面的示例所示：

WebFlux

如果您需要访问预先存在的会话属性，这些属性是全局管理的(即，在控制器 - 之外，例如由筛选器管理)，并且可能存在也可能不存在，则可以在方法参数上使用@SessionAttribute批注，如下面的示例所示：

对于需要添加或删除会话属性的用例，可以考虑将org.springframework.web.context.request.WebRequest或jakarta.servlet.http.HttpSession注入控制器方法。

要将模型属性临时存储在会话中作为控制器工作流的一部分，请考虑使用@SessionAttributes，如@SessionAttributes中所述。

WebFlux

与@SessionAttribute类似，您可以使用@RequestAttribute注释来访问先前创建的预先存在的请求属性(例如，通过ServletFilter或HandlerInterceptor)：

默认情况下，所有模型属性都被视为在重定向URL中公开为URI模板变量。在剩余的属性中，那些是基元类型、基元类型集合或基元类型数组的属性会自动附加为查询参数。

如果专门为重定向准备了模型实例，则将原始类型属性附加为查询参数可能是所需的结果。但是，在带注释的控制器中，模型可以包含出于呈现目的而添加的其他属性(例如，下拉字段值)。为了避免此类属性出现在URL中的可能性，@Requestmap方法可以声明RedirectAttributes类型的参数，并使用它来指定使RedirectView可用的确切属性。如果该方法确实重定向，则使用RedirectAttributes的内容。否则，将使用模型的内容。

RequestMappingHandlerAdapter提供了一个名为Ignore reDefaultModelOnReDirect的标志，您可以使用该标志来指示如果控制器方法重定向，则永远不应使用默认Model的内容。相反，控制器方法应该声明一个RedirectAttributes类型的属性，如果它没有这样做，则不应该将任何属性传递给RedirectView。MVC名称空间和MVC Java配置都将该标志设置为False，以保持向后兼容性。但是，对于新应用程序，我们建议将其设置为true。

请注意，当前请求中的URI模板变量在展开重定向URL时自动可用，您不需要通过Model或RedirectAttributes显式添加它们。以下示例显示如何定义重定向：

将数据传递到重定向目标的另一种方式是使用闪存属性。与其他重定向属性不同，Flash属性保存在HTTP会话中(因此不会出现在URL中)。有关详细信息，请参阅Flash属性。

Flash属性为一个请求提供了一种存储要在另一个请求中使用的属性的方法。这是在重定向 - 时最常用的，例如，后重定向-获取模式。闪存属性在重定向之前临时保存(通常在会话中)，以供重定向后的请求使用，并立即删除。

Spring MVC有两个主要的抽象来支持Flash属性。FlashMap用于保存Flash属性，FlashMapManager用于存储、检索和管理FlashMap实例。

Flash属性支持始终处于“打开”状态，不需要显式启用。但是，如果不使用它，它永远不会导致创建HTTP会话。对于每个请求，都有一个“输入”FlashMap和一个“输出”FlashMap，前者具有从前一个请求传递的属性(如果有的话)，后者具有保存以备后续请求使用的属性。这两个FlashMap实例都可以通过RequestContextUtils中的静态方法从Spring MVC中的任何位置访问。

带注释的控制器通常不需要直接使用FlashMap。相反，@Requestmap方法可以接受RedirectAttributes类型的参数，并使用它为重定向场景添加闪存属性。通过重定向属性添加的Flash属性会自动传播到“输出”FlashMap。类似地，在重定向之后，来自“输入”FlashMap的属性会自动添加到提供目标URL的控制器的Model中。

WebFlux

在MultipartResolver启用后，带有Multipart/form-data的POST请求的内容将被解析，并可作为常规请求参数进行访问。下面的示例访问一个常规表单域和一个上载的文件：

将参数类型声明为list<；MultipartFile>；允许为同一参数名称解析多个文件。

当@RequestParam批注声明为Map<；字符串，MultipartFileMap；或MultiValueMap<；字符串，但没有在批注中指定参数名称时，则使用每个给定参数名称的多部分文件填充映射。

您还可以使用多部分内容作为命令对象数据绑定的一部分。例如，上例中的表单域和文件可以是Form对象上的域，如下面的示例所示：

在REST式服务场景中，还可以从非浏览器客户端提交多部分请求。以下示例显示了一个包含JSON的文件：

您可以使用@RequestParam作为字符串访问“meta-data”部分，但您可能希望将其从JSON反序列化(类似于@RequestBody)。在使用HttpMessageConverter转换分块后，使用@RequestPart注释可以访问该分块：

您可以将@RequestPart与jakarta.validation.Valid结合使用，也可以使用Spring的@valated注释，这两种方法都会导致应用标准Bean验证。默认情况下，验证错误会导致MethodArgumentNotValidException，该异常被转换为400(BAD_REQUEST)响应。或者，您可以通过Errors或BindingResult参数在控制器内本地处理验证错误，如下面的示例所示：

WebFlux

您可以使用 HttpMessageConverter.>@RequestBody 注释来读取请求正文，并通过 将其反序列化为<代码>对象 下面的示例使用 @RequestBody参数：

您可以使用MVC配置的消息转换器选项来配置或定制消息转换。

您可以将@RequestBody与jakarta.validation.Valid或Spring的@valated注释结合使用，这两个注释都会导致应用标准Bean验证。默认情况下，验证错误会导致MethodArgumentNotValidException，该异常被转换为400(BAD_REQUEST)响应。或者，您可以通过Errors或BindingResult参数在控制器内本地处理验证错误，如下面的示例所示：

WebFlux

HttpEntity与使用@RequestBody基本相同，但基于公开请求头和正文的容器对象。下面的清单显示了一个示例：

WebFlux

您可以在方法上使用@ResponseBody注释，通过HttpMessageConverter将返回序列化到响应体。下面的清单显示了一个示例：

@ResponseBody在类级别也受支持，在这种情况下，所有控制器方法都会继承它。这就是@RestController的效果，它只不过是一个用@Controller和@ResponseBody标记的元注释。

您可以对反应类型使用@ResponseBody。有关更多详细信息，请参阅异步请求和反应类型。

您可以使用MVC配置的消息转换器选项来配置或定制消息转换。

您可以将@ResponseBody方法与JSON序列化视图结合使用。详情请参阅Jackson JSON。

WebFlux

ResponseEntity类似于@ResponseBody，但有状态和头。例如：

Spring MVC支持使用单值反应类型为Body异步生成ResponseEntity和/或单值和多值反应类型。这允许以下类型的异步响应：

Spring提供对Jackson JSON库的支持。

WebFlux

在Web应用程序的上下文中，数据绑定涉及将HTTP请求参数(即表单数据或查询参数)绑定到模型对象及其嵌套对象中的属性。

只有遵循JavaBeans命名约定的公共属性才公开用于数据绑定-例如，FirstName()属性的公共字符串getFirstName()方法和FirstName属性的公共空setFirstName(字符串)方法。

默认情况下，Spring允许绑定到模型对象图中的所有公共属性。这意味着您需要仔细考虑该模型具有哪些公共属性，因为客户端可能以任何公共属性路径为目标，甚至是一些不会针对给定用例的路径。

例如，在给定一个HTTP表单数据终结点的情况下，恶意客户端可能会为模型对象图中存在但不属于浏览器中显示的HTML表单的属性提供值。这可能会导致在模型对象及其任何嵌套对象上设置数据，而这些数据预计不会更新。

推荐的方法是使用专用模型对象，该对象仅公开与表单提交相关的属性。例如，在用于更改用户电子邮件地址的表单上，模型对象应该声明至少一组属性，如下面的ChangeEmailForm所示。

如果不能或不想为每个数据绑定用例使用专用模型对象，则必须限制数据绑定允许的属性。理想情况下，您可以通过在WebDataBinder上注册允许的字段模式来实现这一点。

例如，要在应用程序中注册允许的字段模式，您可以在@控制器或@ControllerAdvice组件中实现@InitBinder方法，如下所示：

除了注册允许的模式外，还可以通过DataBinder及其子类中的setDisalloweFields()方法注册不允许的字段模式。但是，请注意，“允许列表”比“拒绝列表”更安全。因此，应该优先使用setAllowweFields()，而不是setDisalloweFields()。

请注意，与允许的字段模式匹配区分大小写；而与不允许的字段模式匹配不区分大小写。此外，与不允许的模式匹配的字段将不被接受，即使它碰巧也与允许的列表中的模式匹配。

WebFlux

@ExceptionHandler方法支持以下参数：

WebFlux

@ExceptionHandler方法支持以下返回值：

ServerRequest提供对HTTP方法、URI、Header和查询参数的访问，而通过Body方法提供对Body的访问。

下面的示例将请求正文提取为字符串：

下面的示例将正文提取到列表<；Person>；，其中Person对象是从序列化格式(如JSON或XML)解码的：

以下示例显示如何访问参数：

ServerResponse提供对HTTP响应的访问，并且由于它是不可变的，您可以使用Build方法来创建它。您可以使用构建器来设置响应状态、添加响应头或提供正文。下面的示例使用JSON内容创建一个200(OK)响应：

以下示例显示如何构建带有Location头而没有正文的201(已创建)响应：

您还可以使用CompletableFuture、Publisher或Reactive AdapterRegistry支持的任何其他类型的异步结果作为正文。例如：

如果不仅正文，而且状态或标头都基于异步类型，则可以对<代码>服务器响应 使用静态<代码>异步 方法，该方法接受CompletableFuture<；ServerResponse>；，<代码>发布者<代码>服务器响应 或<代码>Reactive AdapterRegistry 支持的任何其他异步类型。例如：

服务器发送的事件可以通过ServerResponse上的静态SSE方法提供。该方法提供的构建器允许您将字符串或其他对象作为JSON发送。例如：

我们可以将处理程序函数编写为lambda，如下面的示例所示：

这很方便，但在应用程序中，我们需要多个函数，而多个内联lambda可能会变得混乱。因此，将相关的处理程序函数组合到一个处理程序类中非常有用，该处理程序类与基于注释的应用程序中的@Controller具有类似的角色。例如，下面的类公开了一个被动的Person存储库：

功能端点可以使用Spring的验证工具将验证应用于请求正文。例如，给定Person的自定义SpringValidator实现：

处理程序还可以使用标准的Bean验证API(JSR-303)，方法是基于LocalValidatorFactoryBean创建并注入一个全局Validator实例。请参阅Spring验证。

您可以编写自己的RequestPredicate，但是RequestPredicates实用程序类提供了基于请求路径、HTTP方法、内容类型等的常用实现。下面的示例使用请求谓词基于Accept头创建约束：

您可以使用以下命令将多个请求谓词组合在一起：

RequestPredicates中的许多谓词都是组合的。例如，<代码>RequestPredicates.GET(字符串) 由RequestPredicates.method(HttpMethod)和<代码>RequestPredicates.Path(字符串) 组成。上面显示的示例还使用了两个请求谓词，因为构建器在内部使用RequestPredicates.GET，并将其与Accept谓词组合在一起。

按顺序评估路由器功能：如果第一条路由不匹配，则评估第二条，依此类推。因此，在宣布一般路线之前宣布更具体的路线是有意义的。这在将路由器功能注册为SpringBean时也很重要，稍后将对此进行描述。请注意，此行为不同于基于注释的编程模型，在该模型中，“最具体的”控制器方法是自动选取的。

使用路由器函数构建器时，所有定义的路由被组合成一个RouterFunction，该函数从Build()返回。还可以通过其他方式将多个路由器功能组合在一起：

以下示例显示了四条路由的组成：