spring 引导中的自定义 jpa 验证

custom jpa validation in spring boot

我有一个这样的实体:

@Entity
@Table(name = "transaction_receiver")
public class TransactionReceiver implements Serializable, Addressable {

    private static final long serialVersionUID = 1L;

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;

    @NotNull
    @Column(name = "contact_id", nullable = false)
    private String contactId;

    @Column(name = "datev_number")
    private String datevNumber;

    @NotNull
    @Column(name = "receiver", nullable = false)
    private String receiver;

    @NotNull
    @Size(min = 22, max = 34)
    @Column(name = "iban", length = 34, nullable = false)
    private String iban;

    @Size(min = 8, max = 11)
    @Column(name = "bic", length = 11, nullable = false)
    private String bic;

    @NotNull
    @Column(name = "institute")
    private String institute;

    @Column(name = "company")
    private String company;

我需要写一个自定义验证“你可以提供一个空的iban、bic和institute,没关系。但是如果任何字段不为空,则上述约束必须成立”。 =31=]

我正在寻找完成此任务的最优雅的方法。

我目前的解决方案是——我认为有点脏,但有效——使用 @PrePersist 语句并从那里抛出异常

    @PrePersist
    public void checkBankData() {
        boolean ibanEmpty = iban == null || iban.isEmpty();
        boolean ibanValid = !ibanEmpty && iban.length() >= 22 && iban.length() <= 34;
        boolean bicEmpty = bic == null || bic.isEmpty();
        boolean bicValid = !bicEmpty && bic.length() >= 8 && bic.length() <= 11;
        boolean instituteEmpty = institute == null || institute.isEmpty();

        boolean validState = (ibanEmpty && bicEmpty && instituteEmpty) || ibanValid && bicValid;

        if (!validState) {
            throw new IllegalStateException(
                String.format(
                    "bank data is not empty and %s%s%s%s%s",
                    !ibanValid ? "iban has to be from 22 to 34 chars long" : "",
                    !ibanValid && !bicValid ? "and" : "",
                    !bicValid ? "bic has to be from 8 to 11 chars long" : "",
                    !ibanValid && !bicValid && instituteEmpty ? "and" : "",
                    instituteEmpty ? "institue must not be empty" : ""
                )
            );
        }
    }

不受 @Valid 注释的约束。另一种方法是定义自定义验证器,如下所述:http://docs.jboss.org/hibernate/validator/4.1/reference/en-US/html/validator-customconstraints.html

但这对我的限制来说确实有点矫枉过正。

没有其他优雅的方式吗?

要避免默认 JPA 验证不具有 Hibernate 验证器的 @NotEmpty 等效项,您可以尝试使用 @Size 注释来指定它必须大于或小于某个数字。

@NotNull
@Size(min=1)
private String description;

这是我能想到的最简洁的方法来完成你想要做的事情。

使用 Hibernate 验证 API 并不像看起来那么复杂,并且对于您的限制是一个很好的解决方案。 但是,您可以获得一种使用 Hibernate Validator 定义约束的更简单方法,就像我们在一个项目中所做的那样,添加了一些 classes。您的约束将如下所示:

@Validate(method = "checkBankData", message = "{BankData.invalid.message}")
@Entity
@Table(name = "transaction_receiver")
public class TransactionReceiver implements Serializable, Addressable {

为此,您需要定义 @Validate 注释和 CustomValidator class。

@Target({ ElementType.TYPE, ANNOTATION_TYPE })
@Retention(RUNTIME)
@Constraint(validatedBy = CustomValidator.class)
@Documented
/**
 * Annotation to allow custom validation against model classes
 */
public @interface Validate {

  /**
   * Validation message
   */
  String message();

  Class<?>[] groups() default {};

  Class<? extends Payload>[] payload() default {};

  /**
   * Validation method name
   */
  String method() default "";
}


public class CustomValidator implements ConstraintValidator<Validate, BusinessObject> {

  private static Log log = LogFactory.getLog(CustomValidator.class);
  private String validator;


  @Override
  public void initialize(Validate constraintAnnotation) {
    validator = constraintAnnotation.method();
  }

  @Override
  public boolean isValid(BusinessObject bo, ConstraintValidatorContext constraintContext) {
    try {
      return isValidForMethod(bo);
    } catch (Exception e) {
      /* Error durante la ejecución de la condición o del validador */
      log.error("Error validating "+bo, e);
      return false;
    }
  }


  private boolean isValidForMethod(BusinessObject bo) throws Exception {
    Method validatorMethod =  ReflectionUtils.findMethod(bo.getClass(), validator, new Class[] {});
    if (validatorMethod != null) {
      /* Validator call */
      Boolean valid = (Boolean) validatorMethod.invoke(bo);
      return valid != null && valid;
    } else {
      /* Method not found */
      log.error("Validator method not found.");
      return false;
    }
  }

}

如果您打算定义更多约束,这种方法会很好。您可以使用更多功能扩展它,例如验证条件或添加多个验证等。

题外话:

  • Validation 与 Spring Boot 无关,所以没有必要在你的问题中提及它。

  • serialVersionUID = 1L;是一个非常糟糕的主意。使用您的 IDE serialVersionUID 生成器为该字段填充与 1L 不同的值。