openapi 3.0 有效的最小值和最大值

我有下面的模式定义来表示commission amount在我的 openapi 合同中。

commissionAmount:
  type: number
  minimum: -99999.99
  maximum: 99999.99

生成的代码：

@Valid
@DecimalMin("-99999.99") @DecimalMax("99999.99") 
public BigDecimal getCommissionAmount() {
  return commAmt;
}

生成的代码很好并且符合预期。我只是想知道这些是-99999.99 and 99999.99有效值minimum and maximum.

提出这个问题的原因是它没有检查小数部分的限制。例如，我期望12345.678是无效的 ，12345.67已验证。但它将两者标记为有效。

I read @Digits用于检查整数和小数部分的位数限制。我怎么告诉openapi-generator-maven-plugin注释Digits还有？

预期生成的代码：

@Valid
@Digits(integer = 5, fraction = 2)
@DecimalMin("-99999.99") @DecimalMax("99999.99") 
public BigDecimal getCommissionAmount() {
  return commAmt;
}

在 OpenAPI 中指定这一点的方法是使用multipleOf:

commissionAmount:
  type: number
  minimum: -99999.99
  maximum: 99999.99
  multipleOf: 0.01

但是，使用 OpenAPI 生成器不会产生注释为了这。原因是没有javax.validation可以表示的注解multipleOf有效地（想象一下试图表达multipleOf: 0.02- @Digits是不够的）。

但是，您可以创建自己的注释，因为该用户具有：https://github.com/OpenAPITools/openapi-generator/issues/2192#issuecomment-575132233

使用以下注释和验证器：

@Target({METHOD, FIELD})
@Retention(RUNTIME)
@Repeatable(MultipleOf.List.class)
@Constraint(validatedBy = MultipleOfValidator.class)
public @interface MultipleOf {

    double value();

    String message() default "{error.multipleOf}";

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

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

    @Target({ METHOD, FIELD })
    @Retention(RUNTIME)
    @Documented
    @interface List {
        MultipleOf[] value();
    }

}

public class MultipleOfValidator implements ConstraintValidator<MultipleOf, Number> {

    private double value;

    @Override
    public void initialize(MultipleOf constraintAnnotation) {
        this.value = constraintAnnotation.value();
    }

    @Override
    public boolean isValid(Number value, ConstraintValidatorContext context) {
        return (value == null) || (value.doubleValue() / this.value) % 1 == 0;
    }

}

然后，您可以分叉生成器并将新注释添加到模板中：https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator/src/main/resources/Java/beanValidationCore.mustache

像这样的一行：

{{#multipleOf}}@MultipleOf({{multipleOf}}){{/multipleOf}}