分组序列@GroupSequenceProvider、@GroupSequence控制数据校验顺序，解决多字段联合逻辑校验问题【享学Spring MVC】（中）

// Defines group sequence.  定义组序列（序列：顺序执行的）
@Target({ TYPE })
@Retention(RUNTIME)
@Documented
public @interface GroupSequence {
  Class<?>[] value();
}

public class User {
    @NotEmpty(message = "firstname may be empty")
    private String firstname;
    @NotEmpty(message = "middlename may be empty", groups = Default.class)
    private String middlename;
    @NotEmpty(message = "lastname may be empty", groups = GroupA.class)
    private String lastname;
    @NotEmpty(message = "country may be empty", groups = GroupB.class)
    private String country;
    public interface GroupA {
  }
  public interface GroupB {
  }
  // 组序列
  @GroupSequence({Default.class, GroupA.class, GroupB.class})
  public interface Group {
  }
}

public static void main(String[] args)  {
    User user = new User();
    // 此处指定了校验组是：User.Group.class
    Set<ConstraintViolation<User>> result = Validation.buildDefaultValidatorFactory().getValidator().validate(user, User.Group.class);
    // 对结果进行遍历输出
    result.stream().map(v -> v.getPropertyPath() + " " + v.getMessage() + ": " + v.getInvalidValue()).forEach(System.out::println);
}

        User user = new User();
        user.setFirstname("f");
        user.setMiddlename("s");

ValidatorImpl：
  @Override
  public final <T> Set<ConstraintViolation<T>> validate(T object, Class<?>... groups) {
    Class<T> rootBeanClass = (Class<T>) object.getClass();
    // 获取BeanMetaData，类上的各种信息：包括类上的Group序列、针对此类的默认分组List们等等
    BeanMetaData<T> rootBeanMetaData = beanMetaDataManager.getBeanMetaData( rootBeanClass );
    ...
  }

BeanMetaDataManager:
  public <T> BeanMetaData<T> getBeanMetaData(Class<T> beanClass) {
    ...
    // 会调用AnnotationMetaDataProvider来解析约束注解元数据信息（当然还有基于xml/Programmatic的，本文略） 
    // 注意：它会递归处理父类、父接口等拿到所有类的元数据
    // BeanMetaDataImpl.build()方法，会new BeanMetaDataImpl(...) 这个构造函数里面做了N多事
    // 其中就有和我本例有关的defaultGroupSequenceProvider
    beanMetaData = createBeanMetaData( beanClass );
  }

BeanMetaDataImpl：
  public BeanMetaDataImpl(Class<T> beanClass,
              List<Class<?>> defaultGroupSequence, // 如果没有配置，此时候defaultGroupSequence一般都为null
              DefaultGroupSequenceProvider<? super T> defaultGroupSequenceProvider, // 我们自定义的处理此Bean的provider
              Set<ConstraintMetaData> constraintMetaDataSet, // 包含父类的所有属性、构造器、方法等等。在此处会分类：按照属性、方法等分类处理
              ValidationOrderGenerator validationOrderGenerator) {
    ... //对constraintMetaDataSet进行分类
    // 这个方法就是筛选出了：所有的约束注解（比如6个约束注解，此处长度就是6  当然包括了字段、方法等上的各种。。。）
    this.directMetaConstraints = getDirectConstraints();
    // 因为我们Person类有defaultGroupSequenceProvider，所以此处返回true
    // 除了定义在类上外，还可以定义全局的：给本类List<Class<?>> defaultGroupSequence此字段赋值
    boolean defaultGroupSequenceIsRedefined = defaultGroupSequenceIsRedefined();
    // 这是为何我们要判空的核心：看看它传的啥：null。所以不判空的就NPE了。这是第一次调用defaultGroupSequenceProvider.getValidationGroups()方法
    List<Class<?>> resolvedDefaultGroupSequence = getDefaultGroupSequence( null );
    ... // 上面拿到resolvedDefaultGroupSequence 分组信息后，会放到所有的校验器里去（包括属性、方法、构造器、类等等）
    // so，默认组序列还是灰常重要的（注意：默认组可以有多个哦~~~）
  }
  @Override
  public List<Class<?>> getDefaultGroupSequence(T beanState) {
    if (hasDefaultGroupSequenceProvider()) {
      // so，getValidationGroups方法里请记得判空~
      List<Class<?>> providerDefaultGroupSequence = defaultGroupSequenceProvider.getValidationGroups( beanState );
      // 最重要的是这个方法：getValidDefaultGroupSequence对默认值进行分析~~~
      return getValidDefaultGroupSequence( beanClass, providerDefaultGroupSequence );
    }
    return defaultGroupSequence;
  }
  private static List<Class<?>> getValidDefaultGroupSequence(Class<?> beanClass, List<Class<?>> groupSequence) {
    List<Class<?>> validDefaultGroupSequence = new ArrayList<>();
    boolean groupSequenceContainsDefault = false; // 标志位：如果解析不到Default这个组  就抛出异常
    // 重要
    if (groupSequence != null) {
      for ( Class<?> group : groupSequence ) {
        // 这就是为何我们要`defaultGroupSequence.add(Person.class)`这一句的原因所在~~~ 因为需要Default生效~~~
        if ( group.getName().equals( beanClass.getName() ) ) {
          validDefaultGroupSequence.add( Default.class );
          groupSequenceContainsDefault = true;
        } 
        // 意思是：你要添加Default组，用本类的Class即可，而不能显示的添加Default.class哦~
        else if ( group.getName().equals( Default.class.getName() ) ) { 
          throw LOG.getNoDefaultGroupInGroupSequenceException();
        } else { // 正常添加进默认组
          validDefaultGroupSequence.add( group );
        }
      }
    }
    // 若找不到Default组，就抛出异常了~
    if ( !groupSequenceContainsDefault ) {
      throw LOG.getBeanClassMustBePartOfRedefinedDefaultGroupSequenceException( beanClass );
    }
    return validDefaultGroupSequence;
  }