Spring-MVC参数解析与前端数据提交

JQuery-Ajax定义和用法

ajax()方法通过HTTP请求加载远程数据。该方法是jQuery底层AJAX实现。简单易用的高层实现见$.get, $.post等。$.ajax()返回其创建的XMLHttpRequest对象。大多数情况下你无需直接操作该函数，除非你需要操作不常用的选项，以获得更多的灵活性。最简单的情况下，$.ajax()可以不带任何参数直接使用。

• 所有的选项都可以通过 $.ajaxSetup() 函数来全局设置。

jQuery.ajax([settings])

// settings 可选。用于配置 Ajax 请求的键值对集合。可以通过 $.ajaxSetup() 设置任何选项的默认值。

• 回调函数 如果要处理 $.ajax()得到的数据，则需要使用回调函数：beforeSend、error、dataFilter、success、complete。

@RequestParam与@RequestBody

灵活运用的@RequestParam和@RequestBody

@requestBody 与@requestparam；@requestBody的加与不加的区别

Spring MVC参数解析处理器

HandlerMethodArgumentResolver

HandlerMethodArgumentResolver是用来为处理器解析参数的，主要用在前面讲过的InvocableHandler-Method中。每个Resolver对应一种类型的参数，所以它的实现类非常多，其继承结构如图13-5所示。

这里有一个实现类比较特殊，那就是HandlerMethodArgumentResolverComposite，它不具体解析参数，而是可以将多个别的解析器包含在其中，解析时调用其所包含的解析器具体解析参数， 这种模式在前面已经见过好几次了，在此就不多说了。下面来看一下HandlerMethodArgumentResolver接口的定义：

非常简单，只有两个方法，一个用于判断是否可以解析传入的参数，另一个就是用于实际解析参数。

HandlerMethodArgumentResolver实现类一般有两种命名方式，一种是XXXMethod-ArgumentResolver，另一种是XXXMethodProcessor。前者表示一个参数解析器， 后者除了可以解析参数外还可以处理相应类型的返回值，也就是同时还是后面要讲到的Handler-Method-ReturnValueHandle。 其中的XXX表示用于解析的参数的类型。另外，还有个Adapter，它也不是直接解析参数的，而是用来兼容WebArgumentResolver类型的参数解析器的适配器。

• AbstractMessageConverterMethodArgumentResolver：使用HttpMessageConverter解析request body类型参数的基类。

• AbstractMessageConverterMethodProcessor：定义相关工具，不直接解析参数。

• HttpEntityMethodProcessor：解析HttpEntity和RequestEntity类型的参数。

• RequestResponseBodyMethodProcessor：解析注释@RequestBody类型的参数。

• RequestPartMethodArgumentResolver：解析注释了@RequestPart、MultipartFile类型以及javax.servlet.http.Part类型的参数。

• AbstractNamedValueMethodArgumentResolver：解析namedValue类型的参数（有name的参数，如cookie、requestParam、requestHeader、pathVariable等）的基类，主要功能有：①获取name；②resolveDefaultValue、handleMissingValue、handleNullValue；③调用模板方法resolveName、handleResolvedValue具体解析。

• AbstractCookieValueMethodArgumentResolver：解析注释了@CookieValue的参数的基类。

• ServletCookieValueMethodArgumentResolver：实现resolveName方法，具体解析cookieValue。

• ExpressionValueMethodArgumentResolver：解析注释@Value表达式的参数，主要设置了beanFactory，并用它完成具体解析，解析过程在父类完成。

• MatrixVariableMethodArgumentResolver：解析注释@MatrixVariable而且不是Map类型的参数（Map类型使用MatrixVariableMapMethodArgumentResolver解析）。

• PathVariableMethodArgumentResolver：解析注释@PathVariable而且不是Map类型的参数（Map类型则使用PathVariableMapMethodArgumentResolver解析）。

• RequestHeaderMethodArgumentResolver：解析注释了@RequestHeader而且不是Map类型的参数（Map类型则使用RequestHeaderMapMethodArgumentResolver解析）。

• RequestParamMethodArgumentResolver：可以解析注释了@RequestParam的参数、MultipartFile类型的参数和没有注释的通用类型（如int、long等）的参数。如果是注释了@RequestParam的Map类型的参数，则注释必须有name值（否则使用RequestParamMapMethodArgumentResolver解析）。

• AbstractWebArgumentResolverAdapter：用作WebArgumentResolver解析器的适配器。

• ServletWebArgumentResolverAdapte：给父类提供了request。

• ErrorsMethodArgumentResolver：解析Errors类型的参数（一般是Errors或Binding-Result），当一个参数绑定出现异常时会自动将异常设置到其相邻的下一个Errors类型的参数，设置方法就是使用了这个解析器，内部是直接从model中获取的。

• HandlerMethodArgumentResolverComposite：argumentResolver的容器，可以封装多个Resolver，具体解析由封装的Resolver完成，主要为了方便调用。

• MapMethodProcessor：解析Map型参数（包括ModelMap类型），直接返回mav-Container中的model。

• MatrixVariableMapMethodArgumentResolver：解析注释了@MatrixVariable的Map类型参数。

• ModelAttributeMethodProcessor：解析注释了@ModelAttribute的参数，如果其中的annotationNotRequired属性为true还可以解析没有注释的非通用类型的参数（RequestParamMethodArgumentResolver解析没有注释的通用类型的参数）。

• ServletModelAttributeMethodProcessor：对父类添加了Servlet特性，使用Servlet-RequestDataBinder代替父类的WebDataBinder进行参数的绑定。

