// @since 3.1
public class RequestResponseBodyMethodProcessor extends AbstractMessageConverterMethodProcessor {

  @Override
  public boolean supportsParameter(MethodParameter parameter) {
    return parameter.hasParameterAnnotation(RequestBody.class);
  }
  // 類(lèi)上或者方法上標(biāo)注了@ResponseBody注解都行
  @Override
  public boolean supportsReturnType(MethodParameter returnType) {
    return (AnnotatedElementUtils.hasAnnotation(returnType.getContainingClass(), ResponseBody.class) || returnType.hasMethodAnnotation(ResponseBody.class));
  }

  // 這是處理入?yún)⒎庋b校驗(yàn)的入口，也是本文關(guān)注的焦點(diǎn)
  @Override
  public Object resolveArgument(MethodParameter parameter, @Nullable ModelAndViewContainer mavContainer,
      NativeWebRequest webRequest, @Nullable WebDataBinderFactory binderFactory) throws Exception {

    // 它是支持`Optional`容器的
    parameter = parameter.nestedIfOptional();
    // 使用消息轉(zhuǎn)換器HttpInputMessage把request請(qǐng)求轉(zhuǎn)換出來(lái)，拿到值~~~
    // 此處注意：比如本例入?yún)⑹荘erson類(lèi)，所以經(jīng)過(guò)這里處理會(huì)生成一個(gè)空的Person對(duì)象出來(lái)（反射）
    Object arg = readWithMessageConverters(webRequest, parameter, parameter.getNestedGenericParameterType());

    // 獲取到入?yún)⒌拿Q(chēng),其實(shí)不叫形參名字，應(yīng)該叫objectName給校驗(yàn)時(shí)用的
    // 請(qǐng)注意：這里的名稱(chēng)是類(lèi)名首字母小寫(xiě)，并不是你方法里寫(xiě)的名字。比如本利若形參名寫(xiě)為personAAA，但是name的值還是person
    // 但是注意：`parameter.getParameterName()`的值可是personAAA
    String name = Conventions.getVariableNameForParameter(parameter);

    // 只有存在binderFactory才會(huì)去完成自動(dòng)的綁定、校驗(yàn)~
    // 此處web環(huán)境為：ServletRequestDataBinderFactory
    if (binderFactory != null) {
      WebDataBinder binder = binderFactory.createBinder(webRequest, arg, name);

      // 顯然傳了參數(shù)才需要去綁定校驗(yàn)嘛
      if (arg != null) {

        // 這里完成數(shù)據(jù)綁定+數(shù)據(jù)校驗(yàn)~~~~~（綁定的錯(cuò)誤和校驗(yàn)的錯(cuò)誤都會(huì)放進(jìn)Errors里）
        // Applicable：適合
        validateIfApplicable(binder, parameter);

        // 若有錯(cuò)誤消息hasErrors()，并且僅跟著的一個(gè)參數(shù)不是Errors類(lèi)型，Spring MVC會(huì)主動(dòng)給你拋出MethodArgumentNotValidException異常
        // 否則，調(diào)用者自行處理
        if (binder.getBindingResult().hasErrors() && isBindExceptionRequired(binder, parameter)) {
          throw new MethodArgumentNotValidException(parameter, binder.getBindingResult());
        }
      }

      // 把錯(cuò)誤消息放進(jìn)去 證明已經(jīng)校驗(yàn)出錯(cuò)誤了~~~
      // 后續(xù)邏輯會(huì)判斷MODEL_KEY_PREFIX這個(gè)key的~~~~
      if (mavContainer != null) {
        mavContainer.addAttribute(BindingResult.MODEL_KEY_PREFIX + name, binder.getBindingResult());
      }
    }

    return adaptArgumentIfNecessary(arg, parameter);
  }

  // 校驗(yàn)，如果合適的話。使用WebDataBinder，失敗信息最終也都是放在它身上~ 本方法是本文關(guān)注的焦點(diǎn)
  // 入?yún)ⅲ篗ethodParameter parameter
  protected void validateIfApplicable(WebDataBinder binder, MethodParameter parameter) {
    // 拿到標(biāo)注在此參數(shù)上的所有注解們（比如此處有@Valid和@RequestBody兩個(gè)注解）
    Annotation[] annotations = parameter.getParameterAnnotations();
    for (Annotation ann : annotations) {
      // 先看看有木有@Validated
      Validated validatedAnn = AnnotationUtils.getAnnotation(ann, Validated.class);

      // 這個(gè)里的判斷是關(guān)鍵：可以看到標(biāo)注了@Validated注解 或者注解名是以Valid打頭的 都會(huì)有效哦
      //注意：這里可沒(méi)說(shuō)必須是@Valid注解。實(shí)際上你自定義注解，名稱(chēng)只要一Valid開(kāi)頭都成~~~~~
      if (validatedAnn != null || ann.annotationType().getSimpleName().startsWith("Valid")) {
        // 拿到分組group后，調(diào)用binder的validate()進(jìn)行校驗(yàn)~~~~
        // 可以看到：拿到一個(gè)合適的注解后，立馬就break了~~~
        // 所以若你兩個(gè)主機(jī)都標(biāo)注@Validated和@Valid，效果是一樣滴~
        Object hints = (validatedAnn != null ? validatedAnn.value() : AnnotationUtils.getValue(ann));
        Object[] validationHints = (hints instanceof Object[] ? (Object[]) hints : new Object[] {hints});
        binder.validate(validationHints);
        break;
      }
    }
  }
  ...
}