聊聊如何避免写流水账代码 11

小王曾是少年怪见溪童出门望，雀声先我到山家

阿里巴巴Java开发工程师

博客专家认证

2022-03-24 20:53:07

CQE的校验
CQE作为ApplicationService的输入，必须保证其正确性，那么这个校验是放在哪里呢？

在最早的代码里，曾经有这样的校验逻辑，当时写在了服务里：

if (itemId <= 0 || quantity <= 0 || quantity >= 1000) {
    return Result.fail("Invalid Args");
}

这种代码在日常非常常见，但其最大的问题就是大量的非业务代码混杂在业务代码中，很明显的违背了单一职责原则。但因为当时入参仅仅是简单的int，所以这个逻辑只能出现在服务里。现在当入参改为了CQE之后，我们可以利用java标准JSR303或JSR380的Bean Validation来前置这个校验逻辑。

规范：CQE对象的校验应该前置，避免在ApplicationService里做参数的校验。可以通过JSR303/380和Spring Validation来实现

前面的例子可以改造为：

@Validated // Spring的注解
    public class CheckoutServiceImpl implements CheckoutService {
        OrderDTO checkout(@Valid CheckoutCommand cmd) { // 这里@Valid是JSR-303/380的注解
            // 如果校验失败会抛异常，在interface层被捕捉
        }
    }
    @Data
    public class CheckoutCommand {
        @NotNull(message = "用户未登陆")
        private Long userId;
        @NotNull
        @Positive(message = "需要是合法的itemId")
        private Long itemId;
        @NotNull
        @Min(value = 1, message = "最少1件")
        @Max(value = 1000, message = "最多不能超过1000件")
        private Integer quantity;
    }

这种做法的好处是，让ApplicationService更加清爽，同时各种错误信息可以通过Bean Validation的API做各种个性化定制。

...全文