• ModelMethodProcessor：解析Model类型参数，直接返回mavContainer中的model。

• PathVariableMapMethodArgumentResolver：解析注释了@PathVariable的Map类型的参数。

• RedirectAttributesMethodArgumentResolver：解析RedirectAttributes类型的参数，新建RedirectAttributesModelMap类型的RedirectAttributes并设置到mavContainer中，然后返回给我们的参数。

• RequestHeaderMapMethodArgumentResolver：解析注释了@RequestHeader的Map类型的参数。

• RequestParamMapMethodArgumentResolver：解析注释了@RequestParam的Map类型，而且注释中有value的参数。

• ServletRequestMethodArgumentResolver：解析WebRequest、ServletRequest、Multipart-Request、HttpSession、Principal、Locale、TimeZone、InputStream、Reader、HttpMethod类型和”java.time.ZoneId”类型的参数，它们都是使用request获取的。

• ServletResponseMethodArgumentResolver：解析ServletResponse、OutputStream、Writer类型的参数。

• SessionStatusMethodArgumentResolver：解析SessionStatus类型参数，直接返回mavContainer中的SessionStatus。

• UriComponentsBuilderMethodArgumentResolver：解析UriComponentsBuilder类型的参数。

Model类型参数的ModelMethodProcessor解析器和解析注释了@PathVariable的参数类型的PathVariableMethodArgumentResolver解析器，这两种类型的参数使用得非常多

• ModelMethodProcessor既可以解析参数也可以处理返回值

这个实现非常简单，supportsParameter方法判断如果是Model类型就可以，resolveArgument方法是直接返回mavContainer里的Model。通过前面的分析知道， 这时的Model可能已经保存了一些值，如SessionAttribute中的值、FlashMap中的值等，所以在处理器中如果定义了Model类型的参数，给我们传的Model中可能已经保存的有值了。

• PathVariableMethodArgumentResolver

用于解析url路径中的值，它的实现比较复杂，它继承自AbstractNamedValueMethodArgumentResolver，前面介绍过这个解析器是处理namedValue类型参数的基类， cookie、requestParam、requestHeader、pathVariable等类型参数的解析器都继承自它， 它跟我们之前讲过的很多组件一样，使用的也是模板模式。其中没有实现supportsParameter方法，只实现了resolveArgument方法，代码如下：

通过注释大家可以看到，首先根据参数类型获取到NamedValueInfo，然后将它传入模板方法resolveName由子类具体解析，最后对解析的结果进行处理。 这里用到的Named-ValueInfo是一个内部类，其中包含的三个属性分别表示参数名、是否必须存在和默认值，定义如下：

总结一下resolveArgument过程中所使用的方法，理解了这些方法这里的处理过程就容易理解了。

• getNamedValueInfo方法通过参数类型获取NamedValueInfo，具体过程是先从缓存中获取，如果获取不到则调用createNamedValueInfo方法根据参数创建， createNamedValueInfo是一个模板方法，在子类实现，创建出来后调用updateNamedValueInfo更新NamedValueInfo，最后保存到缓存namedValueInfoCache中。 updateNamedValueInfo方法具有两个功能：①如果name为空则使用parameter的name；②如果默认值是代表没有的ValueConstants.DEFAULT_NONE类型则设置为null。

createNamedValueInfo在子类PathVariableMethodArgumentResolver的实现是根据@PathVariable注释创建的，这里使用了继承自NamedValueInfo的内部类PathVariable-NamedValueInfo， 在PathVariableNamedValueInfo的构造方法里使用@PathVariable注释的value值创建了NamedValueInfo，默认required为true，也就是必须存在， 如果没解析到值会抛异常，defaultValue使用了ValueConstants.DEFAULT_NONE，这是一个专门用来代表空默认值的变量，代码如下：

• resolveName，这个方法用于具体解析参数，是个模板方法，PathVariableMethodArgumentResolver中实现如下：

可以看到它是直接从request里获取的HandlerMapping.URI_TEMPLATE_VARIABLES_ATTRIBUTE属性的值，这个值是在RequestMappingInfoHandlerMapping中的handleMatch中设置的， 也就是在HandlerMapping中根据lookupPath找到处理请求的处理器后设置的。

• resolveDefaultValue，这个方法是根据NamedValueInfo里的defaultValue设置默认值，如果包含占位符会将其设置为相应的值。

• handleMissingValue，如果参数是必须存在的，也就是NamedValueInfo的required为true，但是没有解析出参数，而且也没有默认值， 就会调用（如果是java1.8中的Optional类型则不调用），这也是个模板方法，PathVariableMethodArgumentResolver中直接抛出了异常，代码如下：

• handleNullValue，如果解析结果为null，而且也没有默认值，并且handleMissingValue没调用或者调用了但没抛异常的情况下才会执行，可见这个方法执行的机会是比较小的， 主要用于没解析出参数值也没默认值，不过是Optional类型参数的情况。

首先判断所需的参数是不是Boolean类型，如果是则给它设置为false， 如果是其他原始的类型（原始类型共包含Boolean、Character、Byte、Short、Integer、Long、Float、Double和Void九个）则抛出异常，否则直接返回。代码如下：

也就是说如果是原始类型（除了Boolean），即使是Optional类型（如Optional）也会抛出异常，这是因为原始类型不可以转换为null， 如果想不抛异常可以通过对应的包装类型进行声明，如Optional，这样就不会抛异常了。

• handleResolvedValue，用于处理解析出的参数值，是模板方法，PathVariableMethodArgumentResolver中实现如下：